mirror of
https://github.com/R0m1k3/CollectFlow.git
synced 2026-10-14 10:48:09 +02:00
Page /admin/synchronisation : choisir quels fournisseurs sont cadencés, pour quelle source, et suivre l'avancement. ORDRE DE PASSAGE. La file est « le plus anciennement synchronisé d'abord », en ignorant ceux déjà traités depuis l'ouverture de la fenêtre. Il en découle, sans curseur ni compteur de tour : la nuit 2 reprend là où la nuit 1 s'est arrêtée, le tour recommence quand tout le monde est passé, et un fournisseur en échec garde une date ancienne donc repasse en tête. DEUX FILES. SQL (~43 s sur le plus gros) et Qlik (jusqu'à 8 min, sur un serveur qui abandonne quand on le sollicite trop) ont leur propre activation et leur propre rythme. Une extraction Qlik est intercalée tous les N fournisseurs SQL, sinon elle ne démarrerait jamais avant que la file SQL soit vide. Un plafond par nuit et un âge minimal évitent de refaire chaque nuit des agrégats mensuels. Détails qui comptent : - La fenêtre signifie « ne plus DÉMARRER après l'heure de fin » : une extraction en cours n'est jamais coupée. Le passage par minuit est géré. - L'horodatage est écrit même en cas d'échec, sans quoi le fournisseur fautif bloquerait la file derrière lui. - Garde anti-boucle : l'avancement repose sur cette écriture, volontairement non bloquante ; si elle échoue, le round s'arrête au lieu de reprendre le même fournisseur indéfiniment. - Un fournisseur sans article est désactivé automatiquement, motif affiché, réactivable — plutôt que réessayé chaque nuit. - Désactivé par défaut : un déploiement ne doit pas se mettre à solliciter Qlik la nuit suivante sans décision explicite. Déclenchement par minuteur interne (instrumentation.ts), battement d'une minute. Aucune configuration côté hôte, se réarme au démarrage ; en contrepartie rien ne tourne si l'application est arrêtée. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Y26nRZxTR57K7h8yqsF675
42 lines
1.6 KiB
TypeScript
42 lines
1.6 KiB
TypeScript
/**
|
|
* CollectFlow — Minuteur de la synchronisation nocturne.
|
|
*
|
|
* Démarré une fois au boot par `src/instrumentation.ts`. Il bat chaque minute
|
|
* et laisse `tickScheduler()` décider s'il y a quelque chose à faire : hors
|
|
* fenêtre, ou si un round tourne déjà, le battement ne coûte rien.
|
|
*
|
|
* Conséquence assumée du choix « minuteur interne » plutôt que cron système :
|
|
* rien ne tourne si l'application est arrêtée. En contrepartie, aucune
|
|
* configuration côté hôte, et le minuteur se réarme tout seul au redémarrage.
|
|
*/
|
|
|
|
import "server-only";
|
|
|
|
import { tickScheduler } from "@/features/admin/api/sync-scheduler";
|
|
|
|
const INTERVALLE_MS = 60_000;
|
|
|
|
/**
|
|
* Garde au niveau du module : en développement, le rechargement à chaud peut
|
|
* réévaluer `register()` plusieurs fois, et on se retrouverait avec autant de
|
|
* minuteurs empilés.
|
|
*/
|
|
let minuteur: ReturnType<typeof setInterval> | null = null;
|
|
|
|
export function startSyncTimer(): void {
|
|
if (minuteur) return;
|
|
|
|
console.log(`[sync-nuit] minuteur démarré (battement ${INTERVALLE_MS / 1000} s)`);
|
|
minuteur = setInterval(() => {
|
|
// `tickScheduler` capture déjà ses propres erreurs ; ce `catch` ne couvre
|
|
// qu'un rejet inattendu, pour qu'il ne devienne jamais une exception non
|
|
// gérée capable d'abattre le processus.
|
|
void tickScheduler().catch((e) => {
|
|
console.error("[sync-nuit] battement en erreur :", e instanceof Error ? e.message : String(e));
|
|
});
|
|
}, INTERVALLE_MS);
|
|
|
|
// Ne pas maintenir le processus en vie uniquement pour ce minuteur.
|
|
minuteur.unref?.();
|
|
}
|