| brandId | 品牌编号(主键)· BRD + 29 位 |
| brandName | 必填 品牌名称 · 表里上限 64 |
| brandNameEn · brandAlias | 品牌英文名 · 品牌别名(逗号分隔,用于搜索) |
| brandDescription | 品牌简介 · 长文本 |
| parentBrandId | 父品牌编号 · 只用于真品牌延伸 |
| brandType | 必填 品牌类型 · 数组,可「商品 + 服务」 |
| brandOrigin | 品牌产地 · 国内品牌 / 国外品牌 |
| brandLogo · licenseImage | 品牌 Logo · 授权证书 · 图片数组 |
| authStatus · licenseExpireDate | 必填 授权状态(布尔)· 授权到期日期 |
| officialWebsite · remark | 官方网站 · 备注 |
| status | 必填 状态 · 启用 / 禁用 |
| orderNo | 必填 排序 · 手工填 |
SUPPLIER · 05 DATA
供给方域 · 数据设计
五张表:供应商、品牌两本主档,供应商下挂联系人、资质证照两张子表,两本主档之间一张只有两个编号的绑定表。全部 2026-06-12 发布,受发布闸保护。
网状图:五张表靠编号相认,四处下游只存一个编号
数据库层一条外键都没有:子表靠「供应商编号」认父,绑定表靠两个编号认两端,品牌靠「父品牌编号」认父。右边四处下游存的 supplierId 可能是供应商编号,也可能是品牌编号。
supplier_base,绑定表写明两端 supplier_base × brand_base(两端同在本域)。最容易误解的是右边四个字段的名字:都叫 supplierId,装的却是「提供者编号」,BRD 开头时它指向品牌表。下游引用品牌时直接存品牌编号,不经绑定表。字段: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 | 排序号 | 系统字段,拖拽维护,用户不可填 |
| supplierContactId | 联系人编号(主键)· SCON + 28 位 |
| supplierId | 必填 所属供应商编号 |
| contactName | 必填 联系人 |
| contactRole | 必填 角色 · 法人代表、总经理、业务对接等 8 种 |
| contactPhone | 必填 手机号 · 格式校验 |
| isPrimary | 必填 主要联系人(布尔)· 没有唯一约束 |
| contactEmail · contactWechat | 邮箱(格式校验)· 微信号 |
| contactDepartment · contactPosition | 部门 · 职务 |
| availableTimeDesc · remark | 可联系时段 · 备注(只在导入导出里) |
| orderNo | 排序号 · 系统维护 |
| supplierCertificateId | 证照编号(主键)· SCRT + 28 位 |
| supplierId | 必填 所属供应商编号 |
| certificateType | 必填 证照类型 · 营业执照、公众责任险等 10 种 |
| certificateName | 必填 证照名称 |
| certificateNo · issuer | 证照编号 · 发证机构 |
| issueDate · expiryDate | 发证日期 · 到期日期 |
| coverageAmount · certificateLevel | 承保金额 · 等级(等级只在导入导出里) |
| attachmentUrl | 证照图片 · 图片数组 · 导入不收 |
| certificateStatus | 必填 状态 · 有效 / 即将到期 / 已过期 / 已作废 |
| remark · orderNo | 备注 · 排序号(系统维护) |
| supplierId | 必填 供应商编号 |
| brandId | 必填 品牌编号 |
| (主键) | 系统字段 _id,不计入字段数;这一对联合唯一 |
数据实况
结构事实数自五份数据源文件。线上有多少家供应商、多少个品牌、多少条孤儿绑定行,本轮一个都没查 —— 不虚构。
- 表
- 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 的内容(登记为代码缺口)。
约束在哪里:每一条规则由谁保障
这个域的约束多半只在一层。数据库层的必填最全,服务端与前端各有缺口,而且缺的不是同一批。
| 约束 | 数据库层 | 服务端 | 前端 |
|---|---|---|---|
| 主键唯一、自动编号 | 有 | 不接收主键 | 看不到输入框 |
| 供应商必填 8 项 | 有 | 只校验全称、简称 另两项给默认值 | 只标全称、简称 |
| 品牌必填 5 项 | 有 | 有 新建时校验 | 有 表单规则 |
| 同一对供应商与品牌只绑一次 | 有 联合唯一(2026-07-05 线上补建) | 有 绑定前查重 | 穿梭框里天然不重复 |
| 绑定两端真实存在 | 没有 | 没有 | 候选只来自真实品牌 |
| 删供应商时清掉绑定 | 没有 | 没有 | — |
| 删供应商时清掉联系人、证照与图片 | 没有 无级联 | 有 三段式删除 | — |
| 父品牌存在、不指向自己、不成环 | 没有 | 没有 | 只列根品牌 编辑根品牌时包括它自己 |
| 联系人不能换主 | 没有 | 没有 编号一并写回 | 界面不传别的编号 |
| 每家只有一个主要联系人 | 没有 「所属供应商 + 主要联系人」只是普通组合索引 | 没有 | 没有 |
| 禁用原因与合作状态一致 | 没有 | 没有 | 仅此一层 保存前清空 |
| 坐标跟着地址变 | 没有 | 没有 零解析 | 仅此一层 保存时解析 |
| 下游只能引用在合作的提供者 | 没有 | 没有 四处下游都不看状态 | 没有 |
索引按表文档的「索引建议」:供应商表主键 + 6 个单列索引,品牌表主键 + 6 个单列索引 + 「类型 + 状态」组合索引,联系人有「所属供应商 + 主要联系人」组合索引,证照有「所属供应商 + 证照类型」组合索引。线上是否都建了,本轮未核(绑定表的联合唯一曾经只写在文档里、线上没有,2026-07-05 核实后补建)。