69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
# 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
|
|
|
|
- 查询结果必须受现有数据权限控制。
|
|
- 导出属于查询扩展能力，必须在权限允许范围内执行。
|
|
- 本轮只定义“是否允许导出”和导出边界，不展开导出实现细节。
|