docs: establish project harness baseline

This commit is contained in:
QiuSW
2026-07-25 16:59:06 +08:00
commit 50a6d8ee5b
30 changed files with 2742 additions and 0 deletions
+46
View File
@@ -0,0 +1,46 @@
# 项目文档导航
## 一句话定位
采购自动化验证系统是一个由管理 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` 为准。
需求或架构变化时同步所有受影响的文档,不允许代码独自形成另一套事实。