spec.md 2.4 KB

数据集字段与维度管理增强 Spec

背景

现有数据集字段配置只支持基础字段元数据、是否可筛选、是否可展示、字典类型与简单脱敏。实际报表和分析页面需要更稳定的字段语义配置,包括字段显示名称、标准类型、字段角色、日期格式、计量单位、脱敏规则,以及维度值翻译。

目标

  1. 数据集字段配置支持编辑显示名称、标准类型、字段角色,页面不再暴露“可筛选”“可展示”两个配置项。
  2. 数据集字段扩展属性支持日期展示格式、数据计量单位、脱敏级别与脱敏规则。
  3. 新增维度管理模块,支持手工维护维度字典数据,也支持绑定数据连接并通过 SQL 同步维度数据。
  4. 数据集维度字段支持绑定维度,运行时查询结果自动将字段原始值翻译成维度展示值,同时保留原始值。

设计

数据模型

  • 扩展 ai_report_data_dataset_field
    • date_format: 日期/日期时间展示格式
    • data_unit: 数据计量单位
    • dimension_id: 绑定维度 ID
  • 新增 ai_report_data_dimension
    • 维度主表,支持 MANUALSQL 两种来源
    • SQL 来源配置 connection_idsql_textvalue_columnlabel_column
  • 新增 ai_report_data_dimension_item
    • 维度值表,存储 value/label/status/sort/extra_json

后端接口

  • 新增 /data/dimension 标准 CRUD
  • 新增 /data/dimension/list 用于数据集字段绑定下拉
  • 新增 /data/dimension/{id}/items 查询与保存维度项
  • 新增 /data/dimension/{id}/sync 通过 SQL 同步维度项
  • 数据集字段详情、元数据、运行时查询补充扩展字段与维度信息

前端页面

  • 新增 forge-admin-ui/src/views/data/dimension.vue
  • 新增 forge-admin-ui/src/api/data/dimension.ts
  • 数据集字段弹窗改为字段配置弹窗,支持字段显示名、标准类型、字段角色、日期格式、单位、脱敏、维度绑定

运行时翻译

运行时查询如果字段绑定维度:

  • row[fieldName] 输出翻译后的展示值
  • row[fieldNameRaw] 保留原始值
  • 字段元数据返回 dimensionIddimensionCodedimensionName

非目标

  • 不实现维度树、级联维度、多语言翻译。
  • 不改变数据集参数配置模型。
  • 不删除数据库中的 query_enableddisplay_enabled 字段,保持兼容,但页面不再提供配置入口。