报表中心 · 总览
报表中心是 Zenith Admin 内置的自助式数据可视化与报表平台，对标 JEECG「积木报表」，覆盖从数据接入、数据加工到仪表盘、数据大屏、类 Excel 单据报表的全链路，并提供 AI 问数、数据预警、分享订阅、跨模块嵌入等能力。全程零外部依赖，基于项目自带的 PostgreSQL + Redis 即可运行。
章节导航
| 文档 | 内容 |
|---|---|
| 数据源接入 | API / 内置库 / MySQL / PostgreSQL / SQL Server / 静态数据 / 文件上传；凭据加密与连接测试 |
| 数据集与数据加工 | 参数化查询、计算字段、结果缓存、物化快照、字段格式化与字典翻译、数据权限 |
| 仪表盘设计 | 拖拽设计器、23 种组件、全局筛选器、点击联动、钻取、版本与收藏 |
| 数据大屏 | 自由画布、等比自适应缩放、深色科技皮肤、翻牌器/滚动榜单/地图、全屏与自动刷新 |
| 类 Excel 打印报表 | Univer 单元格设计器、单元格表达式、纵向扩展、套打、打印与 Excel 导出 |
| AI 问数与数据预警 | 自然语言生成 SQL（NL2SQL）、阈值预警规则、邮件/站内信通知 |
| 分享 / 订阅 / 嵌入 / 协作 | 公开分享链接、定时订阅推送、<ReportEmbed> 跨模块嵌入、评论批注 |
能力全景
text
数据源（6 类）
API · 内置只读主库 · MySQL · PostgreSQL · SQL Server · 静态/文件
↓
数据集（数据加工层）
参数 ${param} · 计算字段 · 结果缓存(TTL) · 物化快照 · 字段格式化/字典 · 数据权限 ${__userId}
↓
┌────────────────────┬─────────────────────┬──────────────────────┐
仪表盘 / 数据大屏 类 Excel 打印报表 AI 问数 · 数据预警
23 组件·筛选/联动/钻取 Univer 单元格·套打·导出 NL2SQL · 阈值告警
↓
分享(公开链接) · 订阅(定时推送) · 嵌入(<ReportEmbed>) · 协作(评论) · 导出(Excel/PNG)设计理念
- 自助式：业务/运营人员无需开发即可通过界面接入数据、拖拽搭建仪表盘与大屏、设计打印单据。
- 安全优先：所有取数走只读通道（READ ONLY 事务 / 只读 SELECT 约束 / 语句超时 / 行数上限）；外部库密码与 API 密钥 AES 加密存储、读取脱敏；数据权限系统变量由服务端权威注入，防越权。
- 零外部依赖：取数、缓存、物化、定时刷新/推送全部基于自带的 PostgreSQL + Redis + pg-boss。
- 可嵌入：任意仪表盘可通过一行
<ReportEmbed>嵌入项目其它模块，或生成公开链接 / iframe 对外分享。
后台菜单与权限
报表中心为顶级目录「报表中心」，包含以下页面：
| 页面 | 路径 | 权限码 |
|---|---|---|
| 数据源 | /report/datasources | report:datasource:list / :create / :update / :delete |
| 数据集 | /report/datasets | report:dataset:list / :create / :update / :delete |
| 仪表盘 | /report/dashboards | report:dashboard:list / :create / :update / :delete |
| 打印报表 | /report/print | report:print:list / :create / :update / :delete |
| 数据预警 | /report/alerts | report:alert:list / :create / :update / :delete |
| 订阅推送 | /report/subscriptions | report:subscription:list / :create / :update / :delete |
超级管理员默认拥有全部权限；其他角色需在「角色管理」中分配对应权限码。
典型上手路径
- 在「数据源」新建一个数据源（最简单从内置库「内置主库」开始，无需任何连接配置）。
- 在「数据集」基于数据源编写一条 SQL（或上传 Excel/CSV），点击「试跑预览」确认取数结果，用结果一键生成字段。
- 在「仪表盘」新建仪表盘，进入设计器，从左侧拖入指标卡 / 图表，右侧为组件选择刚建的数据集与字段。
- 需要大屏时，在设计器顶部把「栅格布局」切换为「大屏画布」，进入自由画布 + 深色科技皮肤。
- 保存后「预览」，可全屏投屏；或在「分享」生成公开链接、配置定时订阅、嵌入到其它业务页面。
内置示例「示例仪表盘」「运营数据大屏」「部门用户统计表（打印）」可直接打开参考或修改。