SUPPLIER · 02 FLOW

供给方域 · 流程设计

四个场景,全部由运营在后台完成。前两个在「供应商管理」页(服务中心),第三个在「品牌信息管理」页 —— 这一页的菜单挂在电商中心下,而品牌数据属于本域,照实画。

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

四个场景

这个域没有移动端场景:小程序不直接读这两本主档,只在商品链里带出名字与图标(归商品域)。

两步走

先两项起建,再在详情里补全

新增弹窗只有「企业全称」「企业简称」两项;其余四十来个字段、联系人、证照、品牌都在右栏详情里「编辑」后补。

一次保存

子表改动攒到「保存」才提交

联系人、证照、关联品牌在编辑态里改的都只是暂存;点「取消」全部放弃。点「保存」才逐个调接口写库 —— 中间没有事务。

01

场景 1 · 新增供应商并补全资料

左栏是供应商列表,右栏是选中那一家的详情。新增后自动选中新的那一家,右栏直接出现它的详情。

谁来做
运营(需「新增供应商」「编辑供应商」权限)
从哪进
服务中心 › 供应商中心 › 供应商管理(/supplier/base)
做什么
两项起建 → 编辑补全字段、地址、联系人、证照 → 保存
做完的结果
供应商主档一行 + 联系人、证照若干行;两组地址的坐标由后台自动算出

① 流程图起建与补全分两次写库

进供应商管理左列表 · 右详情 点「+」弹「新增供应商」 填全称、简称 → 确定写库一次 · 自动选中 右栏点「编辑」补字段、地址 加联系人、证照「新增一条数据」 点「保存」算坐标 · 逐个调接口 「保存成功」左栏刷新 无事务
起建那一次只写主档一行(服务端补上排序号,合作状态不填则默认「待审核」)。补全那一次要调多个接口:主档、联系人、证照、证照图片、品牌绑定、重排 —— 任何一步失败,前面写进去的不回滚。

② 怎么操作橙色圆圈 = 这一步要点的地方

第 1 步

进页面,点列表头的「+」

  1. 1顶栏「服务中心」,侧栏「供应商中心」下的「供应商管理」
  2. 2左栏列表头右侧的「+」图标按钮(没有「新增供应商」权限的人看不到它);旁边的上传箭头是导入、下载箭头是导出,数字是当前列表条数
  3. 搜索框的占位字是「输入供应商名字」,只按企业全称匹配,而列表每一条的大字是简称、小字是全称,左侧色条是合作状态(绿 / 黄 / 红),列表没有表头
  4. 面包屑「服务中心 · 供应商中心 · 供应商管理」在顶栏站点名右侧,内容区里没有面包屑
  5. 右栏没选中时显示「请从左侧选择供应商」

弹出「新增供应商」。

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

填全称与简称,点「确定」

  1. 1「企业全称」必填
  2. 2「企业简称」必填 —— 对外显示用的是简称
  3. 3点「确定」
  4. 弹窗只有这两项;企业类型、服务类目、服务模式、覆盖区域、合作状态这几项数据库标为必填,但这里不收,服务端也不校验(已登记)

左栏多出这一家并自动选中,右栏出现它的详情(其余字段为空)。

新增供应商

某某家电服务有限公司
某某家电
取消确定
第 3 步

右栏点「编辑」,补齐资料

  1. 1右栏标题「供应商信息」旁的「编辑」
  2. 2上半区:企业全称、企业简称、成立日期、营业执照有效期、法定代表人、企业类型、统一社会信用代码、企业规模、注册资本、企业官网、注册地址(省市区 + 详细地址),右侧是 Logo
  3. 3下半区:企业介绍、合作状态、供应商分级 / 评级 / 来源、入驻日期、服务模式、人数与日均接单量、响应时长、派单优先级、我方经办人、经办人联系方式、区域经理、服务类目、实际办公地址、经营范围、备注、覆盖区域
  4. 合作状态选「暂停合作」或「终止合作」时,才多出一栏「禁用原因」
  5. 坐标不在表单里:两组地址的坐标在保存时由后台解析

此时的改动只在页面上,还没写库。

供应商信息

保存取消
某某家电服务有限公司
有限责任公司
广东省 / 深圳市 / 南山区 · 某路 1 号
坐标保存时由后台解析
试用期
合作师傅(平台制)
深圳市、东莞市
第 4 步

在「联系人」「资质证照」表里加行

  1. 1编辑态下表格底部的「新增一条数据」虚线行,点一次在末尾加一行
  2. 2也可以点某一行「操作」列里的「+」图标,在这一行下面插入一行
  3. 3「操作」列的垃圾桶图标是删除:只打上删除标记(整行变红、划删除线),图标换成撤销,点撤销就恢复;点保存时才真正删掉。新加的空行点删除直接消失
  4. 联系人列:联系人、角色、手机号、主要联系人、邮箱、微信号、部门、职务;手机号与邮箱有格式校验
  5. 资质证照列:证照图片、证照类型、证照名称、证照编号、发证机构、发证日期、到期日期、承保金额、状态
  6. 「#」列在只读态是序号,编辑态换成拖拽手柄,拖动换顺序,保存时一并落库

