主数据服务设计（Master Data Service Design - MDS-D）
文档编号：DOC-P51-D / MDS-D
版本：V1.1
创建日期：2026-08-05
维护人：BO / TL / DT
关联文档：README.md、QSV、CPT、TND、RQD
一、定位与核心概念
1.1 服务定位
主数据服务（MDS）是平台的主体档案中心——统一管理师傅、客户、安装服务品类、楼宇四类核心主数据，为各业务服务提供共享主数据支撑。
MDS 与 CPT 的核心区别：
- MDS 存储"主体"：师傅/客户/品类/楼宇的长期属性档案，生命周期长于单次交易
- CPT 存储"过程"：单次客户项目的全生命周期记录（L1~L8 阶段）
- 关系：CPT 通过 ID 引用 MDS 中的主体档案；CPT 采集的实际数据反哺 MDS 画像更新
1.2 核心概念
| 概念 |
定义 |
说明 |
| 主数据 |
平台核心主体对象的属性档案 |
师傅/客户/品类/楼宇，跨服务共享、长期存在 |
| 主体 vs 过程 |
主体档案 vs 单次交易过程 |
MDS=主体；CPT=过程；二者通过 ID 关联 |
| 四库 |
MDS 下设四个特征库 |
SCL 服务库 / BPL 楼宇库 / WPL 师傅库 / CPL 客户库 |
| 数据闭环 |
CPT 采集数据反哺 MDS 画像 |
实际工时→师傅画像；评分→师傅等级；楼宇核实→楼宇档案 |
1.3 双重价值
- 共享主数据源：消除各业务服务的数据孤岛，确保师傅/客户/品类/楼宇信息一致。
- 画像持续进化：基于 CPT 采集的实际运营数据，持续校准师傅等级、客户标签、楼宇系数、品类费率。
二、四库总览
| 简称 |
编号 |
全称 |
核心内容 |
主要消费方 |
| SCL |
DOC-P51-S |
安装服务特征库（Service Catalog Library） |
8 大品类目录、32 细分类目、产品参数映射、基础费率、技能要求 |
QSV（费率/参数）、CPT（服务类型）、DSP（技能匹配） |
| BPL |
DOC-P51-B |
楼宇特征库（Building Profile Library） |
楼宇档案、类型系数、电梯配置、楼层、管理要求 |
QSV（楼宇系数/楼层附加）、CPT（楼宇核实） |
| WPL |
DOC-P51-W |
师傅特征库（Worker Profile Library） |
师傅档案、等级体系、技能矩阵、服务区域、历史表现 |
QSV（费率/参数）、CPT（服务类型）、DSP（技能匹配）、OPS（师傅个人品牌） |
| CPL |
DOC-P51-C |
客户特征库（Customer Profile Library） |
客户档案、标签体系、信任徽章、复购意向、推荐关系 |
CPT（客户ID）、OPS（客户画像/营销）、QSV（历史客户优惠） |
三、服务边界与职责
3.1 MDS 负责的职责
| 职责 |
说明 |
| 主数据录入 |
师傅招募录入、品类目录维护、楼宇档案建立、客户档案创建 |
| 主数据存储 |
四库的持久化存储、版本管理、变更历史 |
| 主数据查询 |
对外提供 ID 查询、属性查询、批量查询 API |
| 主数据校准 |
基于 CPT 反哺数据，定期校准师傅等级、客户标签、楼宇系数、品类费率 |
| 主数据权限 |
客户/师傅隐私字段脱敏、按服务分配访问权限 |
3.2 MDS 不负责的职责（明确边界）
| 不负责项 |
归属服务 |
理由 |
| 单次客户项目跟踪记录 |
CPT |
过程数据，非主体档案 |
| 报价计算 |
QSV |
消费 SCL 费率 + BPL 系数 + WPL 等级系数后自行计算 |
| 派单匹配算法 |
DSP |
消费 WPL 技能/区域后自行匹配 |
| 营销活动执行 |
MKT |
消费 CPL 标签后自行触达 |
| 师傅端 App 前端 |
TND D08 |
前端实现，非主数据本身 |
3.3 与原 TND D03 楼宇数据库的关系
原 TND 技术规划 中 D03「楼宇数据库设计」属主数据范畴，本次迁移至 MDS/BPL：
- TND D03 编号保留但标记为「已迁移至 MDS/BPL」
- 后续楼宇库的业务设计文档位于 docs/主数据服务/楼宇特征库设计.md
- 楼宇库的技术实现方案（数据模型、存储、采集接口）仍可在 TND 下另立技术文档
四、与各业务服务的对接方案
4.1 与 QSV 报价服务的对接
sequenceDiagram
participant QSV as QSV 报价服务
participant MDS as MDS 主数据服务
participant SCL as SCL 服务库
participant BPL as BPL 楼宇库
participant WPL as WPL 师傅库
QSV->>MDS: 查询报价参数(品类+楼宇+师傅等级)
MDS->>SCL: 查品类基础费率/产品参数
MDS->>BPL: 查楼宇类型系数/电梯配置
MDS->>WPL: 查师傅等级系数
SCL-->>MDS: 费率/参数
BPL-->>MDS: 系数/附加
WPL-->>MDS: 等级系数
MDS-->>QSV: 返回完整参数集
QSV->>QSV: 按报价公式计算
QSV 从 MDS 消费的数据：
| QSV 参数 |
数据来源 |
MDS 库 |
| 品类基础费率（P1） |
品类目录 × 基础费率表 |
SCL |
| 产品参数映射（影响工时/难度） |
产品参数 → 工时映射表 |
SCL |
| 楼宇类型系数（P3） |
楼宇类型 → 系数映射 |
BPL |
| 楼层附加费（P3） |
电梯配置 + 楼层 |
BPL |
| 师傅等级系数（P8） |
师傅等级 → 系数映射 |
WPL |
4.2 与 CPT 客户跟踪服务的对接
CPT 从 MDS 引用的主体 ID：
| CPT 字段 |
MDS 来源 |
用途 |
| 客户ID |
CPL |
关联客户主体档案 |
| 师傅ID |
WPL |
关联师傅主体档案 |
| 服务类型 |
SCL |
关联品类目录 |
| 楼宇ID |
BPL |
关联楼宇档案（L2 现场核实后回写） |
CPT 反哺 MDS 的数据：
| CPT 采集数据 |
反哺目标 |
更新内容 |
| 师傅实际工时 |
WPL |
师傅效率画像、工时统计 |
| 客户评分（L8 NPS） |
WPL |
师傅评分更新、等级校准 |
| 客户验收/复购行为 |
CPL |
客户标签、复购意向、信任徽章 |
| 师傅现场核实的楼宇信息 |
BPL |
楼宇档案修正（电梯/楼层/管理要求） |
| 实际成交价 vs 报价 |
SCL |
品类费率校准建议 |
4.3 与 DSP 派单服务的对接
DSP 从 MDS 消费的数据：
| DSP 需求 |
MDS 来源 |
用途 |
| 师傅技能品类 |
WPL |
匹配订单品类要求 |
| 师傅服务区域 |
WPL |
匹配订单区域 |
| 师傅可用时段 |
WPL |
匹配订单时段 |
| 师傅等级 |
WPL |
优先派单金牌师傅 |
| 师傅实时状态 |
WPL（动态字段） |
在线/忙碌/休假 |
4.4 与 OPS 运营服务的对接
OPS 从 MDS 消费的数据：
| OPS 需求 |
MDS 来源 |
用途 |
| 客户标签 |
CPL |
精准营销分群 |
| 客户复购意向 |
CPL |
复购推送 |
| 客户推荐关系 |
CPL |
推荐激励计算 |
| 师傅个人品牌资料 |
WPL |
师傅名片/案例展示 |
| 信任徽章 |
CPL + WPL |
可验证的信任标识 |
五、数据闭环与校准机制
5.1 数据闭环总览
flowchart LR
subgraph MDS["MDS 主数据服务"]
SCL["SCL 服务库"]
BPL["BPL 楼宇库"]
WPL["WPL 师傅库"]
CPL["CPL 客户库"]
end
subgraph BIZ["业务服务"]
QSV["QSV 报价"]
CPT["CPT 跟踪"]
DSP["DSP 派单"]
OPS["OPS 运营"]
end
MDS -- "主数据供给" --> BIZ
CPT -.->|"实际工时/评分/复购/楼宇核实"| MDS
QSV -.->|"成交价vs报价偏差"| SCL
5.2 校准周期与流程
| 校准对象 |
校准周期 |
触发条件 |
责任人 |
审批 |
| 师傅等级（WPL） |
月度 |
累计接单量+评分变化 |
OL |
BO |
| 客户标签/徽章（CPL） |
实时 + 月度 |
CPT 事件触发实时；月度全量复核 |
系统自动 + OL |
BO |
| 楼宇系数（BPL） |
季度 |
累计偏差超阈值 |
TL |
BO |
| 品类费率（SCL） |
月度 |
QSV 校准建议 |
BO |
SPO |
5.3 校准流程（以师傅等级为例）
flowchart TD
A["CPT 采集师傅月度数据"] --> B["WPL 计算综合评分"]
B --> C{"评分是否跨阈值?"}
C -- "是" --> D["生成等级变更建议"]
D --> E["OL 审核"]
E -- "通过" --> F["BO 审批"]
F -- "通过" --> G["更新 WPL 师傅等级"]
G --> H["记入 WLG 工作日志"]
H --> I["通知 QSV/DSP 等级系数变更"]
C -- "否" --> J["维持当前等级"]
E -- "驳回" --> K["记录驳回原因"]
F -- "驳回" --> K
六、数据安全与权限
6.1 数据分级
| 等级 |
含义 |
涉及字段 |
访问权限 |
| L1 公开 |
可对外展示 |
师傅昵称/等级/案例、品类目录、楼宇类型 |
全服务可读 |
| L2 内部 |
平台内部共享 |
师傅真实姓名/手机、客户基本信息、楼宇详细地址 |
已授权服务可读 |
| L3 敏感 |
需脱敏访问 |
客户手机/地址/支付信息、师傅收入 |
仅 CPT/PAY 经脱敏访问 |
| L4 机密 |
严格管控 |
客户身份证明、师傅身份证明、银行账户 |
仅合规岗位访问 |
6.2 隐私保护原则
- 最小化原则：业务服务仅可访问其必需字段（如 QSV 不需客户手机号）
- 脱敏原则：跨服务传输敏感字段须脱敏（如手机号显示为 138****5678）
- 审计原则：所有主数据访问记录审计日志
- 合规原则：符合香港《个人资料（私隐）条例》（PDPO）
七、实施优先级
按业务急需度排序：
| 优先级 |
库 |
理由 |
MVP 前置依赖 |
| P0 |
SCL 安装服务库 |
QSV 报价引擎冷启动必需品类费率与产品参数 |
报价引擎 |
| P0 |
BPL 楼宇特征库 |
QSV 楼宇系数是报价最大变量；筹备期需建立港岛/九龙核心楼宇库 |
报价引擎 |
| P1 |
WPL 师傅特征库 |
派单必需；师傅等级系数影响报价 |
派单系统、报价 |
| P2 |
CPL 客户特征库 |
试运营期客户量小，初期可用 CPT 字段替代；扩张期必需 |
营销系统、复购 |
建议实施顺序：SCL → BPL → WPL → CPL
八、后续规划
修订记录
| 版本 |
日期 |
修订人 |
修订内容 |
| V1.0 |
2026-08-05 |
DT |
首版创建：服务定位、四库总览、服务边界、对接方案、数据闭环、安全权限、实施优先级 |
| V1.1 |
2026-08-05 |
DT |
MKT→OPS 全局替换：四库总览消费方、服务边界、§4.4 对接方案、数据闭环图统一为 OPS 运营服务 |