139 lines
11 KiB
Markdown
139 lines
11 KiB
Markdown
# 任务路线图（Roadmap）
|
||
|
||
> 本文维护阶段、依赖和建议拆分，不跟踪状态。真实状态、写路径和执行证据在
|
||
> [`docs/tasks/T-XXX.md`](tasks/README.md)；状态权威是 git frontmatter。
|
||
|
||
## 使用规则
|
||
|
||
1. 从路线图领取任务前先落任务文件、边界、写路径和验收门禁。
|
||
2. 一个 agent 同时只负责一个 `DOING`；只有写路径互不重叠才并行。
|
||
3. `needs_device: true` 只能由人完成验收，agent 写完代码仍保持 `DOING`。
|
||
4. 页面判据必须先在本项目真机取证。真机结论变化时先修订契约/原型，再写生产流程。
|
||
5. 管理员点击“开始采购”是创建待付款订单的授权；单趟业务流程不等于跳过分段取证。
|
||
|
||
## 并行执行与关键路径
|
||
|
||
Phase 是里程碑分组，不是整段串行栅栏。推荐波次：
|
||
|
||
| 波次 | 采购服务 agent | 采购工具 agent | 大脑 / 集成 |
|
||
| --- | --- | --- | --- |
|
||
| 1 | T-001 → T-004 → T-201 → T-202 | T-002 → T-101 → T-102 | T-003、原型与契约 |
|
||
| 2 | T-209 → T-203 → T-204 | T-103 → T-104 → T-105 → T-107 | T-111 单趟重构；逐任务主审 |
|
||
| 3 | T-205 → T-207 → T-208 | T-301 → T-304 → T-306 | 双端契约完整门禁 |
|
||
| 4 | - | T-305 | 围栏前端到端 dry-run 主审 |
|
||
| 5 | T-402 / T-403 | T-401 | 真机人工授权、提交与调和验收 |
|
||
| 6 | - | T-405 | T-404 完整验收 |
|
||
|
||
并行门禁：
|
||
|
||
- T-202 只创建/展示 `DRAFT`，可与 T-103 并行；T-203 只实现管理员授权与任务状态，不依赖页面
|
||
选择器，也可在 T-103 完成前推进。
|
||
- T-205 起涉及实际 attempt/证据字段，必须等待 T-103 确认规格和价格最小事实。
|
||
- T-103、T-105、T-106、T-107 的 capability 相互隔离；未经取证的后续动作不可提前暴露。
|
||
- T-401 前任何任务都不得真实点击“提交订单”；支付能力永远不实现。
|
||
- 主 agent 独立审阅每个子 agent 的 diff 并重跑验证，不以其自报完成作为证据。
|
||
|
||
## 建议拆分清单
|
||
|
||
### Phase 0 · 地基
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 |
|
||
| --- | --- | --- | --- |
|
||
| T-001 | 初始化采购服务 `admin/` | - | Go 模块、健康检查、`go test` / `go vet` 可运行 |
|
||
| T-002 | 初始化采购工具 `client/` | - | Python 包、unittest、compileall、日志/产物目录可运行 |
|
||
| T-003 | 建立 `init.ps1` 统一入口 | T-001, T-002 | 一条命令安装并验证两端；失败明确，不静默跳过 |
|
||
| T-004 | 建立核心数据模型与状态机 | T-001 | 基础 tasks / authorization / submission 模型、十进制金额和状态测试 |
|
||
| T-005 | 网页端 MVP 原型 | - | 采购服务登录、传统表格、创建、批量开始采购、路由详情、待付款/调和状态可演示 |
|
||
| T-006 | 桌面端 MVP 原型 | - | 采购工具固定 tabs、轮询、当前任务/图片/日志、记录详情双视图和单趟状态可演示 |
|
||
| T-007 | 统一产品与目录名称 | - | 项目 `cmbuyer`；网页端“采购服务”在 `admin/`；桌面端“采购工具”在 `client/` |
|
||
| T-010 | 原型与交互核对 | T-005, T-006 | 人工确认 P0 页面、布局、键盘、异常和无生产副作用 |
|
||
|
||
### Phase 1 · 真机取证（最高风险）
|
||
|
||
> 每个任务均 `needs_device: true`。截图、XML、goods_id、设备、Android、连接方式和拼多多 App
|
||
> 版本写入任务记录；只有人能把任务标为 DONE。
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 |
|
||
| --- | --- | --- | --- |
|
||
| T-101 | 验证 ADB / uiautomator2（USB + WiFi） | T-002 | 两通道截图和 dump；同手机双通道 fail closed；超时可配置 |
|
||
| T-102 | 验证按链接打开商品详情页 | T-101 | canonical goods 链接进入对应商品；前台包与 goods_id 有证据 |
|
||
| T-103 | 验证受控规格面板、精确选择与 SKU 单价 | T-102, T-110, T-111 | 精确唯一入口、维度内等值选择/读回、防前缀碰撞、当前价唯一读取；隔离 capability 不含数量/确认/提交 |
|
||
| T-104 | 验证规格选择能力安全退出 | T-103 | 完成选择/读价/截图后可关闭面板或退出；不进入确认页、不提交 |
|
||
| T-105 | 验证数量设置、读回与闸门二 | T-103 | 设置数量并精确读回；再次读规格/单价等于闸门一；不一致即停 |
|
||
| T-106 | dry-run：确认页与闸门三取证 | T-105 | 进入确认页读规格、数量、应付总额并验证提交控件唯一；绝不点击 |
|
||
| T-107 | 固化确认页与提交控件安全判据 | T-106 | 只使用本项目证据；dry-run 静态不可达提交；版本失配 fail closed |
|
||
| T-110 | 批准证据绑定的受控规格入口 | T-103 no-go 决策 | 仅批准拼多多 8.17.0 已取证的精确唯一“快要抢光”，不泛化 |
|
||
| T-111 | 调整为开始采购授权的单趟流程 | T-004, T-010, T-110 | 状态/API/原型/任务依赖一致；删除试选后确认但不放宽三闸门和围栏 |
|
||
|
||
T-106 / T-107 是发布前只读验证，不是业务任务的第一趟。首次允许创建真实待付款订单的是 T-401，
|
||
执行前必须有明确人工授权，并记录订单是否产生及如何处置。
|
||
|
||
### Phase 2 · 采购服务核心
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 |
|
||
| --- | --- | --- | --- |
|
||
| T-201 | 管理员登录与会话 | T-004, T-005 | 会话、CSRF、站内 return path 与权限测试 |
|
||
| T-202 | 手工建单（F-001） | T-201 | 创建/展示 `MANUAL + DRAFT`；链接/金额/幂等/倒序；不含授权或执行 |
|
||
| T-209 | 把核心 schema / 状态机迁移为单趟模型 | T-004, T-111 | 新 migration 安全替换旧 `spec_trials` / 授权锁价结构；新增 `purchase_attempts`；删除旧 MVP 状态；无业务数据事实写入迁移前置，遇未知旧数据 fail closed；领域/迁移测试同步 |
|
||
| T-203 | 表格查询与批量开始采购（F-004、F-008、F-018） | T-202, T-209 | 只选 DRAFT；按钮明确“不付款”；事务内创建锁定任务字段的一次性授权并全批 `DRAFT → PENDING`；重放/冲突测试 |
|
||
| T-204 | 路由化任务详情与内部截图资产（F-007、F-011） | T-203 | 抽屉/完整页共享 URL；状态详情；受保护 `INTERNAL_RAW` screenshot 上传/读取、SHA-256 与 no-store；不接收 XML |
|
||
| T-205 | purchase attempt、事件与执行摘要 API | T-204, T-103 | 记录实际规格、两次单价、数量、确认页金额、固定 reason；不再创建 `spec_trials` 审批记录 |
|
||
| T-206 | 单趟状态视图与安全主动作 | T-205 | PENDING/CLAIMED/ORDERING/NEEDS_MANUAL/WAITING_PAYMENT/RECONCILIATION_REQUIRED 显示和允许动作一致；无中途确认 |
|
||
| T-207 | 授权有效期与围栏前重置（F-010） | T-206 | 围栏前过期/关闭旧授权后回 DRAFT；围栏后拒绝释放、取消、重新授权 |
|
||
| T-208 | 提交围栏与结果调和 API（F-017） | T-207, T-107 | 原子复核授权/attempt/三闸门/唯一控件；首次许可一次；重放不许可点击；结果不明永久围栏且只调和 |
|
||
|
||
### Phase 3 · 双端打通（单趟围栏前）
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 |
|
||
| --- | --- | --- | --- |
|
||
| T-301 | 设备凭据与身份隔离（F-013） | T-201 | Bearer 不能建单/授权；管理会话不能领任务；凭据可撤销 |
|
||
| T-302 | 已授权任务原子领取与租约（F-005） | T-301, T-203 | 只领 PENDING+有效授权；并发唯一；重放同一 attempt；claim token/generation 有效 |
|
||
| T-303 | `HttpTaskSource` / `HttpResultSink` | T-302, T-002 | 执行器依赖抽象；幂等重放；线协议严格校验；不扩大 Excel 范围 |
|
||
| T-304 | 定时轮询与会话边界 | T-303, T-006 | 人启动后轮询；停止只阻止下次领取；连续失败停；当前任务/记录详情双视图 |
|
||
| T-306 | 单趟截图与证据上传 | T-304, T-204 | 显式上传原始 screenshot；可含页面地址/手机号；完整 XML、本机路径、外部支付页不上传 |
|
||
| T-305 | **单趟围栏前端到端 dry-run** | T-306, T-107, T-205 | 从领取连续跑到闸门三与提交控件验证，随后安全停止；全程事件/证据齐全，不申请真实许可、不点击提交 |
|
||
|
||
### Phase 4 · 真实提交与收尾
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 |
|
||
| --- | --- | --- | --- |
|
||
| T-401 | **单趟采购与提交围栏端到端** | T-305, T-208 | 同一设备会话通过三闸门、首次明确围栏许可后点击一次；结果不明只调和；明确创建转待付款；绝不付款 |
|
||
| T-402 | 待付款收口与手工完成 | T-401 | 详情展示订单证据；人付款后手工标记；待付款不等于成功 |
|
||
| T-403 | 失败分类与证据归档 | T-401 | 覆盖需求 reason；终态原子回写；围栏后无重试 |
|
||
| T-404 | 完整 MVP 验收 | T-402, T-403 | P0 验收、双端门禁、真机记录和 current-state 全部通过 |
|
||
| T-405 | 采购工具打包与运行文档 | T-404 | 运营电脑可安装运行，记录产物 SHA-256 |
|
||
|
||
### V2 及以后
|
||
|
||
| ID | 任务 | 说明 |
|
||
| --- | --- | --- |
|
||
| T-501 | 图片搜索产出 goods_id（F-014） | 不在结果页读价；最多 5 个 |
|
||
| T-502 | 候选对照台（F-015） | 多候选对照，窄屏降级 |
|
||
| T-503 | Excel 批量建单（F-002） | 等表头契约 |
|
||
| T-504 | ERP 同步与建单（F-003） | 等字段映射 |
|
||
| T-505 | 批量编排与运行中接管（F-012） | 排序、暂停继续、运行中冻结 |
|
||
| T-506 | 订单自动核对回读（F-016） | 五项唯一匹配，否则人工 |
|
||
| T-507 | 本地执行轨迹留档（F-103） | NDJSON 与模型/规则分歧 |
|
||
| T-508 | AI 辅助（F-101、F-102） | 模型结论不能放宽安全边界 |
|
||
|
||
## 里程碑
|
||
|
||
- **M0**：两端原型确认；单趟主动作、状态、异常和键盘可枚举。（T-005、T-006、T-111）
|
||
- **M1**：两端骨架、基础模型与验证入口可运行。
|
||
- **M2**：真机按链接打开商品、精确选择颜色/尺码并读 SKU 单价。（T-103）
|
||
- **M3**：真机设置数量、闸门二、确认页闸门三和唯一提交控件 dry-run 通过，不点击。（T-107）
|
||
- **M4**：管理员建单并通过批量开始采购创建一次性授权；设备可安全领取。（T-203、T-302）
|
||
- **M5**：单趟从领取到围栏前 dry-run 跑通，事件与证据齐全。（T-305）
|
||
- **M6**：单趟真实提交只创建待付款订单，围栏/调和/人工收口闭环。（T-401～T-404）
|
||
|
||
**M2 仍是生死线。** M2 前可以并行管理会话、DRAFT 建单和开始采购的服务端授权事务，但不能编写
|
||
依赖未取证页面字段的生产执行逻辑。提速来自两端并行、窄任务和主审复用门禁，不来自删除安全闸门。
|
||
|
||
## 待办池
|
||
|
||
- V2：T-501～T-508；多设备、完整 RBAC、多平台。
|
||
- 证据保留期和自动清理策略。
|
||
- SQLite → Postgres 迁移评估。
|
||
- 设备凭据轮换。
|
||
- 风控友好的轮询与动作间隔（需真机观察）。
|