# 28 运营报表 PRD

## 0. Demo开发摘要

- 一句话定位：运营报表负责把 DCIM/DCOM 各模块的指标口径、主题数据集、报表模板、订阅交付、经营分析、数据血缘、权限脱敏和审计证据统一治理，形成可复核、可交付、可追责的运营分析中心。
- 菜单挂载：运营中心 / 经营分析 / 运营报表；与资产、容量、维修、EHS、安防、库存、成本、供应商、客户服务、能效、告警和工作流联动。
- Demo主路径：创建指标口径 -> 绑定主题数据集 -> 设计报表模板 -> 生成报表实例 -> 提交分析说明 -> 审批发布 -> 订阅交付 -> 查看血缘证据 -> 导出审计报告。
- 核心页面：运营分析驾驶舱、报表目录中心、主题数据集管理、指标口径管理、报表模板设计、订阅与交付任务、经营分析工作台、发布审批与复核、报表证据与血缘、报表权限与配置。
- 复用智航能力：CMDB、工单、EHS、安防、库存、成本、供应商、客户、告警事件、工作流、权限中心、对象存储、报表引擎、dcim-cli。
- 需要 Mock 的 API：报表目录、数据集、指标口径、模板、实例、交付任务、分析说明、审批任务、数据快照、权限策略、指标快照、审计日志。

## 1. 制度依据与行业依据

- 制度原文依据状态：本轮本地制度知识库 healthcheck 未定位到 `DATACENTER_OPS_KB_ROOT`，不能把内部制度条文写成已命中依据。以下内容属于基于仓库白皮书、现状盘点、规划文档和运营报表管理常识的产品化推导。
- 本地白皮书依据：DCOM 强调统一视图、数据关联共享、报表预测和全过程运维闭环；运营报表是把分散模块数据转成统一管理和经营决策的核心能力。
- 本地现状依据：智航已有报表、知识库、工单、告警、DCIM 工作台和多个业务子系统，但需要统一指标口径、交付任务、数据血缘和审计证据。
- 本地规划依据：智航向 DCOM 和智能化专家服务演进，需要用经营分析证明资产、容量、维修、安防、EHS、成本等模块的业务价值。
- 产品化推导：运营报表必须落成报表目录、主题数据集、指标口径、模板、实例、订阅交付、分析说明、审批复核、血缘快照、权限脱敏和审计日志。

## 2. 现有能力复用分析

| 能力 | 复用对象 | 报表中的使用方式 | 新增边界 |
|---|---|---|---|
| CMDB/资产容量 | 站点、空间、设备、客户、容量 | 形成资产、容量、资源水位和设备健康数据集 | 新增指标口径和血缘快照 |
| 维修/EHS/安防/库存 | 工单、作业、访客、库存、整改 | 形成运营执行、风险和资源保障数据集 | 新增跨模块指标口径 |
| 成本/供应商/客户 | 成本中心、合同、供应商、客户范围 | 形成经营分析和客户报表 | 新增脱敏和交付审批 |
| 告警事件 | 告警、事件链、作战室、周报 | 形成故障、响应、恢复和趋势指标 | 新增异常归因说明 |
| 工作流 | 审批、发布、复核、退回 | 承载指标口径、报表发布和客户交付审批 | 新增报表发布流程 |
| 权限中心 | 角色、组织、客户、数据范围 | 控制报表访问、导出、脱敏和水印 | 新增报表级权限策略 |
| 对象存储 | PDF、Excel、HTML、快照文件 | 存储报表实例和证据包 | 新增文件 hash 和水印规则 |
| dcim-cli | 命令行分析和导出 | 支持生成、交付、质量检查、血缘和异常分析 | 新增 report 命令组 |

## 3. 用户角色与业务场景

| 角色 | 主要动作 | 关注点 |
|---|---|---|
| 运营负责人 | 查看经营驾驶舱、审批报表发布、确认异常说明 | 指标可信、异常可解释、经营影响可量化 |
| 报表管理员 | 维护报表目录、模板、订阅和导出样式 | 交付准时、模板稳定、客户可读 |
| 指标管理员 | 定义指标口径、维度、版本和负责人 | 口径统一、版本可追溯、影响可评估 |
| 数据产品经理 | 维护主题数据集、血缘、质量和刷新 | 数据完整、及时、一致 |
| 运营分析师 | 做趋势、同比环比、异常归因和经营分析 | 发现问题、解释原因、量化影响 |
| 客户经理 | 配置客户报表和交付对象 | 脱敏、审批、准时交付、客户体验 |
| 审计员 | 查询报表生成、交付、导出和数据血缘证据 | 谁看过、谁导出、数据从哪里来 |

