Reconstruction des projections d'employés
Recalcule les projections par employé depuis les événements sources. À utiliser quand un modèle de lecture semble désynchronisé.
Qu’est-ce qu’une projection ?
L’application précalcule plusieurs modèles de lecture par employé — les données que l’interface lit lorsque vous ouvrez une page. Chaque projection est construite à partir d’événements (demandes de congés, soumissions de feuille de temps, changements de conditions…) et tenue à jour à mesure que de nouveaux événements arrivent. Si une projection dérive un jour (après une mauvaise migration, une correction manuelle, ou un déploiement bogué), la reconstruire depuis les événements la ramène à un état sain.
Projections reconstruites par cette tâche
| Projection | Ce qu’elle alimente |
|---|---|
| Recherche d’employés | L’annuaire et la barre de recherche |
| Périodes d’emploi | Les conditions courantes et historiques résolues |
| Projection congés | Absences planifiées, actives et consommées par employé |
| Solde de temps | Soldes de compte par employé |
| Prévision de droits acquis | Droits à venir prévus |
| Projection feuille de temps hebdomadaire | Agrégats hebdomadaires |
| Relevés feuille de temps | Relevés en attente / prêts / soumis |
| Activité de politique | Activité résolue par politique de congés par employé |
| Boîte d’approbations | La liste « à approuver » du manager |
| Vue utilisateur de notifications | Le fil de notifications par utilisateur |
Fonctionnement
- Charge le périmètre — par défaut, tous les employés de l’espace de travail
- Pour chaque employé, exécute chaque constructeur — la plupart rejouent les événements pertinents à travers les mêmes gestionnaires qu’en production
- Pour certaines projections, une seconde passe — par ex. le drapeau « est manager », qui dépend du règlement de chaque ligne de subordonné direct
Paramètres
| Paramètre | Description |
|---|---|
| Projection | La projection à reconstruire. Par défaut all. Choisir une projection unique limite le travail — utile quand vous savez quel modèle est faussé |
| ID Employé | Optionnel. Reconstruit seulement les projections de cet employé |
| ID Unité d’organisation | Optionnel. Reconstruit tous les employés de cette unité et ses descendantes. Ignoré quand ID Employé est renseigné |
Lorsque le périmètre est restreint (un employé ou une unité), l’étape post-reconstruction est sautée — elle suppose que tous les employés viennent d’être rafraîchis.
Résultats de la tâche
| Métrique | Description |
|---|---|
projection | La cible reconstruite (all ou une clé spécifique) |
scope | all, employee:<id> ou org_unit:<id> |
success_count | Employés reconstruits sans erreur |
error_count | Employés en échec (voir les détails pour les erreurs par employé) |
Quand l’exécuter
- Après un import de données depuis un autre système
- Après avoir corrigé un événement mal formé par migration
- Quand l’interface d’un seul employé semble fausse (utilisez ID Employé pour limiter)
- Après un rapport d’incident mentionnant une projection par son nom
Déclenchement automatique sur backfill
Au démarrage du worker, s’il trouve une projection enregistrée complètement vide alors que des employés existent, il planifie cette tâche automatiquement. C’est un filet de sécurité opérationnel pour les déploiements neufs et les sauvegardes restaurées.
Dépannage
| Problème | Solution |
|---|---|
| L’exécution prend du temps | Reconstruire toutes les projections pour tous les employés est l’option la plus coûteuse. Limitez à une seule projection ou une seule unité quand vous savez ce que vous cherchez à corriger |
| Erreurs sur quelques employés | Ouvrez les détails de l’exécution pour voir les erreurs par employé. Souvent il s’agit d’une référence obsolète à une entité supprimée, corrigible par une édition ciblée, puis reconstruction de ce seul employé |
| La projection est toujours fausse après reconstruction | La reconstruction rejoue les événements à travers les gestionnaires en direct. Si le gestionnaire lui-même est bogué, la reconstruction n’aidera pas — escaladez aux développeurs |