调度核心

libs/scheduler-core 保持纯 Java，不依赖 Spring、Guice、HTTP、数据库或特定运行时。它只处理调度定义、时间计算、任务注册和本地执行。

核心能力

• 6 位 cron：秒、分、时、日、月、周
• fixed-rate 调度
• 任务级 IANA ZoneId
• misfire 策略：SKIP、FIRE_ONCE、CATCH_UP
• 并发策略：ALLOW、FORBID
• 本地 handler 注册表
• 可替换 Clock，便于测试时间语义

时间规则

Firefly 要求任务显式声明 ZoneId。cron 表达式按任务本地时间计算，运行态游标统一保存为 UTC Instant。

JobDefinition job = JobDefinition.builder()
        .id("new-york-daily-report")
        .name("New York Daily Report")
        .handlerName("reportHandler")
        .schedule(new CronSchedule("0 0 9 * * *"))
        .zoneId(ZoneId.of("America/New_York"))
        .build();

这表示任务会在纽约本地时间 09:00 执行，不依赖调度服务部署机器的默认时区。

Misfire

策略	语义
SKIP	跳过错过的触发点，推进到下一个未来时间
FIRE_ONCE	合并错过的触发点，只补偿执行一次
CATCH_UP	在限制内追赶错过的触发点

并发策略

ALLOW 允许同一个任务多个执行重叠。FORBID 会避免同一任务在前一次执行未结束时再次进入执行。