核心业务场景：

1. 运营负责人需要月度经营分析，系统汇总资产、维修、能耗、成本、安防、EHS 和库存数据。
2. 指标管理员调整“维修闭环率”口径，系统识别受影响报表和订阅任务，并进入口径审批。
3. 报表管理员基于模板生成客户月报，系统按客户范围脱敏，并加水印和数据快照。
4. 运营分析师发现能耗成本环比异常，上钻到站点、冷站、设备和运行方案，提交分析说明。
5. 客户经理触发交付任务，系统记录收件人 hash、交付通道、重试次数和导出审计。

## 4. 信息架构与页面清单

| 页面 | 路由 | 角色 | 页面目标 | 核心组件 |
|---|---|---|---|---|
| 运营分析驾驶舱 | `/reports/overview` | 运营负责人 | 查看 DCIM/DCOM 经营、运维、能效、资源、风险和服务指标 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 报表目录中心 | `/reports/catalog` | 报表管理员 | 维护日报、周报、月报、客户报表、经营报表和专项报表 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 主题数据集管理 | `/reports/dataset` | 数据产品经理 | 管理资产、容量、维修、EHS、安防、库存、成本等主题数据集 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 指标口径管理 | `/reports/metric` | 指标管理员 | 定义指标、维度、口径、计算公式、数据源、负责人和版本 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 报表模板设计 | `/reports/template` | 报表管理员 | 设计图表、表格、说明、异常解释、导出样式和水印 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 订阅与交付任务 | `/reports/delivery` | 客户经理 | 配置周期、收件人、客户脱敏、审批、重试和交付状态 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 经营分析工作台 | `/reports/analysis` | 运营分析师 | 进行趋势、同比环比、异常归因、钻取和对标分析 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 发布审批与复核 | `/reports/approval` | 运营负责人 | 完成口径变更、报表发布、客户交付和异常说明审批 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 报表证据与血缘 | `/reports/evidence` | 审计员 | 查看数据血缘、生成快照、导出记录、审批记录和水印证据 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |
| 报表权限与配置 | `/reports/config` | 系统管理员 | 配置权限、脱敏、指标分组、交付通道、告警阈值和保留周期 | 指标卡、筛选器、图表、表格、详情抽屉、血缘图、审批时间线、操作弹窗 |

### 4.1 运营分析驾驶舱

- 页面目标：查看 DCIM/DCOM 经营、运维、能效、资源、风险和服务指标。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.2 报表目录中心

- 页面目标：维护日报、周报、月报、客户报表、经营报表和专项报表。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.3 主题数据集管理

- 页面目标：管理资产、容量、维修、EHS、安防、库存、成本等主题数据集。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.4 指标口径管理

- 页面目标：定义指标、维度、口径、计算公式、数据源、负责人和版本。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.5 报表模板设计

- 页面目标：设计图表、表格、说明、异常解释、导出样式和水印。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.6 订阅与交付任务

- 页面目标：配置周期、收件人、客户脱敏、审批、重试和交付状态。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.7 经营分析工作台

- 页面目标：进行趋势、同比环比、异常归因、钻取和对标分析。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.8 发布审批与复核

- 页面目标：完成口径变更、报表发布、客户交付和异常说明审批。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.9 报表证据与血缘

- 页面目标：查看数据血缘、生成快照、导出记录、审批记录和水印证据。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

### 4.10 报表权限与配置

- 页面目标：配置权限、脱敏、指标分组、交付通道、告警阈值和保留周期。
- 顶部指标：报表数量、生成成功率、交付成功率、数据质量异常数、口径变更数、导出次数、客户报表数、审计完整率。
- 筛选条件：数据中心、客户、业务域、报表类型、周期、负责人、密级、状态、交付通道、时间范围。
- 表格字段：报表编号、名称、类型、业务域、当前模板、生成状态、交付状态、质量分、负责人、更新时间。
- 主按钮：新建报表、创建数据集、创建指标、设计模板、生成报表、创建订阅、提交分析、导出证据。
- 行操作：查看详情、查看血缘、查看快照、审批决策、重新生成、重试交付、导出、查看审计。
- 异常态：数据源延迟、质量分低、口径冲突、交付失败、权限不足、脱敏规则缺失都必须显示原因和处理入口。
- 权限态：客户经理只能看客户范围；审计员只读；指标管理员维护口径；报表管理员维护模板和订阅。

