# 定时任务一次性与时区测试计划
> status: complete
> updated: 2026-07-19

## 1. 验证目标

复用 V2 Job 模块 44/44、前端定向单测 7/7、Admin Reactor 42 模块和生产构建基线，增量验证 V3 的 CRON/ONCE 互斥模型、IANA 时区、DST 解析、Quartz Trigger 类型和一次性完成态。

## 2. 验证矩阵

| 优先级 | 范围 | 验证方式 |
|---|---|---|
| P0 | 迁移字段、存量回填、Cron 可空、字典数据 | JobOnceTimezoneMigrationContractTest |
| P0 | 过去时间、非法时区、互斥字段、DST 缺口与重复时间 | JobScheduleDomainServiceTest、JobConfigValidatorTest |
| P0 | CRON 显式时区、ONCE SimpleTrigger | JobSchedulerTest |
| P0 | 计划 ONCE 成功或失败后已结束，手动执行不结束 | QuartzJobExecutorTest、Mapper 契约测试 |
| P0 | 已结束任务启动恢复不复活 | JobScheduleCoordinatorTest |
| P1 | 表单转换、计划预览和列表状态文案 | 前端定向 Vitest、ESLint、生产构建 |

## 3. 必跑命令

- Job 模块：`mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-job -am test`
- 前端单测：`pnpm exec vitest run <V3 定向测试>`
- 前端检查：V3 定向 ESLint、`pnpm build`
- 静态检查：Mapper XML、Flyway placeholder、Service 查询规范、`git diff --check`
- 聚合验证：`mvn -pl forge-admin-server -am package -DskipTests`

## 4. 边界

- 不启动真实 MySQL、Redis、Admin 或 Quartz 集群，不执行会改变真实运行态的联调。
- 按用户要求不执行 UI 自动化、截图和浏览器验收，UI 由用户自行验证。
- 本轮不引入任务级重试、并发、Misfire 配置或 Flowable 调用。

## 5. 执行结果

- Job 模块全量测试：63/63 通过。
- 前端调度相关单元测试：10/10 通过。
- V3 定向 ESLint、前端生产构建、Admin 42 模块聚合构建通过。
- Mapper XML、Flyway placeholder、Service 查询规范、冲突标记和 `git diff --check` 通过。
- 按用户要求未执行 UI 自动化、截图或浏览器交互验收。