cmroubao/docs/06-tasks.md

任务路线图

本文只维护阶段、里程碑和建议拆分。真实状态和执行证据在 tasks/T-<编号>.md。

使用规则

1. 从建议清单落成一任务一文件，沿用编号。
2. 每个 agent 同时只做一项依赖已完成的任务。
3. 高风险验证失败时先记录结论和 blocker，不继续堆后端功能。
4. DONE 必须绑定可复现命令、设备环境或截图等证据。
5. 本文只在路线图变化时修改，不因单任务状态变化而修改。

Phase 0：可运行基线

ID	任务	依赖	验收要点
T-001	初始化 Git 并接入 Roubao Android 基线	-	记录上游 URL/commit/许可证；Debug APK 构建通过；真实命令同步文档；不含密钥
T-002	建立测试设备基线和就绪检查	T-001	记录 Android/拼多多/App 版本；检测安装、无障碍、前台 App 和登录阻塞
T-003	建立 Android workflow 测试骨架	T-001	fake automation 下可测状态迁移、timeout、retry 和安全停止
T-004	导入本机蝦皮订单验证样本	T-001	同订单号文本/图片可靠配对并生成 ProbeTask；异常明确失败；私有数据不进 Git

Phase 1：最高风险技术探针

ID	任务	依赖	验收要点
T-101	固定任务跑通拼多多关键词搜索	T-002、T-003	用固定搜索词进入结果页；未知页、验证码和登录页安全停止
T-102	浏览并采集最多 5 个候选	T-101	可进入候选详情、返回并记录证据；无界滑动被禁止
T-103	接入 VLM 需求提取	T-101、T-004	蝦皮样本图片+文字输出符合 schema；SKU/数量保持原值；低置信度转人工
T-104	接入候选评估并停在人工确认点	T-102、T-103	给出匹配/缺失理由；不得提交订单或支付

Phase 2：最小后台闭环