## 5. 业务流程与状态机

| 状态 | 中文名 | 进入条件 | 可执行动作 | 退出条件 |
|---|---|---|---|---|
| draft | 草稿 | 报表、指标、模板或交付任务创建未提交 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| submitted | 已提交 | 进入口径复核、发布审批或交付审批 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| reviewing | 复核中 | 指标负责人、数据负责人、运营负责人或客户经理复核 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| approved | 已批准 | 可发布、可生成或可交付 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| published | 已发布 | 报表模板、指标口径或数据集对外可用 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| generating | 生成中 | 报表实例正在取数、计算、渲染和生成文件 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| generated | 已生成 | 报表文件、快照和数据血缘已固化 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| delivering | 交付中 | 报表通过邮件、门户、接口或下载链接交付 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| delivered | 已交付 | 收件人收到或客户门户可访问 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| exception_review | 异常复核 | 数据缺失、口径冲突、交付失败或指标异常待处理 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| archived | 已归档 | 报表、审批、血缘、快照、导出和审计完成归档 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |
| voided | 已作废 | 报表、指标或交付任务停用，保留原因 | 查看、编辑、提交、审批、生成、交付、归档、作废 | 满足状态规则并写入审计 |

主流程：草稿 -> 已提交 -> 复核中 -> 已批准 -> 已发布 -> 生成中 -> 已生成 -> 交付中 -> 已交付 -> 已归档；异常进入异常复核。

关键业务规则：

1. 指标口径必须有负责人、公式、维度、版本和有效期。
2. 口径变更必须识别受影响报表和交付任务。
3. 客户报表必须配置客户范围、脱敏规则和水印。
4. 报表生成必须固化数据快照和 source_hash。
5. 质量分低于阈值时不得自动交付客户。
6. 交付失败必须支持重试并保留失败原因。
7. 导出敏感报表必须记录用户、时间、水印和用途。
8. 报表实例归档后不可覆盖，只能重新生成新实例。
9. 经营分析说明必须绑定指标和报表实例。
10. 审计证据包必须包含报表文件、快照、审批、交付和导出记录。

状态转换限制：

- draft -> submitted：必填报表名称、类型、数据集、指标和负责人。
- submitted -> reviewing：系统创建口径、模板或交付审批任务。
- reviewing -> approved：审批节点均同意且无口径冲突。
- approved -> published：模板、指标或数据集发布成功。
- published -> generating：触发手动或周期生成任务。
- generating -> generated：取数、计算、渲染和快照固化成功。
- generated -> delivering：交付任务生效且权限脱敏校验通过。
- delivering -> delivered：交付通道返回成功或客户门户可访问。
- generated/delivering -> exception_review：质量异常、口径冲突或交付失败。
- delivered -> archived：文件、审批、血缘、导出和审计归档。
- any -> voided：报表、指标或交付任务停用，必须保留原因。

## 6. 数据库设计摘要

| 表名 | 中文名 | 设计目的 |
|---|---|---|
| report_catalog | 报表目录表 | report_id PK、report_code、report_name、report_type、site_scope 等字段 |
| report_dataset | 主题数据集表 | dataset_id PK、dataset_code、dataset_name、domain、source_systems 等字段 |
| report_metric_definition | 指标口径表 | metric_id PK、metric_code、metric_name、domain、formula_expr 等字段 |
| report_template | 报表模板表 | template_id PK、report_id FK、template_name、template_version、layout_schema 等字段 |
| report_instance | 报表实例表 | instance_id PK、report_id FK、template_id FK、period_type、period_start 等字段 |
| report_delivery_task | 订阅交付任务表 | delivery_id PK、report_id FK、instance_id FK、delivery_channel、recipient_scope 等字段 |
| report_analysis_note | 经营分析说明表 | note_id PK、instance_id FK、metric_id、analysis_type、finding 等字段 |
| report_workflow_task | 审批复核任务表 | task_id PK、object_type、object_id、node_code、node_name 等字段 |
| report_data_snapshot | 数据快照表 | snapshot_id PK、dataset_id、report_id、period_start、period_end 等字段 |
| report_access_policy | 报表权限策略表 | policy_id PK、object_type、object_id、role_id、org_scope 等字段 |
| report_metric_daily | 报表指标快照表 | metric_daily_id PK、metric_date、report_count、generate_success_rate、delivery_success_rate 等字段 |
| report_audit_log | 报表审计日志表 | audit_id PK、object_type、object_id、actor_id、actor_role 等字段 |

