Scert/doc/Scert整改任务执行清单.md

Scert 整改任务执行清单

本清单依据《Scert整改合并优化清单.md》建立，用于跟踪实际代码整改、自动化验证、隔离环境验证和生产验收。

当前日期：2026 年 9 月 27 日

状态定义：[ ] 未开始；[~] 进行中；[x] 已完成，等待复审；[✓] 复审通过；[!] 暂缓或存在阻塞。

一、执行规则

1. 代码实现、自动化测试、隔离环境验证和生产验收分开记录。
2. 构建成功、接口返回 HTTP 200 或单元测试通过，不直接等同于生产验收通过。
3. 真实 DNS、ACME、HTTPS、SSH 主机指纹、备份恢复和远程部署必须保留可复核证据。
4. 不使用 -k、--insecure、跳过 SSH 主机指纹或强制 IP TLS 的方式替代正式验证。
5. 不将密码、RAM 密钥、Token、私钥、真实证书或 Cookie 写入代码、文档、日志和 Git。
6. 每个任务完成后先标记为 [x]，复审和对应范围的验收证据齐全后才能标记为 [✓]。

逐项规格入口：《整改任务规格与验收约定.md》。P0/P1/P2/P3 分别见《基础整改任务规格.md》《核心能力任务规格.md》《运维验收任务规格.md》《增强能力任务规格.md》，共 44 项；每项具备全部原定字段及独立六阶段状态。汇总状态与规格同步更新，原始清单保留为需求基准。

二、当前基线证据

项目	当前事实	证据或命令	结论
Git 工作区	main 与 Scert/main 同步，工作区干净	git status --short --branch	已建立基线
后端模块	backend/go.mod 声明 Go 1.26.6，模块内实际使用 go1.26.6	在 backend 执行 go version、go env GOVERSION GOTOOLCHAIN	GOTOOLCHAIN=auto；根目录的 1.26.2 不代表后端构建版本
Node.js	v24.19.0	node --version	已记录
npm	11.17.0	npm.cmd --version	已记录
Vue	锁文件实际版本 3.5.41	frontend/package-lock.json	已记录
Vite	锁文件实际版本 6.4.3	frontend/package-lock.json	已记录
数据库驱动	SQLite、MySQL、PostgreSQL 均有代码和迁移目录	backend/internal/database/	正式支持范围仍需确认
SSH	已有主机指纹、密钥部署和安全测试代码	backend/internal/deployment/	远程实机仍需复核
生产门禁	现有文档明确正式验收尚未全部通过	doc/生产部署与运维说明.md	不能宣称生产放行

三、P0 基础整改和阻塞项

编号	状态	任务	当前问题	下一步交付	验证证据
P0-01	[x]	明确产品范围	正式发布仅含 Web/服务端，桌面源码保留；CLI 已收敛且实际 Windows 产物验证通过	等待最终复审；Windows/Linux 实机安装仍归对应验收项	双平台归档及 SHA256、独立克隆、命令树及实际退出码
P0-02	[~]	建立完整任务清单	44 项逐项规格已补齐，字段、六阶段和汇总状态结构核对通过	完成引用及独立克隆复核后标记待复审，持续维护证据	四份规格及统一验收约定、结构核对结果
P0-03	[~]	整理源码、构建产物和部署产物	全仓库规则和目录说明已补齐；隔离 Git 忽略测试通过，子目录规则补充待再测	当前提交独立克隆复核，保留现有文件	正式 Go 边界回归、索引审查、独立克隆
P0-04	[~]	统一开发和构建版本	模块实际使用 Go 1.26.6，不存在此前误报的版本阻塞；历史文档仍需统一	统一模块、构建说明、锁文件和验收机版本记录	版本矩阵、构建日志
P0-05	[!]	确认数据库正式支持矩阵	三种数据库均有代码，但 README、文档和实机证据口径不完全一致	明确 SQLite、MySQL、PostgreSQL 的正式级别、版本和迁移回滚要求	三数据库迁移、备份恢复和连接测试
P0-06	[~]	建立统一领域模型	已有域名、证书、任务、服务器等实体，项目和部署关联仍需审查	补齐资源关系图、外键/归属和任务关联	模型文档、迁移检查、接口测试
P0-07	[~]	增加项目级权限和资源隔离	用户组和角色已有实现，项目级资源边界未闭环	为证书、DNS、服务器、任务和审计补齐项目归属及越权测试	权限矩阵、接口越权测试
P0-08	[~]	完善凭据和主密钥生命周期	已有凭据存储与测试，轮换、恢复、删除和失效证据不完整	补齐创建、轮换、恢复、删除、脱敏和不可恢复边界	安全测试、日志审查、恢复演练
P0-09	[~]	强化 SSH 主机身份验证	已有指纹校验和安全测试，人工确认、更新与远程公钥部署需逐项复核	完成指定服务器上的密码部署、公钥登录和指纹复核	指纹、授权文件、公钥登录日志
P0-10	[~]	统一任务、部署和回滚事务模型	部署事务已有实现，不代表所有长操作、项目关联和八类状态已经实现	将申请、部署、回滚、重试统一关联任务记录	事务测试、失败回滚证据
P0-11	[!]	建立生产验收门禁	现有自动化证据不能替代 DNS、HTTPS、ACME 和远程验收	固化准入清单、证据目录和阻塞规则	生产验收记录逐项复核
P0-12	[~]	完成备份和恢复方案	已有 CLI 备份恢复，自动备份、列表、下载、确认和审计仍需逐项核查	补齐完整备份能力并进行隔离恢复演练	隔离数据库恢复报告

