跳转至

OPS 运营服务用例库（OPS-Usecase Library）

文档编号：DOC-A08-OPS / OPS-UC 版本：V1.0 创建日期：2026-08-21 维护人：TL / DT 关联文档：用例库总索引 README.md、OPS-D 运营服务设计、BAS 业务架构说明、DIS-D 派单服务设计、原型 opr-admin

一、用例清单总览

编号 分类 用例名称 典型/异常 覆盖BC/聚合根 状态
OPS-UC-01 获客 SCENE 01 线上投放 → CPT L1 批量线索入站（预算扣减+UTM校验） 典型 AcquisitionOps / MarketingCampaign ✅
OPS-UC-02 B端 SCENE 03 电商平台批量订单导入（LGP分润≤12%校验） 典型 AcquisitionOps / BPartnershipContract ✅
OPS-UC-03 物料 F组口碑物料（服务卡片+师傅名片）发布上线（A/B变体） 典型 MaterialOps / SalesMaterial ✅
OPS-UC-04 口碑 CPT L8 NPS 10 → 推荐激励双向发放（HKD 100×2） 典型 WoMMarketing / ReputationLoop ✅
OPS-UC-05 徽章 陈师傅累计12单SLA100% + L8≥4.5 → 授予「准时服务+高满意度」双徽章 典型 WoMMarketing / TrustBadgeGrant ✅
OPS-UC-06 异常-预算 SCENE01投放单日消耗超预算HKD 50,000 → CampaignBudgetExceeded阻断 异常 MarketingCampaign 不变量② ✅
OPS-UC-07 异常-物料 SCENE04启动时D组追踪物料缺项D4 → MaterialCombinationMissing通知ML 异常 SceneMaterialCombination 实体 ✅
OPS-UC-08 异常-低分 CPT L8 NPS=5（DETRACTOR）→ LowNPSSalvageTriggered挽回流程+OL派单 异常 ReputationLoop（ELIGIBLE→INELIGIBLE→ELIGIBLE） ✅
OPS-UC-09 异常-循环 A推荐B→B推荐C→C推荐A 三跳闭环 → IncentiveLoopDetected阻断发放 异常 ReputationLoop 不变量④ ✅
OPS-UC-10 异常-分润 MFR渠道月度对账某笔分润15.8%>合同约定15% → PartnershipCommissionExceeded阻断+告警TL 异常 BPartnershipContract 不变量④ ✅

二、典型用例（5 条）

OPS-UC-01：SCENE 01 线上投放 → CPT L1 批量线索入站

分类：获客运营 | 类型：典型 | 触发：OL 在运营后台 opr-admin/campaigns.html 点击「发布 SCENE 01 Facebook 投放」

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（DDD 校验） 数据样例
1 OL 进入「运营-营销活动」选择 MarketingCampaign.id=SC01-FB-202608W3，预算=HKD 50,000，周期=2026-08-21~2026-08-27 不变量①校验：ChannelUTM(scene=SC01, period=W3, source=FB) 全局唯一 → 通过；当前 spentAmount=28,450 ≤ 50,000 → 不变量②通过 campaignId: SC01-FB-202608W3, utm: ?utm_source=fb&utm_medium=cpc&utm_campaign=SC01-W3
2 OL 配置落地页表单字段 + 绑定 A 组 F1 信任物料页 SalesMaterial 状态机校验 F1.type=TRUST_BADGE_PAGE.status=ACTIVE → 正常绑定；A/B split: 70% 控制组 30% 变体 materialIds: [MAT-F1-A01(ACTIVE v3), MAT-F1-A02(ACTIVE v2, 30%流量)]
3 OL 点击「上线投放」 MarketingCampaign.fsm RUNNING；触发 CampaignLaunched 事件 → 推送到 FB 广告管理 API Campaign.status: RUNNING
4 系统 24 小时用户点击广告 → 落地页填写需求表单提交 不变量③校验：每条 L1 线索自动标注 campaignId=SC01-FB-202608W3 + utm 完整；缺任何字段 → 线索驳回+日志 日累计：点击 1,280 → 线索 62 条（转化率 4.8%，符合场景基准 3-5%）
5 系统 62 条线索调用 LeadIntakeService.batchImport([62条]) → 写 CPT L1 入站表 批量校验：CPL.marketingConsent=GRANTED 客户 62/62 通过；0 条 ConsentViolationBlocked 事件：BatchLeadsImported(count=62, campaignId=SC01-FB-202608W3)
6 系统 spentAmount 实时扣减：当日消耗 HKD 8,200 8,200/50,000 = 16.4%，ChannelROI = 62 线索 / 8200 HKD = 0.0076 → abnormalFlag=🟢（正常区间） spentAmount: 36,650 / 50,000

