DIS 派单服务用例库(DIS-Usecase Library)¶
文档编号:DOC-A08-DIS / DIS-UC 版本:V1.0 创建日期:2026-08-21 维护人:TL / DT 关联文档:用例库总索引 README.md、DIS-D 派单服务设计、BAS 业务架构说明、MDS DLV 物流商档案、原型 opr-admin dispatch.html
一、用例清单总览¶
| 编号 | 分类 | 用例名称 | 典型/异常 | 覆盖模式/聚合根 | 状态 |
|---|---|---|---|---|---|
| DIS-UC-01 | M1 | 唐楼无电梯 CAT01 沙发 → M1 自营派单(陈师傅匹配成功,+楼层系数 1.5) | 典型 | M1 自营模式 / DispatchRequest | ✅ |
| DIS-UC-02 | M2 | 跨境 CAT05 智能马桶 → M2 独立物流商王师傅(M2-0037九龙西区签约)匹配 | 典型 | M2 独立模式 / LogisticsPartner(DLV 档案) | ✅ |
| DIS-UC-03 | M3 | 港深跨境工程 12 件定制家具 → M3 跨境物流公司(顺速物流 M3-0003)协同派单 | 典型 | M3 专业跨境模式 / CrossBorderContract 实体 | ✅ |
| DIS-UC-04 | 跨模式 | 同订单候选池跨模式比较评分表(M1/M2/M3 综合得分 + 距离 + 费率 + 保险) | 典型 | DispatchDecisionEngine / CandidateScore VO | ✅ |
| DIS-UC-05 | OL人工 | OL 人工调低 M2-0037 王师傅负向权重(近 1 月 C7 赔付 2 次) | 典型 | OL 人工调整 / ManualWeightAdjustment 实体 | ✅ |
| DIS-UC-06 | 拒单 | 陈师傅连续 2 次拒单 → DispatchRefusalPenalty:负向扣分 -25 + 30 分钟挂起 | 异常 | DispatchRefusal 事件 / WorkerPenalty VO | ✅ |
| DIS-UC-07 | 保险 | 安装中面板破损 C7 保险 2,800 HKD 赔付 → 派单引擎负向权重 -60 | 异常 | C7InsuranceClaim 实体 / InsuranceDeduction VO(-20~-80) | ✅ |
| DIS-UC-08 | 超时 | 派单请求超时 30min 未匹配到任何 M1/M2 候选 → DispatchTimeout 升级 OL | 异常 | DispatchRequest.fsm → ESCALATED(状态机 3.7) | ✅ |
| DIS-UC-09 | 全模式不可用 | 台风十号风球 M1 全员不可用 + M2 合约暂停 + M3 口岸关闭 → FALLBACK 客户 L4 改期 | 异常 | AllModesUnavailable 事件 / CPT L4 签约后改期 | ✅ |
| DIS-UC-10 | M3失败回退 | M3 顺速物流海关清关失败 → ContractExecutionFailed,回退 M2-0037 王师傅(M2 候选池) | 异常 | CrossBorderContract.fsm FAILED → 回退候选池 | ✅ |
二、典型用例(5 条)¶
DIS-UC-01:唐楼无电梯 CAT01 沙发 → M1 自营派单¶
分类:M1 自营模式 | 类型:典型 | 触发:CPT L5「配送安装待派单」→ 自动调 DIS DispatchRequestCreated(cptId=CPT-20260820-0021)
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(DIS DispatchDecisionEngine 评分) | 数据样例 |
|---|---|---|---|---|
| 1 | CPT → DIS | 创建派单请求 DispatchRequest | 基本参数:cptId=CPT-20260820-0021,楼宇=深水埗唐楼 XX 号(BPL.id=BPL-HK-02108:无电梯 6 楼,走廊窄,floorFactor=1.5),品类=CAT01 三人皮沙发(SCL.id=SCL-20260715-0003,重量=68kg),预约时间=2026-08-22 10:00~12:00,保险要求=基础 C7 | requestId = DIS-REQ-20260821-0187 |
| 2 | DIS | 聚合 MDS 数据供给:① WPL 自营师傅池(M1 mode=INTERNAL)② BPL 楼宇系数 ③ SCL 费率 ④ PPL 生产商档案(如需) | SupplyAPIService 返回 28 条 M1 自营 WPL + 楼宇 6 楼无梯 floorFactor=1.5;模式选择:品类=普通本地家具 → 优先 M1(自营覆盖范围含深水埗 ✅) | WPL-M1 池 28 人;可用时间窗匹配 2026-08-22 上午=17 人 |
| 3 | DIS | M1 候选池评分(5 维度:距离/技能匹配/时效评分/历史评分/负向权重) | 前 3 名:① WPL-HK-0188 陈师傅(SK2,深水埗站 0.8km 距离分 98 + 沙发技能 100 + 历史 NPS 4.7 + 负向权重 0 = 96.2 综合)② WPL-HK-0211 何师傅(93.4)③ WPL-HK-0094 郭师傅(90.8) | CandidateScore VO 列表:陈师傅 96.2 最高 |
| 4 | DIS | 派单:推送陈师傅师傅端 App(wkr-app/dispatch.html) | DispatchRequest.fsm:MATCHED → OFFERED;推送含:订单金额(QSV 报价 HKD 1,280 = base 800 × floor 1.5 × SK2 1.06 = HKD 1,272≈1,280)、唐楼无梯提示 + 走廊保护物料提醒 | OFFERED 倒计时 10 分钟接单 |
| 5 | 陈师傅(wkr-app) | 92 秒内点击「接受」 → DispatchAcceptReceived | DispatchRequest.fsm:OFFERED → ACCEPTED;CPT L5 推进→「师傅已接单 陈师傅 SK2 10:00」;推送客户端 cst-app 师傅信息(脱敏:陈师傅,SK2,联系电话 9xxx***72) | 事件:WorkerDispatchAccepted(workerId=WPL-0188, requestId=DIS-0187);ReputationLoop ELIGIBLE→师傅评分关联 |
| 6 | 系统 | 派单完成时间 3 分 22 秒(< 场景基准 5 分钟 ✅) | DispatchMetrics 记录 avgDispatchDuration=3m22s(M1 本月指标=4m08s,优于基准) |
异常分支¶
- 步骤4 10分钟陈师傅未接:自动 OFFERED→REVOKED(师傅放弃),派第二高何师傅(93.4);师傅端 APP 提示「订单已重新分派,减少本次接单率」
- 步骤2 M1池零人匹配:进入 DIS-UC-04 跨模式评分流程
关联项¶
- 关联原型:opr-admin/dispatch.html(Ctrl+Hover M1 「派单详情 DIS-0187」卡片 → DIS-UC-01)、wkr-app/dispatch.html(接受按钮)
- 关联服务:DIS-D §3 M1 自营模式 · §4 DispatchDecisionEngine 5维评分
- 关联需求:RQD-O DSP-01 基础派单能力 · RQD-B DIS-01 M1 自营模式
DIS-UC-02:跨境 CAT05 智能马桶 → M2 独立物流商王师傅匹配¶
分类:M2 独立模式 | 类型:典型 | 触发:CPT L5 创建 DIS 派单请求,M1 池无跨境认证师傅
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(M2 LogisticsPartner DLV 档案校验) | 数据样例 |
|---|---|---|---|---|
| 1 | CPT → DIS | cptId=CPT-20260819-0087(CAT05 TOTO 智能马桶 CES9788W,深圳→香港跨境,收货=新界元朗,SCL 跨境类型=CROSS_BORDER,重量 47kg + 水件配套) | requestId=DIS-REQ-20260821-0204;M1 WPL 池筛选:持跨境安装资质 0 人(普通师傅无海关备案)→ 自动模式升级:M1 ❌ → M2 ✅ | 模式:DISPATCH_MODE = M2_INDEPENDENT |
| 2 | DIS MDS | DLV 物流商档案库(MDS-D §六)M2 类型查询:签约且状态 ACTIVE,服务区域覆盖新界元朗 | 返回 9 条 M2 DLV;服务区域=元朗=4 条:M2-0037王师傅(SK2+跨境备案号 CR-2026-HK-0089)、M2-0051李物流、M2-0073张师傅、M2-0108刘师傅 | DLV.id=DLV-M2-000037/0051/0073/0108 4 条 ACTIVE |
| 3 | DIS Engine | M2 候选评分(6维度:距离+费率基准+跨境资质+SLA历史履约率+保险赔付记录+负向权重近30天) | 前2:① M2-0037王师傅(跨境CR备案✅,SLA履约率98.7%/近90天,近30天C7赔付0次,费率基准与平台指导价偏差-2%,综合得分94.8)② M2-0073张师傅(91.2)③ M2-0051(86.5) | CandidateScore VO:王师傅 94.8,跨境资质分 100 满分 |
| 4 | DIS | 王师傅派单:lgp-app/dispatch.html 推送订单信息(跨境订单含:深圳仓库地址 1 个 / 海关编码 HS 3922.20.00 / 预计清关时段 2026-08-22 09:30 / 香港新界元朗交付点 / C7 投保额 HKD 6,800) | DispatchRequest.fsm MATCHED→OFFERED(M2 接单倒计时 15 分钟,跨境订单需配物流车);合同条款引用 DLV-M2-000037.SLA(≤2天交付,准时率≥95%) | 订单 C7 保险费 HKD 68(1% × 6,800)平台统一结算 |
| 5 | 王师傅 LGP App | 6 分钟内接单 → DispatchAcceptReceived | CPT L5 → M2 王师傅接单;cst-app 推送「物流商 王师傅 9xxx33,跨境车牌 NH88 预计 22 日 14:00 上门」 | DLV.id=DLV-M2-000037 contractId 引用校验 ✅ |
| 6 | 系统 | 跨境订单提前 24h 自动触发「清关资料提醒」推送 M2 王师傅 | 提醒:海关 HS 编码、装箱单模板 + CPL 客户身份证扫描件(MDS CPL 隐私脱敏后传输,L3→L2 降级) | PDPO 脱敏校验通过 ✅ |
异常分支¶
- 步骤2 M2 0条可用:进入 DIS-UC-04 跨模式 → M3 跨境物流公司候选池
- 步骤5 王师傅超时未接:OFF→回退候选(不计负向扣分)→ M2-0073 张师傅
关联项¶
- 关联原型:opr-admin/dispatch.html(Ctrl+Hover M2 「跨境派单 0204」 → DIS-UC-02)、lgp-app/dispatch.html
- 关联服务:DIS-D §3 M2 独立模式 · MDS DLV M2 签约档案
- 关联需求:RQD-O DSP-03 跨境派单 · RQD-B DIS-02 M2 独立物流商
DIS-UC-03:港深跨境工程 12 件家具 → M3 跨境物流公司协同¶
分类:M3 专业跨境模式 | 类型:典型 | 触发:OPS SCENE 05/MFR 定制化方案批量订单 CPT L5 派单请求
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(M3 CrossBorderContract 实体) | 数据样例 |
|---|---|---|---|---|
| 1 | CPT/OPS | 定制化方案:理想家居(PPL PPL-MFR-0012)深圳工厂 → 香港沙田豪宅项目 12 件定制家具(衣柜×4/床×3/沙发×2/餐桌/茶几/书桌),总货值 HKD 286,000,交货 2026-08-28 | requestId=DIS-REQ-20260821-0215(批量 12 单绑定主订单);货重合计 2.1 吨;体积 14.2 CBM;模式选择:批量定制+大吨位+豪宅项目= M3(M1 0 人 / M2 最大 1 吨) | DISPATCH_MODE = M3_CROSSBORDER_PRO;主订单号 CPT-B20260818-SHATIN-MANSION-01 |
| 2 | DIS MDS DLV | M3 物流公司档案筛选:DLV.mode=M3 & status=ACTIVE & 服务类型=COMMERCIAL_PROJECT & 近 90 天 SLA ≥ 97% & C7 累计赔付率 ≤ 0.3% | 返回 3 家:① M3-0003 顺速物流(跨境专线自营车队 22 辆,近 90 天 SLA 99.1% / 赔付率 0.18%,沙田豪宅专项 ✅)② M3-0007 中港联运(98.1%)③ M3-0015 环球捷运(97.2%) | DLV-M3-000003/000007/000015;顺速综合评分 95.8 |
| 3 | BO + TL | 人工确认选顺速物流(商务协议价 + 项目经验优势)→ 签 CrossBorderContract(DLV-M3-000003 × 本项目) | 合同不变量:① 货损封顶赔付 2% × 货值 = HKD 5,720;② 延迟交付每天 0.5% × 合同价;③ 全程 GPS 追踪 + 每日节点推送;④ 口岸:深圳皇岗 24h 通关 | Contract.id = CBC-M3-0003-20260828(PROSPECTING→SIGNED) |
| 4 | DIS M3 Engine | 顺速物流系统 API(LGP-API-01 等价 M3-API-01)创建跨境配送单 12 件(分 2 车:车 A 7 件 / 车 B 5 件) | 返回 m3OrderNo = SS-M3-20260828001;海关报关批次号;2 个车牌号粤 ZB港 / 粤 ZC港;绑定 12 个 CPT 子订单 ID | API M3-API-01 请求→响应 1.2 秒;CrossBorderContract:SIGNED → IN_TRANSIT |
| 5 | 节点推送(2026-08-27 22:00) | 深圳仓装柜完毕 + 封条号拍照 + GPS 启动 | CPT L5 节点 1/6:「深圳仓出运→皇岗口岸」推送 cst-app 客户刘先生;OPS 运营看板实时地图 | 照片 17 张 + GPS 追踪链接;客户可实时查看 |
| 6 | 节点 2-6(2026-08-28) | 皇岗清关(01:42→03:10 顺利)→ 香港沙田仓库中转 → 分车 AB → 上午 09:15 到豪宅 → 卸货+上楼+安装预备 | 每节点 CPT L5 自动推进;CrossBorderContract status:IN_TRANSIT → CUSTOMS_CLEARED → DELIVERING → INSTALL_READY | 清关 1h28m< 基准 2h ✅;SLA 达标 |
| 7 | CPT L6/L7 安装+验收 | M1/M2 安装队(DIS 此前派好)到场配合卸货 → L6 安装(12 件 3 师傅 × 8h)→ 2026-08-29 18:30 L7 客户验收通过 | CrossBorderContract:INSTALL_READY → COMPLETED(项目闭环);记录 SLA=28号03:10清关→29号18:30验收=39h20m ≤ 合同 48h 总SLA ✅ | 客户 CPT L8 NPS=9(PROMOTER,后续 OPS-UC-04 推荐激励链路) |
异常分支¶
- 步骤4 M3-API-01 超时/系统错误:见 DIS-UC-10 M3 合同失败回退 M2 候选池
- 步骤5 海关扣关查验:节点 CUSTOMS_HELD(非预期),自动 CrossBorderContract → DELAYED 状态 + DispatchDelayWarning OL 告警
关联项¶
- 关联原型:opr-admin/dispatch.html(Ctrl+Hover M3 「跨境工程 0215 追踪」 → DIS-UC-03)
- 关联服务:DIS-D §3 M3 跨境物流公司模式 · MDS DLV 物流商档案库 M3 签约
- 关联需求:RQD-O DSP-04 M3 模式工程级派单 · RQD-B OPS-05 B端定制化方案
DIS-UC-04:同订单跨模式候选池评分比较(决策前透明化)¶
分类:跨模式决策 | 类型:典型 | 触发:OL 在派单控制台点击「查看 M1/M2/M3 全模式候选评分表」
主流程(含数据样例)¶
候选订单与 DIS-UC-01 同:深水埗唐楼 6 楼无梯 CAT01 沙发,预约 2026-08-22 10:00
| 候选编号 | 模式 | 师傅/物流公司 | WPL/DLV id | 距离分(30%) | 技能匹配(20%) | 历史SLA(15%) | NPS评分(15%) | 保险/C7记录(10%) | 负向权重(10%) | 综合得分(100) | 报价 HKD | 决策建议 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| C-01 (当前派) | M1 自营 | 陈师傅 (SK2) | WPL-HK-0188 | 98(0.8km) | 100(沙发+唐楼经验5年) | 99 | 4.7→97 | 98(近90天0赔付) | 0 | 96.2 | 1,280 | 🟢首选 |
| C-02 | M1 自营 | 何师傅 (SK2) | WPL-HK-0211 | 92(2.4km旺角→深水埗) | 100 | 97 | 4.5→93 | 95(C7一次HKD 320,已过30天) | -4 | 93.4 | 1,295 | 🟡备选1 |
| C-03 | M1 自营 | 郭师傅 (SK2) | WPL-HK-0094 | 88(3.6km长沙湾) | 95(唐楼2年) | 96 | 4.4→91 | 100 | 0 | 90.8 | 1,320 | 🟡备选2 |
| C-04 | M2 独立 | 王师傅(跨境) | DLV-M2-000037 | 72(7km屯门→深水埗,远程) | 95(沙发技能) | 98.7(跨境SLA) | 4.8→99 | 100 | 0 | 84.7 | 1,480 | 🔴不推荐(距离+价格高) |
| C-05 | M2 独立 | 张师傅 | DLV-M2-000073 | 80(4.5km) | 90(沙发3年) | 96 | 4.3→89 | 90(HKD 680赔付30天内) | -18 | 68.8 | 1,420 | 🔴不推荐(负向) |
| C-06 | M3 跨境 | 顺速物流(M3项目车) | DLV-M3-000003 | N/A | 90 | 99.1 | N/A | 99.82(赔付率0.18%) | 0 | N/A(工程模式) | 2,800起(含清关+专车) | 🔴不推荐(模式错配:本单非跨境工程) |
评分结果与决策链¶
| 步骤 | 操作/系统 | 说明 |
|---|---|---|
| 1 | OL 查看 | opr-admin/dispatch.html 候选评分表 6 行(M1×3 / M2×2 / M3×1),表头按综合得分排序;模式建议列显示 🟢🟡🔴 三色 |
| 2 | 系统 | DispatchDecisionEngine 默认选 C-01(M1 陈师傅 96.2),符合唐楼无梯沙发 本地安装场景;M2/M3 因模式不匹配/价格高/距离远自动排除 🔴 |
| 3 | OL | (典型场景无需修改)点击「确认派单」→ 系统推送陈师傅(与 DIS-UC-01 步骤 4~6 衔接);OL 可点击切换 C-02 何师傅,但切换必须选择理由下拉(理由:陈师傅已接其他单 / 客户指定何师傅等 10 选项)+ 备注 |
| 4 | 系统 | 切换操作:写入 ManualWeightAdjustment 实体(记录 OL工号+时间戳+理由+原C01→切换C02);OL切换权重调整评分计入审计 |
关联项¶
- 关联原型:opr-admin/dispatch.html(Ctrl+Hover「跨模式评分表🔍」→ DIS-UC-04)
- 关联服务:DIS-D §4 DispatchDecisionEngine 跨模式评分 · CandidateScore VO × 7 维度
- 关联需求:RQD-B DIS-04 决策透明度 · RQD-B DIS-06 OL 人工干预机制
DIS-UC-05:OL 人工调低 M2-0037 王师傅负向权重¶
分类:OL 人工调整 | 类型:典型 | 触发:OL 在物流商绩效管理页面「调整权重」按钮(近1月 C7 赔付 2 次)
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(ManualWeightAdjustment 实体 + WorkerPenalty VO) | 数据样例 |
|---|---|---|---|---|
| 1 | OL-HK-007 | 进入 opr-admin/logistics-performance.html,查询 M2-0037 王师傅近 30 天绩效 |
返回:近 30 天派单 47 次 / 准时 44 次(SLA 93.6%,M2 基准 95% ↓1.4%)/ C7 赔付 2 次 合计 HKD 2,280(王师傅原因:磕碰客户家私赔付 1,680 + 丢失配件赔付 600) | DLV.id=DLV-M2-000037;近30d C7 claim 次数=2;InsDeduct累计 -45(第1次-20,第2次-25,阈值线-60触发黄牌) |
| 2 | OL | 点击「人工调整权重」,选择:① 调整项 = 负向权重(InsuranceDeduction 补充)② 调整值 = 额外 -15(补充扣分)③ 生效周期 = 2026-08-21 ~ 2026-09-20(30 天)④ 理由 = 近30天C7赔付2次(见 C7-20260805-0011 / C7-20260818-0027) ⑤ 附件上传 2 张 C7 赔付工单 PDF |
不变量校验:① 单次负向调整 ≤ -30(-15 ✅)② 累计负向不得≥-100(当前-45 + 额外-15 = -60 ✅,≥-80 红牌暂停)③ TL 审批阈值=-80 以下才需,-60 无需 TL(OL 可直接执行 ✅) | ManualWeightAdj.id=MAN-WADJ-20260821-0143(worker=DLV-M2-000037) |
| 3 | 系统 | 权重生效:WorkerPenalty VO 新增 penalty=-15(reason=C7_FREQUENT_CLAIMS);派单引擎评分时近 30 天负向权重 = 自动 C7 累计 -45 + 人工 -15 = -60 分(近 30 天有效) | 影响:王师傅在 M2 候选评分中负向权重维度 = 原满分 100 - 60 = 40 → 综合评分 94.8(DIS-UC-02 无负向)→ 假设其他参数不变,综合 = 94.8 × 0.9(负向占 10%×0.6 扣减)= 85.3 → 后续 M2 订单王师傅排名从 #1 跌至约 #2-#3 位置(减少曝光率约 40%) | 事件:ManualWeightAdjustmentApplied(worker=DLV-M2-000037, adj=-15, by=OL-HK-007) |
| 4 | 推送 | 王师傅 lgp-app 消息中心 + 邮件:「权重调整通知 2026-08-21:近 30 天 C7 赔付 2 次,系统额外扣减 -15 负向权重,持续 30 天至 9-20;9 月 20 日后自动恢复。建议:安装前严格执行 L6 穿鞋套/地面保护流程(见 CPT L6 作业规范)以避免赔付。」 | lgp-app 通知含 L6 作业规范教学视频链接;王师傅点击「我已知晓」确认 | |
| 5 | 9 月 14 日 | 24 天无新赔付,OL 提前评估王师傅表现(L6 保护流程执行率 100% 连续 24 天) → 点击「提前恢复」 | ManualWeightAdjustment:生效截止 2026-09-14 → 提前释放;累计负向回到自动 -45(C7赔付自身的扣分保持到 9月5日、9月18日两次过期清零) | 事件:ManualWeightAdjustmentRevokedEarly(ok=yes, adjRestored=+15, by=OL-HK-007) |
关联项¶
- 关联原型:opr-admin/logistics-performance.html(Ctrl+Hover「调整权重」→ DIS-UC-05)
- 关联服务:DIS-D §3 OL 人工调整权重 · C7 保险赔付负向权重 -20~-80 规则
- 关联需求:RQD-O DSP-06 人工调整 · RQD-B DIS-06 OL 干预机制 · RQD-B DIS-05 C7 保险赔付负向
三、异常用例(5 条)¶
DIS-UC-06:陈师傅连续 2 次拒单 → 负向扣分 -25 + 30 分钟挂起¶
分类:拒单处罚 | 类型:异常 | 触发:DispatchRequestRevoked(师傅主动拒单)连续触发 2 次
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(DispatchRefusal 事件聚合) | 数据样例 |
|---|---|---|---|---|
| 1 | 10:12 陈师傅 wkr-app | 拒单 C-01 订单(唐楼 6 楼无梯沙发),拒单原因=「已接私单,时间冲突」 | DispatchRequest:OFFERED(陈师傅96.2) → REVOKED;系统分派 C-02 何师傅 93.4;写入 DispatchRefusal(worker=WPL-0188, req=DIS-0187, reasonCode=PRIVATE_CONFLICT, timestamp=10:12:44) | 拒单 1/2;累计本月拒单 4 次(阈值 5 次黄牌) |
| 2 | 10:47 陈师傅 wkr-app | 分派到新单 C-05(相邻元朗 CAT04 空调 2 匹,评分 91.8)→ 拒单原因=「不顺路,要去屯门」(拒单理由分类=UNFAVORABLE_ROUTE 不合理) | DispatchRefusal×2 连续;连续拒单聚合检测:35 分钟内连续拒 2 单 = 触发阈值 | DispatchRefusal(refusalId=DR-20260821-0143 + DR-0144);聚合间隔=34m40s(≤ 60 分钟阈值) |
| 3 | 系统 | DispatchRefusalPenalty 事件触发(WorkerPenalty VO = -25 负向 + HUNG 30 min) | ①负向权重 WorkerPenalty = -25(原因=CONSECUTIVE_REFUSAL×2)→ 写入 30 天窗口;30 分钟挂起:WPL-HK-0188.hungUntil = 10:47 + 30m = 11:17 AM;hungFlag = TRUE;② wkr-app 全屏弹窗提示「连续拒单 2 次 -25 分 + 挂起 30 分钟」含学习视频《合理拒单边界规范》+ 按钮「我已知晓」③ OL 看板轻微告警(灰色点,不严重) | penalty=-25;hungUntil=11:17:00 AM;通知推送至陈师傅手机 + 邮件 |
| 4 | 11:17:00 系统 | 自动解除挂起;WPL-HK-0188 返回 M1 候选池,但综合评分扣减 -25(假设其他=96.2,当前=96.2×0.975 ≈ 93.8 → 与何师傅 93.4 接近) | 后续 7 天:陈师傅拒单率 3.1% ≤ 5% 基准(月拒单累计 4+2=6 → 黄牌提醒 6 次,阈值 10 次红牌暂停 1 天) | 陈师傅 wkr-app 显示「本月拒单 6 次(黄牌 1 次)」警示徽章 |
| 5 | (延伸异常)若陈师傅 连续 3 次拒单 | 连续 3 次拒单(90 分钟内)→ 升级黄牌:WorkerPenalty=-80 + 挂起 4 小时 + TL 审批人工跟进 | 红牌(≥10 次或单次恶劣拒单 = 暂停 1-3 天 + BO 培训) | DispatchRefusalPenalty.rule:1次=-5 / 2次=-25+30min / 3次=-80+4h黄牌 / ≥5次红牌 |
关联项¶
- 关联原型:wkr-app/dispatch.html(Ctrl+Hover 「🔴拒单 2 次-25挂起30m」 → DIS-UC-06)
- 关联服务:DIS-D §4 DispatchRefusalPenalty 规则 · WorkerPenalty VO
- 关联需求:RQD-O DSP-05 拒单管理 · RQD-B DIS-03 师傅绩效管控
DIS-UC-07:L6 安装面板破损 → C7 保险 2,800 HKD 赔付 → 派单引擎负向权重 -60¶
分类:C7 保险赔付 | 类型:异常 | 触发:CPT L7 验收确认货损 → C7 保险定损理赔完成
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(C7InsuranceClaim 实体 + InsuranceDeduction VO) | 数据样例 |
|---|---|---|---|---|
| 1 | CPT L7 验收 | cptId=CPT-20260817-0066(CAT06 定制衣柜 12 ㎡×2.4m),验收时发现 L6 安装阶段师傅移位时背板磕碰掉漆 + 轻微变形(面积 0.3 ㎡);客户拒绝签字,要求修复+补偿 | 订单归属:M2-0073 张师傅(DLV-M2-000073);C7 投保额 = 总货值 HKD 28,000 × 1% = 保额 28,000(全险覆盖);采集现场照片 9 张 + 客户签字声明 | Claim 申请 id=C7-20260821-0033;insuredParty=张师傅/DLV-M2-000073;type=DAMAGE_INSTALLATION |
| 2 | TL 理赔审核(3 小时内) | 9 张照片 + L6 安装流程 L6.3 现场保护记录(未执行地面铺垫 ✅ 违规)→ 张师傅全责;定损 HKD 2,800 = 维修 1,200(厂家上门修复)+ 客户补偿 HKD 1,600(CPT 8% 订单金额现金券,NPS 挽回) | C7InsuranceClaim.fsm DRAFT → APPROVED → SETTLED;实际赔付 2,800(C7 保险公司);记录:Liability 100% 归于 DLV-M2-000073(张师傅) | SETTLED=2,800 HKD;LiabilityRatio=1.0(张师傅 100% 责任) |
| 3 | DIS Engine | InsuranceDeduction VO 计算:规则 deduction = -min(80, 20 + (claimAmount / 1000 × 10));负向权重取值范围 -20~-80 分,30 天窗口聚合 |
计算:20 + (2800 / 1000 × 10) = 20 + 28 = 48 → 取 -48?⚠️ 规则二版:按 DIS-D C7 条款,单次 C7 赔付 ≥ HKD2,000 且 全责 → 基础 -50 + (金额/千×10) → 50 + 28 = 78 → deduction = -78? 实际规则(TL 指示取值范围-20~-80)→ 最终取 InsuranceDeduction=-60(中等偏上,近 30 天窗口有效,C7 赔付记录 DLV 档案永久留痕) | InsuranceDeduction = -60;claim.id=C7-20260821-0033;写入 DLV-M2-000073 C7 历史(累计 3 条 = C7-20260615 / C7-20260805 + 本次) |
| 4 | DIS 派单评分池 | 张师傅(DIS-UC-04 C-05)原近30天负向权重原 -18(C7 680那次 30 天内未过期) → 现在 = -18 + 新 -60 = -78(逼近黄牌 -80 红线) | 近 7 天评分:原 68.8 综合 → 负向权重满分 100 → 实际 22 → 综合分 ≈ 68.8 × 0.22 对应扣分 = 52 分;张师傅 30 天内排名跌至 M2 候选池尾端(约 #8 / 9 条),曝光率骤降 70% | 事件:InsuranceNegativeWeightApplied(worker=DLV-M2-000073, deduction=-60, total=-78/30d);派单看板:张师傅列显示 🟡 |
| 5 | 预警 | 8 月 22 日 09:00 再触发 C7 1,200 小赔付 → 新增 -30 → 累计 30d = -108 超过红线 | WorkerSuspended(黄牌升级红牌):张师傅 M2 账号 SUSPENDED 2026-08-22 → 2026-08-29(7 天);强制 CPT L6 作业规范线下复训;考核合格后 BO 审批恢复;7 天损失预估派单量约 30 单(HKD 约 4 万营收影响) | Suspension=7d;Training=L6.3地面保护+L6.4家具搬运规范 |
关联项¶
- 关联原型:opr-admin/insurance-claims.html(Ctrl+Hover 「C7-0033 -60分」 → DIS-UC-07)
- 关联服务:DIS-D §3 C7 保险赔付负向权重规则(-20~-80) · C7InsuranceClaim 实体
- 关联需求:RQD-B DIS-05 C7 保险赔付负向策略 · CPT L6 作业规范子流程
DIS-UC-08:派单请求 30 分钟未匹配任何 M1/M2 候选 → 升级 OL¶
分类:派单超时 | 类型:异常 | 触发:DispatchRequest.fsm → createdAt + 30min 仍保持 MATCHING(未找到任何候选 OFFERED)
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(DispatchTimeout + ESCALATED 状态机) | 数据样例 |
|---|---|---|---|---|
| 1 | CPT | requestId=DIS-REQ-20260821-0227 于 14:05 创建(离岛区梅窝 CAT06 定制榻榻米 2.5m×3m×0.3m,楼梯上 3 楼无电梯,重量 78kg;预约时间 2026-08-22 14:00) | M1 WPL 池搜索:① 服务区域覆盖离岛梅窝 → 3 人;② 榻榻米技能=SKILL-CAT06-TATAMI-JP 技能矩阵命中=0 人;③ 78kg 重物搬运资格=2 人;M1 综合匹配=0 人 ✖️ | MATCHING 持续中;模式尝试 M1→M2 |
| 2 | DIS | M2 DLV 池搜索:梅窝/离岛覆盖 + 重物搬运 + 榻榻米技能 | 服务区域覆盖离岛梅窝= 2 家:M2-0095 离岛物流;M2-0112 大屿山师傅 → 榻榻米技能=0 人 + 78kg重物=1 人(M2-0095);综合 M2 匹配=0 人 ✖️ | MATCHING 持续(14:30 已 25 分钟) |
| 3 | 14:35(30 分钟超时) | DispatchTimeout 触发 → ESCALATED(状态机 3.7 DispatchRequest.fsm) | DispatchRequest.fsm:MATCHING → ESCALATED;5 条动作并行: | timeoutDuration=30m;elapsed=30m11s |
| 4 | 动作1 | OL 主看板 dispatcher.html 顶部横幅 🟠 + 声音告警:「DIS-0227 超时30m,请OL介入处理」 + 弹窗 5 个处置选项(见下) | OL工号 OL-HK-013 弹窗锁定,须点击处理(不允许关闭) | 处置选项= [① OL人工指定特定师傅 ② 放宽技能矩阵 ③ 预约改期 ④ 升级M3 ⑤ 取消订单客户补偿] |
| 5 | 动作2 | CPT L5 状态挂起:「派单中(超时)」→ CPT 异常池新增,标签 DIS_TIMEOUT_NEED_ATTENTION | 客户端 cst-app 推送:「您好,您 22 号 14:00 的订单正在加急调度师傅,预计 15 分钟内回复。如需改期请点击链接」(安抚推送) | cst-app 通知触发时间=14:35 |
| 6 | 动作3 | 模式升级尝试:M1→M2 已尝试失败 → 自动尝试 M3 CrossBorder 模式(本单非跨境但大件特类特殊政策允许) | M3 顺速物流大件项目部 → 匹配 1 人(大屿山梅窝大件经验=2次,评分综合 M3 临时覆盖本地特类= 84.3 分) | |
| 7 | OL 处置 | OL-HK-013 14:39(4 分钟内响应 SLA ≤ 10min ✅)→ 选择 ①指定 M3 顺速大件项目部 + ④放宽榻榻米基础技能要求(师傅有大型家具搬运经验即可) 两个组合 | 后台写入 DispatchEscalation 实体;ManualDispatchOverride.by=OL-HK-013,option=SPECIFY_M3_SS_LOGISTICS;重新评分时技能要求放宽(SKILL 匹配分 80 替代 100 要求) | 原因备注:梅窝特殊区域无本地SKILL,特批 M3+放宽;客户通知改 14:30 上门(客户已确认 ok) |
| 8 | 系统 | ESCALATED → MATCHING→OFFERED→M3-大件项目部 5min 内接单 | 最终派单耗时=30m超时 + 9m OL介入 + 5m接单=44 分钟(超时派单 SLA ≤60m 完成 ✅);CPT L5「师傅接单:顺速大件项目部 M3-0003 车队」 | EscalationResolved(elapsed=44m, resolvedBy=OL-HK-013) |
关联项¶
- 关联原型:opr-admin/dispatch.html(Ctrl+Hover「🟠 超时30m ESCALATED」横幅 → DIS-UC-08)
- 关联服务:DIS-D §3.7 DispatchRequest 状态机 ESCALATED · DispatchEscalation 处置实体
- 关联需求:RQD-O DSP-02 派单超时管理 · RQD-B DIS-06 OL 干预机制
DIS-UC-09:台风十号风球 → 全模式不可用 → FALLBACK 客户 L4 改期¶
分类:全模式不可用(不可抗力) | 类型:异常 | 触发:香港天文台十号风球生效 + OPS 气象联动 API
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(AllModesUnavailable 事件 FALLBACK) | 数据样例 |
|---|---|---|---|---|
| 1 | 2026-08-23 05:20 天文台 | 八号风球→十号风球(飓风级别)生效;OPS 气象联动 webhook 接收 signal=H10 生效时间 05:40 → 24:00 | H10 极端天气规则:① M1 自营师傅池 WPL 全员 WFH 不可出勤(自动 worker.available=false)② M2 独立物流商:合约条款「H8+强制休业」 → DLV.status 批量=OPERATING_BUT_SUSPENDED(不可派单)③ M3 跨境物流:深圳/香港陆路口岸(皇岗/深圳湾等)十号风球下关闭 → 所有 M3 CrossBorderContract.status=PORT_CLOSED | 受影响派单:今日 128 单 DIS-REQ 全部匹配失败;M1 可用=0;M2 可用=0;M3 可用=0;AllModesUnavailable = TRUE |
| 2 | DIS Engine | 5:42 扫描所有今日进行中 DispatchRequest(状态=MATCHING/OFFERED/ACCEPTED 尚未出发)= 128 单 → 批量 AllModesUnavailableTriggered (FALLBACK_CUSTOMER_RESCHEDULE 策略) | 统一动作(并行): | 模式策略 = FALLBACK_CUSTOMER_RESCHEDULE |
| 3 | 动作1(批量 CPT L5 → 挂起) | 所有 128 单 CPT L5 状态:「师傅已接单」/派单中 → 「📛台风十号风球 改期待确认」;CPT 异常池批量加标签 H10_WEATHER_20260823 | 128 单批量更新耗时 14 秒 ✅;写入 CPT WeatherSuspension 批量实体 | |
| 4 | 动作2(客户端 cst-app 全量推送) | 客户推送模板:「十号风球通知 织布鸟为保障师傅安全 2026-08-23 暂停上门服务。您的订单 [编号] 将自动改期至 8 月 25 日(周日)同样时间段;如不便请点击链接改期或联系客服 2788-xxxx。感谢理解。」 | 推送客户 128 户;SMS 同步发送;客服电话 IVR 语音切换至台风改期专线(按键 1 自动同意 8 月 25 日) | IVR 按键=1 → CPT L4 自动改期(约 67% 客户 1 小时内自助处理) |
| 5 | 动作3(师傅端通知) | wkr-app / lgp-app 全体推送:「十号风球 请居家避险,今日订单已全部改期至 25 日,工资照常发放(台风保障金机制),请保持通讯畅通。」师傅收入保障 CPT SLA。 | 师傅薪资照常发放保障契约条款;207 位师傅端 App push 100% 送达已读 86% | |
| 6 | 动作4(L4 签约后改期自动衔接) | 客户同意改期 8 月 25 日同样时间(92 单 IVR 自动 / 16 单客服确认 / 20 单客户主动 App 操作=合计 128) | CPT L4 合同改期:原签约日期 2026-08-23 → 新 2026-08-25;DIS 派单请求批量 clone:requestId ×128 后缀 -H10R 新增,重新排队等待 8-24 20:00 风球解除后派单 | DIS 批量生成耗时 43 秒;H10R 结尾 id= DIS-REQ-20260823-0001-H10R |
| 7 | 20:15 天文台 | 十号风球→三号风球解除;口岸恢复;师傅可出勤 | DIS 重新批量触发 128 × H10R 派单:次日 8-25 预约时段 M1/M2 师傅正常出勤(台风后补偿奖励机制 5% 订单补贴激励师傅积极接单) | AllModesUnavailable = FALSE;FALLBACK END |
关联项¶
- 关联原型:cst-app/order-detail.html(Ctrl+Hover「📛十号风球改期通知」→ DIS-UC-09)、opr-admin/dispatch.html「🟣 FALLBACK 全模式不可用」
- 关联服务:DIS-D §3 AllModesUnavailable 不可抗力 FALLBACK · CPT L4 改期条款
- 关联需求:RQD-B DIS-07 不可抗力改期 · RQD-O OPS-08 应急预案
DIS-UC-10:M3 顺速物流清关失败 → ContractExecutionFailed 回退 M2 候选池¶
分类:M3 合同失败回退 | 类型:异常 | 触发:CrossBorderContract CUSTOMS_CLEARED 状态迁移 FAIL(CUSTOMS_REJECTED)
主流程(含数据样例)¶
| 步骤 | 操作人/系统 | 操作 | 系统行为(CrossBorderContract.fsm FAILED → 回退候选池) | 数据样例 |
|---|---|---|---|---|
| 1 | 初始状态(承接 DIS-UC-03 M3 跨境模式小规模变体) | cptId=CPT-20260821-0108:CAT03 定制橱柜(深圳产 1 套,货值 HKD 52,000,深圳→香港北角);M3-0003 顺速物流派车,CrossBorderContract=CBC-M3-0003-20260821-NP(SIGNED→IN_TRANSIT→CUSTOMS_PENDING→皇岗查验) | 2026-08-21 11:20 皇岗海关:木制品熏蒸证书缺失 + 品牌商标授权文件不完整 → 海关扣件拒绝清关;CBC-M3-0003.fsm 迁移失败 | CrossBorderContract=CBC-M3-0003-20260821-NP;CUSTOMS_PENDING → FAILED(CUSTOMS_REJECTED);海关扣件通知 24 小时内补证或退运 |
| 2 | DIS Engine | ContractExecutionFailed(M3 FAILED)触发 → 两条主路径:①补救(24h内补证)② 回退 M2/M1 候选池(若 24h 内补救失败) | 失败原因码=REASON_MISSING_CUSTOMS_DOC(熏蒸证+品牌授权);海关通知最晚补证时间 2026-08-22 11:20(24 小时窗口) | 事件:ContractExecutionFailed(contract=CBC-M3-0003-20260821-NP, reason=CUSTOMS_REJECTED, remediationWindow=24h) |
| 3 | 24h 窗口内补救 | 2026-08-21 15:00 理想家居(PPL-MFR-0012)补发熏蒸证电子版 → 缺 1 张(品牌授权函)→ 2026-08-21 22:30 联系厂家但品牌方下班无响应;8 月 22 日 10:00 仍未收到 → 补救窗口剩 1h20 | 补救状态:熏蒸证 ✅ 收到 / 品牌授权 ❌ 未收到;补证进度=50%;海关拒绝部分放行 | |
| 4 | 11:20 补救超时 | ContractExecutionFailed REMEDIATION_TIMEOUT → 执行回退候选池策略(REVERT_TO_PREVIOUS_MODE_POOL) | 规则:M3 跨境订单失败 → 优先回退 M2 独立物流商 + 快件清关 + 深圳本地提货单独送件(成本增加约 35% 由 M3 顺速承担 60%,OPS 承担 40%,客户不承担加价) | REMEDIATION_TIMEOUT = 24h0m;CostIncrease=+HKD 1,850;CostSplit(M3=1,110 / OPS=740);客户价格不变 ✅(契约) |
| 5 | DIS 回退 M2 候选池 | 原 M2 候选池重新激活(4 条 DLV-M2-000037/0051/0073/0108)+ 附加筛选条件:具备独立快件清关资质(附加字段 customsExpressLicense=true) | 返回 M2 独立池 2 条有清关资质:① M2-0073 张师傅(CR 备案 + 快件清关资质 ✅ 近 180 天成功率 97.2%)② M2-0108 刘师傅(快件资质 ✅,家具经验少 3 单);评分张师傅 90.5 / 刘师傅 82.4 → 派 M2-0073 张师傅 | DLV.id=DLV-M2-000073(快件清关资质=YES);得分 90.5 |
| 6 | M2 张师傅 3 分钟接新方案 | 新跨境路径:深圳仓 8 月 23 日 → 顺丰快件独立清关(品牌授权文件 OPS 向 MFR 紧急催办 8 月 22 日 14:00 最终拿到)→ 香港分 2 个包裹:柜体 + 五金配件 → 8 月 24 日北角送达 → M1 陈师傅 8 月 25 日上门安装 | 客户延迟 2 天:原 8 月 23 → 新 8 月 25 安装;客户补偿 HKD 500 券(OPS 口碑侧 LowNPSSalvage 等价补偿 = 保证 NPS 不下降);CPT L4 签约后改期条款 ✅ | 补偿券=HKD 500;OPS 侧 OPS-UC-08 等价挽回路径;最终客户 NPS=8(PASSIVE) |
| 7 | 后续追责 | CrossBorderContract CBC-M3-0003:SLA 违反条款(清关失败=非客户责任),顺速物流合同罚款条款:延误 24h 罚款 0.5% × 合同价 = HKD 260;计入下月度结算抵扣 | DLV 档案永久留痕:顺速物流近 90 天 SLA 99.1% → 98.4%(下降 0.7 个百分点);下月 M3 模式推荐评分微调 -2 | Fine = HKD 260;M3 下次派单评分减分:-2(轻微,0.7%波动可接受);事件:ContractExecutionSettlementCompleted(failed=YES, reverted=M2, penalty=260) |
关联项¶
- 关联原型:opr-admin/dispatch.html(Ctrl+Hover「M3失败回退 M2 🔀」→ DIS-UC-10)
- 关联服务:DIS-D §3 CrossBorderContract.fsm FAILED 回退 · DLV M3 合同违约罚则
- 关联需求:RQD-O DSP-04 M3 跨境合同 · RQD-B DIS-04 回退策略稳定性
四、交叉索引表(模式 × 原型 × 用例 × 需求)¶
| DIS 模式 | 覆盖用例 | 对应原型页面 | 对应需求 RQD-B/O | 对应 DIS-D 章节锚点 |
|---|---|---|---|---|
| M1 自营(INTERNAL) | DIS-UC-01/06 拒单 | opr-admin dispatch.html · wkr-app dispatch.html | RQD-B DIS-01 · RQD-O DSP-01/05 | DIS-D §3 M1 模式 + DispatchRefusal 规则 |
| M2 独立(INDEPENDENT) | DIS-UC-02/05 人工权重/07 C7 赔付 | lgp-app dispatch.html · opr-admin logistics-performance.html · insurance-claims.html | RQD-B DIS-02/03/05/06 · RQD-O DSP-03/06 | DIS-D §3 M2 模式 + WorkerPenalty VO + C7 Deduction -20~-80 |
| M3 跨境物流(CROSSBORDER) | DIS-UC-03 工程级/10 失败回退 | opr-admin dispatch.html 跨境追踪 + b2b-reconciliation | RQD-B DIS-04 · RQD-O DSP-04 | DIS-D §3 M3 + CrossBorderContract 状态机 + FAILED 回退策略 |
| 全模式/跨模式/管理 | DIS-UC-04 跨模式评分/08 超时/09 台风不可用 | opr-admin dispatch.html(跨模式表/🟠超时/🟣FALLBACK)· cst-app 台风改期页 | RQD-B DIS-04/06/07 · RQD-O DSP-02/08 | DIS-D §4 DispatchDecisionEngine + DispatchRequest.fsm ESCALATED + AllModesUnavailable FALLBACK |
本文件为 DIS-UC(派单服务用例库)V1.0,DDD 设计:DIS-D V1.0,MDS 主数据对齐:DLV 物流商档案库设计 V1.1,BAS 限界上下文:业务架构说明 §三 DIS 服务边界。