# 项目文档导航

## 一句话定位

采购自动化验证系统是一个由管理 Web 端创建任务、Android 采购端领取任务，并通过
AI 辅助完成拼多多检索和候选判断的系统；第一版先验证“创建 -> 领取 -> 搜索 ->
人工确认 -> 回传”的最小闭环。

## 核心文档

- [`../AGENTS.md`](../AGENTS.md)：AI coding agent 的仓库级权威规则。
- [`00-ai-start-here.md`](00-ai-start-here.md)：每次开发的入口和开工流程。
- [`01-vision.md`](01-vision.md)：目标用户、价值、产品原则和非目标。
- [`02-requirements.md`](02-requirements.md)：MVP 范围、验收标准和待确认事项。
- [`07-user-stories.md`](07-user-stories.md)：角色目标和业务验收场景。
- [`08-interaction-checklist.md`](08-interaction-checklist.md)：Web 与 Android 的界面行为。
- [`03-tech-stack.md`](03-tech-stack.md)：已定技术选型、待验证项和计划命令。
- [`04-architecture.md`](04-architecture.md)：系统边界、数据流、状态机和数据模型。
- [`api.md`](api.md)：管理端和 App 共用的 API 合约。
- [`routes.md`](routes.md)：管理 Web 路由和 Android 页面结构。
- [`05-coding-rules.md`](05-coding-rules.md)：编码、安全和验证硬规则。
- [`06-tasks.md`](06-tasks.md)：只读路线图和建议任务拆分。
- [`tasks/README.md`](tasks/README.md)：一任务一文件的默认执行协议。
- [`current-state.md`](current-state.md)：当前仓库现实和 blocker。

## Harness 辅助文档

- [`agent-context.json`](agent-context.json)：机器可读的按任务类型文档路由。
- [`agent-context.md`](agent-context.md)：上下文清单的使用方式。
- [`clean-state-checklist.md`](clean-state-checklist.md)：每轮结束前检查项。
- [`design/README.md`](design/README.md)：P0 页面低保真原型约定。
- [`../progress.md`](../progress.md)：可选的项目级大事记。
- [`../init.ps1`](../init.ps1) / [`../init.sh`](../init.sh)：标准验证入口；当前等待
  `T-001` 写入真实命令。

## 文档职责

- “做不做、怎么算完成”以 `02-requirements.md` 为准。
- “谁要获得什么结果”以 `07-user-stories.md` 为准。
- “界面如何反馈”以 `08-interaction-checklist.md` 为准。
- “系统如何分层、状态如何变化”以 `04-architecture.md` 为准。
- “接口字段和错误”以 `api.md` 为准。
- “当前代码是否存在、什么命令能跑”以 `current-state.md` 和真实验证结果为准。
- 任务规格、状态和证据以 `docs/tasks/T-<编号>.md` 为准。

需求或架构变化时同步所有受影响的文档，不允许代码独自形成另一套事实。