异常分支

  • 步骤1 UTM重复：同期同SC01-FB-W3已存在 → 不变量① UTM唯一失败 → 提示「该UTM组合本周期已被SC01-FB-202608W2占用，请修改渠道或周期」
  • 步骤6 预算临界：spentAmount ≥ 47,500（95%线）→ CampaignBudgetWarning 事件 → OL 邮件提醒；≥50,000 → 见异常用例 OPS-UC-06

关联项

OPS-UC-02：SCENE 03 电商平台批量订单导入

分类：B端合作 | 类型：典型 | 触发：某电商平台每日 18:00 API 推送当日安装订单至 OPS

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（DDD 校验） 数据样例
1 电商 API HTTPS POST 批量订单 47 条（签名=Contract.id=BC-ECOM-TMALL-2026 的公钥签名） BPartnershipContract.status=OPERATING 校验 ✅；签名校验 ✅；type=ECOMMERCE_OUTSOURCING contractId: BC-ECOM-TMALL-2026，分润阶梯=12%
2 OPS LeadIntakeService.batchImport([47 条]) 前置分润≤12% 校验 不变量④校验：逐条计算预估 commissionRate：45 条 8-10% ✅；2 条大件 11.8% ✅（<12%）；0 条超 预估总分润：HKD 24,680（平台 47 单成交价总值 HKD 258,200 × 9.56% 平均）
3 OPS 47 条 → CPT L1 批量入站（sourceRef=SC03-TMALL） + QSV 批量报价请求 事件 BatchLeadsImported(count=47, channel=SC03) + 47 × QsvQuoteRequested 事件 CPT L1 入站 ID 范围：CPT-L1-20260821-0143 ~ 0189
4 CPT/QSV 异步处理：L2 需求确认（CAT01 家具 29/CAT02 灯具 11/其他 7）→ QSV PricingEngine 返回报价 报价总金额：HKD 186,440；批量耗时：2.3 秒 场景基准：线索→报价 80%（本批 47/47=100%，批量导入预填需求）
5 OL 次日 10:00 看板对账：47 条全部 L2 通过，3 条客户改期 → CPT L2→L3 流转 无异常 PartnershipReconciliation VO 累计本月：287 单 / 分润 HKD 158,200

异常分支

  • 步骤1 合同非激活：Contract.status=RECONCILING → 拒绝接收，返回 HTTP 403 {"error":"ContractNotOperating"}
  • 步骤2 分润超 12%：见异常用例 OPS-UC-10 模拟 MFR 15.8% 场景

关联项

OPS-UC-03：F 组口碑物料（服务卡片 + 师傅名片）发布上线

分类：物料运营 | 类型：典型 | 触发：ML 物料专员在 opr-admin/materials.html 提交 F 组新版物料审核

主流程（含数据样例）

