鼎味肉市DESIGN ATELIER
← 资料目录docs/architecture/08-domain-model/model-10-analytics.md阅读原文

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

状态:working-draft;候选模型,不是已锁定的结构或状态契约。
上游:BC-10;输入:旧聚合材料(历史材料保留在 docs_bak/)。
编写:主会话;业务决策与长期维护人:待指定。日期:2026-09-18。

1. 对象分类与候选聚合

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

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

2. 关系与引用

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

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

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

3. 生命周期

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

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

4. 业务动作与事件

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

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

5. 强一致性及并发边界

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

共同约束见 CONSISTENCY:单根版本不能替代跨对象约束;如需同 BC 多根本地事务,必须明确保护范围与理由,不能默认为整个 BC 一把锁。

6. 反例、未知与下一步

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

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

7. 交易严谨性补充(2026-09-29)

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

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