Pre_Seg_Server/工程分析/需求分析-2026-04-29-21-27-10.md

需求分析 - 2026-04-29-21-27-10

需求来源

• 提出时间: 2026-04-29-21-27-10
• 需求类型: 代码重构 / 目录结构调整

原始需求描述

将 \src\components 中所有子文件夹内的组件文件全部移入 \src\components 根目录，即取消子文件夹层级，实现组件目录扁平化。

需求拆解

需求 1: 移动组件文件到根目录

• 详细描述: 将 src/components/ 下所有子目录中的 .tsx 文件移动到 src/components/ 根目录
• 优先级: P0-阻塞
• 影响范围: src/components/ 下全部子目录
• 验收标准: 所有组件文件均位于 src/components/ 根目录，无残留子目录中的 .tsx 文件

需求 2: 更新 App.tsx 的 import 路径

• 详细描述: App.tsx 中引用了 7 个组件，路径格式为 ./components/{子目录}/{文件名}，需更新为 ./components/{文件名}
• 优先级: P0-阻塞
• 影响范围: src/App.tsx
• 验收标准: App.tsx 中所有组件 import 路径正确指向扁平化后的位置

需求 3: 更新组件间相互引用的路径

• 详细描述: 组件之间存在内部引用，需将相对路径调整为扁平化后的正确路径
• 优先级: P0-阻塞
• 影响范围: AISegmentation.tsx、VideoWorkspace.tsx 及所有引用 lib/utils.ts 的组件
• 验收标准: 所有组件内部 import 路径正确

需求 4: 清理空子目录

• 详细描述: 文件移动后，删除 src/components/ 下所有空的子目录
• 优先级: P1-高
• 影响范围: src/components/ai/、auth/、dashboard/、layout/、projects/、templates/、workspace/
• 验收标准: 所有空目录已删除

约束条件

• 不修改任何组件的业务逻辑代码
• 不修改组件文件名
• 保持 src/lib/utils.ts 等工具文件位置不变
• 构建和类型检查必须全部通过

风险评估

风险点	影响	缓解措施
遗漏某条 import 路径未更新	高	全局搜索所有 ./components/ 引用，逐一核对
组件间循环引用未被识别	中	使用 grep 全面扫描所有 import 语句
空目录清理不彻底	低	使用 find 命令验证