清单同步与配置移交
平台清单可跟随项目协作方式放在对应仓库:传统双仓项目(project new)默认放在后端 kaiwu/;产品主导项目(从 kaiwu-web-starter 起步并经 project adopt 纳管)维护在前端 kaiwu/,前端 Mock 直接读取该目录,后端通过 kaiwu/frontend-manifests 指向前端清单。
下面以订单状态为例,在项目清单的 kaiwu/dicts.yml 添加列表项,将 order-center 换成自己的项目编码。若文件仍是初始空列表 [],用下面的内容替换它。业务数据保存稳定值 PENDING,页面从字典读取标签(可通过 @/kaiwu 的 useDict 读取)。
- dictCode: order-center.order_status
name: Order status
items:
- value: PENDING
label: Pending
color: processing
default: true在入口仓运行第一条命令预览整份计划;核对目标、项目和全部资源后,再运行第二条。产品主导项目将清单目录换成前端仓路径即可(首次纳管用 project adopt 自动导入并同步 roles.yml,后续复跑 project sync 默认保留平台已调整过的角色,显式传入 --with-access 才同步角色变更):
./kaiwu project sync ../business/order-center-service
./kaiwu project sync ../business/order-center-service --apply清单目录 kaiwu/ 下的文件 | 用途 |
|---|---|
menus.yml、dicts.yml、configs.yml | 菜单与按钮、字典、受管参数;参数在使用处提供默认值。 |
jobs.yml、i18n.yml | 任务声明和项目多语言资源。 |
data-scopes.yml、roles.yml | 数据范围资源和角色授权;首次纳管时自动导入初始角色,日常变更需显式加 --with-access 预览并核对。 |
workflows/(可选) | 业务流程定义与绑定清单,独立启用 Workflow 服务后通过 ./kaiwu workflow sync <前端仓> 预览或导入。 |
在项目作用域的字典页查到稳定值,再切换用户语言检查业务页面。同步会新增资源、更新清单负责的字段,并保留已有参数的当前值。Kaiwu 采用项目作用域隔离的引用式国际化(scope_id 区分平台与各业务项目):项目管理员维护本项目菜单、字典与错语译文时,无需拥有平台全局文案权限,也不会把其他项目的词条下发到无关用户的浏览器。清单中移除的条目会在计划中列出,删除操作需要到配置移交页逐项确认。全局默认和内置 system 项目由平台维护。受管参数 · 同步规则

跨环境移交
很多团队在「开发 → 测试 → 生产」迁移菜单、字典、角色授权与定时任务时,只能靠手工导出 SQL 或在控制台重配一遍,极易因为环境主键 ID 不一致、漏配数据范围或误把测试任务直接跑在生产而出错。
在源环境「项目权限中心 → 配置移交」导出移交包,再到目标环境同名项目导入,整个过程按业务键对齐并具备四重安全边界:
- 6 类配置一次快照打包:JSON 移交包内置与仓库
kaiwu/同格式的dicts.yml、configs.yml、menus.yml、roles.yml(含角色的dataScopes数据范围)、jobs.yml与i18n.yml并附带sha256摘要;敏感配置自动跳过并写入warnings,导出的 YAML 也可以直接覆盖回业务仓库随 Git 提交。 - 业务键对齐,不耦合数据库 ID:菜单按权限码/路由/目录路径匹配,指定部门的数据范围按部门编码(
deptCode)导出,无需手工对账各环境主键。 - 三方基线比对 + 409 并发守卫:导入前先计算「上次成功移交基线 × 本次移交包 × 目标当前状态」的差异计划(
plan)与哈希;执行(apply)时若发现计划之后目标环境被人改过,直接返回 409 拒绝覆盖。 - 风险分级确认防误操作:普通配置默认应用(保留目标环境运营修改过的参数当前值);角色授权(
ACCESS)默认关闭,启用后按组追加;源环境已删条目(REMOVED_AT_SOURCE)须逐项勾选,目标环境自增条目只报漂移不误删;新建定时任务导入后一律默认停用并校验目标环境是否有在线 Handler;成员与密钥留在各自环境,每次移交均记入审计与移交记录。移交包范围
