From 953ce55e3fff2849299deb3f5aa1caf3a25ba903 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Tue, 18 Aug 2026 17:45:03 +0800 Subject: [PATCH] =?UTF-8?q?docs(#40,#41):=20rename=20=E8=B4=A7=E8=BF=90?= =?UTF-8?q?=E5=AE=9D=20to=20SYB=20in=20display=20terms?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 --- docs/03-business-rules-and-glossary.md | 7 ++++--- prototypes/README.md | 4 ++-- .../quantux-shopee-product-6a83b708191a826306a7eeb1.html | 2 +- .../quantux-syb-import-6a83d7b4191a826306a7eebd.html | 4 ++-- 4 files changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/03-business-rules-and-glossary.md b/docs/03-business-rules-and-glossary.md index bd4b8a3..048b3da 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: 6dea349fe5231f5d336919e3861b455b9bead8a4 -synchronized_at: 2026-08-18T07:46:08Z +wiki_revision: 652236933e8dc996af2f8ab43a20cedead62ee5d +synchronized_at: 2026-08-18T09:43:32Z # 业务规则与术语 @@ -95,7 +95,8 @@ synchronized_at: 2026-08-18T07:46:08Z | 重置任务 | 保留任务输入快照,清除原结果后重新进入待执行状态 | | Portal/Agent | Android 端注册、保活、执行规则和提交结果的程序 | | 虾皮 | Shopee 的中文展示名。管理端界面一律用「虾皮」,数据库表名、字段名、API 路径等程序标识符保持 `shopee_products` / `shopee_item_id` 不变 | -| 货运宝 / SYB | 顺云宝 ERP,虾皮订单与货运单的外部来源系统 | +| SYB | 顺云宝 ERP(ShunYunBao,域名 shunyunbaoerp.com),虾皮订单与货运单的外部来源系统。管理端界面一律用「SYB」,不再使用「货运宝」「顺云宝」等别名;数据库表名与字段保持 `syb_products` | +| 货运单 | SYB 中的一张单据(`code`,如 260728TB95MJTQ),下挂一条或多条商品明细。与系统名「SYB」区分,不可混用 | | AI 规格匹配 | 人工映射缺失、PDD 商品无规格数据或目标规格定位不到时,由服务端 AI 接口把虾皮目标颜色尺码匹配到 PDD 实际规格;候选集限定为实时可选规格,无结果即失败 | | 快路径 / 慢路径 | 采购执行的两种路径:Agent 能直接定位到下发的目标规格为快路径;定位不到则触发全量遍历采集并重新匹配,为慢路径 | | 两趟执行 | 慢路径的实现方式:第一趟采集规格后结束并释放设备,服务端离线匹配,第二趟重新派发下单,复用 `task_attempt` 机制 | diff --git a/prototypes/README.md b/prototypes/README.md index 5eda34f..0dae3ff 100644 --- a/prototypes/README.md +++ b/prototypes/README.md @@ -15,8 +15,8 @@ - `quantux-shopee-product-6a83b708191a826306a7eeb1.html`:#40「GoAuto - 虾皮商品档案原型」,线上 App ID `6a83b708191a826306a7eeb1`,10 个页面、704 个控件、63 条流程线。覆盖虾皮商品列表、详情、创建(重复 shopee_item_id 拒绝,可同时录入颜色/尺码规格值并选填关联 PDD 商品)、关联 PDD 商品(含多个虾皮商品共用一个 PDD 商品)、颜色尺码映射编辑器(含规格值来源、映射来源 manual/exact_match/ai_match、待确认状态、一键确认精确匹配与人工添加规格值弹窗)、映射失效复核、新标签打开的 PDD 商品详情跳转目标,以及批量软删除的确认弹窗与逐条结果反馈。列表列为参考图、虾皮商品ID、标题、店铺、售价、PDD 商品(ID 链接)和状态;不设映射完整度列,缺失项数量并入状态文案。展示术语统一为「虾皮」,`shopee_products` / `shopee_item_id` 等程序标识符保持不变。搜索框支持粘贴多行虾皮商品ID 批量查询并回显命中统计。参考图首行使用真实 SYB 样例图并以 data URI 内嵌,导出文件无外链请求。页面不含采购任务、订单和物流字段。 -- `quantux-syb-import-6a83d7b4191a826306a7eebd.html`:#41「GoAuto - 货运宝商品导入原型」,线上 App ID `6a83d7b4191a826306a7eebd`,8 个页面、544 个控件、40 条流程线。覆盖货运宝商品明细列表、明细详情(结构化字段与原始 JSON 并列 + productSpec 解析过程)、从货运宝导入弹窗(创建日期区间 + 预检)、导入结果(新增/覆盖/跳过统计与逐条结果)、解析错误清单与重新解析、规格解析人工修正弹窗、虾皮商品提取与关联结果(关联已有 / 自动建档 / 复活已删除档案),以及新标签打开的虾皮商品详情跳转目标。列表支持多行勾选(解析失败行禁用),虾皮商品ID 为链接,来源明细ID 不在列表展示;搜索框支持粘贴多行单号批量查询并回显命中/未找到统计。字段与解析样例取自 `demo/shunyunbaoerp_stock_list.har` 实测数据。已按 #46 决策变更修订:存疑项不阻断采购,采购时由服务端 AI 拿 SYB 原始颜色尺码匹配 PDD 实际规格。页面不含采购任务、订单和物流字段。 +- `quantux-syb-import-6a83d7b4191a826306a7eebd.html`:#41「GoAuto - SYB商品导入原型」,线上 App ID `6a83d7b4191a826306a7eebd`,8 个页面、544 个控件、40 条流程线。覆盖 SYB 商品列表、明细详情(结构化字段与原始 JSON 并列 + productSpec 解析过程)、从 SYB 导入弹窗(创建日期区间 + 预检)、导入结果(新增/覆盖/跳过统计与逐条结果)、解析错误清单与重新解析、规格解析人工修正弹窗、虾皮商品提取与关联结果(关联已有 / 自动建档 / 复活已删除档案),以及新标签打开的虾皮商品详情跳转目标。列表支持多行勾选(解析失败行禁用),虾皮商品ID 为链接,来源明细ID 不在列表展示;搜索框支持粘贴多行单号批量查询并回显命中/未找到统计。字段与解析样例取自 `demo/shunyunbaoerp_stock_list.har` 实测数据。已按 #46 决策变更修订:存疑项不阻断采购,采购时由服务端 AI 拿 SYB 原始颜色尺码匹配 PDD 实际规格。页面不含采购任务、订单和物流字段。 四份文件由 QuantUX MCP 导出(#31、#32 于 2026-08-17,#40、#41 于 2026-08-18),是包含图片和交互逻辑的单文件离线 HTML,可直接用浏览器打开。MCP 导出验证结果均为 `PASS`,没有运行时错误或不支持的控件类型。 -原型审核状态:#31 PDD 商品档案原型 2026-08-17 已确认;#32 采购闭环原型 2026-08-18 已确认,可作为采购实施依据;#40 虾皮商品档案原型 2026-08-18 首次确认,同日按 #46 决策变更修订后待重新验收;#41 货运宝商品导入原型 2026-08-18 已创建,待用户审核。其余原型以对应 Gitea 工单中记录的用户审核状态为准;草稿不能作为正式实现依据。重新导出时必须使用相同 App ID,并审查差异,不能静默覆盖。 +原型审核状态:#31 PDD 商品档案原型 2026-08-17 已确认;#32 采购闭环原型 2026-08-18 已确认,可作为采购实施依据;#40 虾皮商品档案原型 2026-08-18 首次确认,同日按 #46 决策变更修订后待重新验收;#41 SYB 商品导入原型 2026-08-18 已创建,待用户审核。其余原型以对应 Gitea 工单中记录的用户审核状态为准;草稿不能作为正式实现依据。重新导出时必须使用相同 App ID,并审查差异,不能静默覆盖。 diff --git a/prototypes/quantux-shopee-product-6a83b708191a826306a7eeb1.html b/prototypes/quantux-shopee-product-6a83b708191a826306a7eeb1.html index 9a70c30..978f09b 100644 --- a/prototypes/quantux-shopee-product-6a83b708191a826306a7eeb1.html +++ b/prototypes/quantux-shopee-product-6a83b708191a826306a7eeb1.html @@ -84,7 +84,7 @@
Quant-UX 离线导出