docs(#119-#122): finalize SYB inner-code contract mirrors
This commit is contained in:
QiuSW
@@ -2,8 +2,8 @@
|
||||
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||||
wiki_page: Product-Requirements-Overview
|
||||
wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Product-Requirements-Overview.-
|
||||
wiki_revision: 51afc26df773d7b6a2d48588d69f215676463627
|
||||
synchronized_at: 2026-08-28T02:23:10Z
|
||||
wiki_revision: 0d9924b4566e567edf167ba678fedde28a41cfd3
|
||||
synchronized_at: 2026-08-28T02:27:12Z
|
||||
<!-- gitea-wiki-mirror:end -->
|
||||
|
||||
# 产品需求总览与当前 MVP
|
||||
@@ -31,9 +31,9 @@ synchronized_at: 2026-08-28T02:23:10Z
|
||||
| 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 目标提交见项目档案 |
|
||||
|
||||
| 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) |
|
||||
|
||||
原型状态只有“草稿、已确认、已废弃”。#31 原型已确认（2026-08-17），#32 原型已确认（2026-08-18），均可作为实现依据；#40 原型 2026-08-19 按 #46 修订后重新确认，#41 原型 2026-08-19 首次确认，两者均可作为实现依据，Stage B 代码尚未开始。
|
||||
|
||||
|
||||
@@ -2,8 +2,8 @@
|
||||
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||||
wiki_page: SYB-ERP-Interface-Contract
|
||||
wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/SYB-ERP-Interface-Contract.-
|
||||
wiki_revision: 7a3513c2d59a4c0557b90fabc4aa46313e377fe5
|
||||
synchronized_at: 2026-08-24T09:28:34Z
|
||||
wiki_revision: f596931468caf524cbd9d90b3c299b32a8cf8228
|
||||
synchronized_at: 2026-08-28T02:29:07Z
|
||||
<!-- gitea-wiki-mirror:end -->
|
||||
|
||||
# 12 顺云宝（SYB）ERP 接口契约
|
||||
@@ -430,11 +430,10 @@ Go 侧不用跟着调。
|
||||
|
||||
### 7.1 档口入库码逐件写入（上游工单 #234、#250、#278）
|
||||
|
||||
> **本节在 GoAuto 尚未实现**，与 [#37 T35 服务端物流调度与货运宝自动回填](https://git.ilapage.cn/OPC/goauto/issues/37) 对应。
|
||||
> 这里原样保留上游的接口结论和门禁约束，供 #37 实施时参考；#48 只做读取，不实现任何写接口。
|
||||
> 本节已由 GoAuto #119～#122 实现。匹配阶段保持纯只读；只有采购员在 Admin 回写确认弹窗二次确认后，后台回写执行器才可调用写接口。#37 的采购物流回填仍是独立范围。
|
||||
|
||||
档口入库码最终写入货运明细的 `innerExpCode`（页面名称“快递单号”）。接口来自
|
||||
上游的 Python 流程和 HAR 响应样本：
|
||||
已验证的上游流程和 HAR 响应样本：
|
||||
|
||||
```text
|
||||
GET /am/stock/detail/deleteInnerCode?detailId={detailID}
|
||||
@@ -459,11 +458,11 @@ POST /am/stock/detail/updateDetailCode?t=0&id={stockID}&detailId={detailID}&code
|
||||
- 规划时的旧值为空时不调用删除；旧值非空且仍与规划快照一致时，只有删除明确成功才继续。
|
||||
- 删除和写入请求都只允许发送一次，不使用自动重试。超时、5xx、响应读取失败或成功响应
|
||||
无法解析时，结果可能已经在远端生效，必须标为“需核对”。
|
||||
- 每件动作前后把检查点写入 `remote_items_json`；每个单件码写入后重新读取整张货运单，
|
||||
- 每件动作前后把检查点写入本地 `syb_inner_code_checkpoint`；匹配快照保存在 `syb_inner_code_plan.remote_items_json`。每个单件码写入后重新读取整张货运单，
|
||||
只有它唯一出现在预期明细中才继续。全部目标码确认后才标为已回写。
|
||||
- “重新核对”只调用 `listByStock`，绝不能再次调用上述两个写接口。
|
||||
- 页面提交数量不限制为 20 条。所选记录先在 MySQL 同一业务表中进入 `queued`，HTTP 请求
|
||||
随即返回；后台每次最多读取 20 条，再逐条执行上述远端门禁。Admin 重启不会自动继续
|
||||
- 页面提交数量不限制为 20 条。所选记录先在 MySQL 事务中进入 `queued`，HTTP 请求
|
||||
随即返回；后台取得数据库全局租约后逐条执行上述远端门禁。Admin 重启不会自动继续
|
||||
未开始的真实远端写入：`queued` 恢复为可回写，`applying` 转为需核对。
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user