23 KiB
23 KiB
基础整改任务规格
本文件覆盖原始清单 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]；代码实现[~]；自动化测试[~]；隔离环境测试[~]；生产部署测试[!]；最终验收[ ]。 - 问题说明：已修复迁移、连接恢复、备份会话、精确数值、跨表快照、失败文件保护、生成列和不可见列导出；支持本批官方存储对象 SQL 的分隔符恢复，并新增自有触发器、例程及事件导出、可见权限、恢复调度安全、编码和到期保护。视图、完整表清单、其他编码与 SQL 模式及独立发行验证仍不足。
- 涉及文件：
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 锁并发；逐库检查类型、索引、默认值、事务及初始化、升级、回滚、备份恢复。不能悄然去掉难测版本。
- 验证命令：V06、V02；真实数据库测试按正式集成测试的参数运行并保存非跳过结果，不在命令行嵌入密码。
- 实机验收步骤：逐版本创建专用测试库；从空库初始化及历史版本迁移，注入失败检查事务；使用官方备份工具恢复并核对行数、资源关联和加密凭据；验证 TLS 和断线重连；只清理明确测试库。
- 验收证据：在既有迁移、连接恢复、特殊列互操作及触发器、例程备份基础上，增加事件导出、权限检查、调度安全、编码与到期测试。最终源码
3625e8b在 Windows MySQL 5.7.44、8.0.45 分别通过 139、155 个叶子用例，0 失败、0 跳过；对应含父项记录为 159、175。已实际执行触发器、过程、函数和恢复后的隔离事件；详见支持矩阵第十三节的最终证据及执行清单。 - 复审结果：上述 Windows 隔离范围通过，不等于生产放行。只验证 InnoDB 数据快照，不承诺并发 DDL 一致性；非事务表和视图拒绝属于临时边界。官方导出文件恢复通过不证明自有导出保存了全部对象；其他 SQL 模式、定义者迁移、独立发行命令、Linux 实库、PostgreSQL 当前复测、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-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；补关联完整性、迁移回填和删除约束测试。
- 实机验收步骤：迁移含历史资源的专用库，核对项目归属不丢失；从一次申请追踪订单、版本、任务、部署、通知和审计；删除仍被引用的资源必须拒绝。
- 验收证据：现有模型只能证明部分实体存在；完整关系图、迁移回填与三库关联验证待补。
- 复审结果：未完成，禁止用相似名称替代缺失关联。
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、任务、审计的跨项目读写、删除与回滚；撤权后现有会话及排队任务必须重新判权。
- 验收证据：已有分组/角色测试不能证明项目隔离；项目矩阵和真实越权用例待补。
- 复审结果：未完成。
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；补备份损坏、版本不兼容、错密钥、部分恢复及审计测试。
- 实机验收步骤：每数据库创建完整资源并备份，向空环境恢复、解密并实际部署证书；损坏备份必须在修改前拒绝；恢复中断后可回到原状态；核对恢复前备份、下载授权、定时记录和审计。远端测试不做无关整机备份，产品备份能力不能因此省略。
- 验收证据：部分数据库恢复历史证据存在；全部资源、自动备份和失败回滚闭环待补。
- 复审结果：未完成。