看板图表实现规范
在这套 Go 加 React 代码库里按既定模式加仪表盘:Go 侧聚合数据,前端用 Recharts 出 KPI 卡和图表,并带导出与权限门控。
功能与用途
在这个项目里加统计看板时,容易各写各的。这份规范把做法固定下来:数据全在后端用 SQL 聚合成统一的 label/value/percentage 结构,前端只负责渲染,图表统一用 shadcn 的包装组件以便跟随主题。每张图自动带 CSV 导出、PNG 截图和全屏,敏感分区按权限条件渲染,相关的图会被编成可轮播的图表组省地方。
适用场景
- 要在某个业务模块里加一组按地区、类别分布的图表,需要跟现有看:要在某个业务模块里加一组按地区、类别分布的图表,需要跟现有看板的写法保持一致
- 新建一个角色专属的仪表盘页面,要求复用已有的 KPI 卡片和:新建一个角色专属的仪表盘页面,要求复用已有的 KPI 卡片和图表组轮播组件
- 给图表补上 CSV 导出和 PNG 截图,想确认项目里 Ch:给图表补上 CSV 导出和 PNG 截图,想确认项目里 ChartActions 组件该怎么接
适用人群
- 该项目的全栈开发工程师
- 做数据看板功能的前端开发者
- 维护 Go 聚合服务的后端工程师
使用步骤
- 先确认数据聚合放哪:在对应 Go service 里加 GetDistributionBy 类方法,用原生 SQL 算好 label、value 和百分比。
- 由 DashboardController 调用这些 service,把结果一起塞进 DashboardStats 作为 Inertia props 传给页面。
- 前端导入 Recharts 基础图形和 shadcn 的 ChartContainer、ChartConfig,按 DistributionPoint 形状接数据。
- 给每张图配上 ChartActions 做 CSV 导出、PNG 截图和全屏,相关图表编进 Carousel 组。
- 用 PermissionGate 或 canPerformAction 包住敏感分区,并按 xl:flex-row、lg:grid-cols-2 调好响应式布局。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- develop
- 最近更新
- 2026-09-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Guide for building dashboards, charts, KPI cards, and data visualizations. Use when creating dashboard pages, adding charts to features, building stat displays, aggregating data for visual presentation, or implementing export (CSV/PNG/fullscreen) for charts. Based on the Books dashboard implementation using Recharts and shadcn/ui chart components.
使用前准备
- 需要有这套 Go 加 Inertia 加 React 加 shadcn/ui 加 Recharts 的项目代码库,并熟悉其目录结构与权限约定。
依赖与权限
- 读取用户主动提供的内容