fix(library): 维护收尾必须按预备份恢复并校验
build / build (push) Successful in 1m20s

删掉会自己开入口、只看服务健康的 FinalizeAfterOperatorRecovery。
新的 RecoverWindow 绑定原作业/目标指纹/持久化预备份,在维护关闭下
执行恢复与逐类校验,通过才恢复服务与入口;失败继续维护。
预备份身份与内容风险在第一笔写入前一起落盘;后台任务必须静默后才停写者;
写入者发布端口即拒绝开窗口;维护占用改为按实例互斥(000072)。
This commit is contained in:
姚章浩
2026-10-29 00:50:32 +08:00
parent ec737a9a65
commit 3643e9bf82
26 changed files with 1730 additions and 225 deletions
+52
View File
@@ -1062,6 +1062,58 @@
}
}
},
"/api/v1/library/maintenance/recover": {
"post": {
"tags": [
"Runtime"
],
"operationId": "recoverLibraryMaintenance",
"summary": "按预备份恢复并逐类校验后收尾维护窗口(仅管理员;只建恢复作业,恢复在校验通过前不开放目标)",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"scope"
],
"properties": {
"scope": {
"type": "string",
"enum": [
"internal",
"external"
]
},
"window_job_id": {
"type": "string",
"description": "可选:必须与当前维护窗口的作业一致"
}
}
}
}
}
},
"responses": {
"202": {
"description": "已创建恢复作业并入队"
},
"400": {
"$ref": "#/components/responses/BadRequest"
},
"409": {
"description": "没有未释放的维护窗口,或窗口属于别的 scope/作业"
},
"500": {
"$ref": "#/components/responses/InternalError"
},
"503": {
"description": "目标维护未接线或维护记录存储不可用"
}
}
}
},
"/api/v1/library/restores": {
"post": {
"tags": [