# 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`：下拉数据源