定时任务可靠性加固 Test Spec

1. 测试目标

验证 V1 只加固现有 Cron 调度可靠性，覆盖迁移契约、配置校验、Mapper XML、Quartz 同步、启动恢复、日志筛选与脱敏、管理接口和前端同步状态。

2. 基线

当前 job 模块无 src/test 测试文件。
当前最大 Flyway 版本为 V1.0.39，本变更使用 V1.0.40。
当前工作区存在与本变更无关的全量初始化 SQL 和 .DS_Store 改动，验证与提交均排除。

3. 增量验证矩阵

优先级	范围	命令/方式
P0	job 模块当前编译基线	mvn -pl forge-framework/forge-plugin-parent/forge-plugin-job -am test
P0	Flyway 迁移契约	JobReliabilityMigrationContractTest
P0	配置校验和 Mapper XML	JobConfigValidatorTest、MapperContractTest
P0	Quartz 同步和启动恢复	JobScheduleCoordinatorTest、JobStartupReconcilerTest
P0	日志脱敏和查询	JobLogSanitizerTest、SysJobLogMapperContractTest
P0	job 模块回归	mvn -pl forge-framework/forge-plugin-parent/forge-plugin-job -am test
P1	Admin 聚合构建	mvn -pl forge-admin-server -am package -DskipTests
P1	前端	pnpm 定向测试、lint、build
P1	文档和空白	git diff --check

4. 环境边界

不启动真实 Admin、Quartz 集群、MySQL 或 Redis 服务。
数据库迁移使用静态契约测试；真实 Flyway 和运行态重启恢复由用户联调。
前端命令使用 Node v20.19.0。

5. Task 4 增量验证

定向覆盖注解登记、唯一启动入口、缺失任务恢复、禁用任务保持暂停和非 Forge Job 保留。
job 模块全量回归用于确认删除旧 JobConfigLoader 后 Spring 装配和既有测试无回归。
Mapper XML 继续执行 xmllint --noout，相关目录执行 git diff --check。

6. Task 5 增量验证

红灯覆盖 Token、Authorization、手机号、密码字段脱敏，以及参数、结果和异常长度上限。
执行日志契约覆盖 job_config_id、SCHEDULED/MANUAL 触发来源和应用日志不输出原始执行结果。
JobMonitor 单测验证实际存储对象已脱敏并带稳定任务关联；读取服务再次清洗历史日志响应。
前端定向 ESLint 验证时间范围按 yyyy-MM-dd HH:mm:ss 发送，避免 ISO UTC 转换导致筛选偏移。

7. Task 6 增量验证

Controller 契约验证 POST /job/config/{id}/sync 调用 retrySynchronization，并保持 DTO/VO 分页和详情协议。
前端契约验证同步状态、错误摘要和“重新同步”入口存在，立即运行包含确认提示，编辑时 JobKey 不可修改。
页面默认信息架构只突出任务、执行内容、执行计划、运行状态、调度同步和操作；技术字段不再占据默认主列表。
Node v20.19.0 下定向 ESLint 和生产构建必须通过；仓库既有构建警告记录但不作为本次阻断项。

8. Task 7 最终验证

复用当前成功基线，重新执行 job 模块全量测试和 Admin 聚合构建。
静态检查 Flyway placeholder、Mapper XML、查询规范和全部本变更差异空白。
尝试无真实后端的浏览器页面验证；若鉴权或接口依赖阻断，明确记录真实数据 UI 未联调，不以静态构建替代 E2E 结论。

9. 最终结果

范围	结果
job 模块全量测试	37/37 通过
Admin 聚合构建	42/42 模块通过
前端定向 ESLint	通过
前端生产构建	8699 modules transformed，构建通过
Flyway placeholder	无业务占位符
Mapper XML	`xmllint` 通过
本变更差异	`git diff --check` 通过
浏览器 UI	未完成；开发服务触发 `EMFILE`，生产预览端口绑定被沙箱 `EPERM` 拒绝

真实 MySQL/Flyway、Admin/Quartz 运行态和带真实权限数据的浏览器交互继续由开发环境联调，不能由本轮静态和构建验证替代。