Scert/doc/基础整改任务规格.md
xuans e2200534d3 完善域名服务器多对多关联与共享路径预检,补齐回归源码及进度文档
支持同项目内域名与服务器双向复用,局部修改和清空不影响其他域名;在绑定保存、服务器编辑和部署前拒绝已知共享路径冲突。

新增仓储、接口、工作流与页面回归源码,同步任务状态和第三版接口交接。按要求先开发后统一测试,本批未运行测试、构建或部署,保留在途任务与主机别名等待办。
2026-09-28 21:51:05 +08:00

32 KiB
Raw Blame History

基础整改任务规格

当前开发补充(2026-09-28):已按用户确认补齐域名与服务器多对多源码,同项目内可双向复用,修改或清空一方不改变另一方;共享路径冲突在绑定保存、服务器修改及部署前检查。生命周期收尾、七个资源读取入口与绑定写入授权均待统一测试,其他业务资源及任务授权仍未闭环,六阶段及原始 44 项不缩减。服务器别名、在途任务与远端文件占用不由本批静态路径检查替代。详见执行清单首节、模型第十一/十二节和支持矩阵第二十六节;下方为历史证据。

当前补充(2026-09-28 20:15):P0-04 已新增干净提交 Windows 正式发布构建、包内容与运行副本核验及实际启动证据;P0-07 的浏览器验证仅到达首次初始化的未认证入口,配置和无效令牌均被拒绝。浏览器文件工具工作区配置阻止传入一次性地址,尚未兑换合法会话,不能称成员页面、项目隔离或生产验收通过。初始化专项 128 个叶子通过、4 条平台条件跳过,完整范围见支持矩阵第二十五节。各总项及六阶段验收标准不变,下方为历史进度。

当前进度(2026-09-28 19:54):P0-07 的成员 API、成功事务审计、失败请求审计、可见项目分页入口和成员 Web 页面均已实现;普通项目管理员可从自己的工作台进入,项目和成员响应禁止缓存,账户建议不扩大原有用户可见性。最后源码专项、完整后端、前端、双版本 MySQL 组合及三轮专项竞态已通过,条件跳过和构建证据见支持矩阵第二十四节。真实浏览器、项目增删改、全业务资源及排队任务授权仍未交付或验收;P0-07 保持进行中,原始六阶段与生产门禁不变。下方未接入成员 Web/API 的表述仅对应历史批次。

当前补充(2026-09-28):P0-07/P1-09 的成功成员变更与审计同事务实现已在检查点保存,审计失败必须回滚;拒绝请求审计、成员 Web/API 和业务授权仍未交付。P0-04/P0-05 最终驱动候选的完整后端、SQLite 取消查询与 WAL 专项、双版本 MySQL 组合及 Windows 独立程序恢复已通过。精确结果、竞态与未关闭项见支持矩阵第二十二节,不沿用旧批次放行;各总项状态不升级。

本批进度(模式 14):P0-07 已实现项目成员与六类角色、按实时账户状态和关系判权、单语句授权变更;P0-06 增加成员引用约束。用户分组不隐式授予权限,普通用户不能读取完整私钥。成员 Web/API、审计和全部资源/任务授权链仍未接入;P0-05/P0-06/P0-07 保持 [~]。证据与边界见执行清单首节、模型第九节和支持矩阵第二十一节;下方为历史批次。

本批进度(模式 13):P0-06 已增加任务/审计的项目、系统和未知范围快照及任务关联;HTTP 身份、后台任务、历史删除资源与孤儿尝试按实际来源处理。范围保存与当前资源校验不是成员授权,P0-05/P0-06/P0-07 均保持 [~]。本批证据见执行清单首节及支持矩阵第二十节;下方模式 10~12 说明为历史批次,不覆盖本批结果。

