SUPPLIER · 03 FRONTEND

供给方域 · 前端设计

两个后台页面、两种骨架:供应商管理是左列表、右详情,详情里挂三张可编辑的子表;品牌信息管理是一张树形列表。小程序端没有本域的页面。

版本 v0.3.1复核 2026-09-24端 仅管理端
01

页面地图:本域的数据出现在后台哪几处

自己的两个页面之外,还有两个别的模块借用本域的读取:服务管理与服务标准的「选供应商 / 品牌」弹窗。

界面在哪谁会看到用到的函数
供应商管理 · 左栏列表/supplier/base · 服务中心 › 供应商中心 › 供应商管理有「查询供应商」权限的角色supplier-read · supplier-create · supplier-order-update · supplier-export · supplier-import · supplier-delete(导入里的删除)
供应商管理 · 右栏详情同上,选中一家之后有「查询供应商详情」权限的角色(没有就在加载前拦下)读:supplier-info-read + 三张子表各自的读;存:supplier-update、联系人与证照各四个写、supplier-brands-bind / unbind、file-upload;删:supplier-delete
关联品牌穿梭框详情编辑态「关联品牌」表的「关联」有「关联品牌」权限的角色brand-read(经品牌模块的平铺聚合)
品牌信息管理/brand/base · 电商中心 › 品牌中心 › 品牌信息管理有「查询品牌」权限的角色brand-read · brand-create · brand-update · brand-delete · brand-status-toggle · brand-import · brand-export · file-upload
别处的选择弹窗服务管理(电商中心 › 商品中心)、服务标准(服务中心 › 质量中心)对应页面的角色品牌平铺聚合 + supplier-read,在那两个模块的聚合层里调用
小程序——零直接消费:只在商品读接口里按编号前缀带出名字与图标(归商品域)
菜单归属

品牌页挂在电商中心

菜单树里「品牌中心」是电商中心的子目录,而品牌数据属于本域(服务中心下的供给方)。本轮照实画,不改菜单。

两种骨架

主从详情 vs 树形列表

供应商字段多、子表多,用「左列表 + 右详情」;品牌字段少、有父子,用一张不分页的树形表。两种骨架的写法分别由 x-detail 与 x-curd 规范管。

权限面

界面藏住了,接口没藏

详情页界面按「查询供应商」(supplier-read)的列权限把看不到的字段藏掉,这一层成立。缺口在接口:详情读 supplier-info-read 不做列过滤,返回体里仍带着全部列,打开开发者工具或直接调接口就能拿到(已登记)。

02

逐屏高保真 · 供应商管理(只读态)

左栏 250 宽的列表,右栏选中那一家的详情。详情分上下两区,下面依次是「关联品牌」「联系人」「资质证照」三张表。

窝窝有道服务中心 · 供应商中心 · 供应商管理超级管理员
输入供应商名字
3+↑↓
某某家电
某某家电服务有限公司
某某清洗
某某清洗服务有限公司
某某维修
某某维修服务有限公司

供应商信息

编辑删除

企业全称

某某家电服务有限公司

企业简称

某某家电

企业类型

有限责任公司

统一社会信用代码

91440300XXXXXXXXXX

营业执照有效期

无固定期限

注册地址

广东省 深圳市 南山区 · 某路 1 号

合作状态

试用期

服务模式

合作师傅(平台制)

覆盖区域

深圳市、东莞市

关联品牌

品牌Logo品牌名称英文名称别名产地品牌类型授权状态授权到期官网状态
图某某牌MOUMOU—国内服务否——启用

联系人

#联系人角色手机号主要联系人邮箱微信号部门职务
1张某业务对接138****0000是xxx@example.com—商务部经理

资质证照

#证照图片证照类型证照名称证照编号发证机构发证日期到期日期承保金额状态
1图营业执照营业执照—某区市场监管局2020-01-01——有效
① 搜索只按企业全称匹配,而列表大字显示的是简称 —— 搜简称里独有的字搜不到(已登记)。② 列表每条左侧有合作状态色条(绿 / 红 / 黄),拖动可以换顺序,松手后弹「供应商排序」「确认保存新的排序顺序?」;搜索时不能拖。③ 「编辑」与「删除」受各自权限控制。④ Logo 在上区右侧。⑤ 面包屑在顶栏站点名右侧(分隔符「·」),内容区里没有面包屑。「关联品牌」没有序号列;「联系人」「资质证照」的「#」列只读态是序号、编辑态是拖拽手柄。「自有设备清单」「品类明细」两个字段详情页里没有,只在导入导出里出现(已登记)。
03

