MDS 主数据服务用例库（MDS-Usecase Library）
文档编号：DOC-A08-MDS / MDS-UC
版本：V1.0
创建日期：2026-08-21
维护人：TL / DT
关联文档：用例库总索引 README.md、MDS-D 主数据服务设计、BAS 业务架构说明、原型 opr-admin
一、用例清单总览
| 编号 |
分类 |
用例名称 |
典型/异常 |
覆盖库 |
状态 |
| MDS-UC-01 |
SCL |
新增 CAT07 智能窗帘品类 + 基础费率录入 |
典型 |
SCL |
✅ |
| MDS-UC-02 |
BPL |
L2 楼宇现场核实 → 修正唐楼 5 楼系数 1.8 |
典型 |
BPL |
✅ |
| MDS-UC-03 |
WPL |
招募新师傅 SK2 等级 + 技能矩阵 + 服务区域配置 |
典型 |
WPL |
✅ |
| MDS-UC-04 |
CPL |
CPT L8 NPS 9 分 → 复购意向升级 + 授予「优质客户」徽章 |
典型 |
CPL |
✅ |
| MDS-UC-05 |
DLV |
M2 独立物流商签约 + 九龙西区域配置 |
典型 |
DLV |
✅ |
| MDS-UC-06 |
WPL-异常 |
月度综合评分 62 分 → SK3 降级 SK2（WorkerDowngraded 事件） |
异常 |
WPL |
✅ |
| MDS-UC-07 |
BPL-异常 |
楼宇系数 120 天未核实 + 累计偏差 18% → 触发 BuildingCoefficientExpired |
异常 |
BPL |
✅ |
| MDS-UC-08 |
CPL-异常 |
同一客户手机号 9123**** 重复建档 → 触发 CustomerConflictRaised + 人工合并 |
异常 |
CPL |
✅ |
| MDS-UC-09 |
安全-异常 |
SupplyAPIService 向 QSV 返回客户地址时明文输出 → 脱敏服务拦截 + 告警 |
异常 |
全库 |
✅ |
| MDS-UC-10 |
ID-异常 |
PPL 批量录入时 ID 编码冲突（PPL-20260821-0001 重复）→ MasterDataIdService 冲突检测 + 回滚 |
异常 |
PPL |
✅ |
二、典型用例（5 条）
MDS-UC-01：SCL 新增 CAT07 智能窗帘品类
分类：SCL 品类维护 | 类型：典型 | 触发：OL 在运营后台「主数据-SCL」点击「新增品类」
主流程（含数据样例）
| 步骤 |
操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
OL |
进入 opr-admin → 主数据 → SCL 品类管理，点击「新增品类」 |
打开新增品类表单，MasterDataIdService 预生成 sclId = SCL-20260821-0014（前 13 条为 CAT01~06） |
sclId: SCL-20260821-0014，状态 DRAFT |
| 2 |
OL |
填写品类基础信息：一级=家具软装、二级=窗帘系列、三级=智能电动窗帘 |
SixLibraryEntityFactory 校验不变量①：(SCL, CAT07-CURTAIN-SMART) 组合全局唯一，无重复 |
libraryCode=SCL，businessKey=CAT07-CURTAIN-SMART |
| 3 |
OL |
录入基础费率表：标准尺寸（宽≤3m，高≤2.8m）基础安装费 HKD 600；电机配置另计 |
CatalogRateFactor VO 构造：baseFee=HKD 600，productParams=[{电机类型: 直流→+HKD 300 / 交流→+HKD 150}, {轨道长度: 每+1m→+HKD 80}] |
baseFee=600 HKD，skillRequirements=[SK2: 电工证+智能家居培训] |
| 4 |
OL |
配置技能要求：SK2 及以上 + 持有「智能家居安装证书」 |
SkillMatrix VO 对齐 WPL 技能字典：certCategory=HOME_SMART，minLevel=SK2 |
|
| 5 |
OL |
提交审核（DRAFT → PENDING_REVIEW） |
触发 MasterDataUpdated 事件（载荷：stage=PENDING_REVIEW） |
event: MasterDataUpdated(libraryCode=SCL, entityId=SCL-20260821-0014) |
| 6 |
BO |
审核通过 |
状态 PENDING_REVIEW → ACTIVE；返回 SUCCESS + ACTIVE 版本号=1 |
|
| 7 |
系统 |
供给缓存刷新 |
QSV PricingEngine 收到 MasterDataUpdated 事件，刷新 SCL 缓存。QSV-UC-01~05 后续可正常引用 CAT07 品类 |
|
异常分支
- 步骤 2 冲突：若
CAT07-CURTAIN-SMART 已存在 → 提示「品类业务键重复」，禁止提交
- 步骤 6 驳回：BO 驳回 → 状态回退 DRAFT，附带驳回原因，OL 修改后重新提交
关联项
MDS-UC-02：BPL 楼宇现场核实修正系数
分类：BPL 楼宇校准 | 类型：典型 | 触发：CPT L2 阶段师傅现场核实后提交楼宇差异
主流程（含数据样例）
| 步骤 |
操作人/系统 |
操作 |
系统行为 |
数据样例 |
| 1 |
师傅（WPL） |
CPT L2 阶段，现场核实楼宇「旺角唐楼 XX 号」：无电梯 + 实际 5 楼 + 走廊狭窄 |
CPT 采集差异：原 BPL 档案 bplId=BPL-20260801-0032，系数 1.5；实际应为 1.8 |
bplId: BPL-20260801-0032 |
| 2 |
CPT 服务 |
调用 MDS ACL 接口：BuildingFactor VO = CPT L2 楼宇差异 |
MDS ACL 转换：diff = { buildingType: 唐楼, floor:5F, hasElevator:false, managementPenalty:1.1 } |
BuildingCoefficient VO = |
| 3 |
MDS |
BuildingFactor 入库，生成差异对比报告 |
原系数 1.5 vs 计算系数 1.8 × 1.1 = 1.98，偏差率 = (1.98-1.5)/1.5 = 32%（>15% 阈值） |
deviationRate = 32% |
| 4 |
MDS |
自动生成 BPL 修正建议单，状态 PENDING_REVIEW |
通知 TL 审核，建议将该楼宇系数从 1.5 → 1.98 |
建议单号 BPL-FIX-20260821-007 |
| 5 |
TL |
审核通过（确认差异属实） |
BPL 楼宇档案核心字段更新；触发 MasterDataUpdated 事件 |
event.libraryCode=BPL，changedFields={buildingCoefficient: 1.5→1.98} |
| 6 |
QSV |
订阅 MasterDataUpdated(BPL) → 报价缓存刷新 |
后续该楼宇报价均按 1.98 系数计算 |
例：CAT02 灯具基础 280 × 1.98 = HKD 554.4 |
异常分支
- 偏差率 ≤15% → 只生成「核实记录」不触发修正建议，累计至季度复核
- TL 驳回 → 保留原系数，记录驳回原因，标记该楼宇需 30 天内二次核实
关联项
MDS-UC-03：WPL 招募新师傅 SK2 等级
分类：WPL 师傅录入 | 类型：典型 | 触发：OL 在师傅招募后台审核简历通过后建档
主流程（含数据样例）
| 步骤 |
操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
OL |
简历审核通过，点击「创建师傅档案」 |
MasterDataIdService 生成 wplId = WPL-20260821-0058；状态 DRAFT |
wplId=WPL-20260821-0058，workerName=陈师傅 |
| 2 |
OL |
填写基础档案：姓名=陈大文、手机=9876****（L3 敏感）、服务区域=港岛东（湾仔/铜锣湾/北角）、入职=2026-08-21 |
PrivacyDesensitizationService 将手机标记 L3，对外显示 9876**** |
privacyLevel.phone=L3，address=L2 |
| 3 |
OL |
配置初始等级=SK2（入职考试 85 分 + 3 年行业经验推荐），等级系数=1.2 |
校验 SK2 授予条件：≥80 分 + ≥2 年经验 → PASS |
level=SK2，levelMultiplier=1.2 |
| 4 |
OL |
配置技能矩阵：CAT01 家具✅ / CAT02 灯具✅ / CAT03 卫浴❌ / CAT05 空调❌ / CAT06 智能锁✅；最大距离 8km；时段 周一至六 09:00-18:00 |
SkillMatrix VO 构造：sclCategories=[CAT01,CAT02,CAT06]，maxDistanceKm=8 |
availabilitySlots=[Mon-Sat 09-18] |
| 5 |
OL |
提交审核 |
档案状态 DRAFT→PENDING_REVIEW；触发 MasterDataCreated 事件 |
event.libraryCode=WPL，createdBy=OL-02 |
| 6 |
BO |
审核通过，签署电子协议 |
状态 PENDING_REVIEW→ACTIVE；版本号=1；隐私脱敏规则生效 |
|
| 7 |
DIS |
订阅 MasterDataCreated(WPL) → 派单池更新 |
DIS 将新师傅加入 M1/M2 派单候选池 |
DIS-UC-01/02 后续可派单给陈师傅 |
异常分支
- 步骤 3 等级校验失败（如 <80 分）→ 默认 SK1 等级，OL 可人工调整但需 BO 加审
- 步骤 5 手机与已有 WPL 档案重复 → 抛出 CustomerConflictRaised（WPL 分支），OL 核实是否同一人
关联项
MDS-UC-04：CPT L8 NPS 9 分 → CPL 标签升级 + 徽章授予
分类：CPL 客户画像反哺 | 类型：典型 | 触发：CPT L8 回访阶段客户提交 NPS = 9
主流程（含数据样例）
| 步骤 |
操作人/系统 |
操作 |
系统行为 |
数据样例 |
| 1 |
客户（CST） |
在 cst-app L8 回访页提交 NPS = 9、评价=「师傅专业准时，推荐」、勾选「愿意推荐朋友」 |
CPT L8 完成 → 发布 CPT-L8-Completed 事件，载荷含 cplId=CPL-20260715-0003，NPS=9，repurchaseIntent=高 |
cplId=CPL-20260715-0003，客户=李小姐 |
| 2 |
MDS |
订阅 CPT-L8-Completed → ACL 转换为 CustomerFactor VO |
ACL：nps→9；复购意向=低→中→高（跨两档）；推荐意向=是 → RecommendationLevel=A |
CustomerFactor VO = |
| 3 |
MDS LabelManagementService |
标签变更集计算：五维标签-忠诚度: 银→金、推荐潜力: 一般→高；版本 v3→v4（+1 递增） |
校验不变量③：labelVersion 严格递增 → PASS；oldVersion=3，newVersion=4 |
deltaLabels=[{忠诚度:银→金}, {推荐潜力:一般→高}] |
| 4 |
MDS |
信任徽章引擎：累计 NPS≥9 且完成 2 单 → 授予「优质客户」徽章 |
TrustBadge VO 构造：badgeCode=GOOD_CUST_01，validFrom=2026-08-21，validTo=2027-08-20 |
badgeName=优质客户，evidenceRef=CPT-20260820-0017+0003 |
| 5 |
MDS |
触发 MasterDataLabelChanged 事件（版本+1）+ 徽章授予 |
event.deltaLabels + event.badgesAdded = [GOOD_CUST_01] |
event: MasterDataLabelChanged(cplId=CPL-20260715-0003) |
| 6 |
OPS |
订阅 MasterDataLabelChanged → 营销分群更新 |
将李小姐移入「高价值推荐客户」群，S03 场景推送「推荐好友各得 HKD 100 优惠券」 |
OPS-UC-07 口碑反哺场景 |
异常分支
- NPS=4 低分 → 标签「忠诚度」下降一级，不授徽章；触发 OPS-UC-10 低分挽回
- labelVersion 并发写入（双请求同时 +1）→ 乐观锁失败，后者抛出版本冲突异常并重试
关联项
MDS-UC-05：DLV M2 独立物流商签约
分类：DLV 物流商录入 | 类型：典型 | 触发：OL 完成物流商签约会议后在后台建档
主流程（含数据样例）
| 步骤 |
操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
OL |
opr-admin 主数据 DLV 新建签约档案 |
MasterDataIdService 生成 dlvId = DLV-20260821-0009 |
dlvId=DLV-20260821-0009，公司名称=速达配送 |
| 2 |
OL |
配置业务模式 = M2 独立司机 + 车辆类型 = 客货车（1.5t）+ 司机姓名=王师傅 + 车牌=VN1234 |
LogisticsMode VO 构造：mode=M2，contractFields={vehicleType: VAN_1_5T, driverName: 王师傅, plateNo: VN1234} |
mode=M2，serviceArea=九龙西（深水埗/长沙湾/旺角） |
| 3 |
OL |
配置服务区域：九龙西（深水埗/长沙湾/旺角/油麻地），有效时段 Mon-Sun 08:00-20:00 |
与 WPL 师傅区域字典对齐（district 编码 KOW-W） |
maxDistanceKm=15 |
| 4 |
OL |
设置初始评分 = 85（新签约基准分），C7 赔付记录初始 = [] |
LogisticsMode.insuranceClaims=[]（空数组），baseScore=85 |
baseScore 对应 DIS 派单权重 +40 |
| 5 |
OL |
上传签约合同扫描件（机密字段 L4），指定仅 SPO+BO 可见 |
PrivacyLevel VO 标记：contractDoc=L4，结算费率=L3 |
desensitizeRule.contractDoc=仅元数据可见，全文需 SPO 双审下载 |
| 6 |
BO |
审核通过，合同生效 |
档案 DRAFT→ACTIVE；触发 MasterDataCreated(DLV) 事件 |
DIS 派单池加入 M2 新物流商 |
| 7 |
DIS |
订阅事件 → M2 模式候选池刷新 |
DIS-UC-02 M2 派单场景可匹配到该物流商 |
DIS 评分：mode=80(M2) + baseScore=85/10=8.5 - C7=0 = 88.5 |
异常分支
- 服务区域与既有 DLV M3 独家合同冲突 → 触发冲突提示，OL 可选择调整区域或 BO 特批
- 合同到期日 = 2027-08-20 → 到期前 30 天自动生成 INACTIVE 预警任务
关联项
三、异常用例（5 条）
MDS-UC-06：WPL 月度评分 62 分 → SK3 降级 SK2
分类：WPL 等级校准异常 | 类型：异常 | 触发：月度校准批处理 8 月运行，师傅综合评分跨降级阈值
主流程（含数据样例）
| 步骤 |
系统/操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
MDS 批处理（Cron 08-01 02:00） |
拉取 WPL 全量 ACTIVE 师傅，基于 CPT 7 月数据调用 WorkerFactor ACL 计算综合评分 |
综合评分 = 50% NPS 均值 + 30% 按时完成率 + 15% 异常次数倒数 + 5% 增单推荐率 |
师傅 wplId=WPL-20260501-0018（原 SK3） |
| 2 |
系统 |
计算该师傅：NPS 均值=6.2（3 单）、按时完成率=75%（3/4）、异常=1 次（L6 返工）、增单率=0% → 综合 62 |
对照 SK 等级阈值：SK3≥75、SK2≥60、SK1≥45 → 62 分跨 SK3→SK2 降级线 |
finalScore=62，oldLevel=SK3，suggested=SK2 |
| 3 |
系统 |
生成等级变更建议单 DOWNGRADE-202608-0014 |
通知 OL 审核（3 天内处理），OL 界面显示对比：等级乘数 1.4→1.2，月均收入预估降约 14% |
|
| 4 |
OL |
审核通过（查看工单证据确认异常属实） |
OL=PASS → BO 审批环节 |
|
| 5 |
BO |
审批通过 |
状态：SK3→SK2；发布 WorkerDowngraded 领域事件（§3.5） |
event: WorkerDowngraded(wplId=WPL-20260501-0018, old=SK3, new=SK2) |
| 6 |
QSV + DIS |
订阅 WorkerDowngraded → 各自缓存刷新 |
QSV 报价等级系数 1.4→1.2；DIS 派单等级乘数 ×1.2（原 ×1.4），后续派单权重下降 |
DIS 派单评分 -（1.4-1.2）× 10 = -2 |
阻塞异常
- 评分计算缺失：某师傅 7 月 CPT 数据 <2 单 → 样本不足，跳过该师傅，标记「下月复算」
- OL 3 天未审核 → 自动升级至 BO，BO 5 天未审核 → 维持原等级，记录「审批超时」审计日志
关联项
MDS-UC-07：BPL 楼宇 120 天未核实 + 偏差 18% → 过期告警
分类：BPL 校准异常 | 类型：异常 | 触发：BuildingCoefficientExpired 领域事件触发
主流程
| 步骤 |
系统/操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
MDS 校准批处理（每周三 03:00） |
扫描 BPL 楼宇档案：(NOW - lastVerifiedDate) > 90 天 的记录 + 累计偏差率计算 |
命中楼宇 bplId=BPL-20260401-0151（旺角某工业大厦）：lastVerifiedDate=2026-04-22 → 距今 121 天 |
|
| 2 |
系统 |
拉取 QSV 报价系数 vs CPT 实际反馈累计（11 单样本） |
QSV 计算使用系数 2.0；CPT 师傅 L2 核实平均系数 2.36 → 偏差 = (2.36-2.0)/2.0 = 18%（>15% 阈值） |
deviationRate=18%，sampleCount=11 |
| 3 |
系统 |
同时满足「>90 天未核实 + 偏差>15%」→ 触发 BuildingCoefficientExpired 事件 |
event 载荷：bplId + lastVerifiedDate=121d + deviationRate=18% |
event: BuildingCoefficientExpired |
| 4 |
OPR 任务中心 |
订阅事件 → 生成 TL 待办任务：楼宇现场复核（P2 优先级，7 天内） |
派发给 TL-01（旺角片区负责人） |
taskId=BPL-VERIFY-20260821-003 |
| 5 |
TL |
指派 WPL 师傅 3 天内现场核实 → 按 MDS-UC-02 流程走修正 |
如果核实后系数变化 ≥10% → 走修正建议 BO 审批 |
|
| 6 |
7 天超时未处理 → TL 任务升级至 BO，自动标记 P1 |
|
|
|
异常分支
- 样本量 <5 单 → 偏差率可信度不足，事件降级为「季度复核提醒」不生成 P2 任务
- 楼宇属于 M3 跨境物流公司仓库（特殊类型）→ 自动分发给 TL-跨境片区
关联项
MDS-UC-08：CPL 手机号重复 → CustomerConflictRaised + 人工合并
分类：CPL 档案冲突 | 类型：异常 | 触发：SixLibraryCRUDService 创建客户档案时检测到手机号 businessKey 冲突
主流程
| 步骤 |
系统/操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
CPT L1 |
新客户线上自助填写线索：姓名=李小姐、手机=91234567、邮箱=lee***@gmail.com |
SixLibraryCRUDService 创建 CPL 档案前，先检查不变量①唯一性：(CPL, mobile=91234567) → 命中已有 cplId=CPL-20260601-0044（手机号加密哈希匹配） |
新记录 draftId=CPL-DRAFT-20260821-0112；原档案 cplId=CPL-20260601-0044（历史客户 1 单 2026-06 完成） |
| 2 |
MDS |
检测冲突：业务键重复 ≥1 → 触发 CustomerConflictRaised 事件 |
载荷：conflictingCplIds=[CPL-20260601-0044, CPL-DRAFT-20260821-0112]、matchedFields={手机号:完全匹配, 姓氏:李=李, 邮箱前缀 lee 相似度 0.9} |
confidence=0.92（高度疑似） |
| 3 |
OPR |
生成 OL 人工审核冲突合并任务（P1，24h 内） |
OL 界面并排展示两份档案：来源（2026-06 线下 / 2026-08 线上）、历史单量（1/0）、标签（旧档案忠诚度=铜）、徽章（无） |
|
| 4 |
OL |
电话核实 91234567 → 确认是同一客户（李小姐 6 月帮母亲下单、8 月自己下单） |
OL 选择「合并：保留 CPL-20260601-0044 为主档案，CPL-DRAFT-0112 的新邮箱 + 复购意向=高 → 合并入主档案」 |
mergeAction=MERGE_TO_MASTER，masterId=CPL-20260601-0044 |
| 5 |
MDS LabelManagementService |
合并标签：旧忠诚度=铜 + 新复购意向=高 → 计算合并后标签「忠诚度=银」，版本 v2→v3 |
校验 labelVersion 递增 + MasterDataLabelChanged 事件发布 |
labelVersion=3，deltaLabels=[复购意向: 中→高] |
| 6 |
CPL-DRAFT-20260821-0112 → 逻辑删除状态 DELETED（非合规场景，OL 审批即可），关联引用重定向主档案 |
CPT 新 L1 项目自动引用主档案 CPL-20260601-0044，客户体验连续（历史订单可追溯） |
|
|
异常分支
- confidence<0.6 → 不自动生成任务，只记入疑似冲突日志，月度复核
- OL 判断非同一客户 → 解除冲突标记，两份档案各自独立；标记手机号字段为「家庭共享号」允许重复（但需 OL 备注理由）
关联项
MDS-UC-09：SupplyAPIService 客户地址明文输出 → 脱敏拦截告警
分类：跨服务隐私安全 | 类型：异常 | 触发：自动化测试/代码 PR 引入 Bug，SupplyAPIService 返回未脱敏 L3 字段
主流程
| 步骤 |
系统/操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
QSV 报价服务 |
正常业务调用 MDS SupplyAPIService.query(consumer=QSV, factorType=CustomerFactor, ids=[CPL-20260715-0003])，需要 CPL 标签/徽章（L1/L2），不需要客户地址（L3） |
请求方字段权限白名单 QSV→CPL：允许标签（L1）、徽章（L1）、复购意向（L2）；禁止手机号/详细地址（L3） |
|
| 2 |
MDS |
SupplyAPIService 先调用 PrivacyDesensitizationService 过滤：查询结果集按 QSV 字段白名单投影 |
模拟 Bug：开发改动时将 address 字段意外加入 QSV 白名单 → 返回原始地址「旺角弥敦道 666 号 12 楼 B 室」（L3 明文） |
返回字段=address L3 明文 ❌ |
| 3 |
MDS |
PrivacyDesensitizationService 后置脱敏校验拦截器（Mandatory Check）：扫描返回载荷中 L3/L4 字段，若字段在 consumer 白名单外且未脱敏 → 硬拦截，抛 PrivacyViolationException |
规则：address L3 白名单无 QSV → 判定违规；返回 HTTP 403，触发 MDS 告警 |
error=PrivacyViolationException(FIELD_ADDRESS_NOT_DESENSITIZED) |
| 4 |
MDS |
记录审计日志 + 告警通知 OL+SPO：服务=QSV、违规字段=address(L3)、时间戳、调用方 IP |
告警渠道：企业微信 + 邮件（SPO 隐私合规岗） |
alertId=PRIV-20260821-002 |
| 5 |
系统自动 + SPO |
自动回滚该 PR 引入的白名单改动；SPO 48h 内完成隐私违规根因分析（RCA）→ 修订字段白名单权限矩阵 |
事后检查：最近 7 天 SupplyAPIService 所有调用日志，确认无其他明文泄露 |
|
异常分支
- 脱敏规则规则错误（应显示旺角弥敦道****而非完整地址）→ 同样触发拦截，但告警等级降级为 P2
- 测试环境触发 → 仅记录日志，不通知 SPO，直接阻断测试用例通过（防止带入生产）
关联项
MDS-UC-10：PPL 批量导入 ID 编码冲突 → 自动回滚
分类：ID 编码异常 | 类型：异常 | 触发：PPL 生产商批量导入 10 条数据时，MasterDataIdService 同日流水号重复
主流程
| 步骤 |
系统/操作人 |
操作 |
系统行为 |
数据样例 |
| 1 |
OL |
opr-admin PPL 管理 → 「批量导入生产商」，上传 10 条 xlsx（PPL-BATCH-20260821.xlsx） |
SixLibraryEntityFactory 解析 10 条记录，MasterDataIdFactory 批量生成 ID：预期 PPL-20260821-0015 ~ PPL-20260821-0024 |
batchSize=10 |
| 2 |
MDS |
MasterDataIdService 分配流水号时，第 3 条流水号 NNNN=0017 → DB 唯一索引冲突（PPL-20260821-0017 已于 09:15 被另一 OL 导入单条创建） |
冲突检测命中：(libraryCode=PPL, datePart=20260821, sequence=0017) 组合已存在 → 抛出 MasterDataIdConflictException |
conflictId=PPL-20260821-0017，owner=另 OL-05 单条导入 |
| 3 |
SixLibraryCRUDService |
批量事务整体回滚（事务原子性：10 条全部失败，不残留 0/1/2 条半成品） |
数据库事务 ROLLBACK；前 2 条（0015/0016）创建动作撤销 |
rollbackRows=10 |
| 4 |
返回批处理结果：success=false, conflictRecords=[第 3 条(公司名=XX家居), conflictId=PPL-20260821-0017, existingOwner=OL-05] + 建议「重新生成流水号后重试」 |
OL 界面高亮第 3 条冲突行 + 显示现有档案详情（公司名=XX家居已存在 → 实际为重复导入） |
|
|
| 5 |
OL |
修改 xlsx 删除第 3 条重复记录 → 重新上传 9 条 |
MasterDataIdFactory 重新分配 0015/0016/0018~0024 → 9 条全部通过 |
成功 9 条，版本 1 ACTIVE |
异常分支
- 批量 100 条以上 → 采用分段提交（每 20 条一子事务），冲突时仅回滚当前 20 条子批
- 冲突频率 >5%/天 → 告警 TL：ID 编码规则可能需要扩展流水号位数（NNNN→NNNNN）
关联项
四、用例 → 服务/原型交叉索引表
| 用例编号 |
核心领域服务 |
涉及聚合根/实体 |
关联原型页面 |
| MDS-UC-01 |
SixLibraryCRUDService + MasterDataIdService |
ServiceCategory(SCL) |
opr-admin/master-data-scl.html |
| MDS-UC-02 |
BuildingFactor ACL + LabelManagementService |
BuildingProfile(BPL) |
wkr-app/site-verify.html · opr-admin/master-data-bpl.html |
| MDS-UC-03 |
SixLibraryCRUDService + PrivacyDesensitizationService |
WorkerProfile(WPL) |
opr-admin/master-data-wpl.html · wkr-app/register.html |
| MDS-UC-04 |
CustomerFactor ACL + LabelManagementService |
CustomerProfile(CPL) + TrustBadge VO |
cst-app/review.html · opr-admin/master-data-cpl.html |
| MDS-UC-05 |
SixLibraryCRUDService + LogisticsMode VO |
LogisticsProfile(DLV) |
opr-admin/master-data-dlv.html · lgp-app/profile.html |
| MDS-UC-06 |
WorkerFactor ACL + WorkerDowngraded Event |
WorkerProfile(WPL) |
opr-admin/worklog-worker.html |
| MDS-UC-07 |
BuildingCoefficientExpired Event |
BuildingProfile(BPL) |
opr-admin/task-center.html |
| MDS-UC-08 |
CustomerConflictRaised Event + Label合并 |
CustomerProfile(CPL) ×2 |
opr-admin/master-data-cpl-conflict.html |
| MDS-UC-09 |
PrivacyDesensitizationService + SupplyAPIService |
MasterDataCatalog All |
opr-admin/audit-privacy.html |
| MDS-UC-10 |
MasterDataIdService + MasterDataIdFactory |
ProducerProfile(PPL) Batch |
opr-admin/master-data-ppl-import.html |
五、修订记录
| 版本 |
日期 |
修订人 |
修订内容 |
| V1.0 |
2026-08-21 |
DT |
首版创建：10 用例（5 典型 + 5 异常），覆盖 SCL/BPL/WPL/CPL/DLV/PPL 六库 CRUD + 标签变更 + 师傅降级 + 楼宇过期 + 客户冲突 + 隐私脱敏 + ID 编码冲突；每用例含 8 字段结构 + 数据样例 + 交叉索引 |