当前进度:域名/服务器归属、三库第 11 号迁移及绑定约束已随 7284958 提交;第 12 号迁移已随 92c844f 修复 SQLite 替换绕过并通过本批回归,详细状态见执行清单和支持矩阵第十九节。下方根实体批次与 46 项条件跳过为历史数据;资源批次全量是 47 项条件跳过,不能混用。任务、审计、其他资源及成员授权仍未完成,P0-05/P0-06/P0-07 总项均保持 [~]。

2026 年 9 月 28 日最终验证:项目根实体的 SQLite、MySQL 5.7/8.0 实库及后端回归已通过,替代下方启动阶段“持续验证”的状态;仅该子项为 [x]。完整资源关联与 P0-07 权限隔离仍为 [~]。详细证据、46 项条件跳过及 PostgreSQL/生产缺口见支持矩阵第十八节。

2026 年 9 月 28 日实施补充

  • P0-06 新增项目根实体、三库第 10 号迁移与仓储,本地项目及 SQLite 历史升级专项通过。
  • [~] 完整后端、MySQL 隔离验证及后续项目资源关联持续推进,详见《Scert整改任务执行清单.md》《项目资源关联模型.md》。
  • PostgreSQL 项目实库验证、资源回填、跨项目关联保护、成员授权及危险操作审计关联仍未完成。

P0-06 与 P0-07 均维持 [~],六阶段中的隔离、生产和最终验收不得因新增项目表提前勾选。P0-05 的旧证据只适用于原对应版本,模式 10 的完整数据库矩阵仍需重新验证。

本文件覆盖原始清单 P0 的全部 12 项。命令编号、六阶段定义和实机前置条件见《整改任务规格与验收约定.md》。文件路径相对仓库根目录;“拟新增”明确表示尚未存在,不作为现成功能证据。

P0-01 明确产品范围

  • 任务编号:P0-01;任务名称:明确产品范围;优先级:P0。
  • 当前状态:[x] 已完成,等待复审。
  • 六阶段:需求确认 [x];代码实现 [x];自动化测试 [x];隔离环境测试 [x];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:桌面源码和旧 CLI 业务入口曾与正式范围混淆。
  • 涉及文件:build/build-release.ps1、backend/internal/cli/root.go、backend/internal/releasearchive/、根及各模块 README、《命令行运维范围说明.md》。
  • 依赖任务:无;双平台安装证据由 P2-08、P2-09 补齐,不倒置为范围整改的代码依赖。
  • 整改内容:只正式交付 Web/服务端;桌面窗口、托盘、更新、配置与 UI 测试全部范围外,保留历史源码;CLI 仅作初始化、诊断、迁移、备份恢复和服务管理,拒绝旧业务入口。
  • 验证命令:V01、V05、V04;核对 manifest、归档内容、校验和以及实际程序帮助/拒绝入口退出码。
  • 实机验收步骤:解包当前候选,确认没有桌面程序;分别在 Windows/Linux 运行帮助和运维入口;旧业务命令必须非零退出且不读凭据或生成运行数据;安装分别关联服务验收项。
  • 验收证据:执行清单已记录 885478a 的干净双平台包、独立克隆与 Windows 实际 CLI 结果;Linux 实机尚缺,不能用归档权限替代。
  • 复审结果:待最终复审,未生产放行。

P0-02 整理项目任务清单

  • 任务编号:P0-02;任务名称:整理项目任务清单;优先级:P0。
  • 当前状态:[x] 已完成,等待复审。
  • 六阶段:需求确认 [x];代码实现 [x];自动化测试 [x];隔离环境测试 [x];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:旧汇总表虽覆盖 44 项,缺逐项依赖、文件、命令、实机步骤和复审字段。
  • 涉及文件:《Scert整改任务执行清单.md》、本文件、其余三级任务规格、《整改任务规格与验收约定.md》;关联《Scert开发任务清单.md》《全面审查测试与优化记录.md》《发布加固与实机验收记录.md》《生产部署与运维说明.md》。
  • 依赖任务:P0-01;其余 43 项的业务完成不是本项文档补齐的前提。
  • 整改内容:逐项补足 12 个原定字段及六阶段,原始清单保留;区分历史事实、规划和当前实证;维护汇总状态与规格一致。
  • 验证命令:V01;按约定进行 44 项编号、必需字段、依赖、文件、状态和六阶段结构核对,并人工对照原始范围。
  • 实机验收步骤:生产执行时按规格逐项登记提交、包哈希、环境与实际操作;抽查任何“通过”能回溯到对应证据。文档治理本身不触碰服务器或数据库。
  • 验收证据:2026-09-27 对照原始清单核对全部 44 项编号和名称、必需字段、六阶段、显式依赖编号、既有文件及汇总状态;fab98d1 独立克隆包含全部规格,构建后工作区干净。详见执行清单本批记录;不将文档齐全称为 44 项业务完成。
  • 复审结果:结构与范围核对通过,等待最终复审;本治理项未单独执行生产部署,实际业务按各任务门禁继续验证。

