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