两步走先两项起建,再在详情里补全
新增弹窗只有「企业全称」「企业简称」两项;其余四十来个字段、联系人、证照、品牌都在右栏详情里「编辑」后补。
一次保存子表改动攒到「保存」才提交
联系人、证照、关联品牌在编辑态里改的都只是暂存;点「取消」全部放弃。点「保存」才逐个调接口写库 —— 中间没有事务。
- 谁来做
- 运营(需「新增供应商」「编辑供应商」权限)
- 从哪进
- 服务中心 › 供应商中心 › 供应商管理(
/supplier/base) - 做什么
- 两项起建 → 编辑补全字段、地址、联系人、证照 → 保存
- 做完的结果
- 供应商主档一行 + 联系人、证照若干行;两组地址的坐标由后台自动算出
① 流程图起建与补全分两次写库
起建那一次只写主档一行(服务端补上排序号,合作状态不填则默认「待审核」)。补全那一次要调多个接口:主档、联系人、证照、证照图片、品牌绑定、重排 —— 任何一步失败,前面写进去的不回滚。
② 怎么操作橙色圆圈 = 这一步要点的地方
第 1 步进页面,点列表头的「+」
- 1顶栏「服务中心」,侧栏「供应商中心」下的「供应商管理」
- 2左栏列表头右侧的「+」图标按钮(没有「新增供应商」权限的人看不到它);旁边的上传箭头是导入、下载箭头是导出,数字是当前列表条数
- 搜索框的占位字是「输入供应商名字」,只按企业全称匹配,而列表每一条的大字是简称、小字是全称,左侧色条是合作状态(绿 / 黄 / 红),列表没有表头
- 面包屑「服务中心 · 供应商中心 · 供应商管理」在顶栏站点名右侧,内容区里没有面包屑
- 右栏没选中时显示「请从左侧选择供应商」
弹出「新增供应商」。
第 2 步填全称与简称,点「确定」
- 1「企业全称」必填
- 2「企业简称」必填 —— 对外显示用的是简称
- 3点「确定」
- 弹窗只有这两项;企业类型、服务类目、服务模式、覆盖区域、合作状态这几项数据库标为必填,但这里不收,服务端也不校验(已登记)
左栏多出这一家并自动选中,右栏出现它的详情(其余字段为空)。
第 3 步右栏点「编辑」,补齐资料
- 1右栏标题「供应商信息」旁的「编辑」
- 2上半区:企业全称、企业简称、成立日期、营业执照有效期、法定代表人、企业类型、统一社会信用代码、企业规模、注册资本、企业官网、注册地址(省市区 + 详细地址),右侧是 Logo
- 3下半区:企业介绍、合作状态、供应商分级 / 评级 / 来源、入驻日期、服务模式、人数与日均接单量、响应时长、派单优先级、我方经办人、经办人联系方式、区域经理、服务类目、实际办公地址、经营范围、备注、覆盖区域
- 合作状态选「暂停合作」或「终止合作」时,才多出一栏「禁用原因」
- 坐标不在表单里:两组地址的坐标在保存时由后台解析
此时的改动只在页面上,还没写库。
第 4 步在「联系人」「资质证照」表里加行
- 1编辑态下表格底部的「新增一条数据」虚线行,点一次在末尾加一行
- 2也可以点某一行「操作」列里的「+」图标,在这一行下面插入一行
- 3「操作」列的垃圾桶图标是删除:只打上删除标记(整行变红、划删除线),图标换成撤销,点撤销就恢复;点保存时才真正删掉。新加的空行点删除直接消失
- 联系人列:联系人、角色、手机号、主要联系人、邮箱、微信号、部门、职务;手机号与邮箱有格式校验
- 资质证照列:证照图片、证照类型、证照名称、证照编号、发证机构、发证日期、到期日期、承保金额、状态
- 「#」列在只读态是序号,编辑态换成拖拽手柄,拖动换顺序,保存时一并落库
新加的行带临时编号,保存时才变成真实记录。
第 5 步点「保存」
- 1右栏标题旁的「保存」
- 表单没填对时提示「请检查表单填写是否完整或格式是否正确」,一次都不写库
- 通过后提示「保存成功」,左栏刷新
保存是逐个接口调的:改主档 → 联系人增改删 → 证照增改删(带图的新证照先建、再传图、再回写图片)→ 绑品牌 → 解绑品牌 → 重排。中途任何一步失败,前面已经写进去的不会撤回,页面会报错但数据已部分落库。
- 谁来做
- 运营(需「关联品牌」「解绑品牌」权限)
- 从哪进
- 供应商管理 › 选中一家 › 「编辑」
- 做什么
- 点「关联」→ 在穿梭框里把品牌挪到「已选」→ 确定 → 保存
- 做完的结果
- 绑定表增删若干行(这家公司持有哪些品牌)
① 流程图穿梭框只交回「加了谁、去了谁」
候选列表取的是全部品牌平铺(含子品牌、含已禁用的品牌),按品牌名、英文名、编号都能搜。保存时绑定接口会先查「这一对是不是已经绑过」,绑过就报「以下品牌已绑定,请勿重复绑定」。
② 怎么操作橙色圆圈 = 这一步要点的地方
第 1 步编辑态下点「+ 关联」
- 1「关联品牌」表底部的「关联」虚线行;行上「操作」列的「+」图标打开的是同一个穿梭框
- 2行上的垃圾桶图标等于解绑:原本就绑着的品牌打上删除标记、可以撤销,保存时才解绑;这次刚挑进来的直接从表里拿掉
- 只读态下虚线行与「操作」列都不出现;这张表没有序号列,不能拖动排序;表格列:品牌Logo、品牌名称、英文名称、别名、产地、品牌类型、授权状态、授权到期、官网、状态(示意省略了其中几列)
弹出穿梭框「关联品牌」。
第 2 步在穿梭框里挑品牌,点「确定」
- 1左边「待选」、右边「已选」,勾上后挪到右边
- 2搜索框「请输入搜索内容」,按品牌名、英文名、编号匹配
- 3点「确定」
- 从右边挪回左边就是解绑
「关联品牌」表立刻按新选择显示,但还没写库。
第 3 步点详情页的「保存」
- 1右栏标题旁的「保存」
- 新挪进来的一次性绑定,挪出去的一次性解绑
- 点「取消」则这次的挑选全部作废
绑定接口不检查这家供应商和这些品牌是否真实存在、是否已禁用 —— 界面上挑出来的都存在,风险在于直接调接口的人(已登记)。
- 谁来做
- 运营(需「新增品牌」「更新品牌」「切换状态」权限)
- 从哪进
- 电商中心 › 品牌中心 › 品牌信息管理(
/brand/base) - 做什么
- 顶部「新增」建根品牌;某一行点行尾的「+」图标建它的子品牌;拨状态开关
- 做完的结果
- 品牌表增删改;工具栏里的「数据统计」随之变化
① 流程图两个入口建品牌,一个开关管启停
顶部「新增」里的「父品牌」下拉只列根品牌(取的是树的最外层,而且只在页面打开时读一次、之后不刷新),所以要把品牌挂在子品牌下,只能到那一行点行尾的「+」图标。状态切换不影响下游:禁用的品牌照样出现在供应商的关联候选、商品的供给方选择里。
② 怎么操作橙色圆圈 = 这一步要点的地方
第 1 步顶部「新增」建根品牌
- 1顶栏「电商中心」,侧栏「品牌中心」下的「品牌信息管理」;面包屑「电商中心 · 品牌中心 · 品牌信息管理」在顶栏站点名右侧
- 2表格工具栏最左边的「新增」
- 表格上方是查询表单:品牌名称、品牌类型、品牌产地、授权状态、状态五项,加「查询」「重置」
- 「数据统计」与「新增 删除 导入 导出」在同一条工具栏里,排在按钮右边、占满剩余宽度;每行最右是「+」、铅笔、垃圾桶三个图标(示意省略了表格的部分列)
- 「品牌名称」「状态」「品牌类型」「授权状态」「排序」必填;「品牌类型」是单选(商品 / 服务),提交时包成一个元素的数组
- 「父品牌」留空就是根品牌
「授权状态」是一个开关,这张顶部新增表单没有给它初始值(行尾「+」那张给了「未授权」)。开关一次都不碰时它显示「未授权」,值却是空的,按必填规则会被拦下、提示「请选择授权状态」—— 想建一个未授权的品牌,要把开关打开再关上。读代码的推断,本轮没有实跑(已登记)。
树的最外层多一个品牌。
第 2 步在父品牌那一行点行尾的「+」建子品牌
- 1行尾的「+」图标(只有图标,没有文字)
- 弹窗里没有「父品牌」一栏,新品牌自动挂在这一行下面
- 表单预填:排序 0、品牌类型「商品」、授权状态「未授权」、状态「启用」
- 字段顺序:品牌名称、品牌英文名、品牌别名、官方网站、状态、品牌产地、授权证书、授权到期日期、授权状态、品牌类型、排序、品牌简介、品牌Logo、备注(示意省略了其中六项,位置已标出)
这一行下面多一个子品牌。
新增
(示意省略:品牌产地、授权证书、授权到期日期)
(示意省略:品牌简介、品牌Logo、备注)
第 3 步拨「状态」开关
- 1状态列的开关
- 2弹「确认切换状态」,内容「确定要将品牌 "某某牌" 的状态切换为 "禁用" 吗?」,点「确认」
- 没有「切换状态」权限的人只看到文字,拨不动
成功提示是「商品上架状态切换成功」—— 提示取的标签键 xModules.brand.status.toggleLabel 写的是「商品上架状态」,与品牌启停无关(已登记)。
确认切换状态
确定要将品牌 "某某牌" 的状态切换为 "禁用" 吗?
- 谁来做
- 运营(需「导出供应商」「导入供应商」权限)
- 从哪进
- 供应商管理 › 左栏列表头的导出、导入图标
- 做什么
- 导出全部 → 改文件 → 导入回来,按企业全称认「这是哪一家」
- 做完的结果
- 新的新增、已有的覆盖;子表整组替换
① 流程图按企业全称认人,子表整组替换
认人的键:主档按「企业全称」,联系人按「联系人 + 角色」,证照按「证照编号」,品牌按「品牌名称」。导入接口的证照子项不收图片字段,而证照是整组先删后建,所以已有证照的图片会在导入后变空、旧图片文件也不删;品牌名在品牌表里查不到的,会被静默丢掉。两条都是读代码的推断,本轮没有实跑。
② 怎么操作橙色圆圈 = 这一步要点的地方
第 1 步点导出图标
- 1左栏列表头的下载箭头(只有图标、没有文字)
- 文件名是「供应商」加时间,格式只有 YAML
- 导出前按列权限剔掉当前角色看不到的列
下载一个 YAML 文件,每家供应商一段,内含联系人、资质证照、关联品牌。
第 2 步点导入图标,选文件,在「选择供应商」里挑
- 1上传箭头,选刚改好的 YAML
- 弹出「选择供应商」网格(一行五家,按简称显示),可以「查看校验情况」
- 与存量比对时用的是全部导出数据;品牌候选取全部品牌平铺
看清哪些是新增、哪些会覆盖、哪些会被删。
第 3 步提交
- 新增与覆盖都走同一个导入接口,一家一次;删除走删除接口
- 完成后左栏刷新
覆盖时联系人与证照是整组先删后建,证照图片不在导入字段里 —— 导一次,图片丢一次。确需导入时,导入后回详情页逐个补传证照图片。