一个编号,两种来源
下游只存一个「提供者编号」:SUP 开头去供应商表里找,BRD 开头去品牌表里找。格式是字母前缀加 29 位数字,共 32 位。
SUPPLIER · 01 ARCHITECTURE
一件服务由谁来提供 —— 签约的公司叫供应商,消费者认得的牌子叫品牌,两者共用一个「提供者编号」:SUP 开头指供应商,BRD 开头指品牌。这个编号被商品、服务管理、订单行、服务标准四处引用。本域只管这两本主档和它们之间的绑定,不管它们被拿去干什么。
数字取自 2026-09-23 对五份表文档、28 个云函数目录与两个后台模块的逐个通读。字段按含主键、不含 8 个系统字段与部门字段计(本域的 8 个系统字段里已含部门字段 _mainDep)。
下游只存一个「提供者编号」:SUP 开头去供应商表里找,BRD 开头去品牌表里找。格式是字母前缀加 29 位数字,共 32 位。
工商信息、服务能力、合作管理三大块,下面挂联系人与资质证照两张子表。
可以有父子(小米 → 米家),自己有「启用 / 禁用」。它和供应商一样可以直接当提供者被商品引用。
一张只有两个编号的表。集团控股(海尔智家 → 海尔、卡萨帝)走这里,不走品牌父子。
左边是本域的五张表。右边四处下游只认一个编号,它们引用的是「提供者编号」,不区分这个编号来自哪本主档。
supplierId,但里面装的可能是品牌编号 —— 字段名叫供应商,实际是「提供者」。绑定表不参与下游引用:下游引用品牌时直接存 BRD 编号,不经绑定表。这些规则决定了左栏列表的颜色、详情页里哪一栏出现、以及「顺序」由谁说了算。
| 取值(后台显示) | 列表色条 | 它意味着什么 |
|---|---|---|
| 正式合作 · 自营业务 · 试用期 | 绿 | 在合作中。supplier.tsx:642-648 把这三种归为绿色 |
| 暂停合作 · 终止合作 | 红 | 不再合作。只有这两种状态下,详情页才出现「禁用原因」一栏(supplier.tsx:159);保存成别的状态时,禁用原因被清空(supplier.bff.ts:229-231) |
| 待审核 · 初步接触 · 资质审核中 | 黄 | 还在谈。新建供应商时如果不传,服务端默认写「待审核」(supplier-create/repo.js:50) |
商品绑供给方、服务管理、服务标准、小程序读商品,四处都不按合作状态或品牌启用状态过滤。所以今天「终止合作」只改变后台列表的颜色,不会让它从任何下拉里消失。
状态列是一个开关,拨之前弹「确认切换状态」;没有切换权限的人只看到文字。它同样不影响下游。
三处读取方都这么取:商品绑供给方的列表、小程序服务浏览、服务详情。供应商的简称才是对外名字,全称只在后台出现。
| 表 | 排序方式 | 谁决定顺序 |
|---|---|---|
| 供应商、联系人、资质证照 | 拖拽 | 排序号是系统字段,用户碰不到。新建时追加到末尾(供应商全表一组,联系人与证照按所属供应商分组),拖完一次性重写。 |
| 品牌 | 手工填数字 | 顶部新增、编辑、行尾「+」新增三个表单里都有「排序」输入框,必填;没有拖拽,也没有重排接口。 |
运营在「供应商管理」页做的事。注意两个地方:第 ② 步弹窗只收两项,其余五项数据库必填全靠服务端默认或留空;第 ⑥ 步保存时后台要逐个调好几个接口,中间没有事务。
supplier.bff.ts:107-185、:270-288)。任何一步失败,前面已经写进去的不会撤回。编辑频率低,风险可接受,但已登记。这个判断在代码里没有任何检查,全靠录入的人。品牌表单「父品牌」一栏的提示语写的就是这条规则。
locales/zh-CN/xModules/brand/pages.ts:60)。服务端不校验父品牌是否存在、是否指向自己、是否成环,见本页边界一节。先划清这个域到哪儿为止,再逐条摆出本轮第一次逐端审查查出来的出入 —— 以代码为准,本轮一条代码都不改,只登记。
归服务管理域(商品绑供给方与一条 Offer 都在那里)。本域不知道任何一家供应商在卖什么。
订单行下单时把编号冻结在自己身上;服务标准是「商品 + 提供者」这一对上的关系域。两者都只拿编号。
小程序不直接读这两本主档;服务浏览与服务详情两个读接口按编号前缀分流去取名字与图标,那两个接口归商品域。
| # | 文档怎么说 | 代码实际怎样 | 证据 · 处置 |
|---|---|---|---|
| 1 | 本域 ARCH.md §一结构图、§六:订单引用在 order_base.supplierId,「订单快照冻结」 | 订单头表 v2.0 已删掉这一列;提供者编号在订单行 order_item_node.supplierId,由下单接口从 SKU 取出写入,前端不许传 | order_base.md:93,97,109 · order_item_node.md:18 · order-create/service.js:138 · controller.js:25。本轮已订正 ARCH.md |
| 2 | supplier_base.md:192(订正前;订正后订单行在第 193 行):「工单表 order_order_info.supplierId 引用本表」 | 全库没有这张表,x-data 下查无此文件;派单不引用供应商 | ✅ 2026-09-24 已订正 表文档改成订单行 order_item_node.supplierId(供应商或品牌方两种编号,下单时从 SKU 带出),「关联(后续)」改为现役下游,补上品牌关系、服务绑定、SKU 维护、服务标准四处引用 |
| 3 | supplier_base.datasource.json 必填 8 项(含企业类型、服务类目、服务模式、覆盖区域、合作状态、排序);supplier_base.md:69 写「必填字段禁止默认值」 | 新建接口这五项全是可选(supplier-create/controller.js:21,35,37,38,44);后台新增弹窗只收全称与简称(supplier.tsx:650-671);服务端给合作状态默认「待审核」、派单优先级默认「正常派单」(repo.js:50,55) | 运行时是被数据库拒掉还是写进空值,未核(本轮没有实际新增一条)。表文档自身 :69 与 :95 的必填清单不一致那一处 ✅ 2026-09-24 已订正::95 与两个示例注释里的法定代表人改回选填(它在字段表里本就可空,数据源也不要求) |
| 4 | supplier_brand_relation.md:31-32:插入前必须校验供应商存在;删除供应商前应先检查品牌绑定 | 绑品牌只查「是否已绑过」,不查两端存在(supplier-brands-bind/service.js);删供应商删联系人、证照、主档,不删也不查绑定行(supplier-delete/service.js:16-18) | 删掉的供应商会留下孤儿绑定行。表文档 :31 已如实补注「当前未实现,登记为代码缺口」(✅ 2026-09-24);两件事本身仍是代码缺口,本轮不改 |
| 5 | supplier_base.md:80-88:信用代码、法定代表人、合作状态等「仅管理员可见」 | 界面层成立:详情页按 supplier-read 的列权限把看不到的字段藏掉(detail.tsx:86-88、supplier.tsx:792)。接口层不成立:详情数据取自 supplier-info-read,它不做列过滤(package.json 的 columnControlled 为 false),返回体里仍带着全部列 | 打开开发者工具或直接调接口就能拿到被藏的字段 |
| 6 | 字段长度:品牌名 64(brand_base.md:14、json :161);品牌简介 2000(md :17)/ 4096(json :281);企业介绍 2000(supplier_base.md:21)/ 4096(json :231) | 品牌新建、编辑、导入三处接口:品牌名最多 100、品牌简介最多 512(brand-create/controller.js:16,28 等) | 品牌简介 ✅ 2026-09-24 已订正:表文档写明「数据源上限 4096、接口限 512」,新建、编辑、导入三个接口都限 512,写入不会超过。企业介绍:表文档已写明两层,但导入接口不限长(supplier-import/controller.js:22,后台导入列含这一栏),经导入能写进超过 2000 的内容 —— 登记为代码缺口。品牌名仍对不上:表 64、接口 100,超过 64 的品牌名能过接口校验 |
| 7 | brand_base.md:20:品牌类型多选,可以「商品 + 服务」两者都有 | 后台三个品牌表单都是单选按钮,提交时包成一个元素的数组(brand.tsx:507-517) | 后台建不出双类型品牌,只有导入能写进去。上一版把这条记成表文档写错了,登记错了:数据契约本来就是多选(数据源是数组,brand-create/controller.js:20 收数组),只是后台表单只做了单选 |
| 8 | 表文档示例:联系人示例的供应商编号写 SBAS…、主要联系人写 'yes'(supplier_contact_node.md:76,82);绑定表示例品牌编号写 BRND…(supplier_brand_relation.md:53,66) | 真实前缀是 SUP 与 BRD;主要联系人是布尔值 | ✅ 2026-09-24 已订正 示例改成 SUP / BRD 编号与布尔值;同批订正资质证照示例(SPLR 前缀、日期写成毫秒时间戳、附件写成数组)与品牌示例(授权状态布尔、Logo 与证书写成数组、日期写成毫秒时间戳) |
| 9 | sop_step_node.md:137(订正前;订正后在第 138 行):提供者编号「关联 supplier_base.supplierId」 | 四处真实引用都是 SUP / BRD 多态;sop_step_node.md:15 自己的字段表也写了多态 | ✅ 2026-09-24 已订正 sop_step_node.md 上游段改写为供应商 / 品牌方两种编号,数据源说明同步。spu_sku_node.md:16 也这么写,但那是整表废弃、待清理的遗留表(商品域架构 §2.5),不算现役出入 |
| 10 | 本域 ARCH.md §五:supplier.tsx 各处行号、「品牌字段 11 列」 | 页面文件现为 805 行,锚点整体漂移十余行;品牌列实为 10 列 | 本轮已订正 ARCH.md |
| 11 | 数据源:成立日期、营业执照有效期、入驻日期、品牌授权到期日期都是数字型日期(type: number · format: date) | 新建接口收文本(supplier-create/controller.js:25,26,48),更新接口收数字(supplier-update/controller.js:25,26,48),两边不一样;品牌授权到期日期新建、更新都收文本(brand-create/controller.js:25) | 同一个字段两个入口两种类型 |
| 弱点 | 它现在是什么样 | 怎么看待 |
|---|---|---|
| 下游不看状态 | 终止合作的供应商、禁用的品牌,仍然出现在商品绑供给方、服务管理、服务标准的选择里,也仍然被小程序读出名字 | 最大的一处 状态目前只是后台的标签。要不要「终止即下架」是业务决定,本轮只登记 |
| 一次保存无事务 | 主档、联系人、证照、品牌绑定分多次写,中途失败留下半截 | 已登记 编辑频率低;根治要么事务、要么写完核一遍 |
| 导入会清空证照图 | 导入的证照子项不收图片字段,而证照是整组替换 —— 每导入一次,已有证照的图片就丢一次,旧文件也不删 | 静态推断 本轮没有实际跑一次导入 |
| 删除不收尾 | 删供应商留下绑定行。删品牌:在后台界面删父品牌时整棵子树一起删掉(brand.tsx:614 级联),但绑定行照样留着;brand-delete 本身只删传进来的编号,所以直接调接口、走导入里的删除,或在界面上勾了父品牌又单独取消某个子品牌,子品牌的父编号就会悬空 | 悬空的子品牌会因父编号找不到而浮成根品牌 |
| 父品牌不设防 | 界面上:下拉只列根品牌,编辑根品牌时下拉里包括它自己,子品牌选不到自己;下拉只在页面打开时读一次、之后不刷新。服务端不查存在与成环,直接调接口能写进指向自己或成环的父编号;读接口建树时,这类品牌会从树里整支消失 | 静态推断 读的逻辑见 brand-read/repo.js:52-69 |
| 改联系人能换主 | 编辑联系人时供应商编号一起写回,注释说「用于权限校验」但没有任何校验;「主要联系人」没有唯一约束 | 后台界面不会这么传,风险在直接调接口 |
字段按数据源文件逐个数;28 个云函数的入口、参数、业务、数据四层与包配置都看过;两个后台页面与聚合层逐行对过。
商品绑供给方、服务管理、下单、服务标准的参数校验,以及小程序两个读接口的分流取名,都读了源码。
新增、导入、删除都没有在真实界面上走一遍;线上有多少供应商、多少品牌、多少孤儿绑定行,本轮一个都没查。