新加的行带临时编号,保存时才变成真实记录。

联系人

#联系人角色手机号主要联系人操作
张某业务对接138****0000是
李某财务对接139****0000否
+ 新增一条数据

资质证照

#证照图片证照类型证照名称状态操作
图营业执照营业执照有效
+ 新增一条数据
第 5 步

点「保存」

  1. 1右栏标题旁的「保存」
  2. 表单没填对时提示「请检查表单填写是否完整或格式是否正确」,一次都不写库
  3. 通过后提示「保存成功」,左栏刷新

保存是逐个接口调的:改主档 → 联系人增改删 → 证照增改删(带图的新证照先建、再传图、再回写图片)→ 绑品牌 → 解绑品牌 → 重排。中途任何一步失败,前面已经写进去的不会撤回,页面会报错但数据已部分落库。

保存成功

供应商信息

保存取消
02

场景 2 · 给供应商关联品牌

「关联品牌」是详情页里的第一张表,排在「联系人」「资质证照」前面。它和联系人、证照一样只在编辑态可改、点保存才落库。

谁来做
运营(需「关联品牌」「解绑品牌」权限)
从哪进
供应商管理 › 选中一家 › 「编辑」
做什么
点「关联」→ 在穿梭框里把品牌挪到「已选」→ 确定 → 保存
做完的结果
绑定表增删若干行(这家公司持有哪些品牌)

① 流程图穿梭框只交回「加了谁、去了谁」

编辑态「关联品牌」表 点「+ 关联」打开穿梭框 挪到「已选」→ 确定候选含全部品牌 点「保存」先绑、再解绑 绑定表增删重复绑定会被拒
候选列表取的是全部品牌平铺(含子品牌、含已禁用的品牌),按品牌名、英文名、编号都能搜。保存时绑定接口会先查「这一对是不是已经绑过」,绑过就报「以下品牌已绑定,请勿重复绑定」。

② 怎么操作橙色圆圈 = 这一步要点的地方

第 1 步

编辑态下点「+ 关联」

  1. 1「关联品牌」表底部的「关联」虚线行;行上「操作」列的「+」图标打开的是同一个穿梭框
  2. 2行上的垃圾桶图标等于解绑:原本就绑着的品牌打上删除标记、可以撤销,保存时才解绑;这次刚挑进来的直接从表里拿掉
  3. 只读态下虚线行与「操作」列都不出现;这张表没有序号列,不能拖动排序;表格列:品牌Logo、品牌名称、英文名称、别名、产地、品牌类型、授权状态、授权到期、官网、状态(示意省略了其中几列)

弹出穿梭框「关联品牌」。

关联品牌

品牌Logo品牌名称产地品牌类型状态操作
图某某牌国内服务启用
+ 关联
第 2 步

在穿梭框里挑品牌,点「确定」

  1. 1左边「待选」、右边「已选」,勾上后挪到右边
  2. 2搜索框「请输入搜索内容」,按品牌名、英文名、编号匹配
  3. 3点「确定」
  4. 从右边挪回左边就是解绑

「关联品牌」表立刻按新选择显示,但还没写库。

关联品牌

待选已选
请输入搜索内容
勾选品牌名称
✓另一个牌子
某某子品牌
取消确定
第 3 步

点详情页的「保存」

  1. 1右栏标题旁的「保存」
  2. 新挪进来的一次性绑定,挪出去的一次性解绑
  3. 点「取消」则这次的挑选全部作废

绑定接口不检查这家供应商和这些品牌是否真实存在、是否已禁用 —— 界面上挑出来的都存在,风险在于直接调接口的人(已登记)。

03

场景 3 · 维护品牌树与启停

品牌是一棵树:根品牌在最外层,子品牌挂在父品牌下。排序号要手工填,状态在列表里直接拨。

谁来做
运营(需「新增品牌」「更新品牌」「切换状态」权限)
从哪进
电商中心 › 品牌中心 › 品牌信息管理(/brand/base)
做什么
顶部「新增」建根品牌;某一行点行尾的「+」图标建它的子品牌;拨状态开关
做完的结果
品牌表增删改;工具栏里的「数据统计」随之变化

① 流程图两个入口建品牌,一个开关管启停

品牌信息管理一棵树 · 不分页 顶部「新增」可选父品牌 行尾「+」图标父品牌 = 这一行 树上多一个节点按排序号排 拨「状态」开关启用 ⇄ 禁用 「确认切换状态」点「确认」 提示文案用错了标签「商品上架状态切换成功」
顶部「新增」里的「父品牌」下拉只列根品牌(取的是树的最外层,而且只在页面打开时读一次、之后不刷新),所以要把品牌挂在子品牌下,只能到那一行点行尾的「+」图标。状态切换不影响下游:禁用的品牌照样出现在供应商的关联候选、商品的供给方选择里。

② 怎么操作橙色圆圈 = 这一步要点的地方

第 1 步

