文档按功能维护。产品定义、当前待办、技术契约、操作步骤和评估证据各有一个入口；已结束的实施计划不继续充当当前执行依据。
| 要了解什么 | 入口 |
|---|---|
| 产品做什么、面向谁 | 产品需求 |
| 当前缺口与下一步 | 路线图 |
| 服务、模型和数据如何协作 | 系统架构 |
| 如何启动、迁移和排障 | 本地运行与部署 |
| 如何验证质量 | 评估入口 |
| 数据从哪里来、何时可以发布 | 数据规则（含来源决策记录） |
| 让独立 AI 采集商品并交付入库材料 | AI 辅助采集与入库指南 |
| 主题 | 文档 |
|---|---|
| 工程与选型（含 ADR-007 模型供应商、ADR-008 账号） | 开发约定、技术选型、本地账号操作 |
| AI 协作、Git 提交与工程踩坑 | 仓库协作规则、工程踩坑记录 |
| 默认选配与自主规划 | 自主规划流程（含需求状态、语义选件、已有配件、网页读取策略） |
| 跨会话偏好记忆（草案） | 偏好记忆设计草案（第一阶段独立基座;注入与提取接口待定） |
| 服务与状态 | A2A 边界、Redis 会话、版本快照与改单 |
| 产品接口 | API 与状态机（含分享与导出）、OpenAPI、SSE 协议 |
| 客户端 | Web 客户端 |
| 数据维护 | 数据管道设计（含价格观察与选价）、价格任务 |
| 评估工具 | 评估设施、测试与验收 |
- 文件按功能命名；ADR 编号表示决策身份，命令和数据中的历史编号保持兼容。
- 路线图只维护未完成事项、恢复条件与完成证据；不复制多份阶段清单。
- 实现文档说明现有行为和明确限制，计划中的能力不能写成已实现。
- 历史基线与运行日志保留日期和模型口径；不能把历史通过率当成当前版本成绩。
- Agent 字段以
internal/schemas为准，HTTP 以 OpenAPI 为准，数据库以db/migrations为准；修改时同步维护对应文档。