业务测试目录索引¶
目录编号：DOC-A09 / UAT 版本：V1.1 维护人：听写（DT）/ TL 创建日期：2026-08-18 关联文档：DIP1-SPEC V3.0、CPT-D V3.0、DIP1-PROTO V3.0、DT 听写工作手册、原型需求映射、功能原型入口
一、目录定位¶
本目录是 DIP1 子项目真实用户联调测试的完整准备体系，承接自原 docs/真实用户联调测试准备.md（V2.0），并大幅扩充为多份文档 + 全套静态 HTML 功能原型，覆盖大部分场景和流程环节。
核心特征： - 业务信息真实：所有用例数据基于 BPL/SCL/MDS 真实主数据 - 原型与用例对应：原型业务数据 100% 与测试用例一致 - 五端全覆盖：OPR 运营后台 + MFR 生产商门户 + WKR 师傅端 + CST 客户端 + LGP 物流端 - L1-L8 全流程：覆盖线索→报价→签约→配送→安装→验收→回访全链路 - 正常+异常双轨：标准流程 + 异常分支（报价拒绝、配送延误、安装异常、验收整改等）
二、文档清单¶
2.1 测试准备文档（10 份）¶
| # | 文档 | 简称 | 版本 | 内容要点 |
|---|---|---|---|---|
| 01 | 测试账号清单 | UAT-ACCT | V1.0 | 11 个测试账号详细设计（3 师傅 + 3 客户 + 1 运营 + 2 MFR + 2 LGP）+ 权限矩阵 + RLS 策略 |
| 02 | C端标准流程用例 | UAT-CST-STD | V1.0 | UC-01, UC-08~12：客户主动下单的标准全流程（6 用例） |
| 03 | C端异常流程用例 | UAT-CST-EXC | V1.0 | UC-02~04：报价拒绝、安装异常、验收整改（3 用例） |
| 04 | B2B2C本地配送用例 | UAT-LOC | V1.0 | UC-05, UC-06, UC-13：MFR 委托本地配送+安装（3 用例） |
| 05 | B2B2C跨境配送用例 | UAT-XBD | V1.0 | UC-07, UC-14：跨境清关+安装全流程（2 用例） |
| 06 | 物流配送专项用例 | UAT-LGP | V1.0 | UC-15~18：LGP 视角运单操作、GPS 轨迹、签收异常（4 用例） |
| 07 | MFR生产商专项用例 | UAT-MFR | V1.0 | UC-19~22：MFR 视角产品管理、订单创建、对账结算（4 用例） |
| 08 | 运营管理与派调用例 | UAT-OPR | V1.0 | UC-23~26：OPR 视角看板、订单管理、智能派单、异常处置（4 用例） |
| 09 | 数据初始化方案 | UAT-INIT | V1.0 | 初始化脚本、预置订单、主数据验证、环境配置 |
| 10 | 测试执行计划 | UAT-PLAN | V1.0 | 前置检查清单、执行步骤、Bug 处置流程、报告规范 |
2.2 用例统计¶
| 维度 | 数量 | 说明 |
|---|---|---|
| 总用例数 | 26 个 | 覆盖 L1-L8 全流程 + 五端角色视角 |
| 标准流程用例 | 12 个 | Happy Path，验证正常业务闭环 |
| 异常流程用例 | 14 个 | 报价拒绝、配送延误、签收异常、安装异常、验收整改等 |
| C 端场景 | 9 个 | 客户主动下单视角（UC-01~04, UC-08~12） |
| B2B2C 场景 | 5 个 | MFR 委托+LGP 配送（UC-05~07, UC-13~14） |
| LGP 专项 | 4 个 | 物流司机视角（UC-15~18） |
| MFR 专项 | 4 个 | 生产商视角（UC-19~22） |
| OPR 专项 | 4 个 | 运营管理视角（UC-23~26） |
2.3 功能原型（静态 HTML）¶
| 端 | 路径 | 页面数 | 说明 |
|---|---|---|---|
| OPR 运营后台 | 原型/opr-admin/ |
19 | Next.js Web 模拟，1920/1440/1080 三档栅格 |
| MFR 生产商门户 | 原型/mfr-portal/ |
8 | Next.js Web 模拟，PC 端 |
| WKR 师傅端 | 原型/wkr-app/ |
8 | React Native 模拟，手机外壳 375pt 基准 |
| CST 客户端 | 原型/cst-app/ |
8 | React Native 模拟，手机外壳 375pt 基准 |
| LGP 物流端 | 原型/lgp-app/ |
6 | React Native 模拟，手机外壳 375pt 基准 |
| 总入口 | 原型/index.html |
1 | 五端切换器，一键跳转各端登录页 |
| 共享资源 | 原型/assets/ |
— | CSS（品牌色板）+ JS（导航/数据）+ 测试数据 JSON |
原型特点： - 不追求高保真，但功能点、操作流程、字段细节完整 - 业务数据与测试用例 100% 对应（如 UC-01 的客户王先生、订单号、报价明细均可点击查看） - 桌面端使用浏览器直接打开 HTML 即可预览 - 移动端使用手机外壳模拟器，模拟真机操作体验 - 所有页面间通过超链接跳转，模拟真实导航 - V1.1 新增组件标注系统：按住 Ctrl 鼠标悬停任意组件即显示编号+关联需求 ID，详见 11-原型需求映射.md；亦可通过 原型入口.md 在 MkDocs 发布站点直接操作
三、与既有文档的关系¶
3.1 替代关系¶
本目录替代原 docs/真实用户联调测试准备.md（V2.0），将其内容拆分扩充为 10 份独立文档，并新增全套功能原型。原文件保留作为历史归档。
3.2 依赖关系¶
| 依赖文档 | 关联章节 | 用途 |
|---|---|---|
| DIP1-SPEC V3.0 | §1.2 角色权限矩阵、§3 功能规格 | 账号权限设计依据 |
| CPT-D V3.0 | §二 8 阶段生命周期 | 用例步骤设计依据 |
| QMD V3.0 | §二 报价核心公式 | 报价金额计算依据 |
| BPL V1.1 | §二 7 大楼宇类型 | 楼宇系数取值依据 |
| SCL V1.1 | §二 8 大品类目录 | 品类费率取值依据 |
| DIP1-PROTO V3.0 | 全文 | 原型设计依据 |
四、阅读顺序建议¶
| 角色 | 推荐顺序 |
|---|---|
| TL/技术负责人 | 01 账号 → 09 初始化 → 10 执行计划 → 全部用例 → 原型 |
| 听码（WDE） | 09 初始化 → 01 账号 → 全部用例（理解业务逻辑） → 原型（参考实现） |
| 听云（WCL） | 09 初始化 → 10 执行计划 → 01 账号 → 原型（部署参考） |
| 听写（DT）真实用户测试 | 01 账号 → 全部用例 → 原型 → 10 执行计划 |
| SPO/BO 业务评审 | 02~08 用例（按业务关注点选读） → 原型预览 |
五、修订记录¶
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| V1.0 | 2026-08-18 | DT | 首版创建：① 建立 docs/业务测试/ 子目录；② 迁移并扩充原《真实用户联调测试准备.md》为 10 份独立文档；③ 新增 26 个业务用例（标准 12 + 异常 14）；④ 新增全套静态 HTML 功能原型（五端 50 页）；⑤ 业务数据与用例 100% 对应 |
| V1.1 | 2026-08-18 | DT | 原型组件标注系统 + 公开发布集成：① 新增 Ctrl+Hover 组件标注（assets/js/annotate.js + data-* 属性 + .wv-annotate-mode/.wv-tooltip 样式）；② 新增双向追溯文档 11-原型需求映射.md（页面→组件→需求 + 需求→组件→页面）；③ 新增 原型入口.md 通过 iframe 嵌入原型供 MkDocs 站点直接操作；④ 新增 scripts/scan-prototype.js/gen-prototype-mapping.js/verify-annotate.js/fill-spec-prototype.py 四个工具脚本；⑤ MkDocs url_map.py 扩展业务测试目录与原型入口 slug 映射 |
本目录为真实用户联调测试准备体系，待听码/听云完成部署后执行。协作通道见 协作记录，测试职责见 DT 听写工作手册 §四。