2.2 KiB
2.2 KiB
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 .
宿主应用接入（三处）：
app/{app}.py：定义get_module_dbname('world_sync')并挂 ServerEnv，init()中from world_sync.init import load_world_sync; load_world_sync()spec.json：generated_modules加入"world_sync"- 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）