业务定义驱动 AI 大屏生成

status: apply created: 2026-05-17 complexity: 高

1. 背景与目标

现有 AI 大屏主要根据用户输入的需求描述生成组件和静态示例数据，缺少业务定义和数据集元数据约束，导致生成结果不是数据驱动的。用户已经在数据资产中准备好数据连接、数据集和字段语义后，希望先定义一个“业务定义”，把业务目标、指标口径、分析场景和多个数据集绑定起来，再让 forge-report-ui 的 AI 大屏生成基于该业务定义生成，并尽量自动绑定到对应数据集。

目标：

在数据资产管理中新增“业务定义”，支持描述业务基本定义、分析目标、指标口径和使用建议。
一个业务定义可绑定多个已发布数据集。
forge-report-ui AI 生成大屏时可选择业务定义。
后端提示词增加业务定义和数据集字段元数据上下文。
AI 返回组件时可声明数据集绑定；前端应用到画布时自动写入组件 request 数据集配置。
无法绑定数据集的组件仍允许保留静态数据。

2. 范围

本期包含

后端新增业务定义表、绑定表、CRUD、详情和 AI 上下文接口。
admin-ui 新增业务定义管理页。
report-ui AI 助手新增业务定义选择。
AI 请求模型新增 businessDefinitionId 和 businessContext。
AI 提示词模板新增业务定义数据上下文和数据集绑定输出规则。
AI 引擎应用组件时识别 request 字段并自动绑定数据集。

本期不包含

自动生成 SQL。
复杂指标血缘、指标计算引擎和多表语义建模。
数据集运行时自动聚合改造。
业务定义审批流。

3. 数据模型

新增表：

ai_report_data_business_definition
- 业务定义主表，保存编码、名称、业务描述、目标、指标口径、分析维度、使用建议、状态。
ai_report_data_business_dataset
- 业务定义与数据集多对多绑定表，保存排序、用途说明和主数据集标识。

4. 接口

GET /data/business/page
GET /data/business/list
GET /data/business/{id}
POST /data/business
PUT /data/business
DELETE /data/business/{id}
GET /data/business/{id}/ai-context

5. AI 生成规则

业务上下文包含：

业务定义：名称、编码、业务描述、分析目标、指标口径、分析维度、使用建议。
绑定数据集：数据集 ID、编码、名称、类型、描述、参数定义。
字段元数据：字段名、显示名、类型、维度/指标角色、默认聚合、单位、维度绑定。

AI 组件输出可带：

{
  "request": {
    "datasetId": 123,
    "datasetName": "订单销售数据集",
    "datasetFields": ["order_date", "amount"],
    "datasetMapping": {
      "mode": "auto",
      "fieldMap": {
        "category": "order_date",
        "value": "amount"
      },
      "syncHeader": true
    }
  }
}

前端应用规则：

request.datasetId 有值时，将组件请求模式设置为 DATASET。
继承默认 request 配置，只覆盖数据集相关字段。
AI 同时返回静态 option.dataset 时保留为兜底预览数据，运行时由数据集请求刷新。
未返回 request 或无法匹配数据集时按静态数据处理。

6. 风险

不涉及资金、权限变更和状态流转。
新增接口复用数据集现有访问能力，仅向 AI 上下文暴露当前用户可查询的已发布数据集。
提示词中的字段元数据需要控制长度，避免超出模型上下文。

spec.md 3.6 KB Historik Rå