# Contract: REV-007 营收统计查询设计

## 1. Formal Interface Allocation

| Interface | Role | Direction |
|---|---|---|
| `IF-REV-010` | `REV-007` 统计主题查询、指标汇总和结果导出边界的正式业务接口 | `SYS-002` 内部正式业务接口 |

约束：

- `IF-REV-010` 保持为 `REV-007` 的正式接口编号，不新增新的统计接口编号。
- 本接口只承接经营统计查询，不扩展到 BI 专题、预测分析或独立数据仓库查询。

## 2. Statistics Themes

`IF-REV-010` 本轮至少覆盖以下主题：

- 营收汇总
- 收费与实收统计
- 欠费规模与账龄统计
- 客户结构统计
- 渠道交易统计
- 抄表完成率统计
- 业务概览类工单/办理量摘要（仅限营收业务相关概览）

## 3. Request Contract

| Field | Meaning | Required |
|---|---|---|
| `themeCode` | 统计主题编码 | 是 |
| `dateFrom` | 开始日期 | 是 |
| `dateTo` | 结束日期 | 是 |
| `billPeriod` | 账期 | 否 |
| `deptId` | 营业所/部门 | 否 |
| `regionCode` | 片区/区域编码 | 否 |
| `customerCategory` | 客户类别 | 否 |
| `channelCode` | 收费/交易渠道 | 否 |
| `statusSet` | 状态集合 | 否 |
| `groupBy` | 分组维度集合 | 否 |
| `exportFlag` | 是否导出 | 否 |

## 4. Response Contract

| Field | Meaning |
|---|---|
| `themeCode` | 统计主题编码 |
| `themeName` | 统计主题名称 |
| `dimensionSummary` | 查询维度摘要 |
| `indicatorList` | 指标结果集合 |
| `indicatorList[].indicatorCode` | 指标编码 |
| `indicatorList[].indicatorName` | 指标名称 |
| `indicatorList[].indicatorValue` | 指标值 |
| `indicatorList[].unit` | 单位 |
| `groupRows` | 分组结果集合 |
| `exportAllowed` | 是否允许导出 |
| `msg` | 结果说明 |

## 5. Data Boundary Contract

- 统计结果基于现有在线业务主数据、视图或汇总口径承接。
- 没有明确实现证据的独立统计表、专题报表表或离线数仓对象不得写成既成事实。
- 当历史查询口径参与对账或对比时，只能作为补充来源，不替代在线主数据统计口径。

## 6. Permission and Export Contract

- 查询结果必须受现有数据权限控制。
- 导出属于查询扩展能力，必须在权限允许范围内执行。
- 本轮只定义“是否允许导出”和导出边界，不展开导出实现细节。