From 68395cabf3a557b77af88ceeb1e4e50b49ca74d0 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Fri, 28 Aug 2026 10:25:00 +0800 Subject: [PATCH] docs(#119-#122): sync SYB inner-code rules and requirements --- docs/03-business-rules-and-glossary.md | 14 ++++++++++++-- docs/07-mvp-requirements.md | 6 ++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/docs/03-business-rules-and-glossary.md b/docs/03-business-rules-and-glossary.md index 32e8d10..9e8a54d 100644 --- a/docs/03-business-rules-and-glossary.md +++ b/docs/03-business-rules-and-glossary.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Business-Rules-and-Glossary wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Business-Rules-and-Glossary.- -wiki_revision: b208729957c26801012279a8e89fc18b350f3a87 -synchronized_at: 2026-08-27T10:14:02Z +wiki_revision: 4236dd1d219cc6235537adfd8d0411308c449971 +synchronized_at: 2026-08-28T02:22:48Z # 业务规则与术语 @@ -287,3 +287,13 @@ synchronized_at: 2026-08-27T10:14:02Z - 当前页面任务不能使用“重新采集”重置；失败后重新打开目标商品并新建任务。成功提交完成、部分完成或失败结果后，继续进入设备的采集任务执行间隔。 - 分享入口、复制链接、剪贴板、链接、页面或身份不唯一时明确失败并释放任务槽；不使用 OCR/VLM，不猜测商品身份。 - 该能力只采集商品资料；不创建采购任务、不选择采购规格、不修改地址、不创建订单，也不执行支付动作。 + + +## SYB 档口入库码导入、匹配与回写 + +- 只接受不超过 10 MB、最多 5000 条非空数据行且包含“标签入库码映射”工作表的 Excel。一次文件只能包含一个营业日期；同日单件入库码必须唯一，同一业务键按营业日期、订单号、档口和规范化规格合并并保留 Excel 顺序。 +- 导入事务提交后自动创建并启动只读匹配任务，不提供独立“匹配”按钮。再次导入同日数据只允许整体替换仍处于等待匹配的数据；存在匹配或回写证据时拒绝覆盖。 +- 匹配必须按精确订单号取得唯一货运单，再以规格、原始 SKU 和档口证据确定唯一商品；歧义、冲突或数量不一致均不猜测。匹配阶段不能调用任何 SYB 写接口。 +- 回写前弹窗展示业务记录数、入库码总数、预计占位明细数和替换旧码数。只有 `ready` 记录可提交；所有服务实例共用数据库租约全局串行执行。 +- 每个远端写动作只发送一次，动作前重读整张货运单并校验匹配计划未漂移；每件写入后重读确认目标码唯一位于预期明细。超时、5xx、响应无法确认或服务在写入期间重启时转为 `needs_check`，禁止自动重试；“只读复核”只能读取远端状态。 +- 列表支持勾选后批量物理删除。删除必须再次确认；选中项包含 `queued`、`applying` 或 `needs_check` 时整批拒绝，不做部分删除。其余选中业务记录、逐件码、计划和终态执行证据在同一事务中物理删除；已写入 SYB 的远端值不会撤销。 diff --git a/docs/07-mvp-requirements.md b/docs/07-mvp-requirements.md index 8bbe8c8..cfd7d4a 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: e80a0564cf94d2feb3c068d0bf24419d36e21e67 -synchronized_at: 2026-08-19T07:09:30Z +wiki_revision: 51afc26df773d7b6a2d48588d69f215676463627 +synchronized_at: 2026-08-28T02:23:10Z # 产品需求总览与当前 MVP @@ -33,6 +33,8 @@ synchronized_at: 2026-08-19T07:09:30Z | 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) | | 开发治理与需求追溯 | 负责人和 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 代码尚未开始。 ## 当前采集 MVP 用户闭环