落库原则：报表目录、数据集、指标、模板、实例、交付、分析说明、审批、快照、权限、指标快照和审计分表；报表实例不可覆盖；快照和文件 hash 必须固化。

## 7. 接口契约摘要

| Method | Path | 用途 | 关键入参 | 返回 |
|---|---|---|---|---|
| GET | /api/dcim/reports/catalog | 报表目录分页查询 | type,status,ownerId,customerScope,page,pageSize | 报表列表、模板、最近生成和交付摘要 |
| POST | /api/dcim/reports/catalog | 创建报表目录 | reportName,reportType,siteScope,customerScope,ownerId,confidentialLevel | reportId,reportCode,auditId |
| GET | /api/dcim/reports/datasets | 主题数据集查询 | domain,status,ownerId,qualityLevel | 数据集、来源、刷新、质量和血缘 |
| POST | /api/dcim/reports/datasets | 创建主题数据集 | datasetName,domain,sourceSystems,refreshMode,ownerId | datasetId,auditId |
| GET | /api/dcim/reports/metrics | 指标口径查询 | domain,status,ownerId,keyword | 指标、公式、维度、版本和负责人 |
| POST | /api/dcim/reports/metrics | 创建指标口径 | metricName,domain,formulaExpr,dimensionSet,unit,ownerId | metricId,versionNo,workflowTaskId |
| POST | /api/dcim/reports/templates | 创建报表模板 | reportId,layoutSchema,chartSchema,exportFormats,watermarkRule | templateId,templateVersion |
| POST | /api/dcim/reports/{reportId}/generate | 生成报表实例 | templateId,period,filters,watermark,snapshotFlag | instanceId,generateStatus,snapshotId |
| GET | /api/dcim/reports/instances/{instanceId} | 报表实例详情 | instanceId | 文件、快照、指标、分析说明、导出记录 |
| POST | /api/dcim/reports/instances/{instanceId}/analysis-notes | 提交经营分析说明 | metricId,analysisType,finding,rootCause,impactAmount | noteId,reviewStatus |
| POST | /api/dcim/reports/delivery-tasks | 创建订阅交付任务 | reportId,periodRule,channel,recipients,maskRule,approvalRequired | deliveryId,workflowTaskId |
| POST | /api/dcim/reports/delivery-tasks/{deliveryId}/run | 执行报表交付 | instanceId,manualTrigger,comment | deliveryStatus,retryCount,auditId |
| POST | /api/dcim/reports/workflow/tasks/{taskId}/decision | 审批复核决策 | decision,comment,delegateTo,evidenceIds | nextNode,nextState,auditId |
| GET | /api/dcim/reports/snapshots/{snapshotId} | 数据快照详情 | snapshotId | 数据源、行数、质量分、source_hash、血缘 |
| GET | /api/dcim/reports/evidence/{instanceId} | 报表证据包查询 | instanceId | 报表文件、快照、审批、交付、导出和审计 |
| POST | /api/dcim/reports/access-policies | 创建报表权限策略 | objectType,objectId,roleId,orgScope,maskRule,exportAllowed | policyId,auditId |
| GET | /api/dcim/reports/operation-analysis | 经营分析查询 | siteId,dateRange,domain,metricCodes | 趋势、同比环比、异常归因和影响金额 |
| GET | /api/dcim/reports/audit-logs | 报表审计日志查询 | objectType,objectId,actorId,action,dateRange | 审计日志分页 |

接口规则：所有写接口必须写入 `report_audit_log`；生成、交付、导出和权限策略接口必须校验密级、客户范围、脱敏规则、水印和数据质量。

## 8. 字段、权限、异常与审计

- 字段一致性：页面字段、字段字典、数据库字段、接口入参、Mock 数据和埋点属性必须统一，特别是 report、dataset、metric、template、instance、delivery、snapshot。
- 权限模型：运营负责人审批，报表管理员维护模板，指标管理员维护口径，数据产品经理维护数据集，客户经理管理交付，审计员只读证据。
- 异常处理：数据源延迟、质量分低、口径冲突、模板渲染失败、交付失败、脱敏缺失、权限不足都必须可见、可重试、可审计。
- 审计留痕：创建、修改、审批、发布、生成、交付、下载、导出、订阅、脱敏策略变更都必须记录 actor、object、before_state、after_state、request_id 和时间。

