goauto/docs/07-mvp-requirements.md

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Product-Requirements-Overview wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Product-Requirements-Overview.- wiki_revision: 03ea269058b50fea2be7842b9c284018987c82d9 synchronized_at: 2026-09-21T08:15:00Z

产品需求总览与当前 MVP

本页用途

本页统一导航 GoAuto 的长期需求、状态、工单、原型和验收入口，同时保留当前采集 MVP 的稳定范围。它不复制完整工单、原型内容或聊天记录。

事实来源边界

信息	唯一事实来源
项目目标、用户、规模和建设基线	项目档案
长期业务规则和安全边界	业务规则与术语
单次实现范围、变化和验收	Gitea 单元工单
Android 与服务端共享接口	Agent API 契约
外部原型	QuantUX 应用和对应工单评论
真机验证结果	一加真机验收和对应工单

长期需求索引

需求领域	用户与场景	状态	工单	原型 / 验收入口
PDD 商品采集闭环	管理员维护商品、规则和设备，由 Android 采集结构化结果	已交付；T23～T28 增强项部分待验收	Epic #1、MVP #2、#3～#30 索引	真机验收
PDD 正式商品档案	采购人员长期复用商品资料，可由采集或人工覆盖维护	原型草稿，待用户确认	#31	QuantUX App 6a81db5d191a826306a7edd6
Shopee、SYB 与 PDD 商品关系	从 SYB 明细提取 Shopee 商品，人工关联 PDD 商品和规格	#40、#41 Stage B 服务端与 Admin 页面均已完成；#41 尚缺 SYB 接口拉取客户端（无凭据，明确记录待补）	#40、#41	#40 QuantUX App 6a83b708191a826306a7eeb1；#41 QuantUX App 6a83d7b4191a826306a7eebd
PDD 采购闭环	采购人员派发任务，Agent 选规格、改地址并创建待付款订单，人工支付后回填物流	#33、#34 数据契约与服务端状态机已验收；下一步 #42 Android 无副作用采购演练	#32、#33～#39、#42	QuantUX App 6a827440191a826306a7eddd
SYB 档口入库码	采购员导入标签入库码 Excel，系统自动匹配 SYB 商品，人工确认后逐件回写	#119～#122 已实现，待用户验收；不包含可选 #123	Epic #117、#119～#122	已确认原型快照
开发治理与需求追溯	负责人和 Agent 需要可复现模板基线、双门禁和需求索引	本次文档升级待验收	#43	无 UI 原型；DevHarness 目标提交见项目档案

原型状态只有“草稿、已确认、已废弃”。#31 原型已确认（2026-08-17），#32 原型已确认（2026-08-18），均可作为实现依据；#40 原型 2026-08-19 按 #46 修订后重新确认，#41 原型 2026-08-19 首次确认，两者均可作为实现依据，Stage B 代码尚未开始。

当前采集 MVP 用户闭环

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 不包含

• SYB、货运单和 Shopee 商品。
• 采购、修改地址、创建订单和支付。
• PDD 与其他平台商品关联。
• 批量创建任务、规则草稿/发布/版本历史、全局停机和实时屏幕。
• 独立采集结果主表、自动重试、自动换机和离线续跑。
• OCR/VLM、原始控件树、截图和价格历史。

后续工单存在不代表以上能力已经进入当前采集 MVP。采购能力必须使用独立任务类型、规则权限和高风险门禁，任何阶段都不允许自动支付。

数据约束

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

当前 MVP 验收

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

更新时机

新的长期需求、状态变化、主要工单、原型或验收入口变化时更新本页。普通内部重构、小缺陷和不改变长期能力的任务只保留在工单。