逐屏高保真 · 详情编辑态与删除确认

点「编辑」之后整块变成表单,三张表底部各多出一行虚线加行。必填星号只标了企业全称与企业简称,其余数据库必填项在界面上看不出来。

供应商信息

保存取消
某某家电服务有限公司
有限责任公司
数据库必填,界面无星号
终止合作
只在暂停 / 终止合作时出现
广东省 深圳市 福田区 · 某中心 A 座
坐标保存时由后台解析
深圳市、东莞市(多选)

关联品牌

品牌名称状态操作
某某牌启用
+ 关联

联系人

#联系人角色主要联系人操作
张某业务对接是
+ 新增一条数据

资质证照

#证照图片证照类型状态操作
图营业执照有效
+ 新增一条数据
编辑态 · 三张表依次是关联品牌、联系人、资质证照(示意省略了部分列);底部虚线加行、行上「+」与垃圾桶图标、状态决定的条件栏

删除供应商

确定要删除该供应商吗?此操作不可撤销。

取消确定
删除确认 · 成功后提示「供应商已删除」
① 保存时先校验表单,不通过提示「请检查表单填写是否完整或格式是否正确」;通过后逐个调接口,最后提示「保存成功」。② 合作状态改成非暂停 / 终止时,「禁用原因」在保存前被清空。③ 联系人、证照新加的行带临时编号,保存时才建成真记录;新证照带图的先建、再传图、再回写图片。④ 删除会连同联系人、证照一起删,但不删绑定行、不查下游有没有在用这家(已登记)。⑤ 「操作」列只有图标:「+」在当前行下面插入一行(「关联品牌」表上是打开穿梭框);垃圾桶只打删除标记(整行变红、划删除线),图标换成撤销,点保存时才真正删掉,在「关联品牌」上等于解绑。
04

逐屏高保真 · 关联品牌穿梭框

候选是全部品牌平铺,子品牌也在里面(早先只取树的外层、看不到子品牌,已改成平铺)。表格只显示「品牌名称」一列。

关联品牌

待选

2 项
请输入搜索内容
品牌名称
另一个牌子
某某子品牌

已选

1 项
请输入搜索内容
品牌名称
某某牌
取消确定
① 搜索按品牌名、英文名、品牌编号三者任一匹配。② 候选里包括已禁用的品牌,没有标记也没有过滤。③ 「确定」只把「加了谁、去了谁」交回详情页,不调接口;真正的绑定与解绑发生在详情页「保存」时。
05

逐屏高保真 · 品牌信息管理

上面是查询表单,下面一张树形表,不分页、整棵读出。「数据统计」与「新增 删除 导入 导出」在同一条工具栏里,排在按钮右边、占满剩余宽度。没有标题栏 —— 页面代码没有传表格标题,这里不画。

窝窝有道电商中心 · 品牌中心 · 品牌信息管理超级管理员
查询重置
新增删除导入导出
数据统计:总数 3 | 商品 1 | 服务 2 | 国内品牌 3 | 国外品牌 0
品牌Logo品牌名称品牌英文名品牌别名品牌简介品牌类型品牌产地官方网站授权状态状态授权证书授权到期日期排序备注操作
图▾某某牌MOUMOU——服务国内品牌—未授权启用——1—
图某某子品牌———服务国内品牌—未授权启用——1—
① 统计把整棵树摊平再数:总数、商品、服务、国内品牌、国外品牌;它和按钮在同一条工具栏里。② 状态开关拨之前弹「确认切换状态」,没有切换权限只显示文字;成功提示用错了标签,显示「商品上架状态切换成功」(已登记)。③ 排序是手工填的数字,不能拖。每行最右是「+」(在这一行下建子品牌)、铅笔(编辑)、垃圾桶(删除)三个图标,没有文字。④ 删除是级联的:行尾垃圾桶删父品牌,会把整棵子树一起删掉,确认框提示「将删除 N 项(包含所有子节点)」;勾选父品牌时界面把整棵子树一起勾上。例外:勾上父品牌后再单独取消某个子品牌,确认框仍按整棵子树计数,实际只删还勾着的那些,被取消的子品牌父编号悬空、浮成根品牌(读代码的推断,未实跑)。查询表单的五项是品牌名称、品牌类型、品牌产地、授权状态、状态。
06

