# 任务路线图（Roadmap）

> 本文是**只读路线图**：维护阶段划分、里程碑、待办池和建议拆分清单，把 MVP 拆成小步、可独立交付的任务，让 AI 一步一步开发，避免一次生成整个项目。
> 真实任务以「一任务一文件」存放在 [`tasks/`](tasks/README.md)（`docs/tasks/T-<编号>.md`）。未启用 Gitea 时以任务文件 frontmatter 为状态权威；启用后以 Issue 为实时状态、合并后的任务文件为长期事实。**本文不跟踪单任务状态**。

## 使用规则

1. **开工先落文件**：从下方「建议拆分清单」把下一个任务按 [`tasks/README.md`](tasks/README.md) 落成 `docs/tasks/T-<编号>.md`（沿用建议编号），把验收要点展开成可执行、可观察的步骤，再开始实现。
2. **每个 agent 一次只做一个任务**：领取、状态流转、执行记录、完成定义全部遵循 [`tasks/README.md`](tasks/README.md) 和 [编码规则](05-coding-rules.md)；`DONE` 需要可运行证据，多 agent 只并行写路径互不重叠的任务。
3. **不跳步**：依赖未完成的任务不能开工。
4. **本文只在规划变化时修改**：调整阶段划分、里程碑、增删建议任务或 Backlog 条目时才动本文；单个任务开工或完成**不**修改本文。
5. **动手前**先读 `00-ai-start-here.md`、`05-coding-rules.md` 和 `current-state.md`。

## 建议拆分清单

以下是按阶段列出的建议任务；`T-编号` 为建议编号，落成任务文件时沿用。

### Phase 0 · 地基

| ID | 任务 | 依赖 | 验收要点 |
| --- | --- | --- | --- |
| T-001 | 初始化项目骨架 | - | 依赖安装成功；本地能启动；首页 / 入口可访问；用真实可运行命令替换 `00-ai-start-here.md`、`03-tech-stack.md`、`05-coding-rules.md`、`current-state.md` 中的占位验证命令 |
| T-002 | 建立基础目录和配置 | T-001 | 目录结构符合 `04-architecture.md`；配置不含密钥 |
| T-003 | 加入最小测试 / 构建检查 | T-001 | 测试命令和构建命令可运行 |

### Phase 1 · 最高风险验证

| ID | 任务 | 依赖 | 验收要点 |
| --- | --- | --- | --- |
| T-101 | 验证最高风险功能原型 | T-001 | 用最小输入跑通核心难点，结论写入文档 |
| T-102 | 把原型接入正式结构 | T-101 | 代码进入约定模块，测试覆盖关键路径 |

### Phase 2 · 核心用户流程

| ID | 任务 | 依赖 | 验收要点 |
| --- | --- | --- | --- |
| T-201 | 实现核心页面 / 入口 | T-102 | 用户能进入主流程第一步 |
| T-202 | 实现核心动作 | T-201 | 用户能完成 MVP 最关键动作 |
| T-203 | 实现结果展示 / 状态反馈 | T-202 | 用户能看到保存、提交或处理结果 |

### Phase 3 · 数据与账号

| ID | 任务 | 依赖 | 验收要点 |
| --- | --- | --- | --- |
| T-301 | 建立数据模型 / 迁移 | T-202 | 表结构符合 `04-architecture.md` |
| T-302 | 实现鉴权 / 权限边界 | T-301 | 未授权访问被拒绝；授权后可访问 |
| T-303 | 实现数据持久化 | T-302 | 刷新 / 重进后数据仍在 |

### Phase 4 · 收尾与发布

| ID | 任务 | 依赖 | 验收要点 |
| --- | --- | --- | --- |
| T-401 | 完整验收 MVP | T-303 | `02-requirements.md` 的 P0 验收全部通过 |
| T-402 | 部署 / 打包 / 运行文档 | T-401 | 新环境可按文档运行 |

## 里程碑

- M1：最小可运行地基完成。
- M2：最高风险功能已验证。
- M3：MVP 核心闭环完成。
- M4：可交付 / 可部署。

## 待办池（Backlog）

- 【V2 功能 1】
- 【V2 功能 2】
- 【优化项】