diff --git a/improve.md b/improve.md new file mode 100644 index 0000000..623e108 --- /dev/null +++ b/improve.md @@ -0,0 +1,87 @@ +这份 `tasks.md` (V1.0) 文档质量非常高,它不仅精准地拆解了 `DevelopmentPlan.md` (V1.2) 和 `FeatureSummary.md` (V1.2) 中的复杂逻辑,还完美覆盖了 `User_Role_Interfaces.md` 中新增的移动端页面。 + +特别是对 **Phase 2 (AI 流水线)** 的任务拆解,非常符合 **Phase 2 延长至 4 周** 的规划,将“时间戳对齐”、“Tus 断点续传”、“弹性 GPU”等技术难点都落实到了具体 Task。 + +为了确保开发过程的顺畅(特别是前后端协作),我建议补充 **3 个容易被忽视的工程细节**。 + +### 🟢 审阅结论:通过,建议微调 (Approved with minor suggestions) + +以下是我的改进建议,你可以选择性采纳补充进文档: + +#### 1. 补充“API Mock”任务 (解决前后端并行瓶颈) + +* **问题:** Phase 2 是后端和 AI 的攻坚期(4周),而 Phase 3 的前端开发(达人端/审核台)在逻辑上依赖 Phase 2 的 API。如果等后端全写完前端再动工,会浪费时间。 +* **建议:** 在 **Phase 1** 增加一个 P0 任务 **“API 接口定义与 Mock 服务搭建”**。 +* **TASK-001-B:** 定义 Swagger/OpenAPI 文档,并使用 Mock 工具(如 YApi / FastMock)生成假数据接口。 +* **收益:** 前端可以在 Phase 2 同步开发 Phase 3 的界面,无需等待后端真实接口。 + + + +#### 2. 补全“消息中心”的后端 API + +* **问题:** `TASK-030` (达人端消息中心) 是前端任务,`TASK-023` 是 WebSocket 推送。但系统中缺少**“获取历史消息列表”**和**“标记已读”**的后端 API 任务。 +* **建议:** 在 **Phase 3 (Section 4.3)** 或 **Phase 2** 中补充一个后端任务: +* **TASK-030-B:** 消息通知服务后端接口(列表查询、未读计数、标记已读、过期清理)。 + + + +#### 3. 基础设施中补充 CI/CD 流水线 + +* **问题:** 目前部署任务 `TASK-043` 在 Phase 4 最后。但通常在 Phase 1 就需要建立自动化构建流程,方便测试。 +* **建议:** 在 **Phase 1 (TASK-001)** 中增加子项或单独任务: +* **CI/CD 配置:** 配置 GitHub Actions / GitLab CI,实现代码提交后的自动 Lint 检查、Docker 镜像构建和 Dev 环境自动部署。 + + + +--- + +### 📝 建议的修改 (Copy & Paste) + +如果你希望文档完美无缺,可以在 `tasks.md` 中插入以下补充任务: + +**在 Phase 1 增加:** + +```markdown +#### TASK-005-B: API Mock 与文档定义 +| 属性 | 内容 | +| --- | --- | +| **负责人** | Backend + Frontend | +| **优先级** | P0 | +| **预估工时** | 2d | +| **依赖** | TASK-001 | +| **功能编号** | 基础设施 | + +**任务描述:** +- 定义 OpenAPI (Swagger) 接口文档 +- 搭建 Mock Server (YApi/Apifox) +- 生成前端 TypeScript 接口类型定义 + +**验收标准:** +- [ ] 前端可调用 Mock 接口进行 UI 开发 + +``` + +**在 Phase 3 增加:** + +```markdown +#### TASK-030-B: 消息中心后端接口 +| 属性 | 内容 | +| --- | --- | +| **负责人** | Backend | +| **优先级** | P1 | +| **预估工时** | 1d | +| **依赖** | TASK-002 | +| **功能编号** | F-27 | + +**任务描述:** +- 实现消息列表 API (分页/类型筛选) +- 实现未读数查询 API +- 实现"全部已读/单条已读" API + +**验收标准:** +- [ ] 可拉取历史消息 +- [ ] 未读数同步准确 + +``` + +除此之外,这份任务清单非常出色,尤其是对 **Mobile 移动端任务** 的补充(TASK-037A~I)非常细致,完全可以直接分发给 Jira/飞书项目管理进行排期了。 \ No newline at end of file diff --git a/tasks.md b/tasks.md index 84dedb1..66e814b 100644 --- a/tasks.md +++ b/tasks.md @@ -3,7 +3,7 @@ | 文档类型 | **Development Tasks (开发任务清单)** | | --- | --- | | **项目名称** | SmartAudit (AI 营销内容合规审核平台) | -| **版本号** | V1.0 | +| **版本号** | V1.2 | | **发布日期** | 2026-02-02 | | **依据文档** | PRD.md, FeatureSummary.md, DevelopmentPlan.md, UIDesign.md, User_Role_Interfaces.md | | **总周期** | 11 周 (2.75 个月) | @@ -16,6 +16,7 @@ | --- | --- | --- | --- | | V1.0 | 2026-02-02 | Claude | 初稿:基于功能清单和开发计划拆解任务 | | V1.1 | 2026-02-02 | Claude | 补充:代理商/品牌方移动端任务、响应式与无障碍设计任务 | +| V1.2 | 2026-02-02 | Claude | Gemini 审阅优化:新增 API Mock、CI/CD、消息中心后端接口任务 | --- @@ -169,6 +170,52 @@ --- +#### TASK-005-B: API Mock 与文档定义 +| 属性 | 内容 | +| --- | --- | +| **负责人** | Backend + Frontend | +| **优先级** | P0 | +| **预估工时** | 2d | +| **依赖** | TASK-001 | +| **功能编号** | 基础设施 | + +**任务描述:** +- 定义 OpenAPI (Swagger) 接口文档 +- 搭建 Mock Server (YApi/Apifox) +- 生成前端 TypeScript 接口类型定义 +- 建立 API 变更通知机制 + +**收益说明:** 前端可在 Phase 2 同步开发 Phase 3 的界面,无需等待后端真实接口。 + +**验收标准:** +- [ ] OpenAPI 文档覆盖核心接口 +- [ ] 前端可调用 Mock 接口进行 UI 开发 +- [ ] TypeScript 类型自动生成 + +--- + +#### TASK-005-C: CI/CD 流水线配置 +| 属性 | 内容 | +| --- | --- | +| **负责人** | Backend | +| **优先级** | P0 | +| **预估工时** | 1d | +| **依赖** | TASK-001, TASK-006 | +| **功能编号** | 基础设施 | + +**任务描述:** +- 配置 GitLab CI / GitHub Actions +- 实现代码提交后自动 Lint 检查 +- 实现 Docker 镜像自动构建 +- 配置 Dev 环境自动部署 + +**验收标准:** +- [ ] 代码提交后自动触发构建 +- [ ] Lint 错误阻断合并 +- [ ] Dev 环境自动更新 + +--- + ### 2.2 前端框架搭建 #### TASK-006: PC 端框架搭建 @@ -781,6 +828,28 @@ --- +#### TASK-030-B: 消息中心后端接口 +| 属性 | 内容 | +| --- | --- | +| **负责人** | Backend | +| **优先级** | P1 | +| **预估工时** | 1d | +| **依赖** | TASK-002, TASK-023 | +| **功能编号** | F-27 | + +**任务描述:** +- 实现消息列表 API (分页/类型筛选) +- 实现未读数查询 API +- 实现"全部已读/单条已读" API +- 实现消息过期清理策略 + +**验收标准:** +- [ ] 可拉取历史消息(分页) +- [ ] 未读数同步准确 +- [ ] 已读状态更新正常 + +--- + ### 4.2 代理商端 PC 页面 #### TASK-031: 代理商端工作台 @@ -1570,6 +1639,8 @@ graph TD T003[TASK-003 OSS] T004[TASK-004 Redis] T005[TASK-005 认证] + T005B[TASK-005-B API Mock] + T005C[TASK-005-C CI/CD] T006[TASK-006 PC前端] T007[TASK-007 H5前端] T009[TASK-009 Brief解析AI] @@ -1578,7 +1649,10 @@ graph TD T001 --> T002 T001 --> T003 T001 --> T004 + T001 --> T005B T002 --> T005 + T001 --> T005C + T006 --> T005C T006 --> T007 end @@ -1607,6 +1681,8 @@ graph TD subgraph Phase3 [Phase 3: 界面开发] T027[TASK-027 达人上传页] T028[TASK-028 达人结果页] + T030[TASK-030 消息中心前端] + T030B[TASK-030-B 消息中心后端] T032[TASK-032 审核台播放器] T033[TASK-033 AI检查单] T034[TASK-034 决策操作] @@ -1622,6 +1698,8 @@ graph TD T014 --> T027 T023 --> T027 T027 --> T028 + T023 --> T030B + T030B --> T030 T032 --> T033 T033 --> T034 T032 --> T037A