P0-03 整理源码、构建产物和部署产物

  • 任务编号:P0-03;任务名称:整理源码、构建产物和部署产物;优先级:P0。
  • 当前状态:[x] 已完成,等待复审。
  • 六阶段:需求确认 [x];代码实现 [x];自动化测试 [x];隔离环境测试 [x];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:既有忽略规则未覆盖根级二进制、通用归档、补丁和数据库旁路文件;开发机排除配置不能代表新克隆。
  • 涉及文件:.gitignore、backend/internal/releasearchive/source_boundary_test.go、release/README.md、artifacts/README.md、tests/README.md、scripts/README.md、《仓库目录与产物边界说明.md》。
  • 依赖任务:P0-01。
  • 整改内容:建立八类目录及构建/运行边界,不删除现有文件;忽略产物和敏感文件但保留源码、迁移、部署测试及公开 CA;检测已跟踪违禁产物。
  • 验证命令:V01、V05;go test -count=1 ./internal/releasearchive -run TestRepositoryIgnore,在 backend/ 执行。
  • 实机验收步骤:独立克隆只取源码,安装依赖并正式构建;确认工作区无新增产物入索引;部署只取发布白名单,不能携带浏览器缓存、数据库或本机凭据。
  • 验收证据:fab98d1 后端全量测试、vet、模块校验通过;隔离 Git 核对根及子目录规则和完整索引;独立克隆完成发布模块测试、前端 150 项、双平台构建及 33 项 manifest/归档校验,产物未入索引,未删除现有文件。
  • 复审结果:源码及产物边界复核通过,等待最终复审;没有执行远端生产部署,不代表生产能力通过。

P0-04 统一开发和构建版本

  • 任务编号:P0-04;任务名称:统一开发和构建版本;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [x];自动化测试 [x];隔离环境测试 [~];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:精确工具链、禁用安装脚本、发布前后校验、构建机记录与换行一致性已实现,Windows 双独立克隆验证通过;Linux 原生构建与双平台运行环境证据仍缺。
  • 涉及文件:.gitattributes、backend/go.mod、backend/go.sum、backend/internal/releasearchive/source_boundary_test.go、frontend/package.json、frontend/package-lock.json、frontend/.npmrc、build/build-release.ps1、build/toolchain.mjs、build/toolchain.test.mjs、《构建版本与数据库支持矩阵.md》。
  • 依赖任务:P0-01、P0-03。
  • 整改内容:记录并固定 Go、Node、npm、Vue、驱动和依赖版本、系统版本、编译目标;检查锁文件安装及构建环境差异。模块内实际 Go 版本优先,不按根目录工具版本降级模块。
  • 验证命令:V02、V03、V04;模块内 go version、go env GOVERSION GOTOOLCHAIN;node --version、npm.cmd --version。
  • 实机验收步骤:全新构建环境按固定版本安装依赖;验证锁文件不漂移;在双平台验收机记录系统版本和运行包版本,比较 manifest。
  • 验收证据:最终候选 94237b8 独立克隆前端 175 项通过,其中 25 项工具链回归;后端全量测试、vet、模块校验通过;两份不同换行配置的克隆产生相同 4 个 Web 文件和 5 份版本输入哈希;33 项发布清单、双平台解包及包内校验全部通过,详见执行清单本批记录。
  • 复审结果:Windows 构建与前端重复构建已验证;整体仍未完成,不能用交叉编译替代 Linux 原生构建或真实服务运行验收。

