docs(erp): define freight ingestion tasks

This commit is contained in:
QiuSW
2026-07-28 22:39:18 +08:00
parent 78dc595815
commit cc847c9aed
15 changed files with 547 additions and 6 deletions
+17 -1
View File
@@ -6,7 +6,7 @@
| 项 | 当前事实 |
| --- | --- |
| 任务来源 | 其他管理后台或本项目管理 Web 采集商品标题、SKU、描述、图片、数量和预算。 |
| 任务来源 | 顺运宝 ERP 货运单/商品明细是主要来源;本项目 Admin 先保存并复核货运信息,再生成不可变采购任务。管理 Web 手工创建继续作为补充入口。 |
| 第一层样本来源 | 本机目录中的蝦皮订单文本和参考图;二者以蝦皮订单号作为同名文件名。 |
| 执行方式 | 采购人员使用 Android App 操作拼多多;需求提取、动态词搜索、最多 5 个候选证据采集、匹配建议和人工确认停止点已可运行。 |
| 核心痛点 | 人工把图片和描述转成搜索词、逐条比较商品并记录结果,耗时且不一致。 |
@@ -18,6 +18,8 @@
- **采购管理员**:创建、查看、取消未执行任务,或请求执行中任务安全停止,并查看结果。
- **采购执行员**:在 App 上检查设备状态、手动领取、执行和人工确认任务。
- **设备身份**:代表一台获得授权的 Android 设备领取任务和上报状态。
- **ERP Connector 身份**:只读查询顺运宝并向后端提交最小化货运数据,不能领取任务、
创建下单授权或访问拼多多结果。
- **系统管理员/审核员**:目标架构角色,MVP 不提供完整管理界面。
- **未登录用户**:不能访问任务、图片、执行证据或设备接口。
@@ -34,6 +36,8 @@
| F-007 | 结果与异常回传 | 管理员和采购员看到成功、失败、取消及可恢复建议。 | P0 | US-002、US-006 |
| F-009 | 手机独立执行与 VLM | App 本地完成模型判断和自动化,后端只控制任务并接收结果。 | P0 | US-009 |
| F-010 | 授权创建待付款订单 | Admin 选品后签发一次性授权,Roubao 选择已确认 SKU/数量并创建待付款订单;付款始终人工完成。 | P0 | US-010 |
| F-011 | 导入 ERP 货运信息 | 管理员按完整单号或日期区间同步顺运宝货运头和全部商品明细,重复同步不重复。 | P0 | US-011 |
| F-012 | 从货运明细生成采购任务 | 管理员复核商品标题、SKU、数量和参考图后,从一条商品明细生成一条不可变采购任务。 | P0 | US-012 |
### F-009 手机独立执行与 VLM
@@ -136,6 +140,18 @@ T-206/T-207 已跑通领取、执行、候选/证据和最小结果回传;T-20
唯一且文本精确为“提交订单”。出现添加地址、立即支付、免密支付、先用后付或其他
自动扣款语义时必须停止。围栏创建后即使 App 在实际点击前退出,也只能查订单或
转人工,不能重新提交。
24. 顺运宝查询使用 `stock.id` 作为货运单外部身份,`detail.details[].id` 作为商品
明细外部身份;用户输入单号只是查询条件,不作为数据库主键。
25. ERP 同步先保存货运头和全部商品明细,再提取待采购需求;禁止 ERP 响应直接创建
或修改采购任务。
26. 一条商品明细最多对应一条同 revision 的采购任务;多商品货运单拆成多条采购需求,
不合并 SKU 或使用货运头总数量代替商品数量。
27. 采购任务生成前必须存在明确标题、原始 SKU/规格、正整数数量和已验证参考图。
`productThumb` 等未确认 ERP 引用不能当成可下载图片 URL。
28. ERP 来源更新不得覆盖已生成采购任务。系统保存新 revision/hash 并提示人工处理;
是否取消旧任务和生成新任务由管理员明确决定。
29. 收件人、电话、详细地址、ERP 账号、Cookie、JWT、验证码和完整响应不得进入采购
任务、Roubao、VLM、普通日志或 Git;货运模块也只保存采购所需最小字段。
## 六、第一层本地样本约定