SUPPLIER · 05 DATA

供给方域 · 数据设计

五张表:供应商、品牌两本主档,供应商下挂联系人、资质证照两张子表,两本主档之间一张只有两个编号的绑定表。全部 2026-06-12 发布,受发布闸保护。

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

网状图:五张表靠编号相认,四处下游只存一个编号

数据库层一条外键都没有:子表靠「供应商编号」认父,绑定表靠两个编号认两端,品牌靠「父品牌编号」认父。右边四处下游存的 supplierId 可能是供应商编号,也可能是品牌编号。

本域 · 5 张表 · 零外键 supplier_base 供应商主键 supplierId(SUP + 29 位)41 个字段 · 两组地址三元组 · Logo排序号系统维护(拖拽) brand_base 品牌主键 brandId(BRD + 29 位)16 个字段 · Logo 与授权证书排序号手工填 · 父品牌编号 supplier_brand_relation 绑定supplierId + brandId(2 个字段)系统主键 _id · 这一对联合唯一 supplier_contact_node联系人 · 13 个字段SCON + 28 位 supplier_certificate_node资质证照 · 14 个字段SCRT + 28 位 · 证照图 spu_supplier_relation.supplierId服务管理域(ecommerce/sku)· 绑定时校验格式与存在 sku_maintenance_node.supplierId服务管理 · 与商品编号联合唯一 order_item_node.supplierId订单域 · 下单时冻结 sop_step_node.supplierId服务标准 · 只校验非空 按 supplierId 按 supplierId 按 brandId 父品牌 多态编号 SUP… | BRD…
两本主档子表与绑定表下游引用(不在本域)左边五张表的放置已写进各自的表文档:联系人、资质证照两张子表写明上级 supplier_base,绑定表写明两端 supplier_base × brand_base(两端同在本域)。最容易误解的是右边四个字段的名字:都叫 supplierId,装的却是「提供者编号」,BRD 开头时它指向品牌表。下游引用品牌时直接存品牌编号,不经绑定表。
02

字段:86 个,按表按组铺开

口径:含主键、不含 8 个系统字段与部门字段。「必填」按数据源文件的 required 标。中文名取后台语言包,后台没有显示的字段取表文档。

supplier_base 供应商 · 41 个必填 8 项

组字段(后台里的叫法)说明
身份 4供应商编号(主键)· 企业全称 · 企业简称 · Logo编号格式 SUP + 14 位时间 + 15 位序号;简称是对外显示名;Logo 是图片数组
工商 8统一社会信用代码 · 法定代表人 · 企业类型 · 企业规模 · 企业介绍 · 注册资本 · 成立日期 · 营业执照有效期信用代码固定 18 位;营业执照有效期为空时显示「无固定期限」
注册地址 3注册地址省市区 · 注册地址详细 · 注册地址坐标地址三元组,坐标由后台聚合层解析,不录入;契约见 x-address
办公地址 3办公地址省市区 · 办公地址详细 · 办公地址坐标同上,第二组
经营 2经营范围 · 企业官网长文本、网址
服务能力 9服务类目 · 品类明细 · 服务模式 · 覆盖区域 · 服务人员总数 · 持证人员数 · 日均最大接单量 · 响应时长 · 自有设备清单覆盖区域是多选区域的 JSON 文本,与地址三元组无关;品类明细、自有设备清单后台详情页没有
合作管理 7合作状态 · 供应商分级 · 供应商评级 · 供应商来源 · 入驻日期 · 派单优先级 · 禁用原因禁用原因只在暂停 / 终止合作时出现;派单优先级今天没有任何派单逻辑在读
内部 4我方经办人 · 经办人联系方式 · 区域经理 · 备注内部使用
排序 1排序号系统字段,拖拽维护,用户不可填
brand_base品牌 · 16 个 · 必填 5
brandId品牌编号(主键)· BRD + 29 位
brandName必填 品牌名称 · 表里上限 64
brandNameEn · brandAlias品牌英文名 · 品牌别名(逗号分隔,用于搜索)
brandDescription品牌简介 · 长文本
parentBrandId父品牌编号 · 只用于真品牌延伸
brandType必填 品牌类型 · 数组,可「商品 + 服务」
brandOrigin品牌产地 · 国内品牌 / 国外品牌
brandLogo · licenseImage品牌 Logo · 授权证书 · 图片数组
authStatus · licenseExpireDate必填 授权状态(布尔)· 授权到期日期
officialWebsite · remark官方网站 · 备注
status必填 状态 · 启用 / 禁用
orderNo必填 排序 · 手工填
supplier_contact_node联系人 · 13 个 · 必填 5
supplierContactId联系人编号(主键)· SCON + 28 位
supplierId必填 所属供应商编号
contactName必填 联系人
contactRole必填 角色 · 法人代表、总经理、业务对接等 8 种
contactPhone必填 手机号 · 格式校验
isPrimary必填 主要联系人(布尔)· 没有唯一约束
contactEmail · contactWechat邮箱(格式校验)· 微信号
contactDepartment · contactPosition部门 · 职务
availableTimeDesc · remark可联系时段 · 备注(只在导入导出里)
orderNo排序号 · 系统维护
supplier_certificate_node资质证照 · 14 个 · 必填 4
supplierCertificateId证照编号(主键)· SCRT + 28 位
supplierId必填 所属供应商编号
certificateType必填 证照类型 · 营业执照、公众责任险等 10 种
certificateName必填 证照名称
certificateNo · issuer证照编号 · 发证机构
issueDate · expiryDate发证日期 · 到期日期
coverageAmount · certificateLevel承保金额 · 等级(等级只在导入导出里)
attachmentUrl证照图片 · 图片数组 · 导入不收
certificateStatus必填 状态 · 有效 / 即将到期 / 已过期 / 已作废
remark · orderNo备注 · 排序号(系统维护)
supplier_brand_relation绑定 · 2 个 · 必填 2
supplierId必填 供应商编号
brandId必填 品牌编号
(主键)系统字段 _id,不计入字段数;这一对联合唯一
03