顶部「新增」建根品牌

  1. 1顶栏「电商中心」,侧栏「品牌中心」下的「品牌信息管理」;面包屑「电商中心 · 品牌中心 · 品牌信息管理」在顶栏站点名右侧
  2. 2表格工具栏最左边的「新增」
  3. 表格上方是查询表单:品牌名称、品牌类型、品牌产地、授权状态、状态五项,加「查询」「重置」
  4. 「数据统计」与「新增 删除 导入 导出」在同一条工具栏里,排在按钮右边、占满剩余宽度;每行最右是「+」、铅笔、垃圾桶三个图标(示意省略了表格的部分列)
  5. 「品牌名称」「状态」「品牌类型」「授权状态」「排序」必填;「品牌类型」是单选(商品 / 服务),提交时包成一个元素的数组
  6. 「父品牌」留空就是根品牌

「授权状态」是一个开关,这张顶部新增表单没有给它初始值(行尾「+」那张给了「未授权」)。开关一次都不碰时它显示「未授权」,值却是空的,按必填规则会被拦下、提示「请选择授权状态」—— 想建一个未授权的品牌,要把开关打开再关上。读代码的推断,本轮没有实跑(已登记)。

树的最外层多一个品牌。

窝窝有道电商中心 · 品牌中心 · 品牌信息管理超级管理员
查询重置
新增删除导入导出
数据统计:总数 3 | 商品 1 | 服务 2 | 国内品牌 3 | 国外品牌 0
品牌名称品牌类型状态排序操作
▾某某牌服务启用1
某某子品牌服务启用1
第 2 步

在父品牌那一行点行尾的「+」建子品牌

  1. 1行尾的「+」图标(只有图标,没有文字)
  2. 弹窗里没有「父品牌」一栏,新品牌自动挂在这一行下面
  3. 表单预填:排序 0、品牌类型「商品」、授权状态「未授权」、状态「启用」
  4. 字段顺序:品牌名称、品牌英文名、品牌别名、官方网站、状态、品牌产地、授权证书、授权到期日期、授权状态、品牌类型、排序、品牌简介、品牌Logo、备注(示意省略了其中六项,位置已标出)

这一行下面多一个子品牌。

新增

某某子品牌
请输入品牌英文名
请输入品牌别名(多个用逗号分隔)
请输入官方网站URL
启用

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

未授权
◉ 商品 ○ 服务
单选 · 数据库允许两者都选
0

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

取消确定
第 3 步

拨「状态」开关

  1. 1状态列的开关
  2. 2弹「确认切换状态」,内容「确定要将品牌 "某某牌" 的状态切换为 "禁用" 吗?」,点「确认」
  3. 没有「切换状态」权限的人只看到文字,拨不动

成功提示是「商品上架状态切换成功」—— 提示取的标签键 xModules.brand.status.toggleLabel 写的是「商品上架状态」,与品牌启停无关(已登记)。

确认切换状态

确定要将品牌 "某某牌" 的状态切换为 "禁用" 吗?

取消确认
04

场景 4 · 批量导入导出供应商

左栏列表头的两个图标按钮。导出与导入都是 YAML 整档:一家供应商连同它的联系人、证照、关联品牌一起进出。

谁来做
运营(需「导出供应商」「导入供应商」权限)
从哪进
供应商管理 › 左栏列表头的导出、导入图标
做什么
导出全部 → 改文件 → 导入回来,按企业全称认「这是哪一家」
做完的结果
新的新增、已有的覆盖;子表整组替换

① 流程图按企业全称认人,子表整组替换

导出全部供应商 · YAML 改文件后导入只收 YAML 「选择供应商」与存量比对、看校验 提交逐家新增或覆盖 证照图片被清空找不到的品牌名被丢掉
认人的键:主档按「企业全称」,联系人按「联系人 + 角色」,证照按「证照编号」,品牌按「品牌名称」。导入接口的证照子项不收图片字段,而证照是整组先删后建,所以已有证照的图片会在导入后变空、旧图片文件也不删;品牌名在品牌表里查不到的,会被静默丢掉。两条都是读代码的推断,本轮没有实跑。

② 怎么操作橙色圆圈 = 这一步要点的地方

第 1 步

点导出图标

  1. 1左栏列表头的下载箭头(只有图标、没有文字)
  2. 文件名是「供应商」加时间,格式只有 YAML
  3. 导出前按列权限剔掉当前角色看不到的列

下载一个 YAML 文件,每家供应商一段,内含联系人、资质证照、关联品牌。

第 2 步

点导入图标,选文件,在「选择供应商」里挑

  1. 1上传箭头,选刚改好的 YAML
  2. 弹出「选择供应商」网格(一行五家,按简称显示),可以「查看校验情况」
  3. 与存量比对时用的是全部导出数据;品牌候选取全部品牌平铺

看清哪些是新增、哪些会覆盖、哪些会被删。

第 3 步

提交

  1. 新增与覆盖都走同一个导入接口,一家一次;删除走删除接口
  2. 完成后左栏刷新

覆盖时联系人与证照是整组先删后建,证照图片不在导入字段里 —— 导一次,图片丢一次。确需导入时,导入后回详情页逐个补传证照图片。