budget-data-model

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].总成本

注意事项

1. 表名和字段名：使用数据模型中定义的准确名称
2. 数据类型：注意区分 string、number、integer 等类型
3. 必填字段：创建数据时确保必填字段有值
4. ID 字段：主键字段通常为 ID 或 表名 id，长度为 128
5. 关联查询：通过 id 字段进行表间关联

相关文件

• references/data_models.json - 完整数据模型定义（68 个表）