Matérialisation des droits acquis
Convertit les droits acquis prévisionnels en événements de compte de temps réels, créditant les soldes de congés des employés.
Fonctionnement
Le job de matérialisation des droits acquis s’exécute quotidiennement et effectue les opérations suivantes :
- Trouve les droits échus — prévisions avec une prochaine date d’acquisition égale ou antérieure à la date d’exécution
- Crée des événements — convertit chaque entrée de prévision échue en un événement de compte de temps réel
- Met à jour le suivi — enregistre la dernière date de matérialisation pour éviter les traitements en double
C’est ce job qui crédite réellement les soldes de congés. Jusqu’à la matérialisation, les acquisitions n’existent que comme projections dans la prévision.
Traitement quotidien vs rattrapage
Le job gère deux scénarios :
Traitement quotidien
Pour les employés avec un historique de matérialisation existant, le job :
- Trouve les acquisitions avec
next_accrual_date <= run_date - Crée des événements uniquement pour les acquisitions échues
- Met à jour le
last_materialized_datede la prévision
Traitement de rattrapage
Pour les employés sans historique de matérialisation (nouvelles configurations ou migrations), le job :
- Matérialise toutes les acquisitions du début de la prévision jusqu’à la date d’exécution
- Cela permet de rattraper les acquisitions historiques en une seule exécution
Comportement de la date d’exécution
La date d’exécution est critique pour ce job :
| Scénario | Date d’exécution | Effet |
|---|---|---|
| Exécution quotidienne normale | Aujourd’hui | Matérialise les acquisitions échues jusqu’à aujourd’hui |
| Exécution de rattrapage | Date passée | Matérialise uniquement jusqu’à cette date (utile pour un déploiement contrôlé) |
| Date future | Date future | Matérialise les acquisitions dans le futur (à utiliser avec précaution) |
Rattrapage des acquisitions historiques
Pour matérialiser les acquisitions des périodes passées :
- Assurez-vous que Prévision des droits acquis a été exécuté pour la période historique
- Déclenchez ce job manuellement avec la date d’exécution définie à la date historique cible
- Exécutez à nouveau avec des dates progressivement ultérieures si vous souhaitez une matérialisation incrémentielle contrôlée
Résultats du job
| Métrique | Description |
|---|---|
forecasts_processed | Nombre de prévisions d’employés évaluées |
accruals_materialized | Nombre d’événements d’acquisition créés (traitement quotidien) |
accruals_backfilled | Nombre d’événements d’acquisition créés (traitement de rattrapage) |
errors | Nombre d’échecs lors de la matérialisation |
Timing des acquisitions
Les acquisitions sont attribuées le premier du mois suivant. Par exemple :
- Travail de janvier → acquisition datée du 1er février
- Travail de décembre → acquisition datée du 1er janvier (de l’année suivante)
Cela signifie que le job de matérialisation s’exécutant le 1er février créera l’événement d’acquisition pour les congés gagnés en janvier.
Dépannage
| Problème | Solution |
|---|---|
| Les acquisitions n’apparaissent pas | Vérifiez que le job Prévision des droits acquis a été exécuté en premier |
| Acquisitions historiques manquantes | Vérifiez que last_materialized_date est null pour déclencher le rattrapage, ou relancez la prévision avec une date d’exécution historique |
| Acquisitions en double | Cela ne devrait pas arriver — le job est idempotent. Vérifiez la création manuelle d’événements |
| Le solde semble incorrect | Vérifiez la configuration du plugin d’acquisition et les paramètres de proratisation |