# world 世界管理模块

世界定义与管理模块（W-01 世界管理），平台入口域根模块。

## 功能
- world 表 CRUD（创建自动编码 W+时间戳+随机4位）
- 列表查询：sqlPaging 分页 + 复合索引（org_id+mode+created_at）过滤，返回 {list, total}
- world.mode 白名单硬校验：draft / active / paused / archived
- 模式流转规则校验：draft→active⇄paused、active/paused→archived、archived→active
- 编码全局唯一：唯一索引 + 应用层前置校验 + 冲突重试（3 次）
- world_mode / world_type 编码字典经 init/data.json 幂等落库（appcodes + appcodes_kv）

## 数据表
- `world`：世界定义表（models/world.json，四段式 summary/fields/indexes/codes）
- 编码字典：`world_mode`（draft/active/paused/archived）、`world_type`（game/simulation/education/business/social）

## 接口
REST 统一前缀 `/api/*`，错误结构 `{code, message, field, detail}`，分页 `{list, total}`：
- `POST/GET /world/api/create_world.dspy` 创建（自动编码、mode 校验）
- `POST /world/api/world_update.dspy` 更新（mode 流转校验、code 唯一校验）
- `POST /world/api/world_delete.dspy` 删除
- `GET /world/api/get_world.dspy` 单条查询
- `GET /world/api/list_worlds.dspy` 列表（分页 + 过滤）
- `POST /world/api/set_world_mode.dspy` 模式切换
- `GET /world/api/get_search_status.dspy` / `get_search_world_type.dspy` 下拉数据源

## 安装与集成
1. `pip install .`（pyproject.toml，依赖 sqlor / bricks_for_python）
2. 宿主应用 `from world.init import load_world`，init() 中 `load_world()` 挂载
3. 建表：build.sh 中 json2ddl 依据 models/world.json 生成 DDL；编码字典经 init/data.json 幂等落库
4. RBAC：运行 `scripts/load_path.py`（显式路径注册，禁通配符）
5. 前端：wwwroot/index.ui（入口）、menu.ui（菜单）、CRUD 由 json/world.json 经 xls2ui 生成

## 目录结构
```
world/
├── world/            # Python 包（world.py 业务逻辑 / init.py 注册 / __init__.py 导出）
├── wwwroot/          # index.ui、menu.ui、api/*.dspy
├── models/world.json # 表定义（四段式）
├── json/world.json   # CRUD 定义（tblname+params）
├── init/data.json    # 编码字典种子数据
├── scripts/load_path.py  # RBAC 注册
├── skill/SKILL.md    # 模块技能文档
└── pyproject.toml    # 打包
```