JARVIS/development-doc/plan/today-status-update/README.md

Today Status 完整化实施计划索引

本目录用于存放首页 Today Status 完整化的分阶段规划文档，目标是先完成文档拆解，再交给 Codex 按阶段实施。

文档说明

文件	说明
README.md	总览、阶段关系、实施顺序、关键文件
phase-ts-0-current-state.md	当前现状、问题、目标架构
phase-ts-1-business-task-model.md	业务 Task / SubTask / 分配模型扩展
phase-ts-2-task-api-and-schedule-aggregation.md	Task API 与 Schedule Center 聚合扩展
phase-ts-3-chat-today-status-integration.md	Chat 首页 Today Status 接真实数据
phase-ts-4-manual-create-and-detail-editor.md	手动创建与详情编辑器
phase-ts-5-commander-dispatch.md	Commander 派发闭环
checklist.md	给 Codex 使用的可勾选执行清单

推荐阅读顺序

1. 先阅读 phase-ts-0-current-state.md
2. 再按顺序阅读 phase-ts-1 ~ phase-ts-5
3. 实施时严格按阶段推进

---

总体设计原则

1. 业务任务与执行态分层
   • 业务 Task / SubTask 不直接等于 runtime task graph。
2. Today Status 复用 Schedule Center 真实聚合
   • 不新增第二套聚合真源。
3. Chat 创建先走显式入口
   • 第一版优先 /task、/task@commander 之类显式方式。
4. 先数据闭环，后体验增强
   • 先打通 CRUD / 聚合 / dispatch，再补评论、自动识别、实时推送。
5. 文档先行，代码交给 Codex
   • 这组文档的目标是让 Codex 可以按阶段稳定实施。

---

阶段总览图

Phase TS-0 ───────────────────────────────────────────────────────────┐
│ 当前现状与目标                                                      │
│ - 真实数据流盘点                                                    │
│ - mock 边界盘点                                                     │
│ - 目标三层架构                                                      │
└───────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase TS-1 ───────────────────────────────────────────────────────────┐
│ 业务任务模型扩展                                                    │
│ - Task 扩字段                                                       │
│ - 新增业务级 TaskSubTask                                            │
│ - TaskHistory 动作扩展                                              │
└───────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase TS-2 ───────────────────────────────────────────────────────────┐
│ Task API 与 Schedule 聚合扩展                                       │
│ - task detail / subtasks / dispatch                                 │
│ - schedule-center/date 扩展 focus/quadrants/commander summary       │
└───────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase TS-3 ───────────────────────────────────────────────────────────┐
│ Chat 首页 Today Status 接真实数据                                   │
│ - useSidebarPlan 去 mock                                            │
│ - KanbanPanel 真实化                                                │
│ - Chat 首页联动刷新                                                 │
└───────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase TS-4 ───────────────────────────────────────────────────────────┐
│ 手动创建与详情编辑器                                                │
│ - KanbanDetail 真实 create/edit                                     │
│ - Schedule Center 手动创建增强                                      │
│ - 象限快捷新建                                                      │
└───────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase TS-5 ───────────────────────────────────────────────────────────┐
│ Commander 派发闭环                                                  │
│ - task/subtask dispatch API                                         │
│ - commander 执行态回写                                              │
│ - Today Status / Schedule Center 状态一致                           │
└───────────────────────────────────────────────────────────────────┘

---

关键文件总览

Backend

• backend/app/models/task.py
• backend/app/schemas/task.py
• backend/app/routers/task.py
• backend/app/routers/schedule_center.py
• backend/app/schemas/schedule_center.py
• commander / orchestration service 相关文件

Frontend

• frontend/src/api/task.ts
• frontend/src/api/scheduleCenter.ts
• frontend/src/pages/chat/composables/useSidebarPlan.ts
• frontend/src/pages/chat/index.vue
• frontend/src/components/chat/KanbanPanel.vue
• frontend/src/components/chat/KanbanDetail.vue
• frontend/src/pages/schedule-center/composables/useScheduleCenterPage.ts
• frontend/src/pages/schedule-center/index.vue
• Chat 输入 / 发送消息相关 composable

---

实施顺序

TS-0 → TS-1 → TS-2 → TS-3 → TS-4 → TS-5

不建议跳阶段。尤其是 TS-1 与 TS-2 是后续前端改造和 commander 派发的共同前提。