## 9. 埋点、报表与经营指标

| event | 触发时机 | 属性 | 指标用途 |
|---|---|---|---|
| report_catalog_view | 查看报表目录 | report_id/report_type/user_role/confidential_level | 追踪报表访问 |
| report_create | 创建报表目录 | report_type/site_scope/customer_scope/owner_id | 统计新增报表 |
| report_dataset_create | 创建主题数据集 | domain/source_systems/refresh_mode/owner_id | 统计数据集建设 |
| report_metric_create | 创建指标口径 | metric_code/domain/formula_type/version_no | 统计口径变化 |
| report_metric_review | 指标口径复核 | metric_id/decision/reviewer_role/sla_status | 分析口径审批 |
| report_template_create | 创建报表模板 | report_id/chart_count/export_formats/watermark | 统计模板建设 |
| report_generate_start | 开始生成报表 | report_id/template_id/period_type/filter_count | 追踪生成任务 |
| report_generate_complete | 报表生成完成 | instance_id/generate_status/row_count/quality_score | 计算生成成功率 |
| report_delivery_start | 开始交付报表 | delivery_id/channel/recipient_count/mask_rule | 追踪交付任务 |
| report_delivery_complete | 报表交付完成 | delivery_id/status/retry_count/failure_reason | 计算交付成功率 |
| report_analysis_submit | 提交分析说明 | instance_id/metric_id/analysis_type/impact_amount | 统计经营分析 |
| report_snapshot_verify | 查看数据血缘 | snapshot_id/dataset_id/source_hash/quality_score | 审计数据来源 |
| report_export | 导出报表 | instance_id/format/watermark/user_role | 追踪导出行为 |
| report_cli_command | CLI 调用 | command/user/result/trace_id | 审计自动化调用 |
| report_agent_suggest | 智能体建议 | intent/source_count/accepted | 评估 AI 建议采纳 |

核心指标：报表生成成功率、交付成功率、交付准时率、数据质量异常数、指标口径变更数、客户报表下载数、导出次数、异常说明完成率、审计完整率。

## 10. CLI/智能体与 Demo 验收

CLI 命令组：

- `zhihang report catalog --type monthly`：查询报表目录；输出 报表、模板、状态。
- `zhihang report metric diff KPI-PUE --from V1 --to V2`：比较指标口径版本；输出 公式、维度、影响报表。
- `zhihang report generate RPT-001 --period 2026-06`：生成报表实例；输出 实例ID、文件、快照。
- `zhihang report delivery run DEL-001 --instance INS-001`：执行交付任务；输出 交付状态、重试次数。
- `zhihang report quality --dataset EHS --date 2026-06-23`：检查数据质量；输出 质量分、缺失、延迟。
- `zhihang report lineage INS-001`：查询数据血缘；输出 数据集、来源、hash。
- `zhihang report anomaly --metric energy_cost --month 2026-06`：分析指标异常；输出 趋势、环比、归因。
- `zhihang report export INS-001 --format pdf`：导出报表；输出 文件ID、水印、审计ID。
- `zhihang report audit INS-001 --trace`：查询审计链路；输出 生成、审批、交付、导出。

智能体能力：

- 指标口径解释助手：解释指标公式、维度、来源系统、版本变化和影响报表。
- 异常归因助手：对指标波动做同比环比、站点、客户、专业、设备和事件维度归因。
- 报表摘要助手：自动生成经营分析说明、异常提示和改进建议。
- 审计问答助手：回答报表数据来自哪里、谁审批、谁导出、交付给谁。

Demo 验收脚本：

1. 打开运营分析驾驶舱，看到生成成功率、交付成功率、质量异常和经营指标。
2. 创建主题数据集，绑定资产、维修、EHS、安防、库存、成本等来源系统。
3. 创建指标口径，填写公式、维度、负责人和版本，提交复核。
4. 设计报表模板，选择图表、表格、水印和导出格式。
5. 生成报表实例，查看数据快照、质量分和 source_hash。
6. 提交经营分析说明，审批后创建订阅交付任务。
7. 模拟交付失败并重试，查看失败原因和审计日志。
8. 导出报表证据包，串起报表文件、快照、审批、交付、导出和审计。

### 10.1 页面字段与动作深化

