完成手动续期后台任务及权限隔离并更新回归进度

保留管理与业务续期调度,增加系统级幂等任务、取消传播和统计审计原子收尾;前端跟踪真实任务状态。原生 Linux 全后端、静态检查、相关专项二十次重复及前端二百七十二项测试和生产构建通过,未进行正式生产部署。
This commit is contained in:
xuans committed 2026-10-02 21:32:30 +08:00
1 parent 4ab3f93beb
commit 413a0e66a9
25 files changed
+739 -107

No files matched your search

@@ -16,6 +16,7 @@
| POST /api/v1/domains/:id/deploy | 提交已有证书部署,无请求体 | 可见域名、部署执行权限;202 |
| POST /api/v1/domains/:id/certificate/import | 上传证书后提交导入及部署任务 | 可见域名、证书管理、部署执行权限;不要求 DNS 凭据权限;202 |
| POST /api/v1/domains/:id/certificate/validate | 提交当前本地证书校验,无请求体 | 可见域名、私钥读取权限;不额外要求证书管理、DNS 或部署执行权限;202 |
| POST /api/v1/renewal/run | 提交管理证书及业务域名的全局续期检查,无请求体 | 当前有效超级管理员;202,不再同步返回 report |
| POST /api/v1/tasks/:id/retry | 同一任务新增一次尝试,无请求体 | 重试、证书管理、部署执行权限;申请类还检查 DNS 凭据;202 |
| DELETE /api/v1/tasks/:id | 请求取消 | 任务可见及取消权限;后台任务返回 202,非异步历史任务可能返回 200 |
| GET /api/v1/tasks | 当前身份可见任务列表 | 支持 domain_id 和 limit;返回 200 与 items 数组 |
@@ -65,6 +66,22 @@
- 400:幂等键等输入无效;401:登录失效;403:无权访问或来源错误;409:初始化未完成或状态冲突;500:持久化等内部错误;501:工作流未配置;503:权限服务未就绪、服务停止或队列已满。
- 错误响应一般含 error,可能带 request_id 或 task;网关也可能返回非 JSON 页面。解析失败只能提示暂时无法确认,不能推断任务已失败或自动再次提交。
## 全局手动续期检查
本入口继续调用原续期调度器,保留管理证书、业务域名、调度互斥锁、续期子任务、紧急重试等待与取消传播;不缩减为只检查业务域名。自动调度行为不因 HTTP 后台化改变。
- 系统任务固定为 task_type=renewal_check、domain_id=global-renewal-check、scope_type=system、project_id 为空;它既不是业务域名,也不是单次管理证书签发任务。
- 提交与取得执行槽后均重新核验当前超级管理员。普通管理员及普通用户不能读取该任务、尝试或完成审计,也不能取消;排队期间停用或降级则不执行续期。
- 支持合法 Idempotency-Key。同键命中原续期任务返回 200、task、replayed=true;另一键遇到活动全局检查返回 409、原 task、replayed=true;新任务返回 202、task、accepted=true 和 Location。前端必须确认任务类型,不能把任意 409 当作已受理。
- 同步旧版的 200 加 report 不是新版受理响应,前端必须提示结果无法确认,不能显示检查完成。响应丢失时保留原幂等键;确认受理后,下一次明确操作才生成新键。
- DELETE /api/v1/tasks/:id 接收取消意图后,继续轮询终态。已发生的续期或部署不会因父任务取消自动撤销;取消和超时摘要保留已返回的执行统计。
- 终态摘要保存检查、临期、选中、紧急、成功、失败和异常数量,与任务尝试及完成审计同事务提交;通过现有 task.message 和 attempt.message 展示。没有新增结构化续期 report 接口,也不伪造部署报告或保存底层敏感错误。
- 有失败或异常时为 failed,已有成功项时可为 partial_success;取消为 cancelled、超时为 failed,不因下游返回空错误而显示整体成功。异常中断提示核查已生成的子任务,不自动重放。
- 不支持通过通用 retry 重试 renewal_check;完成后如需再次检查,由超级管理员明确重新提交。逐域名部署、校验与恢复结果仍以对应子任务为准。
- 400 表示幂等键无效,403 表示超级管理员权限校验未通过,501 表示续期工作流未配置,503 表示任务依赖未就绪、服务停止或队列已满,500 表示持久化等错误。队列拒绝时可能已保存失败任务,不能假定从未创建任务。
前端使用独立 RenewalAction.js 管理提交状态和幂等键,复用任务详情跟踪结果;禁止重复点击时并发提交,不能仅凭受理响应显示续期完成。
## 数据模型
| 模型 | 字段 |