P0-05 确认数据库正式支持矩阵

  • 任务编号:P0-05;任务名称:确认数据库正式支持矩阵;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [~];生产部署测试 [!];最终验收 [ ]。
  • 问题说明:已修复迁移、连接恢复、MySQL 对象导出/恢复、SQLite 逐连接配置与 WAL 恢复;本批修复历史模式 1~3 有任务数据时迁移 4 失败,并补充独立 Windows 程序的升级及备份恢复。旧发行包实际数据升级、完整发行包、真实服务重启、Linux 原生、取消边界及剩余数据库/平台证据仍不足。
  • 涉及文件:backend/internal/database/、其 migrations/mysql/、migrations/postgres/、migrations/sqlite/、backend/internal/cli/、《构建版本与数据库支持矩阵.md》。
  • 依赖任务:P0-04。
  • 整改内容:明确 SQLite、MySQL、PostgreSQL 支持版本;验证 MySQL 5.7/8.0、PostgreSQL 目标版本、SQLite 锁并发;逐库检查类型、索引、默认值、事务及初始化、升级、回滚、备份恢复。不能悄然去掉难测版本。
  • 当前新增证据:SQLite 历史模式 1~9 的带数据升级、任务表依赖对象保留、失败回滚与解除阻塞后重试已完成;独立 Windows 产品程序的旧备份升级、恢复后再升级和升级后备份恢复已完成,详见《构建版本与数据库支持矩阵》第十七节。
  • 当前剩余门禁:旧发行包实际数据与配置、完整发行包安装、真实服务重启、Linux 原生执行、取消边界、其余数据库/平台和生产门禁仍未完成;隔离模式夹具和交叉编译不替代这些证据。
  • 验证命令:V06、V02;真实数据库测试按正式集成测试的参数运行并保存非跳过结果,不在命令行嵌入密码。
  • 实机验收步骤:逐版本创建专用测试库;从空库初始化及历史版本迁移,注入失败检查事务;使用官方备份工具恢复并核对行数、资源关联和加密凭据;验证 TLS 和断线重连;只清理明确测试库。
  • 验收证据:源码 777c716 在 Windows MySQL 5.7.44、8.0.45 完整专项分别通过 176、202 个叶子用例,0 失败、0 跳过;含父项记录为 201、227。新增视图与完整清单权限、复杂依赖、原始官方文件恢复及失败保护;详见支持矩阵第十四节,之前批次的例程、事件等证据保留追溯。
  • 复审结果:上述 Windows 隔离范围通过,不等于生产放行。基础表仍只接受 InnoDB,不承诺并发 DDL 一致性;视图已在本批列明场景中验证,不再一概拒绝。官方文件仅对严格识别的连续最终视图块调整顺序;其他编码/SQL 模式、定义者迁移、独立发行命令、Linux 实库、PostgreSQL 当前复测、SQLite 并发锁及正式服务验收仍未完成。

本批补充证据(af831ae):Windows SQLite 3.49.1 专项与竞态检测各通过 42 个叶子用例,26 个核心用例连续重复 10 次通过;连接配置丢失和短截止时间等待超限已有先失败后通过记录。覆盖真实文件库双连接池、三子进程、事务快照、回滚、关闭重开及活动 WAL 快照。无截止时间的手动取消仍可能约 5 秒;这一记录不代表立即取消通过,也不替代完整业务升级恢复、真实服务重启或 Linux/生产验收。当前 SQLite 进展以支持矩阵第十五节及下方子任务为准。

