WIN-JHFT4D3SIVT\caoxiaozhu
21c869db62
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
123 lines
6.8 KiB
Markdown
123 lines
6.8 KiB
Markdown
# 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 派发的共同前提。
|