ID	任务	依赖	验收要点
T-201	生成并收敛 Go-Gin、SQLite 和迁移骨架	T-104	固定 Go Blueprint v0.10.11 生成后改为 Go 1.23.0、Gin 1.11.0；移除演示逻辑和危险默认；GOTOOLCHAIN=local 下服务、健康检查、迁移和 go test ./... 通过；数据目录被忽略
T-202	生成并确认 P0 Web/App 低保真原型	T-104	覆盖 routes 中 P0 页面；人工确认控件集合；IX 与原型一致
T-203	实现任务创建 API 与管理 Web	T-201、T-202	合法任务进入 PENDING；校验、列表和详情状态可见
T-204	实现用户/设备最小鉴权	T-201、T-202	管理会话和设备令牌隔离；未授权访问被拒绝；无明文凭证
T-205	实现原子 claim、租约和状态机	T-203、T-204	并发领取不重复；非法迁移、过期租约和错误设备被拒绝
T-206	App 接入领取、有限离线执行和进度	T-202、T-205	用户点击后领取一条；默认 30 分钟离线授权；到期/取消安全停止；不重复执行
T-207	接入 App 本地 VLM、候选、事件和结果回传	T-206	保留独立模式；Key 加密；后端不代理模型；幂等补报且管理详情可审计
T-208	建立候选决策数据与人工理由闭环	T-207、T-213	观测/预测/推荐/人工标签分离；逐候选结构化理由；截图受控留存；不阻塞第一版流程
T-209	登录失败保留采购配置输入	T-206	登录失败可直接修正重试；敏感值不持久化或写日志
T-210	兼容拼多多 8.17 搜索结果页	T-101、T-206	新旧结果页均可靠识别；其他查询和安全边界不放宽
T-211	参考图召回与 SKU 硬匹配 Top 5	T-207、T-210	参考图进入拼多多图片搜索；颜色/尺码均匹配才回传 0..5 个候选
T-212	修复 Top 5 ordinal 与证据映射	T-211	重排、推荐、证据和人工接受引用同一原始候选
T-213	拼多多候选 SKU 组合与价格核验	T-212	受控选择唯一颜色/尺码并读取组合价；不确认购买，不进入订单或支付
T-214	建立候选商品持久身份与重新定位指纹	T-208、T-213	candidate key 绑定原 observation、卡片/详情/双证据指纹；不伪造平台链接
T-215	Admin 候选确认与一次性下单授权	T-214	非空候选进入等待确认；Admin 按 candidate key 提交逐项理由并生成不可变待投递授权
T-216	设备下单命令投递、确认与恢复	T-215	App 主动拉取；先加密落盘再 ACK；断网/重启重放同一授权且不执行拼多多动作
T-217	已授权商品重新定位与订单 dry-run	T-216	重新核对持久指纹并唯一选择 SKU/数量，停在最终提交前
T-218	单次订单提交与订单回读	T-217	一次性提交后从订单列表读取订单号/时间并对账，不支付
T-219	Admin 待付款提醒与端到端验收	T-218	三态展示可核对订单并提醒采购员去拼多多确认付款；不提供支付入口
T-220	顺运宝 ERP 字段契约与凭证安全基线	T-219	明文凭证和私有响应不进 Git/日志；冻结货运头、商品明细和采购字段映射
T-221	顺运宝精确单号 Connector	T-220	受控 Python 服务按完整单号读取货运头与全部商品明细；失败稳定且不泄露 PII
T-222	货运信息存储、API 与 Admin 页面	T-221	Go 后端幂等保存同步记录、货运单和明细；Admin 可按单号导入、列表和查看
T-223	待采购需求提取与任务生成	T-222	一条有效商品明细形成一条可复核采购需求；参考图齐备后幂等生成采购任务
T-224	ERP 日期增量同步	T-223	按 ERP 创建日期区间分页同步，重叠窗口去重；失败不推进成功水位
T-225	冻结 Go 直连 ERP 协议与安全边界	T-224	以脱敏 fixture 固定验证码、登录、查询和归一化契约；不访问线上 ERP
T-226	Go ERP 会话管理与 Admin 验证码登录	T-225	后端内存维护受控会话；Admin 人工输入验证码，不暴露账号密码或 Cookie
T-227	Go 直连顺运宝查询接入货运同步	T-226	FreightSource 直接查询 ERP，保留单号/日期异步同步、幂等和错误边界
T-228	移除 Python ERP Connector 并完成切换	T-227	删除 Connector、端口和共享 API Key；单 Go 后端完成离线回归与真实登录 smoke

Phase 3：端到端验证

ID	任务	依赖	验收要点
T-301	完成 P0 UI 实现和交互验收	T-203、T-206	Web 和 App 的 IX 默认/加载/错误/中断状态均有验证证据
T-302	建立脱敏、清理和审计策略	T-207	日志/截图不泄密；文件保留和清理可配置；事件可追溯
T-303	运行 20 条真实采购任务试验	T-301、T-302、T-208	指标按人工标签统计；曝光候选和理由完整；失败分类完整；订单提交严格受围栏控制且无自动付款
T-304	可行性评审和 V2 决策	T-303	对照 80%/70% 门槛给出继续、修正或停止结论

Phase 4：交付验证版

ID	任务	依赖	验收要点
T-401	打包 Android 验证 APK	T-304	干净环境可构建安装；版本和配置说明完整
T-402	部署单机后台和备份说明	T-304	新环境可启动；数据库/文件备份恢复完成一次演练
T-403	完整 P0 回归与交付记录	T-401、T-402	所有 P0 验收有证据；已知限制和 blocker 明确

里程碑

• M1：Android 与测试设备基线可复现。
• M2：固定任务 + VLM 在拼多多到达人工确认点。
• M3：管理 Web、手动领取和结果回传闭环完成。
• M4：20 条真实任务达到或未达到门槛，结论可审计。
• M5：验证版 APK 和单机后台可交付。

Backlog

• 完整 RBAC 和人员管理。
• 多设备调度、通知和租约回收运营页面。
• 经单独安全评审后的订单提交审批。
• PostgreSQL、对象存储和正式部署。
• 原生以图搜图。
• 淘宝、1688、京东并行比价。