步骤 操作人 操作 系统行为（DDD SalesMaterial 状态机） 数据样例
1 ML 上传 F1 服务卡片 HTML 新版（完工照片轮播+报价明细折叠+NPS分享按钮）+ 变体 V2：增加微信朋友圈分享图 SalesMaterialRepository 写入 2 条：type=SERVICE_CARD，status=DRAFT；abVariant=CONTROL/V2 materialIds: MAT-F1-CARD-007 (CONTROL v7 DRAFT), MAT-F1-CARD-007-V2 (v7-beta DRAFT)
2 ML 关联 8 场景（SC01~SC08）最小必需集 → SceneMaterialCombination 批量创建 缺项校验：F组物料完整（F1/F2/F3/F4/F5），最小必需集 5/5 ✅ → 不触发 MaterialCombinationMissing
3 ML 提交审核 → DRAFT → REVIEW SalesMaterial.fsm REVIEW 状态转移；触发 MaterialSubmittedForReview 事件 → 通知 TL Material.status: REVIEW（TL 待审）
4 TL 审核通过（样式+法律合规+PDPO授权声明检查） REVIEW → APPROVED；版本号 v7（上一版 v6 → RETIRED）；触发 MaterialVersionActivated 事件 version=7，上架时间 2026-08-21 14:00 HKT
5 系统 APPROVED → ACTIVE（状态机 3.7.2） CPT L6/L7 完成后默认携带的 F1 卡片链接，生效时间精确到分钟；A/B 变体流量分配 70:30 线上 14:00 后新完成订单，30% 显示 V2 变体
6 ML 3 天后 A/B 报告：V2 分享率 8.2% vs 控制组 5.1%（显著提升 60%） 建议 V2 提为 CONTROL；旧版 v7 CONTROL → RETIRED，V2 → 新 CONTROL v8 事件：MaterialABVariantPromoted(MAT-F1-CARD-007-V2 → v8 CONTROL)

异常分支

  • 步骤2 最小必需集缺项：F2 师傅名片 PDF 上传失败 → 触发 MaterialCombinationMissing(scene=ALL, missingMat=F2) → 通知 ML 补全，禁止提交审核
  • 步骤4 审核驳回：TL 发现 V2 分享图隐私水印缺失 → 状态 REVIEW → DRAFT，驳回原因「朋友圈分享图未添加客户照片脱敏水印」，ML 修改后重新提交

关联项

OPS-UC-04：CPT L8 NPS 10 → 推荐激励双向发放

分类：口碑运营 | 类型：典型 | 触发：CPT L8 回访流程完成，客户 NPS=10（最高）

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（DDD ReputationLoop 状态机） 数据样例
1 CPT 完成 cptId=CPT-20260818-0052（李小姐 CAT02 客厅吊灯安装）的 L8 回访 提交 NpsBand VO：score=10 → 分类 PROMOTER；意愿=「愿意推荐2位以上朋友」；推荐人 CPL.id=CPL-HK-002381（李小姐） NpsBand={score: 10, band: PROMOTER, recommendIntent: HIGH}
2 OPS BadgeEligibilityService 检查 ReputationLoop 聚合根 eligibility 不变量③徽章条件不可绕过：CPL.marketingConsent=GRANTED ✅、历史订单数=2 ✅（≥1 单）、opt-out=NO ✅ ReputationLoop.status：DORMANT → ELIGIBLE（fsm 3.7.3）
3 OPS 发送「推荐有礼」邀请（WhatsApp 模板消息 + 邮件） 推荐链接：https://wlyt.hk/r/KOC-2381-NPS10（有效期 90 天，双向 HKD 100） 推荐码 KOC-2381-NPS10；IncentiveIssued VO（面额 100×2）
4 客户操作 李小姐 → 推荐闺蜜 R小姐（CPL.id=CPL-HK-004012 新客）通过链接下单 点击 → 新 CPT L1 标注 campaignId=REF-2381-0052 + 来源 REFERRAL；不变量③ CPL-004012 L1 含 campaignId ✅ 新订单：CPT-L1-20260822-0003（R小姐卧室CAT01床架安装）
5 CPT → OPS R小姐订单 2026-08-25 L7 验收通过 验收 → 触发 RecommendationCompleted 事件（{referee: CPL-HK-002381, referral: CPL-HK-004012}） 推荐链路 CPL-2381 → CPL-4012：1跳
6 OPS IncentiveSettlementService 不变量④循环检测：A→B→A三跳 DFS 路径=2381→4012，2381推荐历史=[], 4012推荐历史=[] → 无闭环 ✅ 通过；双激励发放：李小姐 100 HKD 券（SKU=INC-REF-100-26Q3）+ R小姐 100 HKD 复购券 ReputationLoop.fsm ELIGIBLE → ISSUED → REDEEMED；IncentiveIssued→REDEEMED 2 条流水
7 写回链路 经 CPT → MDS ACL 写回 CPL-HK-002381.kocTier=BRONZE（累计推荐 1 次，升 KOC）+ trustBadges 新增「推荐达人」（同步 OPS-UC-05 徽章路径） 事件：IncentiveSettlementRecorded × 2 + RecommendationRelationUpdated

