异步与定时任务

StackRivet 区分两件看似相似、但边界不同的事：

异步任务——“提交即跑”且明确返回任务 ID 的工作。关注的是状态机、幂等、取消、重试、超时和错误分类。
定时任务——cron / 固定频率：可视化任务管理、集群防重、手动触发、重试、告警和审计。

异步任务

任务化工作不会阻塞请求线程。它作为任务提交，并通过状态机追踪：

stateDiagram-v2
  [*] --> pending
  pending --> running
  pending --> cancelled
  running --> success
  running --> failed
  failed --> retrying
  retrying --> running
  running --> cancelled
  success --> [*]
  cancelled --> [*]

每个任务都带 idempotencyKey，使重试不会把活干两遍，外加重试、取消、超时和错误分类。stackrivet-task 模块拥有这套状态机，管理端提供 /tasks 页面，用于筛选、提交、运行、取消、重试和查看任务详情。

Community 的导入/导出刻意做成同步且有大小上限；见导入与导出。队列化的大文件导入/导出属于更高版本能力，因为 50 MB 导入或一次大导出不应该占住 web 线程。

定时任务：框架无关的 SPI

调度与任何特定调度框架解耦。stackrivet-task 模块定义了一个小的 Scheduler SPI——ScheduledJobHandler、ScheduledJobContext、ScheduledJobResult、ScheduledJobRegistry、SchedulerAdapter、SchedulerCapability——业务 job 只依赖这些 StackRivet 接口，绝不依赖第三方调度器的 API。

默认发行物只内嵌 StackRivet 自己的调度抽象，外加一个本地调度桥，按 handler 名分发任务（并在执行边界恢复租户上下文）。默认运行时不含任何 GPL 调度组件；第三方调度器只通过可选适配器接入。

SnailJob 作为企业适配器

分布式调度方面，SnailJob（Apache-2.0）是优先适配器，作为可选模块发布（stackrivet-scheduler-snailjob）。它：

仅当 stackrivet.scheduler.snailjob.enabled=true 时才激活——即使 jar 在 classpath 上，缺省也休眠。
不进入基础运行时：stackrivet-app 不依赖它，因此默认依赖树里零调度框架代码。
是一个把 SnailJob 回调映射到同一个 SchedulerAdapter SPI 的桥，叠加分布式重试、重放治理、告警和控制台。

PowerJob（复杂 DAG / MapReduce）和 ElasticJob（已有 ZooKeeper 的客户）作为进一步的可选适配器；XXL-Job 仅作迁移/外部触发文档，永不作为 StackRivet 依赖。

版本边界

Scheduler SPI、本地任务样例和 /tasks 管理页在 Community 内。SnailJob 适配器与分布式重试 / 重放治理属于 Pro / Enterprise——见价格页。因为 SPI 在 Community 内，你的 job 代码写在 StackRivet 接口之上，需要分布式调度时无需重写。