# DM-10｜经营分析与数据质量领域模型

> 状态：working-draft；候选模型，不是已锁定的结构或状态契约。\
> 上游：[BC-10](../07-bounded-context/bc-10-analytics.md)；输入：旧聚合材料（历史材料保留在 `docs_bak/`）。\
> 编写：主会话；业务决策与长期维护人：待指定。日期：2026-09-18。

## 1. 对象分类与候选聚合

| 对象 | 分类 | 维护什么 | 要保护的业务含义 |
|:---|:---|:---|:---|
| MetricDefinition / MetricVersion | 候选根及版本 | 口径、范围、输入依据 | 已发布口径可追溯 |
| AnalyticalFact / Dimension | 派生模型 | 来源映射与历史维度 | 不是交易聚合 |
| DataQualityIssue | 候选根 | 问题、影响及验证结果 | 不能通过它编辑源表 |
| BuildRun / ServingPublication | 执行记录 / 候选发布根 | 重算输入；结果生效版本 | 未验证构建不覆盖有效版本 |
| ExportJob | 受控执行对象 | 范围、用途、文件与有效期 | 完成前重新检查有效权限 |
| Dashboard | 组合投影 | 指标视图 | 页面不自创口径 |

“候选根”表示需要独立身份、生命周期及一致性责任的提案，不代表每行已经确定为一个事务。历史、子实体、值对象及集合的最终边界还需基于规模和不变量核对。

## 2. 关系与引用

指标引用来源定义；分析事实保留源身份、版本和时点；发布引用构建结果；质量问题引用原 Owner；导出引用结果范围及授权依据。读模型不因“表很大”自动成为聚合根。

分析MetricDefinition/MetricVersion不等于[通用平台](../platform/MONITORING-AUTOMATION.md)的SignalDefinition或PolicyRevision。平台引用分析口径版本并登记检测映射，不复制经营口径；DataQualityIssue作为来源问题可关联平台告警/工单，二者独立核验，关闭一个不能自动关闭另一个。

值对象及共享引用的统一含义见 [MODELING-RULES](MODELING-RULES.md)。上下文之间引用 ID、版本或不可变快照，不共享可变实体。

## 3. 生命周期

指标草拟、验证、发布；构建排队、运行、失败或验证通过；发布保持独立切换；质量问题发现、处置、验证关闭。导出已生成与当前可下载分开。

这些是语义级路径，尚未列全每种政策下的迁移；不能直接生成生产枚举。业务对象状态、协调进度和技术回执分别保存与展示。

## 4. 业务动作与事件

分析人员定义口径和发起重算；经营者读取授权结果；Worker 消费事件；事件候选：“指标版本已发布”“质量问题已发现”“分析结果已发布”。

事件名称为中文业务语义候选，不新建机器事件名。进入后续契约设计时逐项确定输入、前置条件、结果、错误和受众。

## 5. 强一致性及并发边界

重复事件与源事实版本修正分别处理；新 Serving 发布需检查构建输入仍匹配目标版本；导出范围和可访问性不能仅在排队时校验一次。

共同约束见 [CONSISTENCY](CONSISTENCY.md)：单根版本不能替代跨对象约束；如需同 BC 多根本地事务，必须明确保护范围与理由，不能默认为整个 BC 一把锁。

## 6. 反例、未知与下一步

迟到事件、改正源事实、重复计数、并发发布新旧口径、导出后撤权。freshness、维度历史、重算和保留规则未定；推荐实验不默认由 Analytics 拥有。

上述反例是设计验证目标，尚未执行产品测试。先关闭影响边界的不确定性，再完善动作级迁移表及精确模型。身份、权限与业务状态的联动仍遵守 07 的统一授权接缝，不在本页复制一套权限规则。

## 7. 交易严谨性补充（2026-09-29）

保留购买批次、餐次和前驱/后继订单链，区分计划金额、实收、有效商业金额、实际消费、退款中和实退；不能把替换的新旧两单都统计为实际履约。具体 GMV/净额口径仍待定。重放/重算只改变派生视图，不触发退款、出货或源状态恢复；迟到差异使用来源版本及调整链解释，不将缺失填零。

共用不变量、反例与恢复主讲见[TRANSACTION-INTEGRITY](TRANSACTION-INTEGRITY.md)。本节是设计约束，不证明本域实现或全部状态契约完成。