四、P1 核心产品能力

编号	状态	任务	当前判断	主要验收
P1-01	[~]	统一证书中心	已有证书申请、导入和列表能力，统一详情和状态仍需复审	申请、导入、续期、部署、回滚
P1-02	[~]	证书详情和版本管理	已有证书相关模型，版本、SAN 和历史展示需复核	版本切换、SAN 变化、旧证书保留
P1-03	[~]	ACME 和 DNS 管理	已有多 DNS Provider 和 DNS 账户能力，真实授权范围需复核	Production/Staging、DNS-01、泛域名、CNAME
P1-04	[~]	任务中心	已有任务和执行记录基础，取消、重试和日志展示需复核	长任务、失败重试、取消、执行历史
P1-05	[~]	续期策略	已有续期相关代码，重复申请保护和调度验收需补齐	到期阈值、锁、幂等、失败保留旧证书
P1-06	[~]	服务器和部署目标中心	已有服务器管理和 SSH 密钥展示	服务器归属、验证、密钥登录、部署目标
P1-07	[~]	多服务器部署策略	已有部署客户端和回滚测试	多目标顺序、失败回滚、部分成功状态
P1-08	[~]	通知中心	已有 Smail 系统账户发信接入方向	成功、失败、重试、脱敏和系统账户调用
P1-09	[~]	审计中心	已有审计仓储和接口基础	登录、密码、凭据、证书和部署危险操作
P1-10	[ ]	证书监控仪表盘	页面和监控口径尚未完成复审	到期、失败、部署状态、异常统计
P1-11	[~]	备份恢复页面	CLI 和文档已有，Web 操作和权限需补齐	备份列表、恢复确认、审计和失败保护
P1-12	[~]	API 契约和权限矩阵	已有后端接口说明文档，需与实际路由同步	接口字段、角色、项目和错误码一致

五、P2 Web、运维和验收

编号	状态	任务	当前判断	主要验收
P2-01	[~]	统一 Web 页面结构	已按页面拆分，仍需逐页检查一页完整显示和中文布局	桌面页面、响应式、导航和空状态
P2-02	[~]	统一中文显示和错误信息	已有中文界面，需扫描 HTML 实体和英文残留	页面、接口、日志错误信息
P2-03	[~]	长操作任务化	部分部署/证书操作已有任务基础	页面不阻塞、刷新可恢复、任务状态可追踪
P2-04	[~]	幂等和重复操作保护	已有部分锁和事务测试	重复提交、并发操作、幂等键
P2-05	[~]	日志、指标和追踪	有日志和任务记录，Request ID/脱敏需复核	请求 ID、任务 ID、敏感信息审查
P2-06	[~]	接口和前端测试	已有后端及前端测试，覆盖面需按清单补齐	全量测试、关键页面、越权和失败路径
P2-07	[~]	升级、降级、卸载和回滚	已有安装器和发布说明，实机闭环未完成	升级、降级、卸载、失败恢复
P2-08	[!]	Windows Service 实机验收	当前证据不足以标记通过	安装、启动、升级、卸载和日志
P2-09	[!]	Linux systemd 实机验收	有 unit 和历史测试，当前版本需重新核对	安装、启动、重启、日志、Nginx、回滚
P2-10	[~]	安全基线	已有 SSH、凭据和数据库安全测试，仍需完整门禁	TLS、Cookie、CSRF、越权、路径和命令注入

六、P3 后续增强

编号	状态	功能
P3-01	[ ]	多租户支持
P3-02	[ ]	API Token 管理
P3-03	[ ]	Webhook 事件订阅
P3-04	[ ]	更多 DNS Provider 插件
P3-05	[ ]	证书标签和批量操作
P3-06	[ ]	多实例高可用
P3-07	[ ]	分布式任务队列
P3-08	[ ]	Prometheus 指标接口
P3-09	[ ]	OpenAPI 自动生成
P3-10	[ ]	移动端适配

