4.0 KiB
4.0 KiB
Data Model: REV-007 营收统计查询设计
1. Statistics Theme
Purpose
定义 REV-007 支持的统计主题，是统计查询的一级分类。
Key Fields
| Field | Description | Rule |
|---|---|---|
themeCode |
统计主题编码 | 唯一 |
themeName |
统计主题名称 | 必填 |
scopeDescription |
范围说明 | 必填；说明包含与排除项 |
indicatorSet |
指标集合 | 至少 1 个核心指标 |
dimensionSet |
维度集合 | 至少 1 个查询维度 |
exportAllowed |
是否允许导出 | 必填 |
Relationships
- 一个
Statistics Theme包含多个Statistics Indicator - 一个
Statistics Theme可复用多个Statistics Dimension - 一个
Statistics Theme由一个Statistics Query Contract承接
2. Statistics Dimension
Purpose
定义统计查询的筛选维度和分组维度。
Key Fields
| Field | Description | Rule |
|---|---|---|
dimensionCode |
维度编码 | 唯一 |
dimensionName |
维度名称 | 必填 |
dimensionType |
维度类型 | 必填；时间/组织/客户/渠道/状态等 |
filterMode |
查询方式 | 必填；范围/枚举/模糊/精确 |
groupable |
是否支持分组 | 必填 |
sourceFieldRef |
来源字段引用 | 必填；来源表或视图字段 |
Relationships
- 可被多个
Statistics Theme复用 - 可映射到一个或多个
Aggregation Source
3. Statistics Indicator
Purpose
定义统计结果中返回的核心业务指标。
Key Fields
| Field | Description | Rule |
|---|---|---|
indicatorCode |
指标编码 | 唯一 |
indicatorName |
指标名称 | 必填 |
indicatorMeaning |
指标含义 | 必填；避免同名不同义 |
unit |
单位 | 可为空；金额/笔数/户数/百分比等 |
aggregationRule |
聚合规则 | 必填；求和/计数/占比/完成率 |
sourceMetricRef |
来源指标引用 | 必填 |
Relationships
- 归属于一个或多个
Statistics Theme - 依赖一个或多个
Aggregation Source
4. Statistics Query Contract
Purpose
描述 IF-REV-010 的输入条件、输出摘要、权限控制和导出边界。
Key Fields
| Field | Description | Rule |
|---|---|---|
interfaceCode |
接口编号 | 固定为 IF-REV-010 |
themeCode |
统计主题编码 | 必填 |
queryConditionSet |
查询条件集合 | 必填 |
resultIndicatorSet |
输出指标集合 | 必填 |
permissionScope |
权限范围 | 必填；数据权限/导出权限 |
exportConstraint |
导出约束 | 必填 |
Relationships
- 一个
Statistics Query Contract服务一个Statistics Theme - 引用多个
Statistics Dimension和Statistics Indicator
5. Aggregation Source
Purpose
表示统计结果依赖的在线业务数据来源、视图或汇总口径。
Key Fields
| Field | Description | Rule |
|---|---|---|
sourceCode |
来源编码 | 唯一 |
sourceName |
来源名称 | 必填 |
sourceType |
来源类型 | 必填；在线表/视图/汇总口径 |
primaryObjects |
主数据对象 | 必填 |
retentionBoundary |
承接口径边界 | 必填；说明是否仅逻辑口径 |
implementationStatus |
实现状态说明 | 必填；不得夸大为已存在独立表 |
Relationships
- 支撑多个
Statistics Indicator - 可映射到多个
Statistics Dimension
6. Statistics Governance Record
Purpose
用于在治理台账中记录 REV-007 的设计状态、实现评估和后续建议。
Key Fields
| Field | Description | Rule |
|---|---|---|
requirementCode |
对应需求编号 | 固定为 SYS002-REQ-012 |
featureName |
Speckit feature 名称 | 必填 |
designStatus |
设计状态 | 必填；设计收口中/已收口 |
implementationStatus |
实现评估 | 必填；当前为未见实现 |
nextAction |
后续动作 | 必填 |
validationRecord |
校验记录 | 必填；引用本轮校验动作 |
Relationships
- 关联
01_Project_Progress.md - 关联
03_Task_Checklist.md - 关联
15_SYS002_Requirement_Breakdown.md