| name | budget-data-model |
| description | 提供预算系统数据模型的完整定义，包括所有表名、字段名、数据类型等。当用户需要查询预算相关数据模型结构、编写数据查询脚本、或需要了解特定表的字段信息时使用此技能。 |
| metadata | {"openclaw":{"emoji":"📊","requires":{"bins":[]}}} |
预算系统数据模型技能
提供预算系统的完整数据模型定义，包含 68 个数据表的详细结构信息。
何时使用
✅ 使用此技能的情况：
- "预算管理表有哪些字段？"
- "查询预算数据需要用到哪些表？"
- "帮我写一个查询预算数据的脚本"
- "预算表的表名是什么？"
- "需要了解预算系统的数据库结构"
- "某字段在哪个表里？"
数据模型结构
每个数据模型包含以下信息：
- table_id: 表标识（数据库表名）
- table_name: 表显示名（中文别名）
- fields: 字段列表，每个字段包含：
- field_id: 字段标识（数据库字段名）
- field_name: 字段显示名（中文别名）
- data_type: 数据类型（string/number/integer/datetime/date/array）
- length: 长度/精度
- is_required: 是否必填
- is_editable: 是否可编辑
主要数据表分类
预算基础表
费用预算表
业务预算表
报表相关表
辅助表
数据查询规范
1. 使用 DataModelUtils 查询
// 单条查询
def 数据 = DataModelUtils.getCIByPK("表名", ['ID': 值])
// 多条查询
def 数据列表 = DataModelUtils.getCIByAttr("表名", ['字段名': 值])
// SQL 查询
def sql = """SELECT * FROM "表名" WHERE 条件"""
def 结果 = DataModelUtils.queryForListMap(sql, null)
2. 字段命名规范
- 使用中文变量名（如
def 预算数据）
- 字段访问使用
dataFieldMap.字段名
- ID 字段通常为
ID 或 表名 id
3. 常见字段类型
| 类型 | 说明 | 示例 |
|---|
| string | 字符串 | '预算名称' |
| number | 数字（含小数） | 1000.00 |
| integer | 整数 | 2024 |
| datetime | 日期时间 | ${currTime} |
| date | 日期 | '2024-01-01' |
| array | 数组 | ['值 1', '值 2'] |
常用数据表说明
预算主表
用于存储预算的基本信息，包含预算名称、状态、创建时间等。
预算版本表
用于存储预算的不同版本，支持版本管理和历史追溯。
单位成本表
存储各单位的成本数据，包含月份、项目、金额等字段。
成本预算表
存储成本预算数据，支持多维度预算编制。
维修计划表
存储飞机维修计划，包含飞机号、客户编号、维修项目等。
培训计划表
存储培训计划信息，包含培训人员、时间、项目等。
数据模型文件
完整的数据模型定义存储在 references/data_models.json 文件中，包含所有 68 个数据表的详细字段信息。
使用示例
示例 1：查询预算主表数据
def 预算数据 = DataModelUtils.getCIByPK("预算主表", ['ID': 预算 ID])
def 预算名称 = 预算数据.dataFieldMap.预算名称
def 状态 = 预算数据.dataFieldMap.状态
示例 2：查询某飞机的维修计划
def 维修计划列表 = DataModelUtils.getCIByAttr("维修计划表", ['飞机号': 飞机号])
for (计划 in 维修计划列表) {
println "维修项目：" + 计划.dataFieldMap.维修项目
}
示例 3：汇总某单位某月的成本
def sql = """
SELECT SUM("金额") AS 总成本
FROM "单位成本表"
WHERE "单位 id" = ? AND "月份" = ?
"""
def 结果 = DataModelUtils.queryForListMap(sql, [单位 ID, 月份])
def 总成本 = 结果 [0].总成本
注意事项
- 表名和字段名：使用数据模型中定义的准确名称
- 数据类型：注意区分 string、number、integer 等类型
- 必填字段：创建数据时确保必填字段有值
- ID 字段：主键字段通常为 ID 或 表名 id，长度为 128
- 关联查询：通过 id 字段进行表间关联
相关文件
references/data_models.json - 完整数据模型定义（68 个表）