七、本轮执行记录

2026-09-27：建立整改执行基线

• 已检查 main 分支和工作区，当前无未提交代码变更。
• 已确认 Go、Node.js、npm 和前端锁文件实际版本。
• 已确认数据库代码同时包含 SQLite、MySQL 和 PostgreSQL 适配，但正式支持矩阵尚未统一。
• 已发现桌面二进制和桌面前端构建入口仍在 Git 索引中，暂不直接删除，列入 P0-03 复审。
• 已补强 .gitignore，覆盖桌面构建产物、部署暂存目录、发布/证据目录和本地数据库/密钥文件。

八、下一轮优先顺序

1. 对已补齐的 P0-02 全部 44 项规格完成引用与独立克隆复核，保持状态、依赖及证据一致。
2. 对 P0-03 全仓库及子目录忽略规则完成正式回归和当前提交独立克隆复核，保留桌面源码及本地历史产物。
3. 继续 P0-04 版本/安装策略统一及 P0-05 三数据库迁移恢复的实际验证。
4. 继续定位 SSH 公钥自动部署实机失败阶段，完成密码回退和密钥登录双路径验收。
5. 将生产验收门禁与当前远程部署、DNS、HTTPS 和 ACME 证据逐项对应。

2026-09-27：自动化基线验证

验证项	命令	结果
后端单元和集成测试	go test -p 1 -count=1 -timeout=3m ./...	通过
后端静态检查	go vet -p=1 ./...	通过
Go 模块完整性	go mod verify	通过
前端测试	npm.cmd test	150 项通过，0 失败
前端生产构建	npm.cmd run build	通过
前端生产依赖审计	npm.cmd audit --omit=dev --audit-level=high	0 个漏洞

以上结果仅证明当前代码在本地自动化层通过，不替代 Windows Service、Linux systemd、真实 DNS、ACME、HTTPS、SSH 和备份恢复验收。

2026-09-27：P0-03 生成物索引清理

• 已确认 desktop/scripts/build-frontend.mjs 从根目录 frontend/dist 重新构建并复制桌面资源。
• 已将 desktop/desktop.exe 和 desktop/frontend/dist/index.html 从 Git 索引移除；本地文件仍保留，未物理删除。
• deploy/tests/install-linux-test.py 保留为可复用测试代码。
• 本项仍需在独立克隆中验证正式发布包和生成物边界；按 P0-01 的范围调整，不再以桌面构建作为正式门禁。

2026-09-27：P0-04、P0-05、P2-07 版本和迁移保护

• 纠正工具链误报：backend 模块内实际为 Go 1.26.6，GOTOOLCHAIN=auto。没有降低模块版本要求。
• 新增《构建版本与数据库支持矩阵》，区分本地代码检查、SQLite 实测和外部数据库实机验收。
• 新增迁移目录/嵌入/版本登记一致性检查，以及七类反例测试。
• Migrate 拒绝新版数据库和不连续的迁移历史，避免旧程序误用更新后的数据库。
• 数据库定向测试通过：五类异常历史拒绝后原数据不变；SQLite 从 0～9 版本升级并重复执行通过。
• 仅使用测试临时库，没有访问或清空外部业务数据库。三种数据库兼容性不能据此标记全部通过。

2026-09-27：P0-01 正式发布范围收敛

• 依赖：原始整改清单 P0-01，已推送的 8b33282 作为修改前检查点；未删除桌面源码或本地生成物。
• 涉及文件：build/build-release.ps1、backend/internal/releasearchive/verify_test.go、根目录及各模块 README、生产和历史测试文档。
• 正式发布已移除 Wails 调用和桌面打包；清单新增 delivery_scope=[web,server]，兼容字段 desktop_requested=false。
• 旧参数 SkipDesktop 仅警告并兼容，显式设假也不能恢复桌面构建；传入 DesktopDirectory 在构建前报错。
• 保留路径扫描、Go -trimpath、文件及归档 SHA256、拒绝覆盖旧输出、源码提交和脏状态记录。
• 已通过 PowerShell 语法解析、go test -count=1 -timeout=3m ./internal/releasearchive ./cmd/scert-release、git diff --check。
• 发布范围验证已完成，证据见下节；这仍是构建层验证，不代表 Windows/Linux 实机安装验收。
• 历史业务 CLI 的执行入口及最终产物检查已由后续批次完成，见本节末尾的范围验收记录。

2026-09-27：双平台和独立克隆发布验证

