# world 世界定义与管理模块（W-01 世界管理）

## 功能
- world 表 CRUD（创建/更新/删除/查询）
- 分页列表查询（sqlPaging + 复合索引 idx_world_list）
- 创建自动编码（W + 时间戳 + 随机4位，全局唯一，冲突重试 3 次）
- mode 白名单硬校验（draft/active/paused/archived）与流转规则校验
- world_mode / world_type 编码字典幂等落库（appcodes + appcodes_kv）

## 数据表
`world`（models/world.json 四段式 summary/fields/indexes/codes）：
- id VARCHAR(32) PK（str 32，getID() 生成，禁 uuid）
- code VARCHAR(64) 唯一（唯一索引 idx_world_code）
- name VARCHAR(255) NOT NULL
- description TEXT
- mode VARCHAR(32) NOT NULL DEFAULT 'draft'
- world_type VARCHAR(32)
- owner_id / org_id VARCHAR(32)
- created_at / updated_at TIMESTAMP
- 复合索引 idx_world_list(org_id, mode, created_at)

## 安装集成
1. 模块仓库克隆到宿主应用 pkgs/，`pip install .`
2. 宿主应用 `app/{app}.py` 引入 `from world.init import load_world` 并在 init() 调用 `load_world()`
3. 宿主应用定义 `get_module_dbname('world')` 映射到实际库名（禁止模块内硬编码 DBNAME）
4. `scripts/load_path.py` 注册 RBAC 路径（禁通配符）
5. 构建：`bash build.sh`（生成 DDL、CRUD UI、链接 wwwroot）

## 关键接口（经 load_world() 注册）
- `create_world(params)` → 自动编码；mode 默认 draft；非法 mode/流转 100% 拦截；编码冲突重试 3 次
- `update_world(params)` → 部分更新；mode 变更走流转校验；code 变更走全局唯一校验
- `delete_world(params)` / `get_world(params)`
- `list_worlds(params)` → 分页 {list, total, page, page_size}
- `set_world_mode(params)` → 模式切换严格校验（draft→active⇄paused、active/paused→archived、archived→active）
- `get_world_mode_options()` / `get_world_type_options()` → 下拉数据源 [{value, text}]

REST 前缀 `/api/*`：create_world.dspy / world_update.dspy / world_delete.dspy /
get_world.dspy / list_worlds.dspy / set_world_mode.dspy /
get_search_status.dspy / get_search_world_type.dspy

## 错误与分页结构
- 错误：`{code, message, field, detail}`
- 分页：`{list, total, page, page_size}`

## 依赖
sqlor（DBPools/sor.C/U/D/R/sqlPaging/sqlExe）、ahserver（ServerEnv）、appbase（appcodes/appcodes_kv）