商业运营指标、趋势报表与口径说明

[web-ppanel]

元数据

• 优先级：P2
• 目标仓库：perfect-panel/frontend
• 目标分支：next
• 规划基线：origin/main@4411b429744302ef612db0d81d072149c73fde7e
• 主要 Backend 契约：商业运营指标与分析报表 backend#244
• 横切依赖：统一列表查询契约与 Read Model 基础设施 backend#214、改造订单、支付、提现、邀请、佣金列表及财务事实 Read Model backend#216、统一审计、任务运行与日志查询数据模型 backend#219、流量上报幂等、对账与纠错闭环 backend#228
• 依赖其他 Frontend 规划项：OpenAPI 生成客户端、契约 Drift Gate 与统一 request 错误模型 #152、Admin 权限路由、能力点消费与高危操作守卫 #153、统一 ProTable 2.0、筛选排序导出与列表一次请求 #154、订单、支付、退款、对账与财务列表闭环 #157、流量日志、流量对账、纠错入口与用户用量展示 #159、修复命令中心与业务异常处置工作台 #161、运营监控控制台：日志、审计、任务、健康、发布与告警只读治理 #162

现状

现有 Dashboard 只有轻量收入、用户、服务器流量统计；商业运营报表依赖统一列表、财务事实、流量事实、日志/任务和导出底座稳定后再建设，不作为 2.0 上线阻塞项。

范围

• 建设收入、订单、订阅、流量、佣金、工单、异常趋势 7 类固定运营报表。
• 支持日期、商品规格、支付渠道、地区、节点/协议、用户来源等维度 breakdown。
• 支持趋势、同比/环比、Top N、cohort、导出、口径说明和更新时间。
• 与明细列表和导出使用一致筛选、权限、脱敏和金额精度。

明确不做

• 不建设通用拖拽式 BI 平台。
• 不把 P2 报表作为 2.0 首发阻塞项。
• 不绕过列表、导出、RBAC 和审计规范直接读写业务表。

页面与组件

• Admin dashboard/reporting 模块。
• MetricCard、TrendChart、BreakdownTable、TopNTable、CohortView、MetricDefinitionDrawer、ReportExportButton。

API 前置

• metric_definitions、report_daily_facts、metric_snapshots、report query/export API。
• 指标口径版本、更新时间、精确金额语义、查询范围限制。
• 复用 统一 ProTable 2.0、筛选排序导出与列表一次请求 #154 导出、运营监控控制台：日志、审计、任务、健康、发布与告警只读治理 #162 task_runs/审计、修复命令中心与业务异常处置工作台 #161 异常聚合结果。

验收

• 至少 7 类报表可查询，每个指标有口径说明、版本号和更新时间。
• 同一筛选条件下报表、明细列表和导出可对账。
• 大范围查询有时间/行数限制，不造成全表扫描或内存爆炸。
• 财务报表查看和导出均受 RBAC 控制并写审计。

归属边界

只负责商业指标口径、固定报表、趋势分析和导出，不并入运维监控控制台。

跨域能力只保留入口、摘要或结果链接，不在本 Issue 重复定义其他 Owner 的状态机、查询底座或执行逻辑。