• 源码提交：25fd4cf，已推送。默认双平台构建成功，manifest.json 的 source_dirty=false、delivery_scope=[web,server]、desktop_requested=false、路径检查通过。
• 输出：build/release-scope-20260927-25fd4cf/。清单共 33 项（31 个包内文件、2 个归档），逐项文件长度和 SHA256 匹配。
• 真实解包核对：Windows 9 个文件、8 条包内校验和；Linux 22 个文件、21 条包内校验和。解包内容与清单一致，无桌面产物。
• DesktopDirectory 反例返回退出码 1，且没有创建输出目录。
• 独立克隆：build/checkout-scope-20260927-25fd4cf/。执行 npm.cmd ci --no-audit --no-fund、npm.cmd test，150 项通过；显式 -SkipDesktop:$false 构建双平台通过，33 项清单的长度和 SHA256 再次匹配。
• 独立克隆保留 desktop/main.go，不包含 desktop/desktop.exe 或桌面 dist。跟踪清单没有 .runtime、node_modules、dist、可执行文件、数据库或私钥后缀文件；克隆工作区仍干净。
• npm ci 提示 esbuild 的安装脚本尚未列入批准清单，但命令、前端测试及构建均退出成功；未自动批准额外脚本。可复现安装策略仍归 P0-04 后续审查。

2026-09-27：CLI 运维范围收敛

• 依赖 P0-01 正式范围；涉及 backend/internal/cli/root.go、根命令/范围/运维测试、README 和《命令行运维范围说明》。
• domain、server、ssh-key、renew、deploy 不再注册业务实现；仅保留隐藏的中文迁移提示，返回错误，不解析或回显旧凭据参数。
• 保留初始化、服务启动、状态、证书诊断、DNS 诊断、配置、日志、备份恢复及系统服务运维；服务端自动续期未更改。
• 新增命令树白名单和 11 类旧入口拒绝测试；用无效配置和模拟凭据证明拒绝先于配置读取，配置内容不变且没有新增运行数据。
• CLI 定向测试、后端全量 go test -p 1 -count=1 -timeout=3m ./... 和 go vet -p=1 ./... 已通过。使用测试临时目录，没有清空或连接生产数据库。
• 本批实际 Windows 可执行文件的帮助和旧入口退出码已在后续干净发布包中验证；Linux 安装及服务运行仍需独立实机验证。

2026-09-27：CLI 实际产物复核修正

• d90ddaa 已推送并完成干净工作区双平台构建，产物位于 build/release-scope-20260927-d90ddaa/。
• 实际 Windows 可执行文件的默认帮助仅显示运维命令；旧 domain add 返回退出码 1，没有执行旧业务。
• 实测发现框架先输出英文 Error:，入口随后又输出中文错误，造成重复提示。已设置根命令 SilenceErrors=true，由 Execute 统一输出中文错误；新增无重复输出断言。
• 修正后 CLI 和发布模块定向测试及静态检查通过；最终复核使用修正后的 885478a 干净发布包，没有用之前的二进制代替。

2026-09-27：P0-01 范围验收记录

验收点	当前证据	结论
正式范围只有 Web 和服务端	根 README、构建/部署说明、当前执行清单和历史范围声明一致；无额外 CI 或发布入口调用 Wails	本地复核通过
桌面历史源码保留	桌面目录及开发说明仍在；原本机桌面二进制和 dist 未物理删除	符合不删除要求
双平台实际发布包	build/release-scope-20260927-885478a/；源码 885478a7e0dfc3832cdd094ed388891c41062eb9，source_dirty=false	构建层通过
清单及归档一致	33 项长度和 SHA256 一致；Windows 解包 9 文件/8 校验项，Linux 22 文件/21 校验项，均无桌面产物	构建层通过
Linux 可执行权限	归档内 scert、scert-admin、scert-nginx、scert-storage 和安装器均为 0755	归档层通过，不代表 Linux 已运行
实际 CLI 帮助	从最终 Windows ZIP 解出的 scert.exe help 返回 0，仅公开运维入口	本机执行通过
实际旧 CLI 拒绝	domain、server、ssh-key、renew、deploy 均返回 1；仅一条中文错误，无模拟凭据回显，无运行目录创建	本机执行通过
自动化回归	最终应用代码通过后端全量测试、全量 vet 和 go mod verify；前端独立克隆 150 项通过，源码未再修改	本地自动化通过
归档测试范围	Linux 测试改用 scert-storage，不再要求桌面；Windows 测试逐项核查实际平台文件，不再仅判断 Web 入口存在	发布模块测试和 vet 通过

P0-01 标记 [x] 已完成，等待复审，不标记生产放行。整体 44 项整改未完成：P0-02 执行规格、P0-03 全仓库边界、三数据库实机验证、项目权限、统一任务、备份页面及生产门禁等仍需继续。上述输出均在忽略目录内，没有提交二进制、运行数据或辅助测试脚本。