P0-05 触发器自有备份子任务进度

  • [x] 复现自有备份丢失触发器,以及权限不足时隐藏触发器仍报告成功的问题。
  • [x] 实现按执行顺序导出原始定义、定义者、SQL 模式、客户端字符集、连接和数据库排序规则;先恢复基础数据再创建触发器。
  • [x] 全局、库级、表级、角色、部分撤销和授权遮蔽的可见权限预检;不能证明权限时失败并保留既有备份。
  • [x] 最终候选 3f6d5b8 的 Windows MySQL 5.7.44 / 8.0.45 完整专项回归通过 97 / 104 个叶子用例,0 失败、0 跳过;官方客户端也验证了自有触发器文件。
  • [x] 本批实现、最终复测、收尾与文档证据已核对;后端全量测试、vet、模块校验及 Linux 测试包交叉编译通过。细节见支持矩阵第十一节,不提升 P0-05 总状态,也不将交叉编译记为 Linux 实库通过。
  • [ ] 例程、事件、视图、其他 SQL 模式、完整表清单权限及剩余三库/双平台矩阵;歧义通配授权目前保守失败,不能视为所有权限组合均完整支持。

P0-05 例程自有备份子任务进度

  • [x] 复现并修复存储过程、函数遗漏;保留定义者、参数、SQL 模式、创建字符集与排序规则,支持替换同名例程。
  • [x] 不依赖过滤后的元数据空列表;完整查看权限不足时失败,保留已有备份并清理临时文件。
  • [x] 修复 5.7 Latin-1 例程注释乱码,保留 8.0 声明头处理;新增五种元数据失败保护场景,错误保留中文上下文及底层原因。
  • [x] 双版本正式实库全专项通过 110 / 121 个叶子用例,0 失败、0 跳过;完整后端回归、vet、模块校验及 Linux 测试包交叉编译通过。收尾与证据见支持矩阵第十二节;未执行 Linux 实库,不提升总状态。
  • [ ] 事件、视图、完整表清单权限、其他 SQL 模式、跨服务器定义者迁移及生产恢复验收。本子任务不提升 P0-05 总状态。

P0-05 事件自有备份子任务进度

  • [x] 补齐事件原始定义、时区和计划、定义者、启停状态、创建会话属性,支持重复恢复与同名替换。
  • [x] 全局/库级有效 EVENT 可见权限预检;无权限空库、未启用角色、部分撤销与通配遮蔽均有正式反例。
  • [x] 恢复前检查 PROCESS、工作线程和调度状态;维护窗口由管理员维持,产品不改全局调度、不终止线程、不擅自禁用已有事件。
  • [x] 编码元数据拒绝、过期事件与恢复警告保护,Scert 和官方客户端双路径互操作及真实事件执行。
  • [x] 最终双版本完整专项、常规全量测试、静态检查及收尾验证通过,见支持矩阵第十三节;之前的失败证据保留,不与最终通过结果混用。
  • [~] 视图自有备份与恢复;上方触发器、例程子任务的剩余项为当时记录,事件本批进展以此节为准。
  • [ ] 完整表清单权限、其他 SQL 模式、跨库及跨服务器定义者、独立发行验证、其余数据库/平台与生产门禁;P0-05 总状态不提升。

P0-05 视图与完整清单子任务进度

  • [x] 完整库 SELECT 与逐视图 SHOW VIEW 检查;隐藏对象、角色、部分撤销、授权遮蔽失败时保留原备份。
  • [x] 原始定义、创建编码、定义者和检查选项保留;依赖解析与拓扑排序,不以占位表规避视图依赖。
  • [x] 原始官方文件的连续最终视图块受限排序;计划预检、会话上下文检查及原文件哈希不变验证。
  • [x] 复杂/宽/失效视图、三条互操作路径和失败保护的 Windows 双版本实库证据,详见支持矩阵第十四节。
  • [~] 下一步验证 SQLite 并发与锁;上方触发器、例程和事件段中的缺口是各批历史状态,当前进展以本节为准。
  • [ ] MySQL 其他编码/SQL 模式、并发 DDL/授权变化、独立发行验证、剩余三库/双平台及生产门禁;P0-05 保持 [~]。

