diff --git a/docs/00-ai-start-here.md b/docs/00-ai-start-here.md index 3708e8c..1a4865f 100644 --- a/docs/00-ai-start-here.md +++ b/docs/00-ai-start-here.md @@ -85,22 +85,24 @@ cmbuyer 是一个自动化采购系统：**采购服务**（网页端，`admin/` ## 当前阶段 -**Phase 0 · 地基。** 采购服务与采购工具骨架均已初始化，尚无采购业务代码。 +**Phase 1 · 真机可行性，并行启动采购服务基础能力。** 两端骨架与核心数据模型已完成，T-103 +仍是当前真机关键路径；与真机可读字段无关的采购服务能力不再空等。 执行按任务依赖驱动，**不按 Phase 整段串行等待**。当前优先路径： -1. T-003 统一入口与 T-004 核心数据模型已完成；T-101 真机环境盘点已就绪，但尚未真机验收。 -2. T-002 已完成，立即推进 **T-101 → T-102 → T-103 真机取证**。 -3. T-103 结论确认后，才开始依赖真机可读字段的 Phase 2 生产页面；采购服务核心与 - T-104 → T-107 后续真机安全判据按依赖并行推进。 +1. T-001～T-004 与 T-101～T-102 已完成，继续推进 **T-103 真机取证**。 +2. T-103 进行时并行推进 T-201 管理会话 → T-202 `DRAFT` 建单与基础列表；两者不得启动试选， + 也不得引入机器结果、规格面板单价或证据字段。 +3. T-103 结论确认后，再推进 T-203 批量开始试选、T-204 试选证据详情、T-205～T-207， + 并按依赖推进 T-104 → T-107 后续真机安全判据。 4. Phase 3：双端打通与**第一趟试选**端到端。 5. Phase 4：**第二趟下单**与收尾。 6. V2 及以后：图搜、Excel、ERP、订单自动核对、AI 辅助。 > **M2 是本项目的生死线**：真机能按链接打开商品、精确勾选颜色分类和尺码、 > **读到该 SKU 的单价**（T-103）。前序项目正是卡在选规格和读价。 -> M2 不通过之前不要写 Phase 2 的生产页面；Phase 0 原型只确认流程与信息架构，实际可读 -> 字段仍以真机证据为准。 +> M2 不通过之前不要写**依赖真机可读字段或会启动试选**的 Phase 2 功能；T-201 与仅创建 +> `DRAFT` 的 T-202 可以并行。原型只确认流程与信息架构，实际可读字段仍以真机证据为准。 ## 领取任务规则 diff --git a/docs/05-coding-rules.md b/docs/05-coding-rules.md index f9c2259..08a7af7 100644 --- a/docs/05-coding-rules.md +++ b/docs/05-coding-rules.md @@ -96,8 +96,10 @@ - V2 / V3 只记录，不实现。**图搜、Excel、ERP、订单自动核对、AI 辅助全部不在 MVP。** - 需求明确排除的非目标不得实现。 - 不为「将来可能用到」提前抽象。 -- **Phase 1 真机结论出来之前不写 Phase 2 的页面**——确认页显示什么，取决于真机上 - 能读到什么，尤其是规格面板上的单价。 +- **Phase 1 真机结论出来之前，不写依赖真机可读字段或会启动试选的 Phase 2 功能。** T-201 + 管理会话与只创建 `DRAFT` 的 T-202 基础建单 / 列表可以并行；T-203 的批量开始试选、T-204 + 的试选证据详情以及 T-205 以后仍等待 T-103。T-201 / T-202 不得夹带机器实际规格、规格面板 + 单价、证据、授权、提交或付款字段。 ## 5. 架构纪律 diff --git a/docs/06-tasks.md b/docs/06-tasks.md index c78ed96..2347a69 100644 --- a/docs/06-tasks.md +++ b/docs/06-tasks.md @@ -10,8 +10,9 @@ 把验收要点展开成可执行、可观察的步骤，再开始实现。 2. **每个 agent 一次只做一个任务**：领取、状态流转、执行记录、完成定义遵循 [`tasks/README.md`](tasks/README.md) 和[编码规则](05-coding-rules.md)。 -3. **不跳步**：依赖未完成的任务不能开工。Phase 0 可先做使用假数据的低保真交互原型； - **Phase 1 的真机结论出来之前不写 Phase 2 的生产页面**，T-103 若改变可读字段则先修订原型与 IX。 +3. **不跳步**：依赖未完成的任务不能开工。T-103 完成前可并行 T-201 管理会话与只创建 `DRAFT` + 的 T-202 基础建单 / 列表；**依赖真机可读字段或会启动试选的 Phase 2 功能仍不得抢跑**， + T-103 若改变可读字段则先修订原型与 IX。 4. **本文只在规划变化时修改**：单个任务开工或完成**不**修改本文。 5. **动手前**先读 `00-ai-start-here.md`、`05-coding-rules.md` 和 `current-state.md`。 @@ -24,14 +25,15 @@ | --- | --- | --- | --- | | 1 | T-001 初始化 `admin/` | T-002 初始化 `client/` | - | | 2 | T-001 后立即做 T-004 | T-002 后立即做 T-101 → T-102 → **T-103** | T-001、T-002 都完成后做 T-003 | -| 3 | T-103 通过后推进 T-201 → T-207 | T-103 后推进 T-104 → T-107 | T-208 等待 T-207 与 T-107 均完成 | +| 3 | 与 T-103 并行做 T-201 → T-202；T-103 后做 T-203 → T-207 | T-103 后推进 T-104 → T-107 | T-208 等待 T-207 与 T-107 均完成 | | 4 | T-301 → T-302 | T-302 后交接 T-303 → T-304 → T-306 | T-306 与 T-104 完成后做 T-305 | | 5 | - | T-305、T-208、T-306 后做 T-401 | T-401 后并行 T-402 / T-403，再做 T-404 → T-405 | **T-103 是当前最高优先级和 MVP 生死线。** T-002 一完成就启动 T-101，不等待 T-003、 T-004 或整个 Phase 0 收尾。并行只优化等待关系，不改变下列门禁： -- T-103 的真机结论出来前，不写依赖真机可读字段的 Phase 2 生产页面。 +- T-103 的真机结论出来前，T-201 / T-202 只能落管理会话、`DRAFT` 建单与基础列表；不启动试选， + 不展示机器规格、规格面板单价或证据。T-203～T-207 继续等待 T-103。 - `needs_device: true` 的任务仍只能由人完成验收。 - 不复用前序项目页面判据，不放宽三道价格闸门，不让第一趟引用任何下单函数。 - 第三个 agent 优先做写路径独立的集成任务或只读复核，不与两端任务争写共享文档。 @@ -126,8 +128,9 @@ T-004 或整个 Phase 0 收尾。并行只优化等待关系，不改变下列 - **M5**：第一趟试选端到端跑通，任务能停在「等你确认」。（T-305） - **M6**：MVP 闭环——第二趟下单成功，任务停在「待付款」。（T-401） -**M2 是本项目的生死线。** 前序项目正是卡在选规格和读价；M2 不通过之前不要写 Phase 2 -的生产页面。Phase 0 原型只用于确认信息架构，T-103 若改变可读字段必须先回修原型与 IX。 +**M2 是本项目的生死线。** 前序项目正是卡在选规格和读价；M2 不通过之前只允许 T-201 与 +不启动试选的 T-202，不写依赖真机字段或会推进任务执行的 Phase 2 功能。原型只用于确认信息架构， +T-103 若改变可读字段必须先回修原型与 IX。 ## 待办池（Backlog） diff --git a/docs/tasks/T-010.md b/docs/tasks/T-010.md new file mode 100644 index 0000000..04ad9ee --- /dev/null +++ b/docs/tasks/T-010.md @@ -0,0 +1,50 @@ +--- +id: T-010 +title: 收窄 Phase 2 门禁并启动安全并行 +phase: 0 +deps: [T-009] +status: DOING +created: 2026-08-04 +vikunja_task_id: 25 +context_ref: d27fda6 +work_branch: task/t-010-parallel-gate +needs_device: false +needs_human_review: false +write_paths: + - docs/tasks/T-010.md + - docs/00-ai-start-here.md + - docs/05-coding-rules.md + - docs/06-tasks.md +--- + + +## 问题 / 背景 + +客户要求加快 MVP。现有全局门禁把全部 Phase 2 页面都冻结到 T-103 完成，范围过宽；管理员登录与只创建 DRAFT 的基础建单不读取真机页面字段，也不会启动试选或触发下单。 + +## 方案 + +1. 把门禁收窄为：T-103 前允许 T-201 管理会话与 T-202 DRAFT 建单/基础列表；T-203 的批量开始试选、T-204 试选证据详情和 T-205 以后继续冻结。 +2. 同步 AI 入口、编码规则和路线图；不修改 T-103 安全边界，不放宽不付款、第一趟禁下单、真机判据先取证或隐私证据分层。 +3. 并行启动 admin T-201；共享文档由本任务所有者统一修改。 + +## 验收要点 + +- 门禁文字不存在“冻结全部 Phase 2”的歧义。 +- T-201/T-202 不得出现 PDD 页面判据、试选结果、证据、授权、提交或支付能力。 +- 上下文校验、Vikunja 导出检查与 diff-check 通过。 + +## 执行记录 + +（暂无） + + +## 边界 + +- 本任务只调整依赖门禁和并行顺序，不实现任何采购服务、真机自动化或页面判据代码。 +- T-103 完成前只放行与真机可读字段无关的 T-201 管理会话，以及只创建 `DRAFT`、不启动试选的 + T-202 基础建单与列表壳。 +- T-203 的批量 `DRAFT → PENDING`、T-204 的试选证据详情以及 T-205 以后仍由 T-103 阻塞；不得用 + 假字段、原型假数据或前序项目结论提前固化生产契约。 +- 不付款、第一趟不可达下单、价格读取位置、真机判据先取证、原始证据本机隔离与派生物消费边界 + 均保持不变。