| 页面 | 字段/动作 | 数据来源 | 业务规则 | 验收方式 |
|---|---|---|---|---|
| 运营分析驾驶舱 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 运营分析驾驶舱 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表目录中心 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 主题数据集管理 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 指标口径管理 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表模板设计 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 订阅与交付任务 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 经营分析工作台 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 发布审批与复核 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表证据与血缘 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 报表类型 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 主题数据集 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 指标口径 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 口径版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 模板版本 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 生成状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 质量分 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 交付状态 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 脱敏规则 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 数据血缘 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 报表权限与配置 | 审计日志 | 数据集/指标/模板/实例/交付/快照/审计 | 字段变化必须触发权限校验、口径版本校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |

### 10.2 风险目录与阻断规则

| 风险场景 | 典型触发条件 | 必填控制措施 | 阻断规则 |
|---|---|---|---|
| 口径冲突 | 同一指标存在多个有效公式 | 版本、生效期、负责人、影响评估 | 冲突未解决不得发布 |
| 数据质量低 | 缺失、延迟、重复或口径不一致 | 质量分、异常说明、负责人 | 低于阈值不得客户交付 |
| 脱敏缺失 | 客户报表包含敏感字段 | 脱敏规则、水印、权限策略 | 缺脱敏禁止交付 |
| 交付失败 | 邮件、门户或接口返回失败 | 重试、失败原因、通知对象 | 超过重试次数进入异常复核 |
| 模板渲染失败 | 图表配置、字段或文件生成异常 | 模板校验、回退版本 | 失败实例不可交付 |
| 越权导出 | 用户无导出权限或超范围访问 | 权限策略、审计日志 | 返回 403 并记录审计 |
| 血缘缺失 | 报表无快照或 source_hash | 数据快照、来源系统、hash | 禁止归档 |
| 指标异常 | 环比、同比或阈值异常 | 分析说明、根因、责任人 | 缺说明时标记待复核 |

### 10.3 审批矩阵

| 条件 | 必经节点 | 可退回原因 | 升级规则 |
|---|---|---|---|
| 指标口径新增或变更 | 指标管理员 -> 数据负责人 -> 运营负责人 | 公式不清、维度缺失、影响评估不足 | 影响客户报表时升级客户经理 |
| 客户报表发布 | 报表管理员 -> 客户经理 -> 运营负责人 | 脱敏缺失、质量异常、模板错误 | 交付前未审批自动阻断 |
| 敏感报表导出 | 申请人 -> 数据负责人 -> 审计员备案 | 用途不清、范围过大 | 导出后强制水印和审计 |
| 主题数据集发布 | 数据产品经理 -> 数据负责人 | 血缘不清、刷新不稳定 | 质量分低时不得发布 |
| 异常说明发布 | 运营分析师 -> 运营负责人 | 根因不足、影响未量化 | 重大异常进入复盘 |

### 10.4 验收清单

| 验收项 | 合格标准 | 证据 |
|---|---|---|
| 指标口径闭环 | 可创建、复核、发布、版本化和影响评估 | 指标表和审批任务 |
| 报表生成 | 可生成实例、文件、快照和质量分 | 实例表和快照表 |
| 订阅交付 | 可创建、执行、失败重试和记录收件人hash | 交付任务表 |
| 经营分析 | 可提交趋势、异常、归因和影响金额 | 分析说明表 |
| 权限脱敏 | 客户报表和敏感报表按策略脱敏和水印 | 权限策略和导出记录 |
| 数据血缘 | 报表实例可追溯数据集和 source_hash | 快照和证据包 |
| 审计导出 | 生成、审批、交付、导出全链路可查 | 审计日志 |
| 质量阻断 | 低质量或口径冲突不能自动交付 | 异常复核状态 |
| 埋点可用 | 关键动作生成 report_* 事件 | TRACKING_PLAN |
| CLI 可用 | 可查询、生成、交付、质量检查、血缘、异常和审计 | CLI_AND_AGENT_SPEC |

## 11. 非目标范围

- 不替代底层数据仓库、BI 引擎或财务系统，本模块负责产品化指标口径、交付、证据和审计。
- 不直接修改来源系统数据，发现质量问题只生成异常复核和责任任务。
- 不绕过权限中心交付客户报表，客户范围和脱敏必须显式配置。
- Demo 可使用 Mock 数据，但字段、状态、接口、埋点、血缘和审计必须映射真实智航底座。