# 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 派发的共同前提。