用途:为 React 应用提供仪表盘 UI 模式,适用于管理面板、分析仪表盘与数据驱动界面,覆盖布局、小组件、实时数据与数据表格。
主要能力:响应式仪表盘网格(侧边栏、粘性头部、CSS Grid 多列);StatCard 等指标小组件;Widget Registry 模式,按 stat、chart、table、list 类型动态渲染;基于 TanStack Query 与 SSE 的实时更新,将流式数据写入查询缓存;基于 TanStack Table 的数据表格,支持排序、全局过滤与分页;骨架屏加载态。
使用方式:布局用 CSS Grid 与 Tailwind 类名组合;实时数据用 useQuery 拉取初始数据,再通过 EventSource 订阅 /api/metrics/stream,onmessage 中 setQueryData,onerror 时关闭并 invalidateQueries;表格使用 useReactTable 并挂载 core、sorted、filtered、pagination 各 rowModel。
限制与反模式:禁止每个小组件独立重复拉取数据;禁止单个指标变化导致整屏重渲染;禁止硬编码非响应式布局;禁止无间隔轮询;加载态不可缺失;实时更新需防抖。关键决策:2D 布局用 CSS Grid,服务端到客户端用 SSE、双向用 WebSocket,表格选 TanStack Table,状态用 TanStack Query 的细粒度 key,内容区用骨架屏。相关技能包括 recharts-patterns、tanstack-query-advanced、streaming-api-patterns。具体安装方式与收费情况暂未提供。