P0-05 SQLite 并发与锁子任务进度

  • [x] 逐连接初始化;短截止时间执行/查询/预处理/事务启动等待预算及配置恢复;不重试业务 SQL。
  • [x] 多连接、多连接池和三子进程实际锁竞争;隔离、快照、事务回滚、连接重建与文件库关闭重开。
  • [x] 活动 WAL 快照不包含未提交数据,提交后快照包含对应数据;专项、重复、竞态及相关后端回归通过。
  • [~] 无截止时间取消的原生等待边界、完整业务升级恢复和服务重启;已记录的 5 秒行为不是已修复证明。
  • [ ] 独立发行命令、Linux 实机、其余数据库复测及生产门禁;P0-05 不提升为完成。

P0-05 SQLite 异常退出及业务恢复子任务

  • [x] 源码 6db5d7b 修复残留 WAL 覆盖恢复主文件;恢复前快照包含已经提交的 WAL,恢复失败仍保留原业务数据。
  • [x] 正式命令处理器核对当前全部业务表和模式、迁移历史、审计序列、用户密码/分组、任务和部署关联、加密凭据及真实证书私钥,重复恢复通过。
  • [x] SQLite 专项 55 个叶子用例、恢复专项 13 个用例连续 5 次竞态检测通过;完整后端、静态及模块检查通过,证据见支持矩阵第十六节。
  • [ ] 带业务数据的历史版本升级、独立发行命令、真实服务重启和 Linux 原生运行;异常进程退出不等于断电/磁盘故障,凭据可解密不等于外部 DNS/SSH/邮件服务已验收。

P0-06 建立统一领域模型

  • 任务编号:P0-06;任务名称:建立统一领域模型;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [ ];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:已有用户、域名、任务和服务器模型,项目、证书订单/版本及跨业务关联未闭环。
  • 涉及文件:backend/internal/domain/、backend/internal/database/migrations/、backend/internal/repository/、backend/internal/httpapi/;拟新增领域关系说明及必要实体迁移。
  • 依赖任务:P0-05 的支持矩阵;设计审查可先于实机完成。
  • 整改内容:覆盖 users、roles、projects、domains、certificates、certificate_versions、certificate_orders、dns_accounts、dns_delegations、servers、deployment_targets、deployment_records、tasks、task_attempts、renewal_policies、notification_channels、notification_records、audit_logs、backup_records;定义外键、归属、引用删除策略、任务和审计关联。
  • 验证命令:V06、V07;补关联完整性、迁移回填和删除约束测试。
  • 实机验收步骤:迁移含历史资源的专用库,核对项目归属不丢失;从一次申请追踪订单、版本、任务、部署、通知和审计;删除仍被引用的资源必须拒绝。
  • 验收证据:项目根实体、域名/服务器四字段、默认项目历史回填及事务绑定已有代码与 SQLite/MySQL 隔离证据;关系模型见《项目资源关联模型.md》。第 12 号迁移补强替换保护,完整任务/审计等关联、PostgreSQL 实库及生产闭环仍待补,当前结果见支持矩阵第十九节。
  • 复审结果:未完成,禁止用相似名称替代缺失关联。

