SUPPLIER · 01 ARCHITECTURE

供给方域 · 架构设计

一件服务由谁来提供 —— 签约的公司叫供应商,消费者认得的牌子叫品牌,两者共用一个「提供者编号」:SUP 开头指供应商,BRD 开头指品牌。这个编号被商品、服务管理、订单行、服务标准四处引用。本域只管这两本主档和它们之间的绑定,不管它们被拿去干什么。

版本 v0.3.1复核 2026-09-24端 数据 + 服务端 + 管理端
01

业务参数:先把这个域有多大说清楚

数字取自 2026-09-23 对五份表文档、28 个云函数目录与两个后台模块的逐个通读。字段按含主键、不含 8 个系统字段与部门字段计(本域的 8 个系统字段里已含部门字段 _mainDep)。

数据表
52 本主档 + 2 张子表 + 1 张绑定表
字段
8641 + 16 + 13 + 14 + 2
云函数
28供应商 21 + 品牌 7 · 全部要登录
后台页面
2供应商管理 · 品牌信息管理
页面上的权限
28与云函数一一对应
被引用的地方
4商品 · 服务管理 · 订单行 · 服务标准
引用时看状态的地方
0终止合作、禁用的品牌照样能被选
一次保存要调的接口
N逐个调 · 没有事务

四个词先对齐后面所有图都用这四个词

供给方

一个编号,两种来源

下游只存一个「提供者编号」:SUP 开头去供应商表里找,BRD 开头去品牌表里找。格式是字母前缀加 29 位数字,共 32 位。

供应商

签约、派单的公司

工商信息、服务能力、合作管理三大块,下面挂联系人与资质证照两张子表。

品牌

消费者认得的牌子

可以有父子(小米 → 米家),自己有「启用 / 禁用」。它和供应商一样可以直接当提供者被商品引用。

绑定

哪家公司持有哪些品牌

一张只有两个编号的表。集团控股(海尔智家 → 海尔、卡萨帝)走这里,不走品牌父子。

02

结构图:两本主档、一张绑定表,四处下游

左边是本域的五张表。右边四处下游只认一个编号,它们引用的是「提供者编号」,不区分这个编号来自哪本主档。

本域 · 5 张表 供应商 supplier_baseSUP 编号 · 41 个字段 · 两组地址 品牌 brand_baseBRD 编号 · 16 个字段 · 可有父品牌 绑定 supplier_brand_relation只有两个编号 · 同一对不许重复 联系人13 个字段 · 可拖拽 资质证照14 个字段 · 带证照图 商品绑供给方 spu_supplier_relation一件商品由哪几个提供者供给(服务管理域) 服务管理 sku_maintenance_node商品 × 提供者一条供给单元(Offer) 订单行 order_item_node下单时从 SKU 带出、冻结在行上(订单域) 服务标准 sop_step_node「商品 + 提供者」这一对编一套标准 四处都不看合作状态、不看品牌启用状态只看编号格式或编号存在 1 : N 1 : N N : M 提供者编号 SUP… | BRD… 父子(小米→米家)
两本主档子表与绑定表下游(不在本域)弱点四处下游写的字段都叫 supplierId,但里面装的可能是品牌编号 —— 字段名叫供应商,实际是「提供者」。绑定表不参与下游引用:下游引用品牌时直接存 BRD 编号,不经绑定表。
03

状态与规则:合作状态八种、品牌两种、排序两种

这些规则决定了左栏列表的颜色、详情页里哪一栏出现、以及「顺序」由谁说了算。

合作状态八种左栏列表条目左侧的色条就是它

取值(后台显示)列表色条它意味着什么
正式合作 · 自营业务 · 试用期绿在合作中。supplier.tsx:642-648 把这三种归为绿色
暂停合作 · 终止合作红不再合作。只有这两种状态下,详情页才出现「禁用原因」一栏(supplier.tsx:159);保存成别的状态时,禁用原因被清空(supplier.bff.ts:229-231)
待审核 · 初步接触 · 资质审核中黄还在谈。新建供应商时如果不传,服务端默认写「待审核」(supplier-create/repo.js:50)
状态只是标签

下游谁都不看它

商品绑供给方、服务管理、服务标准、小程序读商品,四处都不按合作状态或品牌启用状态过滤。所以今天「终止合作」只改变后台列表的颜色,不会让它从任何下拉里消失。

品牌两种状态

启用 / 禁用,列表里直接拨

状态列是一个开关,拨之前弹「确认切换状态」;没有切换权限的人只看到文字。它同样不影响下游。

显示名规则

SUP 取简称,BRD 取品牌名

