feat(docs): add development documentation, prototypes, and war-room components

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
2026-04-11 08:49:41 +08:00
parent 1ca8855751
commit 21c869db62
1218 changed files with 11858 additions and 0 deletions
--- a/development-doc/plan/today-status-update/README.md
+++ b/development-doc/plan/today-status-update/README.md
@@ -0,0 +1,122 @@
+# 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 可以按阶段稳定实施。
+
+---
+
+## 阶段总览图
+
+```text
+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
+
+---
+
+## 实施顺序
+
+```text
+TS-0 → TS-1 → TS-2 → TS-3 → TS-4 → TS-5
+```
+
+不建议跳阶段。尤其是 `TS-1` 与 `TS-2` 是后续前端改造和 commander 派发的共同前提。