P0-07 增加项目级权限和资源隔离

  • 任务编号:P0-07;任务名称:增加项目级权限和资源隔离;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [ ];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:当前用户分组不等于项目及资源隔离,项目级授权仍需实现和审查。
  • 涉及文件:backend/internal/auth/、backend/internal/admin/、backend/internal/httpapi/、backend/internal/repository/、frontend/src/views/UserManagement/;拟新增项目管理模块及迁移。
  • 依赖任务:P0-06。
  • 整改内容:资源增加项目、所有者、创建人及更新人;制定系统管理员、项目管理员、证书/DNS/部署管理员、审计与只读角色矩阵;列表、详情、写操作、导出与后台任务均检查项目归属,普通用户不能读完整私钥。
  • 验证命令:V07、V06、V03;补跨项目 ID 枚举、伪造归属、任务访问与私钥导出拒绝测试。
  • 实机验收步骤:建立两项目和最小权限成员;分别测试证书、服务器、目标、DNS、任务、审计的跨项目读写、删除与回滚;撤权后现有会话及排队任务必须重新判权。
  • 验收证据:域名/服务器归属和 HTTP 拒绝伪造归属已覆盖;六类角色、实时判权及成功审计同事务已有仓储证据。本批成员分页、授予/撤销 API、实际应用接线和失败审计已通过专项及双版本 MySQL,完整后端、三轮成员专项竞态和构建通过,跳过与验证范围见支持矩阵第二十三节。成员页面、项目入口、全部资源跨项目读写和排队任务撤权重判仍待补,不能称项目隔离已完成。
  • 复审结果:未完成。

P0-08 完善凭据和主密钥生命周期

  • 任务编号:P0-08;任务名称:完善凭据和主密钥生命周期;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [ ];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:加密存储已有基础,引用检查、禁用、轮换、主密钥变更和恢复链路证据不完整。
  • 涉及文件:backend/internal/secretstore/、backend/internal/sshkey/、backend/internal/config/、backend/internal/certificate/、backend/internal/database/credentials.go、backend/internal/httpapi/。
  • 依赖任务:P0-06、P0-07。
  • 整改内容:统一 DNS、SSH、SMTP、HTTP、数据库、ACME 和证书私钥的创建、验证、禁用、轮换、删除与引用检查;实现主密钥变更、备份恢复和丢失边界;页面与日志永不返回完整秘密。
  • 验证命令:V08、V07、V10;增加轮换中断、密钥丢失、被引用删除、禁用后使用及日志脱敏测试。
  • 实机验收步骤:专用测试凭据轮换后确认新值生效、旧值失效;中断主密钥变更验证原子性;从受保护备份恢复;缺主密钥必须明确拒绝而非静默生成并丢失数据;检查输出与存储权限。
  • 验收证据:已有 secretstore 与密钥测试;完整生命周期和恢复演练尚缺。
  • 复审结果:未完成。

P0-09 强化 SSH 主机身份验证

  • 任务编号:P0-09;任务名称:强化 SSH 主机身份验证;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [~];生产部署测试 [~];最终验收 [ ]。
  • 问题说明:指纹校验已有测试,首次确认、变更更新以及自动公钥安装实机失败尚需定位。
  • 涉及文件:backend/internal/deployment/、backend/internal/sshkey/、backend/internal/httpapi/、frontend/src/views/Dashboard/ServerModal.vue、frontend/src/views/Dashboard/SSHKeyModal.vue。
  • 依赖任务:P0-07、P0-08。
  • 整改内容:保存并确认指纹、变更阻断、人工更新留审计;未确认、目标不符、失效凭据全部阻断;命令依据具体服务器展示,支持密码安装公钥并用密钥验证登录,失败日志仅含安全摘要。
  • 验证命令:V09、V07、V03;补首次未确认、指纹变化及各公钥部署阶段失败测试。
  • 实机验收步骤:使用已确认主机指纹密码登录,按 password_connect、authorized_key_install、private_key_connect、private_key_command、private_key_exit 分阶段定位;验证 authorized_keys 权限和密钥登录;隔离 SSH 目标更换指纹后必须阻断,人工更新后再试。
  • 验收证据:历史 SSH 身份只作连接线索,当前候选公钥自动部署成功、失败与恢复的完整证据待补。
  • 复审结果:未完成,不跳过指纹换取成功。

