jeecg-system

JeecgBoot 系统主数据查询与管理

查询和管理 JeecgBoot 系统中的角色、用户、部门、字典等主数据。遵循"先查后建"原则：优先使用系统已有数据，没有才创建。

前置条件

用户必须提供以下信息（或由 AI 引导确认）：

1. API 地址：JeecgBoot 后端地址（如 https://boot3.jeecg.com/jeecgboot）
2. X-Access-Token：JWT 登录令牌（从浏览器 F12 获取）

如果用户未提供，提示：

请提供 JeecgBoot 后端地址和 X-Access-Token（从浏览器 F12 → Network → 任意请求的 Request Headers 中复制）。

核心原则：先查后建

在任何 skill（流程设计、表单设计、代码生成等）需要使用主数据时，必须先查询系统已有数据，确认不存在后才创建新数据。

数据类型	查询函数	创建函数	一站式函数
角色	query_roles() / find_role()	create_role()	find_or_create_role()
角色绑定用户	—	add_users_to_role(role_id, user_ids)	—
审批角色	query_approval_roles() / find_approval_role()	create_approval_role_group() + create_approval_role()	find_or_create_approval_role()
审批角色绑定用户	—	add_users_to_approval_role(role_id, user_ids)	—
用户	query_users() / find_user()	—	—
部门	query_depts() / find_dept()	—	—
岗位	query_dept_positions()	—	—
字典（普通）	query_dict() / search_dict() / find_dict()	create_dict()	find_or_create_dict()
字典（SQL表）	query_sql_table_dict()	—	—

使用方式

脚本位置

• scripts/system_creator.py — 通用命令行脚本（推荐，无需生成临时 .py）
• scripts/system_utils.py — 工具库（供其他 skill 脚本 import）

方式一：通用脚本 + 命令行（推荐）

单项查询（直接命令行，无需配置文件）：

SCRIPT="<skill目录>/jeecg-system/scripts/system_creator.py"
API="<api_base>"
TOKEN="eyJ..."

# 查询角色列表
python "$SCRIPT" --api-base $API --token $TOKEN --action query-roles
python "$SCRIPT" --api-base $API --token $TOKEN --action query-roles --keyword 经理

# 查询用户列表
python "$SCRIPT" --api-base $API --token $TOKEN --action query-users --keyword 张

# 查询部门树
python "$SCRIPT" --api-base $API --token $TOKEN --action query-depts
python "$SCRIPT" --api-base $API --token $TOKEN --action query-depts --keyword 研发

# 查询字典列表
python "$SCRIPT" --api-base $API --token $TOKEN --action query-dicts --keyword 请假

# 查询字典项
python "$SCRIPT" --api-base $API --token $TOKEN --action query-dict --code sex

# 查询职务列表
python "$SCRIPT" --api-base $API --token $TOKEN --action query-positions

# 查询部门+岗位树
python "$SCRIPT" --api-base $API --token $TOKEN --action query-dept-positions

# 查询审批角色
python "$SCRIPT" --api-base $API --token $TOKEN --action query-approval-roles

# 查询租户列表
python "$SCRIPT" --api-base $API --token $TOKEN --action query-tenants

# 查询数据源
python "$SCRIPT" --api-base $API --token $TOKEN --action query-datasources

# 查询定时任务
python "$SCRIPT" --api-base $API --token $TOKEN --action query-quartz-jobs

# 查询分类字典
python "$SCRIPT" --api-base $API --token $TOKEN --action query-categories --code B01

# 输出结果到 JSON 文件
python "$SCRIPT" --api-base $API --token $TOKEN --action query-roles --output roles.json