# 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`