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