MFR 生产商专项用例
文档编号：DOC-A09-07 / UAT-MFR
版本：V1.0
创建日期：2026-08-18
维护人：听写（DT）/ TL
关联文档：README、01-测试账号清单、CPT-D V3.0、DIP1-API V3.0、DIP1-PROTO V3.0 §七 MFR 门户
一、文档定位
本文档覆盖生产商端（MFR-Portal）Web 门户主动操作的全流程用例，MFR 通过 Web 端管理产品目录、批量创建订单、查看订单进度、月度对账结算、API Key 集成测试等。本用例集聚焦 MFR 视角的业务闭环。
用例列表：
| 用例 |
名称 |
MFR |
涉及端 |
主流程 |
起始 |
终止 |
| UC-19 |
MFR 产品目录管理 + SKU 创建 |
mfr_01 宜居家居 |
MFR-Portal + OPR-Admin |
产品创建→审核→上架 |
草稿 |
上架 |
| UC-20 |
MFR 批量创建订单（Excel 导入） |
mfr_01 宜居家居 |
MFR-Portal + OPR-Admin |
模板下载→批量导入→线索创建 |
L1 |
L2 |
| UC-21 |
MFR 订单进度查看 + 全流程追踪 |
mfr_02 优品家电 |
MFR-Portal |
订单列表→时间轴→物流轨迹→安装照片 |
L1 |
L8 |
| UC-22 |
MFR 月度对账 + API Key 集成 |
mfr_02 优品家电 |
MFR-Portal + API |
对账统计→明细核对→导出→API 调用 |
— |
— |
共性特征：
- 仅 MFR 角色登录 MFR-Portal Web 端（mfr-portal，端口 3001，Next.js 14 SSR）
- 触发 L1 线索：B2B2C 模式 MFR 委托下单，OL 后续介入确认
- RLS 行级安全：MFR 仅可见自己委托的产品（ppl_products.mfr_id）与订单（cpt_orders.mfr_id）
- 8 页门户结构：MFR-DASH / MFR-PROD-01 / MFR-PROD-02 / MFR-PROD-03 / MFR-ORD-01 / MFR-ORD-02 / MFR-ACC-01 / MFR-SET-01
二、UC-19：MFR 产品目录管理 + SKU 创建
2.1 基本信息
| 项 |
值 |
| 用例编号 |
UC-19 |
| 场景类型 |
标准流程（Happy Path） |
| 业务模式 |
MFR B2B2C（MFR 创建产品供客户下单） |
| 起始阶段 |
草稿创建 |
| 终止阶段 |
上架可售（CPL/SCL 联动） |
| MFR 账号 |
mfr_01（宜居家居有限公司，MFR-001，观塘仓） |
| 运营账号 |
ol_01（黄运营，负责产品审核） |
| API Key |
mfr_yijv_a1b2c3d4e5f6（已在 MFR-SET-01 预置） |
| 关联主数据 |
PPL 产品库、SCL 安装服务特征库、HS 编码库（9401/9403/9404） |
2.2 业务数据
| 数据项 |
值 |
说明 |
| MFR 公司全称 |
宜居家居有限公司 |
MFR-001 |
| 总部地址 |
香港九龙观塘开源道 55 号 |
观塘仓所在地 |
| 产品 SKU |
FURN-05 |
餐桌（新增 SKU，沿用 FURN-NN 命名） |
| 产品名称 |
北欧实木餐桌 1.4m |
4-6 人位 |
| 品类编码 |
CAT-01 家具组装 |
P0 品类 |
| 细分类目 |
FURN-05 餐桌 |
关联 SCL 安装服务 |
| HS 编码 |
9403.10 |
木质家具（餐桌归类） |
| 重量 |
28 kg |
含包装 |
| 体积 |
0.8 m³ |
1.4×0.8×0.7m（折叠后包装） |
| 基础安装费率 |
HKD 250/h |
与 SCL FURN 类目基础费率对齐 |
| 预估安装工时 |
1.5 h |
标准餐桌组装工时 |
| 建议零售价 |
HKD 2,880 |
MFR 建议价（不影响平台报价） |
| 库存数量 |
50 件 |
观塘仓库存 |
| 产品图片 |
5 张（主图 1 + 细节图 4） |
JPG/PNG，单张 ≤3MB |
| 审核要求 |
OL 必审 |
新建产品默认需运营审核 |
2.3 用例步骤
| 步骤 |
操作角色 |
系统端 |
操作内容 |
预期结果 |
| Step 1 |
MFR（mfr_01） |
MFR-Portal |
浏览器打开 https://uat.mfr.weavely.hk，输入用户名 mfr_01 + 密码 Test@2026（已通过强制改密流程），点击"登录"按钮 |
成功登录，跳转至 MFR-DASH 品牌驾驶舱首页，右上角显示"宜居家居"账户名 + 顶栏 🔔 订单通知红点为 0 |
| Step 2 |
MFR（mfr_01） |
MFR-Portal |
点击左侧导航"产品管理 → 产品目录"（路由 /products，页面 ID：MFR-PROD-01），进入产品目录卡片网格视图 |
显示 mfr_01 现有 35 个 SKU 卡片（含 FURN-01 床架、FURN-02 衣柜等），筛选器：品类 / 系列 / 状态默认全部，右上角有"新建产品"按钮 |
| Step 3 |
MFR（mfr_01） |
MFR-Portal |
点击右上角"新建产品"按钮，弹出新建产品抽屉表单（右侧滑出 Drawer，宽度 480px） |
表单字段：基本信息 / HS 编码 / 规格参数 / 价格与库存 / 安装配置 / 图片上传 6 个分组 |
| Step 4 |
MFR（mfr_01） |
MFR-Portal |
填写"基本信息"：①产品名称 北欧实木餐桌 1.4m；②品类下拉选择 CAT-01 家具；③细分类目下拉选择 FURN-05 餐桌；④产品描述 4-6 人位，E1 级环保板材 |
字段必填校验通过，下方出现 SCL 联动提示："已匹配家具类安装费率 HKD 250/h" |
| Step 5 |
MFR（mfr_01） |
MFR-Portal |
填写"HS 编码"：点击 HS 编码输入框（带搜索图标），输入 9403，下拉显示 HS 编码库匹配项 9403.10 木质家具、9403.30 木制办公家具，选择 9403.10 |
HS 编码自动填充至输入框，关联字段"申报中文品名"自动带出"木质家具"，"申报要素"列出 5 项要素提示 |
| Step 6 |
MFR（mfr_01） |
MFR-Portal |
填写"规格参数"：①重量 28 kg；②长 × 宽 × 高 1.4 × 0.8 × 0.7 m（自动算出体积 0.784 m³，系统四舍五入显示 0.8 m³）；③条码 4700000000517（EAN-13 校验通过）；④材质 实木+板材 |
体积自动计算正确，条码红框变绿色（校验通过） |
| Step 7 |
MFR（mfr_01） |
MFR-Portal |
填写"安装配置"：①基础安装费率 250 HKD/h（默认锁定为 SCL 费率，灰显不可改）；②预估工时 1.5 h；③安装难度等级 2-中等（影响 WPL 派单系数） |
安装费率灰显提示"对齐 SCL FURN 类目费率"，难度等级下拉显示 5 档 |
| Step 8 |
MFR（mfr_01） |
MFR-Portal |
填写"价格与库存"：①建议零售价 2880 HKD；②仓库下拉选择 观塘仓；③初始库存 50 件；④安全库存阈值 10 件（低于将预警） |
库存数字下方提示"将同步至 MFR-PROD-03 库存看板" |
| Step 9 |
MFR（mfr_01） |
MFR-Portal |
上传"产品图片"：①点击"主图"上传框，选择 furn05_main.jpg（1.8MB）；②依次上传 4 张细节图 furn05_detail1.jpg～furn05_detail4.jpg（每张约 1.2-2.5MB）；③拖拽主图至首位（标记"封面"） |
5 张图片上传完成，进度条 100% 后显示缩略图，左上角红色"封面"角标出现在主图上 |
| Step 10 |
MFR（mfr_01） |
MFR-Portal |
点击底部"保存草稿"按钮 → 弹出确认提示"产品已保存为草稿，是否提交审核？"→ 点击"提交审核" |
表单关闭，产品目录列表新增卡片状态标签 待审核（橙色），系统自动推送通知至 ol_01 工作台，ol_01 OPR-Admin "产品审核" 任务池新增一条 |
| Step 11 |
运营（ol_01） |
OPR-Admin |
ol_01 登录运营后台，进入"主数据管理 → 产品审核"页面，找到"北欧实木餐桌 1.4m"待审记录，点击"审核"→ 弹出审核详情面板，核对 HS 编码 9403.10 / 重量 28kg / 安装费率 250/h / 图片清晰度 → 点击"审核通过" |
审核状态变更为 已通过，触发后端事件：①PPL 库写入 SKU FURN-05，状态 ACTIVE；②CPL 同步新增产品标签"餐桌"；③SCL 联动更新 FURN 类目 SKU 列表 |
| Step 12 |
MFR（mfr_01） |
MFR-Portal |
mfr_01 在 MFR-Portal 收到 WebSocket 实时通知（🔔 红点+1），进入 MFR-PROD-01 产品目录，查看 FURN-05 卡片 |
卡片状态标签变更为 已上架（绿色），上架时间 2026-08-18 14:32；点击卡片进入详情，Tab 页"基本信息/SKU 列表/价格历史/库存状态"信息齐全 |
2.4 预期产出
| 产出物 |
说明 |
| 产品记录（PPL） |
SKU FURN-05，状态 ACTIVE，归属 mfr_01 |
| HS 编码申报要素 |
9403.10 木质家具，5 项申报要素齐备 |
| 5 张产品图片 |
主图 1 + 细节图 4，已上传至 Cloudflare R2 |
| 审核工单 |
ol_01 审核通过记录（时间戳 + 操作人 + 备注） |
| CPL/SCL 联动 |
客户端 CPL 标签新增"餐桌"可选类目；SCL FURN 类目 SKU 列表更新 |
| 库存记录 |
观塘仓 FURN-05 初始库存 50 件，安全阈值 10 件 |
2.5 关键验证点
| 验证项 |
说明 |
| HS 编码校验 |
输入 9403 后下拉应匹配出 9403.10/9403.30 等子项；不允许手填非 HS 库中的编码 |
| 体积自动计算 |
长×宽×高输入后体积应自动算出并显示 m³（验证 1.4×0.8×0.7=0.784≈0.8） |
| SCL 费率锁定 |
基础安装费率字段灰显，强制对齐 SCL FURN 类目 250 HKD/h，MFR 不可擅自改 |
| 图片大小校验 |
单张 >3MB 应拒绝上传并提示"图片不可超过 3MB" |
| 审核流程闭环 |
草稿→待审核→已上架 三态切换需有审核工单流转记录 |
| 上架后 CPL 联动 |
客户端 cus_01 下单时，"家具组装"品类下应出现 FURN-05 餐桌选项 |
| 上架后 SCL 联动 |
SCL 安装服务特征库 FURN 类目 SKU 列表应自动新增 FURN-05 |
| RLS 数据隔离 |
mfr_01 仅可见自己创建的 FURN-05；mfr_02 登录不应看到 mfr_01 的产品 |
| WebSocket 通知 |
ol_01 审核通过后，mfr_01 应在 1s 内收到 🔔 实时推送 |
三、UC-20：MFR 批量创建订单（Excel 导入）
3.1 基本信息
| 项 |
值 |
| 用例编号 |
UC-20 |
| 场景类型 |
标准流程（Happy Path） |
| 业务模式 |
MFR 批量委托下单（B2B2C） |
| 起始阶段 |
L1 线索获取 |
| 终止阶段 |
L2 需求确认（OL 批量确认） |
| MFR 账号 |
mfr_01（宜居家居） |
| 运营账号 |
ol_01（黄运营） |
| 物流商 |
lgp_01（速达物流，本地配送） |
| 批量规模 |
5 笔订单（cus_01/cus_02/cus_03 + 2 名新客户） |
3.2 业务数据
| 数据项 |
值 |
说明 |
| Excel 模板字段 |
12 列 |
订单号(MFR自编)/客户姓名/联系电话/WhatsApp/收货地址/区域/楼宇类型/楼层/产品 SKU/数量/期望时段/备注 |
| 订单 1 |
cus_01 王先生 |
FURN-03 沙发 ×1，中环某某花园 28F，2026-08-22 10:00-13:00 |
| 订单 2 |
cus_02 张女士 |
FURN-02 床架 ×1，旺角某某街 33 号唐楼 5F，2026-08-22 14:00-17:00 |
| 订单 3 |
cus_03 李小姐 |
FURN-05 餐桌 ×1（UC-19 上架产品），元朗某某村 12 号，2026-08-23 10:00-12:00 |
| 订单 4 |
新客户 cus_04 林先生 |
FURN-01 床架 ×2，九龙湾某某广场 15F，2026-08-23 14:00-17:00 |
| 订单 5 |
新客户 cus_05 周女士 |
FURN-04 衣柜 ×1，将军澳某某居屋 22F，2026-08-24 10:00-13:00 |
| 生成订单号 |
ORD-20260822-001~003、ORD-20260823-001、ORD-20260824-001 |
系统按送达日期生成 |
| 校验规则 |
5 类 |
电话格式（+852-XXXX-XXXX）/ 地址非空 / SKU 存在性 / 区域合法 / 时段格式 |
3.3 用例步骤
| 步骤 |
操作角色 |
系统端 |
操作内容 |
预期结果 |
| Step 1 |
MFR（mfr_01） |
MFR-Portal |
mfr_01 登录 MFR-Portal，进入"订单通知 → 订单通知列表"（路由 /orders，页面 ID：MFR-ORD-01），点击右上角"批量导入订单"按钮 → 弹出批量导入向导弹窗（Step 1/3 下载模板） |
向导显示模板下载区，列出 12 个字段说明，提供"下载 Excel 模板"和"下载示例文件"两个按钮 |
| Step 2 |
MFR（mfr_01） |
本地 Excel |
点击"下载 Excel 模板"按钮，浏览器下载 mfr_order_template_v1.2.xlsx（约 28KB），打开 Excel 查看模板字段 |
Sheet1 包含 12 列表头（含批注说明），Sheet2 为"楼宇类型代码表"参考（ESS/HOS/PRH/COM/TONG/VIL/LUX 7 类），Sheet3 为"产品 SKU 速查表"（mfr_01 在售 35 SKU） |
| Step 3 |
MFR（mfr_01） |
本地 Excel |
在模板 Sheet1 填写 5 笔订单数据：①cus_01 王先生，沙发 FURN-03 ×1，地址"中环某某道 88 号某某花园 28F"；②cus_02 张女士，床架 FURN-02 ×1，旺角唐楼 5F；③cus_03 李小姐，餐桌 FURN-05 ×1，元朗村屋；④林先生新客户，床架 FURN-01 ×2；⑤周女士新客户，衣柜 FURN-04 ×1；保存为 mfr01_orders_20260818.xlsx |
5 笔订单数据填写完毕，电话格式 +852-XXXX-XXXX，时段格式 YYYY-MM-DD HH:MM-HH:MM |
| Step 4 |
MFR（mfr_01） |
MFR-Portal |
回到 MFR-Portal 批量导入向导 Step 2/3，点击"选择文件"按钮 → 选择本地 mfr01_orders_20260818.xlsx → 点击"上传并校验" |
上传进度条 0→100%，后端解析 Excel 调用 POST /mfr/products/batch-import 类似逻辑，校验中显示转圈动画 |
| Step 5 |
系统（SYS） |
后端 |
系统执行 5 类校验：①电话格式正则匹配 ^\+852-\d{4}-\d{4}$；②地址非空且匹配 BPL 楼宇库（如"某某花园"→ESS）；③SKU 存在性（FURN-01~05 均在 mfr_01 产品目录）；④区域合法（港岛/九龙/新界/离岛）；⑤时段格式校验 |
5 笔订单全部校验通过，向导 Step 3/3 显示校验结果摘要："5 笔订单全部校验通过，0 笔错误" |
| Step 6 |
MFR（mfr_01） |
MFR-Portal |
mfr_01 在向导 Step 3/3 查看校验结果明细（5 笔订单逐行显示：客户名/SKU/数量/地址/时段/校验状态✅），点击"确认批量创建"按钮 |
系统显示创建进度（5/5 完成），完成后弹出成功提示"已成功创建 5 笔订单线索"，订单号列表 ORD-20260822-001~003、ORD-20260823-001、ORD-20260824-001 |
| Step 7 |
系统（SYS） |
后端 |
系统为 5 笔订单分别创建 L1 线索记录，每条线索包含：mfr_id=MFR-001、来源=MFR 批量导入、客户信息、产品 SKU、期望时段；推送通知至 ol_01 OPR-Admin 线索池 |
5 条 L1 线索入 OPS-01 线索池，状态 L1_PENDING，ol_01 工作台"待处理线索"角标 +5；同步推送 WhatsApp 通知至 cus_01/02/03 三位已有客户 |
| Step 8 |
运营（ol_01） |
OPR-Admin |
ol_01 登录运营后台，进入"线索池"，筛选来源=MFR 批量导入 且 mfr_id=MFR-001，看到 5 条线索；勾选全部 → 点击"批量确认需求" → 弹出批量确认面板，逐条核对品类/地址/时段后点击"确认" |
5 条线索 L1 → L2 流转，状态 L2_CONFIRMED，系统自动触发 L3 报价流程；mfr_01 在 MFR-ORD-01 订单通知列表看到 5 条订单状态从"待确认"变为"已确认" |
3.4 Excel 模板字段定义
| 列号 |
字段名 |
类型 |
必填 |
校验规则 |
示例 |
| A |
mfr_ref_no |
文本 |
否 |
MFR 自编号，便于内部对账 |
MFR01-ORD-001 |
| B |
customer_name |
文本 |
是 |
2-30 字符 |
王先生 |
| C |
phone |
文本 |
是 |
正则 ^\+852-\d{4}-\d{4}$ |
+852-9123-4567 |
| D |
whatsapp |
文本 |
否 |
同电话格式，缺省同 C |
+852-9123-4567 |
| E |
address |
文本 |
是 |
含楼宇名+楼层 |
中环某某花园 28F |
| F |
region |
枚举 |
是 |
港岛/九龙/新界/离岛 |
港岛 |
| G |
building_type |
枚举 |
是 |
ESS/HOS/PRH/COM/TONG/VIL/LUX |
ESS |
| H |
floor |
文本 |
是 |
数字+F 或 G |
28F |
| I |
product_sku |
文本 |
是 |
必须在 mfr 产品目录中 |
FURN-03 |
| J |
quantity |
数字 |
是 |
1-99 整数 |
1 |
| K |
expected_slot |
文本 |
是 |
YYYY-MM-DD HH:MM-HH:MM |
2026-08-22 10:00-13:00 |
| L |
remark |
文本 |
否 |
≤200 字符 |
客户要求周六送达 |
3.5 预期产出
| 产出物 |
说明 |
| 5 条 L1 线索 |
来源标记 MFR 批量导入，含 mfr_id 关联 |
| 5 个订单号 |
ORD-20260822-001~003、ORD-20260823-001、ORD-20260824-001 |
| 校验报告 |
5 笔通过 / 0 笔失败（如失败将列出失败原因） |
| WhatsApp 通知 |
已有客户 cus_01/02/03 收到下单确认通知 |
| OL 批量确认工单 |
ol_01 操作记录含 5 条批量确认时间戳 |
3.6 关键验证点
| 验证项 |
说明 |
| Excel 模板字段 |
12 列字段定义是否齐全，含必填/选填标识与批注说明 |
| 电话格式校验 |
错误格式（如 91234567 缺 +852- 前缀）应被拦截并提示 |
| SKU 存在性校验 |
填写 mfr_01 不存在的 SKU（如 APPL-01）应被拦截 |
| 楼宇库自动匹配 |
地址含"某某花园"应自动匹配 BPL 库 ESS 类型 |
| 错误提示友好度 |
校验失败时 Excel 中应高亮错误行+错误列，并附具体原因 |
| 批量创建效率 |
5 笔订单应在 ≤5s 内完成批量创建，不应阻塞 UI |
| WebSocket 推送 |
创建完成后 ol_01 应在 1s 内收到工作台角标更新 |
| 批量 vs 单笔 |
批量导入流程不应跳过任何 L1→L2 必备字段采集 |
| 新客户识别 |
cus_04/05 为新客户，系统应自动创建 CPL 客户档案并标记"来源 MFR 推送" |
四、UC-21：MFR 订单进度查看 + 全流程追踪
4.1 基本信息
| 项 |
值 |
| 用例编号 |
UC-21 |
| 场景类型 |
标准流程（MFR 视角只读追踪） |
| 业务模式 |
MFR B2B2C 跨境配送+安装 |
| 起始阶段 |
L1（订单已存在） |
| 终止阶段 |
L8（仅查看，不操作） |
| MFR 账号 |
mfr_02（优品家电，MFR-002，深圳+屯门仓） |
| 示例订单 |
ORD-20260820-005（跨境空调配送+安装给 cus_03） |
| 物流商 |
lgp_02（跨境快线，中港牌粤 ZB1234 港） |
| 师傅 |
wkr_02（李师傅，家电 5/5） |
4.2 业务数据
| 数据项 |
值 |
说明 |
| 订单号 |
ORD-20260820-005 |
2026-08-20 第 5 笔订单 |
| 客户 |
cus_03 李小姐 |
元朗某某村 12 号（VIL 村屋 1.8 系数） |
| 产品 SKU |
APPL-01 |
分体式空调 1.5 匹（深圳仓出库） |
| 配送模式 |
跨境配送 |
深圳仓 → 福田口岸 → 元朗 |
| HS 编码 |
8415.10 |
空调整机 |
| 配送阶段 |
L5.1~L5.4 |
接单→提货→跨境配送→签收 |
| 安装阶段 |
L6.1~L6.5 |
接单→上门→安装→清场→交付 |
| 当前状态 |
L6.3 安装作业中 |
用于本用例的查看时点 |
4.3 用例步骤
| 步骤 |
操作角色 |
系统端 |
操作内容 |
预期结果 |
| Step 1 |
MFR（mfr_02） |
MFR-Portal |
mfr_02 登录 MFR-Portal（用户名 mfr_02 + 密码 Test@2026），进入 MFR-DASH 品牌驾驶舱，查看核心 KPI 卡片：在售 SKU 22 / 本月订单 38 / 本月营收 HKD 145,200 / 库存预警 1（深圳仓 APPL-03 缺货） |
顶栏 🔔 订单通知红点为 3，左侧导航 8 项可见，主区域显示近期订单时间线（最近 7 天 12 笔） |
| Step 2 |
MFR（mfr_02） |
MFR-Portal |
点击左侧"订单通知 → 订单通知列表"（路由 /orders，页面 ID：MFR-ORD-01），进入订单列表页 |
列表显示 mfr_02 委托的 38 笔订单（仅 mfr_02 的，RLS 隔离生效），列：订单号/产品/数量/金额/状态/下单时间；筛选器：状态（全部/待确认/已确认/已发货/已完成）+ 时间范围 |
| Step 3 |
MFR（mfr_02） |
MFR-Portal |
在搜索框输入 ORD-20260820-005，点击查询；列表过滤后只剩 1 行；点击该行订单号超链接 |
跳转至 MFR-ORD-02 订单详情页（路由 /orders/ORD-20260820-005） |
| Step 4 |
MFR（mfr_02） |
MFR-Portal |
在订单详情页查看"订单头"区：订单号 ORD-20260820-005 / 客户姓名（脱敏显示 李*姐）/ 收货地址 新界元朗某某村 12 号 / 金额 HKD 3,200 / 状态 L6.3 安装作业中 |
客户电话脱敏（中间 4 位显示 ****），地址完整可见（MFR 需配送），状态徽章为蓝色"进行中" |
| Step 5 |
MFR（mfr_02） |
MFR-Portal |
点击详情页中部"时间轴"Tab（默认展开），查看 L1-L8 各阶段时间戳 + 操作人 |
时间轴垂直展示 8 个阶段节点，已完成阶段为绿色✅+时间戳+操作人，进行中阶段为蓝色⏳+预计完成时间，未开始阶段为灰色⏸ |
| Step 6 |
MFR（mfr_02） |
MFR-Portal |
在时间轴 L5.3 节点点击"查看物流轨迹"链接 → 弹出物流轨迹地图模态框 |
地图显示 lgp_02 货车 GPS 轨迹：①深圳福田仓（起点）；②福田口岸（清关 8-19 09:15）；③香港元朗（送达 8-19 14:30）；④客户地址（签收 8-19 15:10）；轨迹时间戳与里程数完整 |
| Step 7 |
MFR（mfr_02） |
MFR-Portal |
关闭地图模态框，点击时间轴 L6.3 节点"查看安装照片"链接 → 弹出安装照片画廊（Gallery）组件 |
显示 wkr_02 上传的实时照片：①入户前照片（08-19 15:20）；②穿鞋套照片；③地面保护垫；④空调内机定位（进行中）；右下角显示"师傅上传中..."实时状态 |
| Step 8 |
MFR（mfr_02） |
MFR-Portal |
关闭画廊，在订单详情页底部查看"商品列表"+"物流信息"区域：商品 APPL-01 ×1 / 单价 HKD 2,880 / 物流单号 LGP02-WAY-20260819001 / 配送方式 跨境 / 物流商 跨境快线 / 预计送达 2026-08-19 14:00 |
物流单号可点击复制，物流商字段带"粤 ZB1234 港"中港车牌标识 |
4.4 时间轴明细（L1-L8）
| 阶段 |
状态 |
时间戳 |
操作人 |
关键产出 |
| L1 线索获取 |
✅ 完成 |
2026-08-18 10:25 |
mfr_02（批量导入） |
线索来源：MFR 委托 |
| L2 需求确认 |
✅ 完成 |
2026-08-18 11:30 |
ol_01 黄运营 |
需求确认单 |
| L3 报价生成 |
✅ 完成 |
2026-08-18 11:45 |
SYS |
报价单 HKD 3,200 |
| L4 签约下单 |
✅ 完成 |
2026-08-18 14:20 |
cus_03 李小姐 |
电子签约 |
| L5.1 物流接单 |
✅ 完成 |
2026-08-19 08:30 |
lgp_02 司机王师傅 |
物流单号 |
| L5.2 物流提货 |
✅ 完成 |
2026-08-19 09:00 |
lgp_02 |
提货照片×3 |
| L5.3 跨境配送 |
✅ 完成 |
2026-08-19 14:30 |
lgp_02 |
GPS 轨迹+清关文件 |
| L5.4 签收确认 |
✅ 完成 |
2026-08-19 15:10 |
cus_03 |
签收照片+签字 |
| L6.1 师傅接单 |
✅ 完成 |
2026-08-19 15:15 |
wkr_02 李师傅 |
接单确认 |
| L6.2 上门准备 |
✅ 完成 |
2026-08-19 15:25 |
wkr_02 |
穿鞋套+地面保护照片 |
| L6.3 安装作业 |
⏳ 进行中 |
2026-08-19 15:30 起 |
wkr_02 |
内机定位进行中 |
| L6.4 完工清场 |
⏸ 待开始 |
预计 17:00 |
wkr_02 |
— |
| L6.5 交付说明 |
⏸ 待开始 |
预计 17:15 |
wkr_02 |
— |
| L7 验收交付 |
⏸ 待开始 |
预计 17:30 |
cus_03 |
— |
| L8 售后回访 |
⏸ 待开始 |
预计 8-26 |
ol_01 |
NPS 采集 |
4.5 预期产出
| 产出物 |
说明 |
| MFR 视角订单列表 |
仅 mfr_02 委托的 38 笔订单（RLS 隔离） |
| 时间轴完整记录 |
L1-L8 共 15 个节点（含子节点）时间戳 + 操作人 |
| 物流 GPS 轨迹 |
跨境配送 4 个关键节点 + 完整轨迹图 |
| 安装照片画廊 |
实时显示师傅上传的照片（≤30s 延迟） |
| 物流单号 + 车牌 |
含中港车牌标识，便于跨境追溯 |
4.6 关键验证点
| 验证项 |
说明 |
| RLS 数据隔离 |
mfr_02 仅可见自己委托的 38 笔订单，不应看到 mfr_01 的订单 |
| 客户信息脱敏 |
客户电话中间 4 位必须脱敏为 ****，但地址完整可见（MFR 需配送） |
| 时间轴完整性 |
L1-L8 共 15 个节点（含 L5.1-L5.4 + L6.1-L6.5 子节点）应全部显示 |
| 物流轨迹可见 |
跨境订单 GPS 轨迹应包含深圳起点 + 福田口岸 + 香港终点 3 个关键节点 |
| 安装照片实时性 |
师傅上传后 ≤30s 内 MFR 端应能查看到最新照片 |
| 状态徽章颜色 |
已完成=绿色✅ / 进行中=蓝色⏳ / 待开始=灰色⏸ 颜色规范一致 |
| 跨境车牌展示 |
物流商字段应展示中港车牌号 粤 ZB1234 港 标识 |
| 脱敏规则一致性 |
mfr_02 在不同页面（列表/详情/时间轴）查看同一客户信息脱敏规则一致 |
五、UC-22：MFR 月度对账 + API Key 集成
5.1 基本信息
| 项 |
值 |
| 用例编号 |
UC-22 |
| 场景类型 |
标准流程（对账结算 + API 集成） |
| 业务模式 |
MFR 月度结算 + API Key 自助生成与调用 |
| MFR 账号 |
mfr_02（优品家电） |
| 运营账号 |
ol_01（黄运营，处理复核） |
| 对账周期 |
2026-08-01 至 2026-08-31 |
| 对账触发日 |
2026-09-01（mfr_02 月结对账日为每月 10 号，提前测试） |
| API 路径 |
/mfr/orders、/mfr/accounting/monthly 等（OpenAPI V3.0 §11） |
5.2 业务数据
| 数据项 |
值 |
说明 |
| 对账月份 |
2026 年 8 月 |
period: 2026-08 |
| 订单总数 |
38 笔 |
含已完成 32 笔 + 进行中 4 笔 + 已取消 2 笔 |
| 对账口径 |
已完成订单（L7 通过） |
32 笔纳入对账 |
| 总金额（HKD） |
145,200 |
32 笔已完成订单金额合计 |
| 平台服务费 |
14% |
mfr_02 协议费率（共 HKD 20,328） |
| 应付 MFR 金额 |
HKD 124,872 |
总金额 - 平台服务费 |
| 差异订单 |
1 笔 |
ORD-20260815-002（金额差异 HKD 200） |
| 新 API Key 名称 |
mfr02-erp-sync-202608 |
用于 ERP 同步 |
| API Key 权限范围 |
orders:read、accounting:read |
仅读取权限 |
| API Key 有效期 |
90 天 |
2026-08-18 至 2026-11-16 |
5.3 用例步骤
| 步骤 |
操作角色 |
系统端 |
操作内容 |
预期结果 |
| Step 1 |
MFR（mfr_02） |
MFR-Portal |
mfr_02 登录 MFR-Portal，进入"对账结算 → 月度对账"页面（路由 /accounting，页面 ID：MFR-ACC-01） |
顶部显示 4 张 KPI 卡片：本月订单总数 38 / 本月应收 HKD 145,200 / 已对账 HKD 0 / 待对账 HKD 145,200；下方为对账明细表格 |
| Step 2 |
MFR（mfr_02） |
MFR-Portal |
在页面顶部"对账月份"选择器中，年份下拉选 2026，月份下拉选 8，点击"查询"按钮 |
表格刷新，显示 8 月订单明细，按日期升序排列 32 行（仅已完成订单），列：日期/订单号/客户/产品/数量/金额/状态/操作 |
| Step 3 |
MFR（mfr_02） |
MFR-Portal |
查看对账汇总栏（表格上方）：订单数 32 笔 + 总金额 HKD 145,200 + 平台服务费 HKD 20,328（14%） + 应付 MFR HKD 124,872；逐行核对前 5 笔订单金额与内部 ERP 一致 |
汇总数字与表格明细小计一致；前 5 笔：ORD-20260801-001 HKD 3,200、ORD-20260802-001 HKD 2,880... 均对账无误 |
| Step 4 |
MFR（mfr_02） |
MFR-Portal |
点击表格右上角"导出 Excel"按钮 → 弹出导出选项对话框，选择字段（默认全选 12 列）+ 文件格式 XLSX → 点击"确认导出" |
浏览器下载 mfr02_accounting_202608.xlsx（约 156KB），含 Sheet1 汇总+Sheet2 明细+Sheet3 服务费计算说明 |
| Step 5 |
MFR（mfr_02） |
本地 Excel |
mfr_02 财务人员打开下载的 Excel，与内部 ERP 系统 8 月数据进行比对，发现 ORD-20260815-002（cus_03 空调订单）金额差异：平台显示 HKD 3,200，ERP 显示 HKD 3,000 |
发现差异订单 1 笔，差异金额 HKD 200，需要在系统中标记复核 |
| Step 6 |
MFR（mfr_02） |
MFR-Portal |
回到 MFR-ACC-01 月度对账页面，在表格中找到 ORD-20260815-002 行，点击"操作"列"标记差异"按钮 → 弹出差异标记对话框，填写：差异类型 金额不一致 + 差异金额 200 + 差异说明 客户实际支付 HKD 3,000，平台记录 HKD 3,200，差额 HKD 200 + 附件上传 erp_compare_20260815.xlsx → 点击"提交复核" |
该行状态变为 待复核（橙色），系统自动创建复核工单推送至 ol_01 工作台 |
| Step 7 |
运营（ol_01） |
OPR-Admin |
ol_01 登录运营后台，进入"对账管理 → 复核工单"，找到 ORD-20260815-002 差异工单；点击"处理" → 查看订单详情+物流单+验收单 → 发现 8-15 当天客户参加平台促销活动（满 3000 减 200），ERP 未同步优惠 → 点击"调整金额" → 输入 3000 + 备注 促销活动折扣 → 点击"确认调整" → 状态变为 已复核（绿色） |
差异工单处理完成，应付 MFR 金额自动重算：HKD 124,672（原 124,872 - 200） |
| Step 8 |
MFR（mfr_02） |
MFR-Portal |
mfr_02 在 MFR-ACC-01 页面刷新，看到 ORD-20260815-002 状态变更为 已复核，金额更新为 HKD 3,000；汇总栏"已对账"更新为 HKD 145,000（32 笔全部对账完成），点击"确认对账"按钮 → 弹出二次确认对话框 → 点击"确认提交" |
对账单状态变为 PENDING_CONFIRM（待 BO 审批）；BO 审批通过后（用例不展开 BO 流程），状态变 CONFIRMED，生成结算单号 STL-202608-002 |
| Step 9 |
MFR（mfr_02） |
MFR-Portal |
mfr_02 进入"系统设置 → 账号与 API"页面（路由 /settings，页面 ID：MFR-SET-01）；在"API 密钥管理"区域，点击"创建密钥"按钮 → 弹出创建对话框，填写：①名称 mfr02-erp-sync-202608；②权限范围勾选 orders:read + accounting:read；③有效期 90 天；④回调 URL https://erp.youpin.com.hk/callback → 点击"创建" |
系统生成新 API Key mfr_youpin_q1w2e3r4t5y6（仅此一次显示明文），下方提示"请立即复制保存，关闭后将无法再次查看"；同时显示 masked_key: mfr_youpin_********************y6 |
| Step 10 |
MFR（mfr_02） |
Postman/API 客户端 |
mfr_02 在 Postman 中测试新 API Key：①调用 GET /api/v1/mfr/orders?status=COMPLETED&date_from=2026-08-01&date_to=2026-08-31，Header 携带 X-API-Key: mfr_youpin_q1w2e3r4t5y6 → 返回 32 笔订单 JSON 列表；②调用 POST /api/v1/mfr/orders 创建测试订单（cus_03 测试空调），返回新订单号 ORD-20260818-TEST001；③调用 GET /api/v1/mfr/accounting/monthly?year=2026&month=8，返回对账汇总 JSON |
三次调用全部返回 HTTP 200，①返回 32 条订单数据与 MFR-ORD-01 列表一致；②测试订单创建后应在 MFR-ORD-01 显示（标记 API 创建）；③返回 total_amount_hkd: 145000 + order_count: 32 与 MFR-ACC-01 一致 |
5.4 对账汇总数据
| 项 |
值 |
备注 |
| 对账月份 |
2026-08 |
— |
| 订单总数 |
38 笔 |
含已完成 32 + 进行中 4 + 已取消 2 |
| 纳入对账 |
32 笔 |
仅 L7 通过的订单 |
| 总金额（HKD） |
145,000 |
原始 145,200 - 差异调整 200 |
| 平台服务费率 |
14% |
mfr_02 协议费率 |
| 平台服务费（HKD） |
20,300 |
145,000 × 14% |
| 应付 MFR（HKD） |
124,700 |
145,000 - 20,300 |
| 结算单号 |
STL-202608-002 |
BO 审批通过后生成 |
5.5 预期产出
| 产出物 |
说明 |
| 月度对账单 |
周期 2026-08，32 笔订单，金额 HKD 145,000 |
| 对账明细 Excel |
mfr02_accounting_202608.xlsx（汇总+明细+服务费说明 3 Sheet） |
| 差异复核工单 |
ORD-20260815-002 差异 HKD 200，ol_01 已调整 |
| 结算单 STL-202608-002 |
状态 CONFIRMED，应付 mfr_02 HKD 124,700 |
| 新 API Key |
mfr_youpin_q1w2e3r4t5y6（90 天有效，权限 orders:read + accounting:read） |
| API 调用日志 |
3 次 API 调用（GET orders / POST orders / GET accounting），全部成功 |
5.6 关键验证点
| 验证项 |
说明 |
| 对账统计准确性 |
总金额 = 32 笔已完成订单金额之和；不应包含进行中或已取消订单 |
| 服务费计算 |
14% 服务费基于"应付 MFR 前"总金额计算，与协议费率一致 |
| 明细导出完整性 |
Excel 应包含 3 个 Sheet（汇总/明细/服务费说明），字段齐全 |
| 差异标记流程 |
MFR 可自助标记差异，工单自动推送至 ol_01 处理 |
| 复核工单处理 |
ol_01 调整金额后，应付 MFR 金额应自动重算 |
| 结算单生成 |
对账确认 + BO 审批通过后，生成结算单号，状态 CONFIRMED |
| API Key 一次性显示 |
创建后明文仅显示一次，之后只能查看 masked_key |
| API Key 权限范围 |
新 Key 权限范围严格限制为 orders:read + accounting:read，调用 POST orders 应被允许（已含 orders:write 隐式授权或单独测试用 Key） |
| API 接口返回一致性 |
API 返回的订单数据应与 Web 端 MFR-ORD-01 列表一致（数量、金额、状态） |
| API 鉴权失败处理 |
携带错误/过期 API Key 调用应返回 HTTP 401，并记录失败日志 |
六、共性验证点汇总
| 验证维度 |
涉及用例 |
说明 |
| MFR-Portal 登录 |
UC-19~22 |
用户名+密码登录，强制改密策略，登录态保持与超时退出 |
| RLS 数据隔离 |
UC-19~22 |
MFR 仅可见自己的产品（ppl_products.mfr_id）与订单（cpt_orders.mfr_id） |
| HS 编码校验 |
UC-19 |
必须从 HS 编码库选择，不允许手填非库内编码 |
| SCL 费率联动 |
UC-19 |
基础安装费率字段灰显锁定为 SCL 类目费率 |
| 产品审核流程 |
UC-19 |
草稿→待审核→已上架 三态切换，需 OL 审核通过 |
| 上架后 CPL/SCL 联动 |
UC-19 |
客户端可见新产品 + SCL 类目 SKU 列表更新 |
| WebSocket 实时通知 |
UC-19~21 |
订单状态变更/产品审核结果 1s 内推送至 MFR 端 |
| Excel 模板字段 |
UC-20 |
12 列字段定义齐全，含必填/选填/校验规则 |
| 批量校验规则 |
UC-20 |
电话格式/SKU 存在性/楼宇匹配/区域合法/时段格式 5 类校验 |
| 批量创建效率 |
UC-20 |
5 笔订单 ≤5s 完成批量创建 |
| 订单时间轴完整性 |
UC-21 |
L1-L8 共 15 节点（含 L5.1-L5.4 + L6.1-L6.5 子节点） |
| 物流 GPS 轨迹 |
UC-21 |
本地+跨境配送轨迹完整可见 |
| 安装照片实时性 |
UC-21 |
师傅上传 ≤30s 内 MFR 端可见 |
| 客户信息脱敏 |
UC-21 |
客户电话中间 4 位脱敏，地址完整可见 |
| 对账统计准确性 |
UC-22 |
仅纳入已完成订单（L7 通过），不含进行中/已取消 |
| 对账明细导出 |
UC-22 |
Excel 导出含汇总/明细/服务费说明 3 Sheet |
| 差异复核流程 |
UC-22 |
MFR 自助标记差异 → ol_01 复核 → 金额自动重算 |
| API Key 生命周期 |
UC-22 |
创建/查看 masked/吊销 全流程，明文仅显示一次 |
| API Key 权限范围 |
UC-22 |
scopes 字段严格限定，超范围调用应返回 403 |
| API 接口一致性 |
UC-22 |
API 返回数据与 Web 端展示数据一致 |
| 跨境车牌展示 |
UC-21 |
物流商字段含中港车牌号（粤 ZXXXX 港） |
| 审计日志记录 |
UC-19~22 |
MFR 所有写操作（产品创建/订单导入/对账确认/API Key 生成）记入 sys_audit_logs |
七、修订记录
| 版本 |
日期 |
修订人 |
修订内容 |
| V1.0 |
2026-08-18 |
DT |
首版创建：4 个 MFR 专项用例（UC-19~22），覆盖产品目录管理+SKU 创建、批量订单 Excel 导入、订单进度全流程追踪、月度对账+API Key 集成；对齐 DIP1-API V3.0 §11 MFR 门户 17 个端点与 DIP1-PROTO V3.0 §七 MFR 门户 8 页结构；业务数据对齐 mfr_01/mfr_02 测试账号画像 |
本文档为 MFR 生产商专项用例，与原型 MFR-Portal 门户页面对应。测试时按步骤执行，验证每个节点的系统行为。MFR 门户原型路径：原型/mfr-portal/（Next.js Web 8 页）。