异常分支

  • 步骤2 未授权客户：CPL.marketingConsent=DENIED → ReputationLoop INELIGIBLE → 不发送推荐邀请
  • 步骤6 循环链路：A→B→C→A 三跳闭环 → 见 OPS-UC-09 异常用例
  • 步骤6 券过期：链接有效期 90 天未使用 → ReputationLoop ISSUED → EXPIRED；激励回收入库

关联项

OPS-UC-05：陈师傅「准时服务 + 高满意度」双徽章授予

分类：信任徽章 | 类型：典型 | 触发：CPT L8 月度批量聚合任务（每月 1 日 02:00）

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（DDD BadgeEligibilityService） 数据样例
1 OPS 定时任务 BadgeEligibilityService.batchRun(period=2026-08) 遍历全量 WPL 师傅 + CPL 客户 8 月新完工订单 CPT 聚合 WPL.id=WPL-HK-0188（陈师傅，SK2 等级）、CPT 订单 14 单
2 徽章 1 校验 TrustBadgeGrant.type=PUNCTUAL_SERVICE，BadgeCondition：SLA 达成率 = 准时单数/总单数 = 100% ≥ 100% 阈值 AND 累计 ≥ 5 单（=14 ✅） 不变量③：陈师傅L5/L6迟到记录=0单 → 14/14准时=100% ✅ 条件满足 punctualRate = 100% (14/14)
3 徽章 2 校验 TrustBadgeGrant.type=HIGH_SATISFACTION，BadgeCondition：L8 评分均值 ≥ 4.5 AND 累计 ≥ 10 单 L8 评分 14 单平均=4.71（最高5×6，4×8，合计66/14=4.71 ✅）；单数 14 ≥ 10 ✅ avgSatisfactionScore = 4.71, n=14
4 OPS 生成 2 条 TrustBadgeGrant 实体，状态 ELIGIBLE → ISSUED（ReputationLoop.fsm）；写 WPL 档案前 不变量③校验：无手动绕过API记录，审计日志 BadgeGranted × 2 写入 badgeGrantIds=TBG-W188-PUNC-202608, TBG-W188-HSAT-202608 事件：TrustBadgeGranted × 2；WPL.workerId=WPL-HK-0188 trustBadges 字段新增 2 枚
5 写回链路 经 CPT → MDS ACL 写回 WPL（L2 内部级字段） 公开侧：师傅展示页、推荐名片、服务卡片公开展示「准时💯」「好评⭐⭐⭐⭐⭐」标识（PrivacyDesensitizationService 脱敏校验：仅展示徽章图标，不展示评分明细 ✅） WPL-HK-0188 公开主页徽章栏更新；同步物料 F2 师傅名片 V8 缓存刷新

异常分支

  • 步骤2 刚够门槛不满足：14单中1单迟到（13/14=92.8%<100%）→ PUNCTUAL_SERVICE 不授予，写入解释日志「L6/L7 有1单 SLA 超时 12min，记录编号=SLA-20260815-011」
  • 步骤4 手动绕过：OL 尝试直接 API 调写 TrustBadgeGrant → 不变量③ 拦截 → PrivacyViolationException，返回「徽章必须经 BadgeEligibilityService 批处理」

关联项

三、异常用例（5 条）

OPS-UC-06：SCENE 01 投放单日消耗超预算 → 阻断

