品牌页挂在电商中心
菜单树里「品牌中心」是电商中心的子目录,而品牌数据属于本域(服务中心下的供给方)。本轮照实画,不改菜单。
SUPPLIER · 03 FRONTEND
两个后台页面、两种骨架:供应商管理是左列表、右详情,详情里挂三张可编辑的子表;品牌信息管理是一张树形列表。小程序端没有本域的页面。
自己的两个页面之外,还有两个别的模块借用本域的读取:服务管理与服务标准的「选供应商 / 品牌」弹窗。
| 界面 | 在哪 | 谁会看到 | 用到的函数 |
|---|---|---|---|
| 供应商管理 · 左栏列表 | /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,在那两个模块的聚合层里调用 |
| 小程序 | — | — | 零直接消费:只在商品读接口里按编号前缀带出名字与图标(归商品域) |
菜单树里「品牌中心」是电商中心的子目录,而品牌数据属于本域(服务中心下的供给方)。本轮照实画,不改菜单。
供应商字段多、子表多,用「左列表 + 右详情」;品牌字段少、有父子,用一张不分页的树形表。两种骨架的写法分别由 x-detail 与 x-curd 规范管。
详情页界面按「查询供应商」(supplier-read)的列权限把看不到的字段藏掉,这一层成立。缺口在接口:详情读 supplier-info-read 不做列过滤,返回体里仍带着全部列,打开开发者工具或直接调接口就能拿到(已登记)。
左栏 250 宽的列表,右栏选中那一家的详情。详情分上下两区,下面依次是「关联品牌」「联系人」「资质证照」三张表。
| 某某家电 某某家电服务有限公司 |
| 某某清洗 某某清洗服务有限公司 |
| 某某维修 某某维修服务有限公司 |
企业全称
某某家电服务有限公司
企业简称
某某家电
企业类型
有限责任公司
统一社会信用代码
91440300XXXXXXXXXX
营业执照有效期
无固定期限
注册地址
广东省 深圳市 南山区 · 某路 1 号
合作状态
试用期
服务模式
合作师傅(平台制)
覆盖区域
深圳市、东莞市
| 品牌Logo | 品牌名称 | 英文名称 | 别名 | 产地 | 品牌类型 | 授权状态 | 授权到期 | 官网 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| 图 | 某某牌 | MOUMOU | — | 国内 | 服务 | 否 | — | — | 启用 |
| # | 联系人 | 角色 | 手机号 | 主要联系人 | 邮箱 | 微信号 | 部门 | 职务 |
|---|---|---|---|---|---|---|---|---|
| 1 | 张某 | 业务对接 | 138****0000 | 是 | xxx@example.com | — | 商务部 | 经理 |
| # | 证照图片 | 证照类型 | 证照名称 | 证照编号 | 发证机构 | 发证日期 | 到期日期 | 承保金额 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | 图 | 营业执照 | 营业执照 | — | 某区市场监管局 | 2020-01-01 | — | — | 有效 |
点「编辑」之后整块变成表单,三张表底部各多出一行虚线加行。必填星号只标了企业全称与企业简称,其余数据库必填项在界面上看不出来。
| 品牌名称 | 状态 | 操作 |
|---|---|---|
| 某某牌 | 启用 | |
| + 关联 | ||
| # | 联系人 | 角色 | 主要联系人 | 操作 |
|---|---|---|---|---|
| 张某 | 业务对接 | 是 | ||
| + 新增一条数据 | ||||
| # | 证照图片 | 证照类型 | 状态 | 操作 |
|---|---|---|---|---|
| 图 | 营业执照 | 有效 | ||
| + 新增一条数据 | ||||
确定要删除该供应商吗?此操作不可撤销。
候选是全部品牌平铺,子品牌也在里面(早先只取树的外层、看不到子品牌,已改成平铺)。表格只显示「品牌名称」一列。
| 品牌名称 |
|---|
| 另一个牌子 |
| 某某子品牌 |
| 品牌名称 |
|---|
| 某某牌 |
上面是查询表单,下面一张树形表,不分页、整棵读出。「数据统计」与「新增 删除 导入 导出」在同一条工具栏里,排在按钮右边、占满剩余宽度。没有标题栏 —— 页面代码没有传表格标题,这里不画。
| 品牌Logo | 品牌名称 | 品牌英文名 | 品牌别名 | 品牌简介 | 品牌类型 | 品牌产地 | 官方网站 | 授权状态 | 状态 | 授权证书 | 授权到期日期 | 排序 | 备注 | 操作 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 图 | ▾某某牌 | MOUMOU | — | — | 服务 | 国内品牌 | — | 未授权 | 启用 | — | — | 1 | — | ||
| 图 | 某某子品牌 | — | — | — | 服务 | 国内品牌 | — | 未授权 | 启用 | — | — | 1 | — |
顶部「新增」、行尾「+」、行尾铅笔(编辑)三个表单字段几乎相同,差别在「父品牌」:只有顶部新增与编辑有这一栏,行尾「+」建的品牌自动挂在那一行下。下图是顶部「新增」,字段按代码里的真实顺序画,省略的六项在原位标出。
(示意省略:品牌产地、授权证书、授权到期日期)
(示意省略:品牌简介、品牌Logo、备注)
两个模块都住 x-admin/src/xModules/ 的顶层(不在电商或服务分组目录下),平级并列。
| 文件 | 行数 | 它负责什么 |
|---|---|---|
supplier/pages/supplier.tsx | 805 | 整页:21 条权限声明、上下两区字段与三张子表的配置、导入导出列、左栏列表、右栏详情 |
supplier/pages/supplier.less | 9 | 左右两栏的页面布局 |
supplier/services/supplier.api.ts | 564 | 21 个原子服务,与 21 个云函数一一对应 |
supplier/services/supplier.bff.ts | 291 | 详情聚合读(先读主档,再把三张子表的读并发发出,最后解析文件令牌)、聚合保存(逐个调)、保存适配器(地址坐标、区划序列化、子表模式守卫、重排) |
supplier/services/supplier.types.ts | 715 | 主档、联系人、证照的实体类型与各接口参数、返回类型 |
supplier/services/supplier.constants.ts | 163 | 六个下拉字段的色点映射;还在这里全局注册了「区划」「坐标」两种导入导出取值类型,注册一次别的模块也生效 |
supplier/services/supplier.mock.ts | 45 | 建页时的样例数据 |
supplier/components/supplier-brand-transfer/ | 198 | 关联品牌穿梭框:取全部品牌平铺、解析 Logo 令牌、只交回变更集 |
brand/pages/brand.tsx | 1106 | 查询表单与树形列表、顶部新增 / 行尾「+」新增 / 编辑三个表单、状态开关、导入导出、数据统计条、7 条权限声明 |
brand/pages/brand.less | 73 | 统计条配色等 |
brand/services/brand.api.ts | 193 | 7 个原子服务 |
brand/services/brand.bff.ts | 57 | 品牌树摊平成列表 —— 被供应商穿梭框、服务管理、服务标准三个模块借用,是本域对外的前端出口 |
brand/services/brand.types.ts 等 | 357 | 类型 271、样例 83、常量 3 |
服务管理与服务标准的聚合层直接引入品牌模块的平铺聚合与供应商模块的原子读,拿来做「选供应商 / 品牌」弹窗。改这两个函数的返回形状,要同时回看那两个模块。
「自有设备清单」「品类明细」有表字段、有导入导出列,详情页没有,后台界面上改不了。