feat: add release diff rollback plan
This commit is contained in:
@@ -124,7 +124,7 @@ EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署
|
||||
- `eip4 release package`
|
||||
- `eip4 release verify`
|
||||
- `eip4 release apply --require-approval`
|
||||
- `eip4 release rollback --package-id`
|
||||
- `eip4 release rollback-plan --package-file FILE --output FILE`
|
||||
|
||||
验收标准:
|
||||
|
||||
@@ -138,6 +138,7 @@ EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署
|
||||
- 参考 NocoBase revision 创建前检查版本控制插件的思路,EIP4 后续 revision restore/diff 不能只依赖 JSON 快照,必须有发布系统能力检查。
|
||||
- 新增 `eip4 release verify --package-file FILE`,先做离线发布前门禁,阻断未替换占位符和缺失本地 evidence 的功能包。
|
||||
- 新增 `eip4 release export/import-preview`,形成 `.eip4pkg.json` 文件格式和 checksum 门禁;导入预览不写环境、不启用功能。
|
||||
- 新增 `eip4 release diff/rollback-plan`,先落地离线差异检查和计划型回滚;回滚计划不执行生产 SQL。
|
||||
- 详细源码对照见 `docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md`。
|
||||
|
||||
### P4:Typed Page Schema 和组件注册表
|
||||
@@ -191,6 +192,6 @@ EIP4 应该借鉴的是边界和流程:
|
||||
| P0 | 完成 | `platform-ai` 主链路已提交 |
|
||||
| P1 | 第一版完成 | 已新增 `platform-cli` 和 Skills 规范骨架 |
|
||||
| P2 | 第一版完成 | 已新增功能包快照、里程碑 revision、CLI 命令和持久化表 |
|
||||
| P3 | 进行中 | 已完成 env registry/current env/cross-env guard/release verify/export/import-preview 第一版 |
|
||||
| P3 | 进行中 | 已完成 env registry/current env/cross-env guard/release verify/export/import-preview/diff/rollback-plan 第一版 |
|
||||
| P4 | 待开始 | 依赖页面 schema 现状清理 |
|
||||
| P5 | 待开始 | 依赖权限、审计、工具白名单成熟 |
|
||||
|
||||
@@ -46,6 +46,8 @@
|
||||
- 新增 `eip4 release verify --package-file FILE`,离线检查功能包是否具备本地门禁 evidence、人审标记、SQL/rollback,并阻断 `${...}` 占位符。
|
||||
- 新增 `eip4 release export --package-file FILE --output FILE`,将功能包封装为 `.eip4pkg.json`,包含格式版本和 SHA-256 checksum。
|
||||
- 新增 `eip4 release import-preview --package-file FILE`,离线验证 `.eip4pkg.json` checksum 和发布门禁,不写任何环境。
|
||||
- 新增 `eip4 release diff --left FILE --right FILE`,离线比较两个功能包或 `.eip4pkg.json` 的标识、SQL、rollback SQL 和 manifest 差异。
|
||||
- 新增 `eip4 release rollback-plan --package-file FILE --output FILE`,只生成结构化回滚计划,不执行生产写入。
|
||||
|
||||
## 三、后续实现顺序
|
||||
|
||||
@@ -79,12 +81,20 @@
|
||||
|
||||
### P3-3:Revision diff/restore
|
||||
|
||||
状态:第一版完成。
|
||||
|
||||
目标:
|
||||
|
||||
- revision diff
|
||||
- rollback plan
|
||||
- rollback 只生成计划和 SQL,不默认执行生产写入
|
||||
|
||||
第一版已落地:
|
||||
|
||||
- diff: 比较两个普通 feature package JSON 或 `.eip4pkg.json`,支持 checksum 校验和 JSON 输出。
|
||||
- rollback-plan: 生成 `EIP4_ROLLBACK_PLAN` JSON,包含 package/task/changeSet、rollback SQL、source evidence 和人审要求。
|
||||
- rollback-plan 会阻断 rollback SQL 中的 `${...}` 占位符;命令不连接环境、不落库、不执行 SQL。
|
||||
|
||||
### P4:Typed UI Registry
|
||||
|
||||
目标:
|
||||
|
||||
@@ -52,15 +52,31 @@ java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-pre
|
||||
--package-file target/ai-runs/feature-package.eip4pkg.json
|
||||
```
|
||||
|
||||
6. 确认部署包包含:
|
||||
6. 如存在上一版功能包,先做离线差异检查:
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff \
|
||||
--left target/ai-runs/feature-package-old.json \
|
||||
--right target/ai-runs/feature-package.json
|
||||
```
|
||||
|
||||
7. 需要回滚预案时,只生成回滚计划文件:
|
||||
|
||||
```bash
|
||||
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan \
|
||||
--package-file target/ai-runs/feature-package.eip4pkg.json \
|
||||
--output target/ai-runs/rollback-plan.json
|
||||
```
|
||||
|
||||
8. 确认部署包包含:
|
||||
- manifest
|
||||
- SQL 草案
|
||||
- rollback SQL
|
||||
- 本地 apply evidence
|
||||
- smoke evidence
|
||||
- repair evidence
|
||||
7. 确认部署包需要人工审批。
|
||||
8. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核;`release verify` 默认会阻断这类包。
|
||||
9. 确认部署包需要人工审批。
|
||||
10. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核;`release verify` 默认会阻断这类包。
|
||||
|
||||
## 线上 bug 修复路径
|
||||
|
||||
@@ -77,3 +93,4 @@ java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-pre
|
||||
- 不把 smoke 失败的变更包交给发布流程。
|
||||
- 不发布 `release verify` 失败的功能包。
|
||||
- 不把 `import-preview` 当成导入或启用;它只是离线检查。
|
||||
- 不把 `rollback-plan` 当成回滚执行;它只生成计划和 SQL 清单。
|
||||
|
||||
Reference in New Issue
Block a user