分类：预算异常 | 类型：异常 | 触发：MarketingCampaign.spentAmount 超 budgetAmount 阈值

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（不变量②触发） 数据样例
1 投放进行中 SC01-FB-202608W3 投放第 5 天，FB API 回传当日累计消耗 HKD 15,200 累计 spentAmount = 42,300 + 15,200 = HKD 57,500 budgetAmount = 50,000 HKD → 超出 7,500（15% 超额）
2 OPS 不变量② spentAmount ≤ budgetAmount 校验 FAIL 触发 CampaignBudgetExceeded(campaignId=SC01-FB-202608W3, overrun=7500) 事件 → 3 个后续动作并行 事件：CampaignBudgetExceeded
3 动作 1（自动执行） 立即调 FB Marketing API pause_ad_set() 暂停投放 30 秒内 API 返回 OK；MarketingCampaign.fsm RUNNING → SUSPENDED（预算暂停子状态） 投放链接：fb.com/ads/manage/... 提示 Campaign Suspended
4 动作 2（通知） 邮件 + 企业微信告警 OL + TL 双审 告警正文：「SC01-FB-202608W3 投放预算 HKD50,000，已消耗 57,500，超额 15%」；附 3 个处理选项（增预算/调降出价/结束投放） 收件人：OL-xxx@wlyt.hk, TL-xxx@wlyt.hk
5 动作 3（监控看板） 漏斗看板 ROI 标记 🔴 abnormalFlag 历史 ROI=3.2 → 当前 ROI=2.7（流量质量下降），CAC 二级预警 🔴 阈值 = 2.5× 基准 = HKD 400/线索 实际 CAC=HKD 448（57500/128线索）> 400 🔴
6 TL 处理 审批追加预算 HKD 15,000 → budgetAmount=65,000 校验 spentAmount ≤ 65,000 (57500 ✅) → RUNNING 恢复；追加预算写入 MarketingCampaign.budgetAdjustments 审计 追加备注：「W3 中期 ROI 仍 2.7>1.5 基准，追加至 65,000，关注剩余 2 天转化」

关联项

OPS-UC-07：SCENE 04 启动时 D4 验收单物料缺项 → 告警

分类：物料缺项 | 类型：异常 | 触发：SCENE 04（物流引荐场景）上线前最小必需集校验 FAIL

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（SceneMaterialCombination 校验） 数据样例
1 OL 配置 SCENE 04（中港物流引荐）上线物料组合：勾选 F1 信任页、B2 批量报价单、D 组追踪物料 D1/D2/D3/D4（验收单 PDF）/D5 SceneMaterialCombination.scene=SC04，最小必需集清单定义=[F1, B2, D1, D2, D3, D4, D5]
2 系统 校验对应物料 SalesMaterial.status=ACTIVE F1(ACTIVE) ✅, B2(ACTIVE) ✅, D1(ACTIVE) ✅, D2(ACTIVE) ✅, D3(ACTIVE) ✅, D4=MAT-D4-ACCEPT-004.status=REVIEW（未通过审核） ❌ D4 状态=REVIEW（ML 上传新版验收单后，TL 待审批中）
3 OPS 最小必需集缺项 → 触发 MaterialCombinationMissing(scene=SC04, missing=[D4]) 事件 2 个动作：①禁止 SC04 上线（按钮灰掉，tooltip「缺D4验收单物料」）②通知 ML + TL 看板消息「SC04 缺项：MAT-D4-ACCEPT-004 仍在 REVIEW，请催促审批」 事件：MaterialCombinationMissing；推送对象：ML@wlyt.hk + TL企业微信
4 TL 收到通知，进入 materials.html 审批 D4 验收单（核实验收条款+SLA 罚则 PDPO 合规 ✅） REVIEW → APPROVED → ACTIVE（状态机 3.7.2） D4 版本=5，激活时间 11:20
5 系统 10 秒后缓存刷新 → SceneMaterialCombination 自动重验 = [7/7 ACTIVE ✅] SC04 上线按钮解除禁用，OL 可点击发布

关联项

OPS-UC-08：CPT L8 NPS=5（DETRACTOR）→ 挽回流程启动

