一期采用字段级 DSL，生成固定代码，不提供 SQL 编辑器、跨表关联、公式脚本或任意 ECharts 配置。

单表聚合 DSL：single-table-aggregate-v1

{
  "table": "shop_order",
  "dimension": {
    "field": "create_time",
    "timeUnit": "day"
  },
  "metrics": [{
    "field": "amount",
    "aggregate": "sum",
    "alias": "salesAmount"
  }],
  "filters": [{
    "field": "status",
    "operator": "eq",
    "value": "PAID"
  }],
  "dateRange": {
    "field": "create_time",
    "preset": "last_30_days"
  },
  "sort": { "by": "dimension", "order": "asc" },
  "limit": 100
}

统一响应协议

{
  "dimensions": [
    { "key": "2026-06-01", "label": "06-01" }
  ],
  "series": [{
    "key": "salesAmount",
    "name": "销售额",
    "values": [12800.50]
  }],
  "summary": {
    "value": 86420,
    "count": 328
  }
}

指标卡读取 summary，折线/柱状图读取 dimensions + series，饼图将第一组 series 映射为分类占比。

字段类型约束

COUNT

任意字段或整表计数

SUM / AVG

仅数值字段

维度

文本、枚举、日期时间

时间粒度

日、周、月；仅时间字段

生成与运行链路

保存页面

校验表、字段、聚合和筛选

→

生成代码

每个块生成只读聚合 API

→

运行查询

Mapper 使用白名单字段和固定 SQL 片段

→

图表渲染

ECharts 组件消费统一响应

权限与安全

块默认继承所在后台菜单的权限标识，并生成对应 @PreAuthorize。
可选开启 RuoYi 数据权限，由生成的 Service 方法进入数据权限切面。
表名、字段名、聚合函数、运算符全部来自白名单，值使用参数绑定。
限制最大分组数 500、默认 100；查询超时由数据库和应用统一配置控制。

错误与降级

设计时：字段删除或类型变化，页面标记“需要修复”，禁止生成。
预览时：当前块显示具体配置错误，其他块继续工作。
运行时：空数据展示空态；接口失败展示重试按钮，不弹全局错误。
旧定义版本继续可读；定义升级通过 version 和迁移函数归一化。

首批四个块的差异

块	维度	指标	特有配置
指标卡	不需要	1 个	前后缀、精度、对比文案
折线图	必填	1–3 个	平滑、面积、图例
柱状图	必填	1–3 个	横向、堆叠、Top N
饼图	必填	1 个	环形、标签、Top N + 其他

配置协议与运行边界

字段类型约束

权限与安全

错误与降级

首批四个块的差异