逐屏高保真 · 品牌新增弹窗

顶部「新增」、行尾「+」、行尾铅笔(编辑)三个表单字段几乎相同,差别在「父品牌」:只有顶部新增与编辑有这一栏,行尾「+」建的品牌自动挂在那一行下。下图是顶部「新增」,字段按代码里的真实顺序画,省略的六项在原位标出。

新增

某某牌
请输入品牌英文名
请输入品牌别名(多个用逗号分隔)
仅真品牌延伸如 小米→米家/Mercedes→AMG,集团旗下并行品牌请用供应商关联(留空=根品牌)
请输入官方网站URL
启用

(示意省略:品牌产地、授权证书、授权到期日期)

未授权
◉ 商品 ○ 服务
0

(示意省略:品牌简介、品牌Logo、备注)

取消确定
① 父品牌下拉只列根品牌(取品牌树的最外层,页面打开时读一次、之后不刷新);编辑根品牌时下拉里包括它自己,子品牌在界面上选不到自己;服务端不拦「以自己为父」与成环,直接调接口能写进去(已登记)。② 品牌类型是单选,提交时包成一个元素的数组,所以后台建不出「商品 + 服务」双类型品牌。③ 排序手工填,必填,默认 0。④ 授权状态开关在这张表单里没有初始值:不碰它时显示「未授权」、值却是空的,按必填规则会被拦下,要打开再关上才能建未授权的品牌(读代码的推断,未实跑,已登记);行尾「+」那张表单预填了「未授权」,没有这个问题。
07

代码结构

两个模块都住 x-admin/src/xModules/ 的顶层(不在电商或服务分组目录下),平级并列。

文件行数它负责什么
supplier/pages/supplier.tsx805整页:21 条权限声明、上下两区字段与三张子表的配置、导入导出列、左栏列表、右栏详情
supplier/pages/supplier.less9左右两栏的页面布局
supplier/services/supplier.api.ts56421 个原子服务,与 21 个云函数一一对应
supplier/services/supplier.bff.ts291详情聚合读(先读主档,再把三张子表的读并发发出,最后解析文件令牌)、聚合保存(逐个调)、保存适配器(地址坐标、区划序列化、子表模式守卫、重排)
supplier/services/supplier.types.ts715主档、联系人、证照的实体类型与各接口参数、返回类型
supplier/services/supplier.constants.ts163六个下拉字段的色点映射;还在这里全局注册了「区划」「坐标」两种导入导出取值类型,注册一次别的模块也生效
supplier/services/supplier.mock.ts45建页时的样例数据
supplier/components/supplier-brand-transfer/198关联品牌穿梭框:取全部品牌平铺、解析 Logo 令牌、只交回变更集
brand/pages/brand.tsx1106查询表单与树形列表、顶部新增 / 行尾「+」新增 / 编辑三个表单、状态开关、导入导出、数据统计条、7 条权限声明
brand/pages/brand.less73统计条配色等
brand/services/brand.api.ts1937 个原子服务
brand/services/brand.bff.ts57品牌树摊平成列表 —— 被供应商穿梭框、服务管理、服务标准三个模块借用,是本域对外的前端出口
brand/services/brand.types.ts 等357类型 271、样例 83、常量 3
对外出口

品牌平铺聚合被三处借用

服务管理与服务标准的聚合层直接引入品牌模块的平铺聚合与供应商模块的原子读,拿来做「选供应商 / 品牌」弹窗。改这两个函数的返回形状,要同时回看那两个模块。

界面缺口

两个字段只在文件里

「自有设备清单」「品类明细」有表字段、有导入导出列,详情页没有,后台界面上改不了。