98 lines
7.3 KiB
Markdown
98 lines
7.3 KiB
Markdown
<!-- gitea-wiki-mirror:start -->
|
||
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||
wiki_page: Product-Requirements-Overview
|
||
wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Product-Requirements-Overview.-
|
||
wiki_revision: b1b1b343917e66288f4282bc6b3b90ea4ff3cca0
|
||
synchronized_at: 2026-09-04T11:30:20Z
|
||
<!-- gitea-wiki-mirror:end -->
|
||
|
||
# 产品需求总览与当前 MVP
|
||
|
||
## 本页用途
|
||
|
||
本页统一导航 GoAuto 的长期需求、状态、工单、原型和验收入口，同时保留当前采集 MVP 的稳定范围。它不复制完整工单、原型内容或聊天记录。
|
||
|
||
## 事实来源边界
|
||
|
||
| 信息 | 唯一事实来源 |
|
||
|---|---|
|
||
| 项目目标、用户、规模和建设基线 | [项目档案](https://git.ilapage.cn/OPC/goauto/wiki/Project-Profile) |
|
||
| 长期业务规则和安全边界 | [业务规则与术语](https://git.ilapage.cn/OPC/goauto/wiki/Business-Rules-and-Glossary) |
|
||
| 单次实现范围、变化和验收 | Gitea 单元工单 |
|
||
| Android 与服务端共享接口 | [Agent API 契约](https://git.ilapage.cn/OPC/goauto/wiki/Android-Agent-API-Contract) |
|
||
| 外部原型 | QuantUX 应用和对应工单评论 |
|
||
| 真机验证结果 | [一加真机验收](https://git.ilapage.cn/OPC/goauto/wiki/OnePlus-Real-Device-Acceptance)和对应工单 |
|
||
|
||
## 长期需求索引
|
||
|
||
| 需求领域 | 用户与场景 | 状态 | 工单 | 原型 / 验收入口 |
|
||
|---|---|---|---|---|
|
||
| PDD 商品采集闭环 | 管理员维护商品、规则和设备，由 Android 采集结构化结果 | 已交付；T23～T28 增强项部分待验收 | [Epic #1](https://git.ilapage.cn/OPC/goauto/issues/1)、[MVP #2](https://git.ilapage.cn/OPC/goauto/issues/2)、[#3～#30 索引](https://git.ilapage.cn/OPC/goauto/wiki/Delivery-Issues) | [真机验收](https://git.ilapage.cn/OPC/goauto/wiki/OnePlus-Real-Device-Acceptance) |
|
||
| PDD 正式商品档案 | 采购人员长期复用商品资料，可由采集或人工覆盖维护 | 原型草稿，待用户确认 | [#31](https://git.ilapage.cn/OPC/goauto/issues/31) | [QuantUX App `6a81db5d191a826306a7edd6`](http://124.222.27.183:8082/#/apps/6a81db5d191a826306a7edd6.html) |
|
||
| Shopee、SYB 与 PDD 商品关系 | 从 SYB 明细提取 Shopee 商品，人工关联 PDD 商品和规格 | #40、#41 Stage B 服务端与 Admin 页面均已完成；#41 尚缺 SYB 接口拉取客户端（无凭据，明确记录待补） | [#40](https://git.ilapage.cn/OPC/goauto/issues/40)、[#41](https://git.ilapage.cn/OPC/goauto/issues/41) | [#40 QuantUX App `6a83b708191a826306a7eeb1`](http://124.222.27.183:8082/#/apps/6a83b708191a826306a7eeb1.html)；[#41 QuantUX App `6a83d7b4191a826306a7eebd`](http://124.222.27.183:8082/#/apps/6a83d7b4191a826306a7eebd.html) |
|
||
| PDD 采购闭环 | 采购人员派发任务，Agent 选规格、改地址并创建待付款订单，人工支付后回填物流 | #33、#34 数据契约与服务端状态机已验收；下一步 #42 Android 无副作用采购演练 | [#32](https://git.ilapage.cn/OPC/goauto/issues/32)、[#33～#39](https://git.ilapage.cn/OPC/goauto/wiki/Delivery-Issues)、[#42](https://git.ilapage.cn/OPC/goauto/issues/42) | [QuantUX App `6a827440191a826306a7eddd`](http://124.222.27.183:8082/#/apps/6a827440191a826306a7eddd.html) |
|
||
| SYB 档口入库码 | 采购员导入标签入库码 Excel，系统自动匹配 SYB 商品，人工确认后逐件回写 | #119～#122 已实现，待用户验收；不包含可选 #123 | [Epic #117](https://git.ilapage.cn/OPC/goauto/issues/117)、[#119](https://git.ilapage.cn/OPC/goauto/issues/119)～[#122](https://git.ilapage.cn/OPC/goauto/issues/122) | [已确认原型快照](https://git.ilapage.cn/OPC/goauto/src/branch/main/prototypes/118/v1/index.html) |
|
||
| 开发治理与需求追溯 | 负责人和 Agent 需要可复现模板基线、双门禁和需求索引 | 本次文档升级待验收 | [#43](https://git.ilapage.cn/OPC/goauto/issues/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；部分结果正常展示。
|
||
- 重置后原结果彻底清除，快照保持不变，并可重新采集。
|
||
- 离线和各类安全页面返回明确错误且不自动重试。
|
||
|
||
## 更新时机
|
||
|
||
新的长期需求、状态变化、主要工单、原型或验收入口变化时更新本页。普通内部重构、小缺陷和不改变长期能力的任务只保留在工单。
|