✨ (cron): Añade la extensión pagetop-cron

- Trabajos programados con expresiones cron (croner), `fixed_rate()` y
  `fixed_delay()`, declarados con la acción `DeclareCronJobs` y
  ajustables por su clave en `[cron.jobs."clave"]`.
- Control de solapamiento, tiempo máximo, zona horaria por trabajo,
  ejecución al arrancar y bajo demanda con `run_now()`.
- Modo `external` sin estado, para réplicas y escalado a cero:
  `POST /cron` con `Authorization: Bearer`, ventanas alineadas de
  `trigger_interval_secs` y respuesta al terminar los trabajos.
- Estado con `jobs()`/`job()`, acción `AfterJobRun` y parada ordenada
  con `JobContext::is_stopping()`.
This commit is contained in:
Manuel Cillero 2026-10-28 06:52:42 +01:00
parent 4c3f4dab1b
commit 86d9f0e213
22 changed files with 3678 additions and 1 deletions

View file

@ -0,0 +1,50 @@
//! Errores de `pagetop-cron`.
/// Errores al declarar, configurar o ejecutar trabajos programados.
#[derive(Debug, thiserror::Error)]
pub enum CronError {
/// Una programación no es válida (p. ej. una expresión cron mal escrita o un intervalo nulo).
#[error("invalid schedule \"{schedule}\": {reason}")]
InvalidSchedule {
/// Programación tal como se indicó.
schedule: String,
/// Motivo del error.
reason: String,
},
/// La clave de un trabajo no es válida.
#[error(
"invalid job key \"{0}\": use lowercase letters, digits, '_', '-' and '.', starting with a \
letter or digit"
)]
InvalidKey(String),
/// Dos trabajos se declaran con la misma clave.
#[error("job \"{0}\" is declared more than once")]
DuplicateJob(String),
/// Un trabajo no se puede programar, por su declaración o por sus ajustes.
#[error("invalid job \"{key}\"")]
InvalidJob {
/// Clave del trabajo.
key: String,
/// Motivo del error.
#[source]
source: Box<CronError>,
},
/// Un ajuste de la sección `[cron]` no es válido.
#[error("invalid cron setting \"{key}\": {reason}")]
InvalidSetting {
/// Clave del ajuste, p. ej. `"cron.trigger_token"`.
key: &'static str,
/// Motivo del error.
reason: String,
},
/// No hay ningún trabajo declarado con la clave indicada.
#[error("unknown job \"{0}\"")]
UnknownJob(String),
/// El trabajo ya se está ejecutando y no admite ejecuciones simultáneas
/// ([`Overlap::Skip`](crate::Overlap::Skip)).
#[error("job \"{0}\" is already running")]
AlreadyRunning(String),
/// Los trabajos aún no están disponibles: la aplicación no se ha preparado.
#[error("cron jobs are not available until the application is prepared")]
NotInitialized,
}