36 lines
1.5 KiB
Markdown
36 lines
1.5 KiB
Markdown
# entity 模块
|
||
|
||
实体管理模块，含实体导入。依赖 `world`、`scene` 模块。
|
||
|
||
## 功能
|
||
- 实体表（entity）CRUD：实体名称/编码/所属世界/所属场景/实体类型/状态/属性 JSON
|
||
- 实体导入：上传 CSV/JSON 文件 → 解析 → 逐条校验 → 批量落库 → 写导入记录（entity_import）
|
||
|
||
## 数据表
|
||
| 表 | 说明 |
|
||
|----|------|
|
||
| entity | 实体表 |
|
||
| entity_import | 实体导入记录表 |
|
||
|
||
## 目录结构
|
||
```
|
||
entity/
|
||
├── entity/ # Python 包（init.py 定义 load_entity 及业务函数）
|
||
├── models/ # 表定义（entity.json / entity_import.json）
|
||
├── json/ # CRUD 定义（entity.json / entity_import.json）
|
||
├── wwwroot/ # 前端（index.ui / import_page.ui / api/*.dspy）
|
||
├── init/data.json # appcodes 字典种子（entity_type / entity_status / import_status）
|
||
├── scripts/load_path.py # RBAC 权限注册
|
||
└── skill/SKILL.md # 模块技能文档
|
||
```
|
||
|
||
## 集成方式
|
||
应用入口 `app/{应用名}.py` 中 `from entity.init import load_entity`，并在 `init()` 里调用
|
||
`load_entity()`。库名由宿主应用的 `get_module_dbname('entity')` 决定，模块内不硬编码。
|
||
|
||
## 关键接口
|
||
- `load_entity()`：挂载模块函数到 ServerEnv
|
||
- `wwwroot/api/entity_import.dspy`：实体导入（world_id + scene_id + file）
|
||
- `wwwroot/api/entity_create.dspy` / `entity_update.dspy` / `entity_delete.dspy`：实体 CRUD
|
||
- `wwwroot/api/get_search_*.dspy`：下拉数据源
|