136 lines
4.0 KiB
Markdown
136 lines
4.0 KiB
Markdown
# 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`
|