任务路线图（Roadmap）
本文是只读路线图：维护阶段划分、里程碑、待办池和建议拆分清单。
真实任务以「一任务一文件」存放在 tasks/（docs/tasks/T-<编号>.md），
状态权威在任务文件 frontmatter。本文不跟踪单任务状态。
使用规则
- 开工先落文件：从下方清单把下一个任务落成
docs/tasks/T-<编号>.md（沿用建议编号），
把验收要点展开成可执行、可观察的步骤，再开始实现。
- 每个 agent 一次只做一个任务：领取、状态流转、执行记录、完成定义遵循
tasks/README.md 和编码规则。
- 不跳步：依赖未完成的任务不能开工。Phase 0 可先做使用假数据的低保真交互原型；
Phase 1 的真机结论出来之前不写 Phase 2 的生产页面，T-103 若改变可读字段则先修订原型与 IX。
- 本文只在规划变化时修改：单个任务开工或完成不修改本文。
- 动手前先读
00-ai-start-here.md、05-coding-rules.md 和 current-state.md。
建议拆分清单
Phase 0 · 地基
| ID |
任务 |
依赖 |
验收要点 |
| T-001 |
初始化 web 端 Go 骨架 |
- |
go test ./...、go vet ./... 可运行；健康检查端点可访问；用真实命令替换 03-tech-stack.md、00-ai-start-here.md、current-state.md 中的占位命令 |
| T-002 |
初始化 desk 端 Python 骨架 |
- |
虚拟环境、requirements.txt、unittest 可运行；python -m compileall 通过；日志与产物目录策略明确且不记录敏感信息 |
| T-003 |
建立 init.ps1 统一入口 |
T-001, T-002 |
一条命令完成两端安装与基础验证并打印启动命令；未配置时主动失败而不是静默跳过 |
| T-004 |
建立核心数据模型与状态机 |
T-001 |
tasks、order_authorizations、order_submissions 表与 04-architecture.md 一致；状态流转有单元测试；金额用十进制字符串 |
| T-005 |
网页端 MVP 交互原型 |
- |
“采购服务”的 docs/design/web-*.html 单文件假数据原型覆盖登录、表格工作台、创建弹窗、批量开始试选、路由化详情抽屉与完整详情；键盘、窄屏、空态 / 错误 / 加载、围栏后调和状态可演示；经人工确认前保持 DOING |
| T-006 |
桌面端 MVP 交互原型 |
- |
docs/design/desk-*.html 单文件假数据原型覆盖“采购工具”的采购执行 / 配置固定页签、顶部轮询控制、当前任务图片、滚动日志、时间倒序执行记录，以及左侧当前任务 / 记录详情双视图；明确 dry-run / 真实下单、App 版本失配、围栏后不可重试；经人工确认前保持 DOING |
Phase 1 · 真机取证（最高风险，必须先做）
本阶段每个任务都需要真机，只能由人完成验收。结论写入任务文件并同步
04-architecture.md；每条页面判据必须记录拼多多 App 版本。
| ID |
任务 |
依赖 |
验收要点 |
| T-101 |
验证 ADB 与 uiautomator2 连接（USB + WiFi） |
T-002 |
两种连接都能列设备、截图、dump_hierarchy(compressed=False)；同一手机双通道在线时报明确错误；超时参数可配置 |
| T-102 |
验证按链接打开商品详情页 |
T-101 |
输入 goods_id 链接后真机进入对应详情页；打不开时有可区分的失败原因；保存截图与页面 XML |
| T-103 |
验证规格面板打开、按维度精确选择、读取 SKU 单价 |
T-102 |
能打开规格面板；按 颜色分类=X、尺码=Y 精确选中并读回确认；防前缀碰撞；找不到精确值时停止且不点相近项；取证单价在哪个节点、是否带券后前缀——闸门一依赖此结论 |
| T-104 |
验证试选后安全退出并释放手机 |
T-103 |
读完价截完图后退出商品页；全程不点击「现在买」或任何下单入口，有测试证明；退出后可立即开始下一条任务 |
| T-105 |
验证数量设置与复核 |
T-103 |
设置后读回精确等于要求值；不等时停止，不进入购买入口 |
| T-106 |
dry-run：验证进入订单确认页并读「实付款」 |
T-105 |
进入确认页读出规格、数量、实付金额；验证提交控件唯一但绝不点击；不提取地址原文与手机号；保存截图与 XML 证据到任务产物 |
| T-107 |
固化提交控件判据与 dry-run 安全边界 |
T-106 |
只把本项目真机证据转成可测试判据；第一趟和 dry-run 路径不可达 submit_order；App 版本不匹配时 fail closed；不创建真实订单 |
T-106 与 T-107 只做只读演练，不得点击提交订单。 本路线图中首次允许创建真实订单
的任务是 T-401；执行前必须取得明确授权，并在任务文件记录订单是否产生、如何处置。
Phase 2 · web 端核心
| ID |
任务 |
依赖 |
验收要点 |
| T-201 |
管理员登录与会话 |
T-004, T-005 |
登录建立会话；CSRF 生效；未登录跳转并只接受站内返回路径 |
| T-202 |
手工建单（F-001） |
T-201 |
列表内创建弹窗与 /tasks/new 复用表单；任务名称、链接、颜色分类、尺码、数量、价格上限校验；成功创建 DRAFT 并倒序显示第一行 |
| T-203 |
任务表格、查询与批量开始试选（F-004、F-018） |
T-202 |
传统表格无操作列；标题关键词筛选；只选 DRAFT；批量 DRAFT → PENDING 全有或全无；空状态可清除筛选 |
| T-204 |
路由化任务详情（F-011） |
T-203 |
从列表进入显示保留现场的右侧抽屉，直达显示完整页；按状态呈现唯一主区块与主动作；执行证据可查看 |
| T-205 |
试选结果接收与确认页（F-007） |
T-204, T-103 |
接收 spec_trials 与规格面板截图；确认页展示需求 vs 所选、单价、合计、截图；轻量版，非对照台 |
| T-206 |
人工确认与授权签发（F-008） |
T-205 |
确认即签发一次性授权并锁定试选单价；expected_task_version 冲突返回 409；金额上限服务端校验；支持「退回，不买」 |
| T-207 |
授权超时与围栏前放弃（F-010） |
T-206 |
围栏前超时 / 放弃后任务转 PENDING_RETRIAL，必须重新试选；围栏后禁止超时释放或放弃，改走人工核查；每个状态都有安全下一步 |
| T-208 |
提交围栏与结果调和 API（F-017） |
T-207, T-107 |
dry-run start / ready、submission start / reconcile / manual-review 幂等；围栏事务原子消费执行权；响应不明不允许点击；不确定结果保留额度且不可重试 |
Phase 3 · 双端打通（第一趟）
| ID |
任务 |
依赖 |
验收要点 |
| T-301 |
设备凭据与身份隔离（F-013） |
T-201 |
设备 Bearer 不能建单或授权；管理会话不能调设备接口；凭据可撤销 |
| T-302 |
原子领取与租约（F-005） |
T-301, T-004 |
并发领取只有一个成功；重复领取重放同一结果；同时支持领取待试选与已授权两类；claim_token 与 claim_generation 校验生效 |
| T-303 |
desk 端 HttpTaskSource / HttpResultSink |
T-302, T-002 |
执行器只依赖抽象；测试假数据与断连 JSONL 暂存不扩大 Excel MVP 范围；补传使用幂等键 |
| T-304 |
定时轮询与会话边界 |
T-303, T-006 |
只在执行员启动的会话内轮询，关窗口即停；连续失败达阈值自动停止并提示原因；间隔可配置 |
| T-306 |
证据上传与分层 |
T-304, T-103 |
规格面板截图与订单截图上传服务端并脱敏；节点树与失败现场留本地；上传前校验不含地址与手机号 |
| T-305 |
第一趟试选端到端 |
T-306, T-104 |
从领取跑到试选回传：开商品、勾选规格、读单价、截图、退出释放手机；任务转「等你确认」；全程有事件与证据 |
Phase 4 · 第二趟与收尾
| ID |
任务 |
依赖 |
验收要点 |
| T-401 |
第二趟下单端到端 |
T-305, T-208, T-306 |
拿到授权后重新开商品、重新选同一规格、过三道闸门、原子建立提交围栏后提交一次；不确定结果进入调和且不可重试；明确创建才转「待付款」 |
| T-402 |
待付款收口与手工完成 |
T-401 |
详情页展示订单截图与授权信息供核对；人付款后手工标记完成；待付款不等于成功 |
| T-403 |
失败分类与证据归档（F-011） |
T-401 |
覆盖需求列出的全部失败原因；终态一次原子回写，不落中间态 |
| T-404 |
完整验收 MVP |
T-402, T-403 |
02-requirements.md 的 P0 验收全部通过；真机记录写入任务文件与 current-state.md |
| T-405 |
desk 端打包与运行文档 |
T-404 |
运营电脑可按文档运行；记录产物 SHA-256 |
V2 及以后（不在 MVP，编号预留）
| ID |
任务 |
说明 |
| T-501 |
图片搜索产出 goods_id（F-014） |
推图到相册、搜图、从结果页取 goods_id；不读价格；最多 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：网页端与桌面端 P0 原型经人工确认，流程、状态与主动作可枚举。（T-005、T-006）
- M1：两端骨架可运行，数据模型与状态机落地。（Phase 0）
- M2：真机能按链接打开商品、精确勾选颜色分类和尺码、读到该 SKU 单价。（T-103）
- M3：真机能设对数量、以 dry-run 进入订单确认页读到「实付款」并验证唯一提交控件，
但不点击。（T-107）
- M4：管理员能建单、看到试选结果、确认并签发授权。（Phase 2）
- M5：第一趟试选端到端跑通，任务能停在「等你确认」。（T-305）
- M6：MVP 闭环——第二趟下单成功，任务停在「待付款」。（T-401）
M2 是本项目的生死线。 前序项目正是卡在选规格和读价；M2 不通过之前不要写 Phase 2
的生产页面。Phase 0 原型只用于确认信息架构，T-103 若改变可读字段必须先回修原型与 IX。
待办池（Backlog）
- V2 全部条目见上方「V2 及以后」表（T-501 ~ T-508）
- 多设备并行（F-104）
- 完整 RBAC（F-105）
- 多平台比价（F-106）
- 证据保留期与自动清理策略
- web 端从 SQLite 迁移到 Postgres 的评估
- 设备凭据轮换机制
- 定时轮询间隔的风控友好节奏（需真机观察后确定）