数据实况

结构事实数自五份数据源文件。线上有多少家供应商、多少个品牌、多少条孤儿绑定行,本轮一个都没查 —— 不虚构。

表
5全部已发布 2026-06-12
字段
8641 + 16 + 13 + 14 + 2
数据库必填
248 + 5 + 5 + 4 + 2
下拉字段
15供应商 9 · 品牌 3 · 联系人 1 · 证照 2
图片字段
4全部是图片数组
地址三元组
2 组只在供应商表
数据库外键
0认父全靠编号字段
线上行数
未查本轮没有连库
排序号两种

三张表拖拽,品牌手填

供应商、联系人、证照的排序号是系统字段;品牌的排序号是普通必填字段,表单里手工填。同一个域里两种范式并存,写法见 x-order 规范。

绑定表的主列与主键

主列是 supplierId,主键仍是 _id

数据源里标成 supplierId 的是控制台的「主列」—— 关联选择时显示哪一列,不是主键;主键仍是系统 _id,两者不矛盾(spu_supplier_relation、refund_item_relation、role_user_relation 也是同样写法)。上一版把它登记成「数据源把主键写错了」,登记错了。系统字段的列名是另一套写法(下划线),这一半属实,早期建表遗留,演化时一并校正。

长度三处不一

品牌名、企业介绍还对不上

品牌名:表 64、接口 100。品牌简介:表 4096,新建、编辑、导入三个接口都限 512,写入不会超过。企业介绍:表 4096,新建、编辑限 2000,但导入接口不限长,经导入能写进超过 2000 的内容(登记为代码缺口)。

04

约束在哪里:每一条规则由谁保障

这个域的约束多半只在一层。数据库层的必填最全,服务端与前端各有缺口,而且缺的不是同一批。

约束数据库层服务端前端
主键唯一、自动编号有不接收主键看不到输入框
供应商必填 8 项有只校验全称、简称 另两项给默认值只标全称、简称
品牌必填 5 项有有 新建时校验有 表单规则
同一对供应商与品牌只绑一次有 联合唯一(2026-07-05 线上补建)有 绑定前查重穿梭框里天然不重复
绑定两端真实存在没有没有候选只来自真实品牌
删供应商时清掉绑定没有没有—
删供应商时清掉联系人、证照与图片没有 无级联有 三段式删除—
父品牌存在、不指向自己、不成环没有没有只列根品牌 编辑根品牌时包括它自己
联系人不能换主没有没有 编号一并写回界面不传别的编号
每家只有一个主要联系人没有 「所属供应商 + 主要联系人」只是普通组合索引没有没有
禁用原因与合作状态一致没有没有仅此一层 保存前清空
坐标跟着地址变没有没有 零解析仅此一层 保存时解析
下游只能引用在合作的提供者没有没有 四处下游都不看状态没有

索引按表文档的「索引建议」:供应商表主键 + 6 个单列索引,品牌表主键 + 6 个单列索引 + 「类型 + 状态」组合索引,联系人有「所属供应商 + 主要联系人」组合索引,证照有「所属供应商 + 证照类型」组合索引。线上是否都建了,本轮未核(绑定表的联合唯一曾经只写在文档里、线上没有,2026-07-05 核实后补建)。