主数据对齐规则

适用于多系统主数据同步中的编码统一、映射管理、冲突合并与版本治理场景。

规则文件内容

请复制以下内容，保存为 .cursor/rules/master-data-alignment.mdc：

---
description: 主数据编码、映射合并、冲突处理与同步一致性规则
globs: src/master-data/**, src/integrations/mdm/**, src/sync/**
---

# 主数据对齐业务规则

## 1. 核心原则
- **一主多从**：主数据必须有唯一主来源系统。
- **编码稳定**：标准主键不可复用、不可重写语义。
- **冲突可决策**：冲突处理需明确优先级与人工介入点。

## 2. 主数据对象范围
- 人员主数据（员工、供应商、客户）
- 组织主数据（部门、项目、区域）
- 资产主数据（设备、物资、车辆）

## 3. 编码规则
- 标准编码采用不可变 `mdm_id`。
- 来源系统保留 `source_id`，通过映射表关联。
- 删除采用逻辑删除，禁止物理删主键。

```ts
interface MasterMapping {
  mdmId: string;
  sourceSystem: string;
  sourceId: string;
  syncStatus: 'active' | 'conflict' | 'deprecated';
}

4. 同步与合并规则

• 增量同步按 updated_at 拉取。
• 合并策略按字段级优先级执行。
• 核心字段冲突（名称、状态、归属）进入人工审核。

5. 冲突处理规则

• 冲突记录必须标记 conflict_type 与候选值。
• 审核通过后写入 resolved_value 与 resolver_id。
• 未解决冲突禁止下游分发。

6. 版本与发布规则

• 主数据模型变更必须版本化。
• 每次全量发布需生成校验报告（总量、缺失、冲突数）。
• 下游订阅方可按版本回放。

7. 质量校验规则

• 唯一性校验：编码、手机号、证件号等关键键。
• 完整性校验：关键字段缺失率阈值。
• 一致性校验：多系统同对象关键字段一致率。

8. 数据模型约束

• mdm_entities 必须包含：mdm_id, entity_type, status, version, updated_at
• mdm_mappings 必须包含：mdm_id, source_system, source_id, sync_status, last_synced_at
• mdm_conflicts 必须包含：mdm_id, field_name, candidate_values, conflict_type, status

9. 实施注意事项

• 主数据同步链路建议引入事件总线与补偿队列。
• 映射表应支持历史追溯，避免覆盖丢失来源信息。
• 建议设置“冻结窗口”，避免高峰期全量重建。

## 适用场景

- 多系统主数据治理
- ERP/CRM/业务系统对齐
- 组织与资产编码统一