48 lines
2.2 KiB
Markdown
48 lines
2.2 KiB
Markdown
# 需求分析 - 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 命令验证 |
|