- 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 个表）