cmroubao/docs

项目文档导航

一句话定位

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

VLM 和拼多多工作流在手机本地执行；管理后端只负责任务控制、取消和结果审计。

核心文档

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

Harness 辅助文档

• agent-context.json：机器可读的按任务类型文档路由。
• agent-context.md：上下文清单的使用方式。
• clean-state-checklist.md：每轮结束前检查项。
• design/README.md：P0 页面低保真原型约定。
• ../progress.md：可选的项目级大事记。
• ../init.ps1 / ../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 为准。

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