# script_engine 模块

逻辑编程（脚本/规则引擎）模块——脚本表 CRUD + 执行/校验接口。

## 功能

- `script_engine` 脚本表 CRUD：create_script / update_script / delete_script / get_script / list_scripts
- `execute_script`：按 id 或按 content+script_type 校验后执行
- `validate_script_api`：仅校验（语法 + 受限语法），不落库不执行
- 脚本类型：`0`=Python（受限命名空间，禁 import/类/λ/async/await/对象方法调用），`1`=SQL（仅只读 SELECT/SHOW/DESCRIBE/EXPLAIN，禁写语句/多语句）

## 数据表

`script_engine`：id(str32 PK)、script_name(str100 not null)、script_type(str32 default '0')、content(text not null)、description(str255)、status(str32 default '1')、created_at、updated_at
索引：idx_script_name、idx_script_type
编码：script_type→appcodes_kv(parentid='script_type')，status→appcodes_kv(parentid='script_status')

## 安装（挂载到宿主应用）

1. `pip install .`（或加入宿主 build.sh 模块安装循环）
2. 宿主应用 `app/{app}.py`：`from script_engine.init import load_script_engine` + `load_script_engine()`（init() 内）
3. `scripts/load_path.py` 注册 RBAC（显式路径，无通配符）
4. `build.sh` 四步：安装 xls2ddl → models→DDL → json→CRUD UI → 链接 wwwroot

## 集成

- 取库名统一 `ServerEnv().get_module_dbname('script_engine')`（.py）/ `get_module_dbname('script_engine')`（.dspy），禁止硬编码 DBNAME
- REST 接口（wwwroot/api/*.dspy）：script_create / script_update / script_delete / script_get / script_list / script_execute / execute_script / script_validate / validate_script
- 返回统一 `{code, message, field, detail}`；code=0 成功；分页 `data.list` / `data.total`

## 依赖

无业务依赖；依赖基础包 sqlor / ahserver / appPublic。