world_sync 同步管理模块（W-05）

元景项目 W-05 同步管理功能模块，负责同步配置、同步任务执行与同步日志查询。

功能

• 同步配置管理：world_sync 表 CRUD（同步编码唯一、类型/模式/状态白名单校验，非法输入 100% 拦截不落库）
• 同步任务执行：create_sync_task 创建任务 + execute_sync_task 批量事务执行，任一条失败整体回滚，无脏数据
• 同步日志查询：world_sync_log 分页查询（{list,total}）
• 编码字典：sync_status / sync_type 经 init/data.json 幂等落库到 appcodes/appcodes_kv

数据表（models/）

表	说明
world_sync	同步配置（sync_code 唯一）
world_sync_task	同步任务（batch_no 批次、统计计数、状态）
world_sync_log	同步日志（task_id 关联、payload/result/error_msg）

安装与集成

pip install .

宿主应用接入（三处）：

1. app/{app}.py：定义 get_module_dbname('world_sync') 并挂 ServerEnv，init() 中 from world_sync.init import load_world_sync; load_world_sync()
2. spec.json：generated_modules 加入 "world_sync"
3. RBAC：运行 scripts/load_path.py（或在中央 load_path.py 显式登记 /world_sync/* 路径，禁止通配符）

REST 接口（统一前缀 /api/*）

路径	说明
POST /world_sync/api/world_sync_create.dspy	新增同步配置
POST /world_sync/api/world_sync_update.dspy	更新同步配置
POST /world_sync/api/world_sync_delete.dspy	删除同步配置
GET /world_sync/api/world_sync_list.dspy	配置分页列表
POST /world_sync/api/world_sync_task_create.dspy	创建同步任务
POST /world_sync/api/world_sync_task_execute.dspy	执行同步任务（batch 事务）
GET /world_sync/api/world_sync_task_list.dspy	任务分页列表
GET /world_sync/api/world_sync_log_list.dspy	日志分页查询
GET /world_sync/api/world_sync_dict.dspy	编码字典

错误结构：{code, message, field, detail}；分页结构：{list, total}。

技术栈

Python 3.8+ / sqlor / ahserver ServerEnv / bricks-framework（前端 .ui）