QSV 用例库（Quotation Service Use Cases）¶
文档编号：DOC-P31-UC / QSV-UC 版本：V1.0 创建日期：2026-08-21 维护人：BO / DT 关联文档：QSV-D V1.2、QMD 报价模型、用例库 README
UC-01 标准家居（家具）报价（典型）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-01 |
| 分类 | 典型 |
| 触发条件 | CPT L3 调用 QSV，请求家具安装报价 |
| 关联原型 | OPR-QUOTE-01（报价详情）、CST-QUOTE-01（客户端报价查看） |
| 关联服务 | QSV-D §四 DDD 战术设计、QMD P1 基础费 |
| 关联需求 | F-QSV-001 |
主流程：
1. CPT 调用 PricingEngine.generateQuote(request)
2. MDS 查询 SCL 品类档案：CAT-01 床架，baseFee=350
3. MDS 查询 BPL 楼宇档案：港岛屋苑 18 楼有电梯，floorMultiplier=1.0
4. MDS 查询 WPL 师傅档案：认证级 AUTH，levelMultiplier=1.0
5. 时段系数：平峰 1.0；复杂度系数：1.0；供需系数：港岛热门 1.1
6. 计算确定部分：350 × 1.0 × 1.0 × 1.0 × 1.0 × 1.1 = HKD 385
7. 灵活部分（上限）：拆旧不确定费 maxLimit=HKD 200
8. 总额 = 385 + 200 = HKD 585
9. 封顶价校验：CAT-01 上限 HKD 800，未触发
10. 发布 QuoteGenerated 事件
异常分支：无
UC-02 灯具安装含楼宇系数（典型）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-02 |
| 分类 | 典型 |
| 触发条件 | 楼宇为唐楼无电梯 |
| 关联原型 | OPR-QUOTE-01、OPR-BLDG-01 |
| 关联服务 | QSV-D §四、BPL 楼宇特征库 |
| 关联需求 | F-QSV-003 |
主流程： 1. SCL 品类：CAT-02 灯具，baseFee=280 2. BPL 楼宇：九龙唐楼 5 楼无电梯，floorMultiplier=1.8 3. WPL 师傅：高级 SK3，levelMultiplier=1.2 4. 时段：平峰 1.0；复杂度：吊灯高空作业 1.5；供需：九龙 1.0 5. 确定：280 × 1.8 × 1.2 × 1.0 × 1.5 × 1.0 = HKD 907 6. 灵活部分：高空作业不确定费 maxLimit=HKD 300 7. 总额 = 907 + 300 = HKD 1,207 8. 封顶价校验：CAT-02 上限 HKD 1,500，未触发
异常分支： - 吊灯超 10kg → 复杂度系数升至 2.0 → 总额 HKD 1,576 → 触发封顶价 HKD 1,500
UC-03 卫浴安装（含拆旧）（典型）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-03 |
| 分类 | 典型 |
| 触发条件 | 卫浴拆旧+安装 |
| 关联原型 | OPR-QUOTE-01 |
| 关联服务 | QSV-D §五 灵活部分设计规范 |
| 关联需求 | F-QSV-004 |
主流程： 1. SCL 品类：CAT-03 马桶，baseFee=400 2. BPL 楼宇：新界屋苑有电梯，floorMultiplier=1.0 3. WPL 师傅：中级 SK2，levelMultiplier=1.0 4. 时段：周末高峰 1.2；复杂度：1.0；供需：新界 0.9 5. 确定：400 × 1.0 × 1.0 × 1.2 × 1.0 × 0.9 = HKD 432 6. 灵活部分：拆旧不确定费 maxLimit=HKD 300 + 隐蔽工程不确定费 maxLimit=HKD 500 7. 总额 = 432 + 300 + 500 = HKD 1,232 8. 封顶价校验：CAT-03 上限 HKD 1,500，未触发
异常分支：无
UC-04 家电安装（含家电系数）（典型）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-04 |
| 分类 | 典型 |
| 触发条件 | 家电（空调/洗衣机）安装 |
| 关联原型 | OPR-QUOTE-01 |
| 关联服务 | QSV-D §四 |
| 关联需求 | F-QSV-005 |
主流程： 1. SCL 品类：CAT-05 分体空调，baseFee=500 2. BPL 楼宇：港岛屋苑有电梯，floorMultiplier=1.0 3. WPL 师傅：高级 SK3（空调资质），levelMultiplier=1.2 4. 时段：工作日平峰 1.0；复杂度：分体空调 1.3；供需：港岛 1.1 5. 确定：500 × 1.0 × 1.2 × 1.0 × 1.3 × 1.1 = HKD 858 6. 灵活部分：支架加长不确定费 maxLimit=HKD 200 7. 总额 = 858 + 200 = HKD 1,058 8. 封顶价校验：CAT-05 上限 HKD 1,200，未触发
异常分支：无
UC-05 智能家居（含技能等级乘数）（典型）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-05 |
| 分类 | 典型 |
| 触发条件 | 智能家居安装，需高技能师傅 |
| 关联原型 | OPR-QUOTE-01、OPR-WKR-01 |
| 关联服务 | QSV-D §四、WPL 师傅技能矩阵 |
| 关联需求 | F-QSV-006 |
主流程： 1. SCL 品类：CAT-06 智能门锁，baseFee=350 2. WPL 师傅：高级 SK3（智能锁资质），levelMultiplier=1.2 3. 复杂度：智能门锁 1.4（含网络配置） 4. 确定：350 × 1.0 × 1.2 × 1.0 × 1.4 × 1.0 = HKD 588 5. 灵活部分：门体改造不确定费 maxLimit=HKD 300 6. 总额 = 588 + 300 = HKD 888 7. 封顶价校验：CAT-06 上限 HKD 1,000，未触发
异常分支： - 无 SK3 师傅可用 → 系统提示"暂无高技能师傅" → CPT 暂停 L3
UC-06 加价险触发（异常）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-06 |
| 分类 | 异常 |
| 触发条件 | 实际收费 > 报价总额 |
| 关联原型 | OPR-QUOTE-01 |
| 关联服务 | QSV-D §四 PricingEngine |
| 关联需求 | F-QSV-010 |
主流程： 1. 报价总额 HKD 585（UC-01 场景） 2. 实际安装中师傅发现床架需额外组装床头柜，增项 HKD 150 3. 客户购买加价险 → 触发理赔 4. 加价险赔付 HKD 100（赔付比例 80%，上限 HKD 200） 5. 客户实付 = 585 + 150 - 100 = HKD 635
异常分支： - 未购买加价险 → 客户全额承担 HKD 735
UC-07 封顶价触发（异常）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-07 |
| 分类 | 异常 |
| 触发条件 | 报价总额 > 品类封顶价 |
| 关联原型 | OPR-QUOTE-01 |
| 关联服务 | QSV-D §四 CapPriceService |
| 关联需求 | F-QSV-011 |
主流程：
1. 灯具安装：计算总额 HKD 1,576（UC-02 异常分支）
2. CAT-02 封顶价 HKD 1,500
3. CapPriceService.checkCap() 触发 → 总额降至 HKD 1,500
4. 发布 CapPriceTriggered 事件
5. OPR 后台审计：记录差额 HKD 76（运营补贴）
异常分支： - 封顶价仍高于客户预算 → ESC 议价 → 客户出价 HKD 1,400 → 二次议价失败 → END 流失池
UC-08 师傅超能力拒绝（异常）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-08 |
| 分类 | 异常 |
| 触发条件 | 报价生成后无合适师傅接单 |
| 关联原型 | OPR-QUOTE-01、OPR-WKR-01 |
| 关联服务 | QSV-D §四、WPL 技能矩阵 |
| 关联需求 | F-QSV-012 |
主流程： 1. 智能家居报价生成：CAT-06 SK3 师傅需求 2. WPL 查询：当前港岛无 SK3 智能锁师傅可用 3. 系统提示"暂无高技能师傅" → CPT 暂停 L3 4. OL 联系客户：改期至 3 天后（SK3 师傅从九龙调动） 5. 3 天后恢复 L3 → 报价有效（7 天内）
异常分支： - 7 天内仍无师傅 → END 流失池
UC-09 增项报价（异常）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-09 |
| 分类 | 异常 |
| 触发条件 | L6 现场增项，需生成增项报价 |
| 关联原型 | WKR-INSTALL-01 |
| 关联服务 | QSV-D §四 FlexiblePart |
| 关联需求 | F-QSV-013 |
主流程：
1. L6 安装中，客户要求"顺便安装另一个房间的小夜灯"
2. 师傅提交增项内容 → QSV 生成增项报价
3. SCL 品类：CAT-02 小夜灯，baseFee=80
4. 计算：80 × 1.0 × 1.0 × 1.0 × 0.8 × 1.0 = HKD 64（师傅现场作业，复杂度低）
5. 发布 FlexiblePartConfirmed 事件
6. 客户签字确认 → 增项费用合并结算
异常分支： - 客户拒绝增项报价 → 续原单 + 增项记录归档（反哺报价模型）
UC-10 MFR 开放报价（典型）¶
| 字段 | 值 |
|---|---|
| 用例编号 | QSV-UC-10 |
| 分类 | 典型 |
| 触发条件 | MFR 生产商通过 Portal 提交开放报价请求 |
| 关联原型 | MFR-OQ-01（开放报价页） |
| 关联服务 | QSV-D §五 MFR 开放报价服务边界 |
| 关联需求 | F-QSV-010, F-MFR-011 |
主流程：
1. MFR 员工登录 Portal，选择"开放报价"
2. 输入：产品类型（家具-床架）、规格型号（MALM 180×200）、客户地址（港岛西门大厦）、安装需求
3. QSV 调用 PricingEngine.generateQuote(openQuoteRequest)
4. 生成报价单：HKD 585（同 UC-01 场景）
5. QSV 生成 PDF 报价单（含 MFR 品牌+徽章+报价明细+灵活部分）
6. MFR 下载 PDF 或直接确认
7. 确认后转为 CPT L1 线索
异常分支： - MFR 未绑定 PPL 档案 → 提示"请联系平台绑定生产商档案"
修订记录¶
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| V1.0 | 2026-08-21 | DT | 初版建立：10 用例（5 典型 + 5 异常）覆盖 QSV 报价全流程 + 封顶价 + 加价险 + 增项 + MFR 开放报价 |
本文件为 QSV 用例库 V1.0，对应用户指令"报价操作至少要有 3-5 个典型的，不同类型的货品和服务需求"。