三处读取方都这么取:商品绑供给方的列表、小程序服务浏览、服务详情。供应商的简称才是对外名字,全称只在后台出现。

排序两种范式同一个域里并存

表排序方式谁决定顺序
供应商、联系人、资质证照拖拽排序号是系统字段,用户碰不到。新建时追加到末尾(供应商全表一组,联系人与证照按所属供应商分组),拖完一次性重写。
品牌手工填数字顶部新增、编辑、行尾「+」新增三个表单里都有「排序」输入框,必填;没有拖拽,也没有重排接口。
04

泳道图:新增一家供应商并补全资料

运营在「供应商管理」页做的事。注意两个地方:第 ② 步弹窗只收两项,其余五项数据库必填全靠服务端默认或留空;第 ⑥ 步保存时后台要逐个调好几个接口,中间没有事务。

运营在后台操作 左栏列表供应商管理 右栏详情供应商信息 服务端21 个云函数 数据表4 张表 ① 点「+」列表头右侧 ② 新增供应商只填全称与简称 ③ supplier-create补排序号 · 默认待审核 ④ 新增一行SUP 编号自动生成 ⑤ 选中 → 编辑补字段 · 加联系人证照 ⑥ 保存逐个调接口 ⑦ 四张表各写各的中途失败留半截 没有事务 五项必填靠默认或留空
⑥ 的保存顺序是:先在后台把两组地址解析成坐标,再依次改主档 → 联系人增、改、删 → 证照增(带图的先建再传图再回写)、改、删 → 绑品牌 → 解绑品牌 → 联系人与证照重排(supplier.bff.ts:107-185、:270-288)。任何一步失败,前面已经写进去的不会撤回。编辑频率低,风险可接受,但已登记。
05

判定图:该建供应商、建品牌,还是挂父品牌

这个判断在代码里没有任何检查,全靠录入的人。品牌表单「父品牌」一栏的提示语写的就是这条规则。

要登记一个提供者先问它是什么 签约、派单的公司?有工商信息 在供应商管理里新增(SUP)再在详情里「关联」它持有的品牌 是某个牌子的延伸?小米 → 米家 新增品牌,填「父品牌」或在父品牌那一行点行尾「+」 新增根品牌(父品牌留空)集团旗下并行品牌也走这里 再去供应商详情「关联」海尔智家 → 海尔、卡萨帝 是 否 是 否
父品牌表单的提示语原文:「仅真品牌延伸如 小米→米家/Mercedes→AMG,集团旗下并行品牌请用供应商关联(留空=根品牌)」(locales/zh-CN/xModules/brand/pages.ts:60)。服务端不校验父品牌是否存在、是否指向自己、是否成环,见本页边界一节。
06

边界、文档与代码对不上的地方、弱点

先划清这个域到哪儿为止,再逐条摆出本轮第一次逐端审查查出来的出入 —— 以代码为准,本轮一条代码都不改,只登记。

不在本域

这个提供者能供哪件商品

归服务管理域(商品绑供给方与一条 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
2supplier_base.md:192(订正前;订正后订单行在第 193 行):「工单表 order_order_info.supplierId 引用本表」全库没有这张表,x-data 下查无此文件;派单不引用供应商✅ 2026-09-24 已订正 表文档改成订单行 order_item_node.supplierId(供应商或品牌方两种编号,下单时从 SKU 带出),「关联(后续)」改为现役下游,补上品牌关系、服务绑定、SKU 维护、服务标准四处引用
3supplier_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 与两个示例注释里的法定代表人改回选填(它在字段表里本就可空,数据源也不要求)
4supplier_brand_relation.md:31-32:插入前必须校验供应商存在;删除供应商前应先检查品牌绑定绑品牌只查「是否已绑过」,不查两端存在(supplier-brands-bind/service.js);删供应商删联系人、证照、主档,不删也不查绑定行(supplier-delete/service.js:16-18)删掉的供应商会留下孤儿绑定行。表文档 :31 已如实补注「当前未实现,登记为代码缺口」(✅ 2026-09-24);两件事本身仍是代码缺口,本轮不改
5supplier_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 的品牌名能过接口校验
7brand_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 与证书写成数组、日期写成毫秒时间戳)
9sop_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 个函数逐个读过

字段按数据源文件逐个数;28 个云函数的入口、参数、业务、数据四层与包配置都看过;两个后台页面与聚合层逐行对过。

验过

四处下游逐个核过

商品绑供给方、服务管理、下单、服务标准的参数校验,以及小程序两个读接口的分流取名,都读了源码。

没验

没有实跑、没查线上

新增、导入、删除都没有在真实界面上走一遍;线上有多少供应商、多少品牌、多少孤儿绑定行,本轮一个都没查。