分类：低分挽回 | 类型：异常 | 触发：CPT L8 采集 NPS ≤ 6

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（NpsBand=DETRACTOR + LowNPSSalvageTriggered） 数据样例
1 CPT cptId=CPT-20260815-0119（王先生 CAT03 定制衣柜跨境安装）L8 回访完成 NPS 评分=5（DETRACTOR 分档），问题描述：「L6 安装时衣柜面板磕碰 2cm 划痕未及时处理」 NpsBand={score: 5, band: DETRACTOR, salvagePriority: HIGH}
2 OPS LowNPSSalvageTriggered 事件触发 → 两条联动 ① ReputationLoop ELIGIBLE → INELIGIBLE（暂不推荐/复购激励）② CPT 异常池「问题客户」新增条目，分配 OL 工号 OL-HK-027，24 小时 SLA 指派：OL-HK-027（客户满意度组），SLA 截止=2026-08-22 18:00
3 OL 2 小时内电话联系王先生：道歉 + 提出上门修复（免费补漆+HKD 200 补偿券） 王先生接受 → CPT 异常工单 WORKORDER-SALVAGE-20260821-017 创建 补偿券 SKU=INC-LOWNPSSALV-200-26Q3（REDEEMABLE）
4 CPT 8 月 22 日 10:00 陈师傅上门补漆修复 → 客户签字确认修复完成 L6 现场返工记录 + 完工照片；工单状态 RESOLVED 修复耗时 1.5h，照片 6 张上传 CPT L6 附件
5 OPS CPT L8 二次回访（修复满意度） 修复后 NPS=8（PASSIVE，从 DETRACTOR 回升 3 分）；不变量③修复确认 → ReputationLoop INELIGIBLE → ELIGIBLE（状态回转，允许后续激励资格恢复） 二次 NPS=8 PASSIVE；补偿券 200 HKD 状态 REDEEMED
6 写回 经 CPT → MDS ACL → CPL-HK-003357 标签新增「L8_DETRACTOR_SALVAGED」（精准营销黑名单 3 个月，不参与高强度投放） CPL 标签；避免 30 天内再推送广告防止骚扰 事件：LowNPSSalvageCompleted(ok=true, deltaNPS=+3)

异常分支

  • 步骤3 客户拒绝挽回：电话沟通王先生要求退款 50% → 升级 TL 商务谈判 → 升级 BO 财务处理（退款路径非 OPS 职责）；ReputationLoop INELIGIBLE 持续

关联项

OPS-UC-09：推荐三跳闭环（A→B→C→A）→ 激励发放阻断

分类：激励循环异常 | 类型：异常 | 触发：RecommendationCompleted 后不变量④ IncentiveLoopDetection DFS 检测 FAIL

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（不变量④：循环检测） 数据样例
1 历史链路 3 条推荐链路记录：① CPL-A（陈先生 000011）→ CPL-B（何小姐 000027）2026-07 成交 ② CPL-B → CPL-C（郭先生 000039）2026-07 成交 ③ CPL-C → CPL-A 2026-08-20 新成交（本次待结算） 推荐链 CPL-000011→000027→000039→000011 → 三跳闭环 A→B→C→A；3 人互推套取双向激励
2 OPS 步骤 6 执行 IncentiveSettlementService.settle(CPL-C→CPL-A) 前 不变量④循环检测 DFS 搜索 findCycle(start=CPL-A, target=CPL-A, maxDepth=5) → 返回路径长度=3（阈值 ≤5 命中）；闭环包含 3 个客户 ID → FAIL 循环路径：[000011 → 000027 → 000039 → 000011]（3跳）
3 OPS 不变量④ IncentiveLoopDetected 事件触发 → 4 条动作并行 ①本次激励发放完全 BLOCKED（不发 C / A 任何券，状态保持 ELIGIBLE 不进入 ISSUED） 事件：IncentiveLoopDetected(members=[000011,000027,000039], pathLength=3)
4 动作 2 CPL 标签写回（经 CPT ACL） 3 人均增加标签=LOOP_SUSPECT_KOC（推荐达人资格暂停 6 个月审计）；推荐码 KOC-xxx-NNNN 暂时失效（点击提示活动审核中） CPL.loyaltyStatus = SUSPENDED（×3）
5 动作 3 OL + TL 双告警，附审计报告 PDF 报告内容：3 人 IP 均为香港旺角某网咖公共 WiFi（登录 5 次重叠 80%）、收货地址 3 家均为同一栋唐楼 3 层 3 个相邻单位、下单时间集中 2026-07 周二下午 14-17 点 → 高度疑似团伙刷单 嫌疑分：92/100（高风险）
6 动作 4 ReputationLoop 聚合根 INELIGIBLE 冻结（三人全部） 3 人徽章、KOC、推荐资格全部暂停；ReputationLoop 状态 ELIGIBLE → INELIGIBLE；直到 TL 人工审核结论后解冻 待 TL-审批-手动-撤销-或-确认欺诈-转财务追责

关联项

OPS-UC-10：MFR 月度对账某笔分润 15.8% 超合同 15% → 阻断结算