P0-10 统一任务、部署和回滚事务模型

  • 任务编号:P0-10;任务名称:统一任务、部署和回滚事务模型;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [ ];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:部署事务不等于全部长操作都具备统一任务、执行尝试、取消和部分成功状态。
  • 涉及文件:backend/internal/domain/、backend/internal/repository/task_repository.go、backend/internal/deployment/、backend/internal/certificate/、backend/internal/httpapi/;拟新增统一任务服务与必要迁移。
  • 依赖任务:P0-06、P0-07、P0-09。
  • 整改内容:申请、续期、DNS 验证、部署、批量部署、远程备份、回滚、恢复全部关联任务;统一待执行、执行中、成功、失败、取消中、已取消、等待重试、部分成功;记录项目、创建人、时间、步骤、日志、错误、次数和资源。
  • 验证命令:V06、V09、V10、V07;补状态转换、崩溃恢复、任务尝试和事务边界测试。
  • 实机验收步骤:执行长任务期间刷新、断网、取消和重启;验证状态及执行历史可恢复;批量目标一成一败时显示部分成功;回滚后证书版本、部署与任务结论一致。
  • 验收证据:已有部署事务测试;统一八状态和全操作关联尚未验收。
  • 复审结果:未完成。

P0-11 建立生产验收门禁

  • 任务编号:P0-11;任务名称:建立生产验收门禁;优先级:P0。
  • 当前状态:[!] 暂缓或存在阻塞。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [~];生产部署测试 [!];最终验收 [ ]。
  • 问题说明:局部测试与历史部署不能证明当前候选具备全链路生产能力。
  • 涉及文件:《发布加固与实机验收记录.md》《生产部署与运维说明.md》《全面审查测试与优化记录.md》、build/、deploy/、artifacts/。
  • 依赖任务:P0-01 至 P0-10、P0-12、P1-01 至 P1-12、P2-01 至 P2-10 的对应交付;P3 留在完整目标中但不阻断第一阶段。
  • 整改内容:分别建立单元、隔离、数据库、真实 DNS、ACME Staging、ACME Production、SSH/SFTP、HTTPS/SNI、Windows Service、Linux systemd、备份恢复、升级回滚 12 层门禁,每层独立结论。
  • 验证命令:V01 至 V12 按层执行;实机命令取正式安装/运维说明并登记实际退出码,不能用空参数或跳过结果填通过。
  • 实机验收步骤:从当前干净候选完成首次安装、初始化、真实签发、分发、正常 DNS 公网 TLS、重启、恢复和升级回滚;双平台及三库分别记录;任何缺口保留未通过。
  • 验收证据:既有自动化及发布证据不覆盖全部 12 层;当前缺口由执行清单持续跟踪。
  • 复审结果:禁止生产放行,任务规划和局部整改仍可继续。

P0-12 完成备份和恢复方案

  • 任务编号:P0-12;任务名称:完成备份和恢复方案;优先级:P0。
  • 当前状态:[~] 进行中。
  • 六阶段:需求确认 [x];代码实现 [~];自动化测试 [~];隔离环境测试 [~];生产部署测试 [ ];最终验收 [ ]。
  • 问题说明:现有 CLI/数据库恢复不是包含私钥、配置、主密钥与审计的完整产品备份方案。
  • 涉及文件:backend/internal/cli/backup_restore.go、backend/internal/database/、backend/internal/secretstore/、backend/internal/certificate/、backend/internal/httpapi/;拟新增备份记录及调度服务。
  • 依赖任务:P0-05、P0-06、P0-08、P0-10。
  • 整改内容:覆盖数据库、证书元数据/版本/私钥、DNS/服务器/任务/通知/主密钥配置;支持手动、自动、列表、校验、下载、确认恢复、失败回滚与审计;定义一致性和受保护存储,不把秘密放测试证据目录。
  • 验证命令:V06、V08、V10、V07;补备份损坏、版本不兼容、错密钥、部分恢复及审计测试。
  • 实机验收步骤:每数据库创建完整资源并备份,向空环境恢复、解密并实际部署证书;损坏备份必须在修改前拒绝;恢复中断后可回到原状态;核对恢复前备份、下载授权、定时记录和审计。远端测试不做无关整机备份,产品备份能力不能因此省略。
  • 验收证据:部分数据库恢复历史证据存在;全部资源、自动备份和失败回滚闭环待补。
  • 复审结果:未完成。