goauto/docs/07-mvp-requirements.md

第一阶段最小采集闭环

用户闭环

1. 管理员添加一个 PDD URL。
2. 服务端提取 goods_id；重复时提示商品已存在。
3. 管理员创建一条采集规则，创建成功后立即可用。
4. 管理员从 PDD 商品创建采集任务，选择规则，默认指定设备，也可不指定。
5. 指定设备领取自己的任务；空闲设备可原子领取未指定任务。
6. Android 使用任务内的 URL 和规则快照进入 PDD 并采集结构化数据。
7. Android 把完整、部分或失败结果写回该任务。
8. 管理员在任务详情查看结果，必要时重置终态任务重新采集。

MVP 包含

• PDD 商品新增、列表和 URL 编辑。
• URL 规范化、goods_id 提取和唯一性校验。
• 规则新增、编辑、列表和软删除；创建即生效。
• 单商品创建任务，可指定设备或留空。
• 设备注册、令牌、心跳、在线状态与单设备串行。
• 指定任务领取与未指定任务的空闲设备原子领取。
• 任务内 URL、goods_id 和规则快照。
• pending、running、completed、completed_partial、failed 状态。
• 标题、店铺、销量、评价、规格维度、规格值和 SKU 结果。
• 终态任务重置、失败任务删除和任务详情。
• 登录失效、验证码、风控、人机验证、控件缺失和离线错误。

MVP 不包含

• 顺云宝、货运单和 Shopee 商品。
• 采购、下单和支付。
• PDD 与其他平台商品关联。
• 批量创建任务。
• 规则草稿、发布、版本历史和全局停机。
• 独立采集结果主表或独立结果页面。
• 自动重试、自动换机和离线续跑。
• 实时屏幕和管理端远程控制。
• OCR/VLM、原始控件树、截图和价格历史。

数据约束

• pdd_product.goods_id 唯一。
• 同一 pdd_product_id 最多一个 pending 或 running 任务。
• 一台设备最多一个 running 任务。
• 规则软删除后不能创建新任务，但已有任务不受影响。
• 终态任务提交后结果冻结，除非管理员执行重置。
• 重置事务保留所有输入快照，删除全部旧结果子记录并清空结果字段。

验收

• 一加/ColorOS 完成真实商品闭环；当前 MVP 不包含华为兼容。
• 重复 goods_id 显示明确冲突，不产生第二条商品。
• 规则创建后可以直接选用；删除后不能创建新任务，旧任务仍可执行。
• 指定设备和未指定设备两种领取方式均正确且没有双领。
• 同一商品不能创建第二个未完成任务。
• 每个颜色价格正确展开到该颜色的尺码 SKU；部分结果正常展示。
• 重置后原结果彻底清除，快照保持不变，并可重新采集。
• 离线和各类安全页面返回明确错误且不自动重试。