分类：B端分润异常 | 类型：异常 | 触发：PartnershipReconciliation VO 对账批次执行校验 FAIL

主流程（含数据样例）

步骤 操作人/系统 操作 系统行为（BPartnershipContract 不变量④ ≤15%） 数据样例
1 OPS 月结 2026-08 MFR 生产商渠道月度对账：Contract.id=BC-MFR-IDEALHOME-2025（品牌：理想家居，分润阶梯：年成交额 ≥500 万 HKD → 15% 封顶，当前累计 4,872,000 → 12% 正常档位） 本批次订单 128 条，预估总分润：逐条计算 commissionAmount = dealAmount × tieredRate dealAmount 合计 = HKD 628,400；合同条款 tieredRate ≤ 15%
2 OPS 逐条校验 第 79 条 cptId=CPT-20260817-0093：dealAmount=HKD 42,800（定制化工程项目，MFR 后台上传分润率申请=15.8%） 不变量④校验 15.8% > 合同约定 15%（封顶值） FAIL commissionRequested = 42800 × 15.8% = HKD 6,762.40 → 允许上限 = 42800 × 15% = HKD 6,420 → 超出 HKD 342.40
3 OPS PartnershipCommissionExceeded 事件触发 → 4 条动作 ①整条对账批次 HOLD 挂起（不生成结算单） 事件：PartnershipCommissionExceeded(contractId=BC-MFR-IDEALHOME-2025, cptId=CPT-20260817-0093, excess=342.40 HKD, excessRate=0.8%)
4 动作 2 MFR 门户 mfr-portal dashboard.html 「对账中心」红字提示：本批次 128 条含异常订单，禁止确认回执 mfr-portal 同步显示：⚠️ 订单 CPT-20260817-0093 分润率 15.8% 超过合同约定 15%，请修正或联系客户经理 MFR 指定联系人收到邮件+短信
5 动作 3 TL + BO（商务对接人）双告警：附该订单报价明细对比 报告：理想家居 CPT-0093 报价明细（QSV V1.2 PricingEngine 计算）显示 MFR 产品占比=HKD28,000/42,800=65%；按 15% 应付分润 6,420 而非 6,762.40；差额原因=MFR 财务接口误填 15.8%（旧合同值尚未更新）
6 BO 与 MFR 沟通后：MFR 确认合同分润 15% 正确 → 后台 API 修正该条 rate=15% → 重算 commission=6,420 HKD ✅ OPS 批次重新校验：128 条全部 ≤15% ✅；PartnershipCommissionExceeded CLEAR；批次 HOLD → UNLOCKED → 生成结算单 事件：PartnershipCommissionCorrected(ok=true, correctedAmount=-342.40)
7 FL 财务 3 工作日内转账：结算金额 = Σ128 条（含 CPT-0093 修正后）= HKD 75,408（原预估 75,750.40 - 342.40 = 75,408） PartnershipReconciliation VO 本月状态 RECONCILED → SETTLED

关联项

四、交叉索引表（服务 × 原型 × 用例 × 需求）

OPS 服务限界 覆盖用例 对应原型页面 对应需求 RQD-B 对应 OPS-D 章节锚点
AcquisitionOps BC（获客） OPS-UC-01/02/06/10 opr-admin/campaigns.html / b2b-orders.html / b2b-reconciliation.html / mfr-portal/dashboard OPS-01/OPS-05/OPS-06/OPS-10 §三.3.1 MarketingCampaign · §八 B端合作 · §九.9.1 QSV对接
MaterialOps BC（物料） OPS-UC-03/07 opr-admin/materials.html OPS-03/OPS-09 §三.3.2 SalesMaterial · §六 7组物料 · §6.3 SceneMaterialCombination
WoMMarketing BC（口碑） OPS-UC-04/05/08/09 opr-admin/reputation.html / worker-profile.html / customer-issues.html OPS-04/OPS-07/OPS-08 §三.3.3 ReputationLoop · §七 口碑营销 · 状态机3.7.3

本文件为 OPS-UC（运营服务用例库）V1.0，需求来源：RQD-B OPS-01~10，DDD设计：OPS-D V2.1 §二+§三，关联 DIS 派单服务：DIS-D V1.0。