docs(erp): define freight ingestion tasks

2026-07-28 22:39:18 +08:00
parent 78dc595815
commit cc847c9aed
15 changed files with 547 additions and 6 deletions
@@ -17,6 +17,38 @@
 | US-008 | 积累可信的候选决策样本 | P1 | 采购执行员、优化人员 | 用真实曝光和人工理由评估并改进模型 | F-008 | IX-009 | 已定，T-208 后置 |
 | US-009 | 手机独立完成采购任务 | P0 | 采购执行员 | 后端短时不可用时仍在有限授权内安全执行 | F-009 | IX-010 | 已定，T-206/T-207 |
 | US-010 | 审批并创建待付款订单 | P0 | 采购管理员、采购执行员 | Admin 选定候选后只创建一笔可核对的待付款订单 | F-006、F-010 | IX-011 | 已定，T-215 至 T-219 |
+| US-011 | 导入并查看 ERP 货运单 | P0 | 采购管理员 | 按单号或时间同步货运单及全部商品明细，知道同步是否完整 | F-011 | IX-012 | 已定，T-220 至 T-224 |
+| US-012 | 从货运明细生成采购任务 | P0 | 采购管理员 | 复核来源商品并幂等生成一条可执行采购任务 | F-012 | IX-013 | 已定，T-223 |
+
+## US-011 导入并查看 ERP 货运单
+
+- 关联页面：管理 Web `/freight`、`/freight/import`、`/freight/{id}`
+- 前置条件：ERP Connector 已建立受控登录会话。
+
+作为采购管理员，我想按完整单号或时间范围同步顺运宝货运信息，并查看每张货运单的
+全部商品明细，从而不再手工抄写采购资料。
+
+**验收场景**
+
+1. 同一单号重复同步不会增加重复货运单或商品明细。
+2. 一张货运单有多个商品时，Admin 展示全部明细而不是只保留最后一条。
+3. Connector 未登录、ERP 超时、查询过宽或响应缺字段时显示可重试失败，不写半批数据。
+4. 页面和日志不显示收件电话、详细地址、ERP Cookie/JWT 或完整原始响应。
+
+## US-012 从货运明细生成采购任务
+
+- 关联页面：管理 Web `/freight/{id}`
+- 前置条件：商品明细已导入，标题、SKU、数量和参考图可核对。
+
+作为采购管理员，我想从一条 ERP 商品明细生成一条采购任务，从而让 Roubao 使用
+经过核对的不可变来源快照执行采购。
+
+**验收场景**
+
+1. 每条商品明细独立显示标题、规格/SKU、数量、图片和来源 revision。
+2. 缺图、数量非法、SKU 含糊或来源状态不允许时禁止生成并指出原因。
+3. 重复点击或网络重试返回同一采购任务。
+4. ERP 来源变化不修改已领取或执行中的采购任务，而是提示来源已更新。

 ## US-001 创建清晰的采购任务