From 2f5415553efb1b2e22fa8badc7b029e142ca7b79 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Fri, 28 Aug 2026 10:30:25 +0800 Subject: [PATCH] docs(#119-#122): finalize SYB inner-code contract mirrors --- docs/07-mvp-requirements.md | 6 +++--- docs/12-syb-erp-interface.md | 15 +++++++-------- 2 files changed, 10 insertions(+), 11 deletions(-) diff --git a/docs/07-mvp-requirements.md b/docs/07-mvp-requirements.md index cfd7d4a..971007f 100644 --- a/docs/07-mvp-requirements.md +++ b/docs/07-mvp-requirements.md @@ -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 # 产品需求总览与当前 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 代码尚未开始。 diff --git a/docs/12-syb-erp-interface.md b/docs/12-syb-erp-interface.md index 992f20a..3d5e117 100644 --- a/docs/12-syb-erp-interface.md +++ b/docs/12-syb-erp-interface.md @@ -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 # 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` 转为需核对。 ---