Tableau de bord¶

À quoi ça sert¶

Le tableau de bord (/dashboard) est la page d'accueil personnelle de chaque utilisateur : il résume vos chiffres clés du moment, votre activité récente et vous propose des raccourcis vers les actions les plus courantes.

Prérequis¶

Prérequis

Modules sous licence : CORE (socle commun, toujours disponible)
Rôles : ORG_ADMIN, HR_MANAGER, MANAGER, EMPLOYEE, RECRUITER, ACCOUNTANT, CFO

Comment ça marche¶

À la connexion, vous êtes redirigé automatiquement vers /dashboard. Le titre en haut de page affiche une salutation personnalisée (« Bonjour, Prénom ») et la date du jour.
Cartes de statistiques — une rangée de 2 à 4 cartes (StatCard) résume vos données clés : par exemple votre solde de congés restant, le nombre de vos demandes en attente, ou le nombre de membres de votre équipe absents cette semaine. Chaque carte est cliquable et vous renvoie vers le module concerné (icône calendrier, personnes, horloge ou coche selon le sujet). Une flèche verte à côté de la valeur indique une évolution positive depuis la dernière période.
Fil d'activité (colonne de gauche, la plus large) — liste chronologique des événements qui vous concernent : une demande de congé approuvée, une réservation confirmée, un commentaire ajouté à un de vos dossiers, etc. Il se recharge automatiquement toutes les 60 secondes.
Actions rapides (carte à droite, « Accès rapides ») — une liste de boutons contextuels menant directement aux actions les plus fréquentes pour votre profil (ex. « Nouvelle demande de congé », « Réserver une salle »). Cliquez sur un bouton pour être redirigé directement vers le formulaire correspondant.
Disponibilité de l'équipe (sous les accès rapides, visible si vous encadrez une équipe ou selon votre rôle) — aperçu de qui est présent, en congé ou en télétravail parmi vos collègues proches.
En cas d'erreur de chargement (panneau réseau ou backend indisponible), un message d'erreur s'affiche avec un bouton Réessayer pour recharger les données sans recharger toute la page.

Qui peut faire quoi¶

Aucune permission particulière. Rôles concernés : ORG_ADMIN, HR_MANAGER, MANAGER, EMPLOYEE, RECRUITER, ACCOUNTANT, CFO.

Le tableau de bord lui-même n'exige pas de permission spécifique — il est visible par tout utilisateur authentifié. Le contenu affiché (cartes, actions rapides, approbations en attente) s'adapte cependant à vos permissions réelles :

Élément affiché	Permission nécessaire
Widget « Approbations en attente » sur le tableau de bord	`leave.manage`
Carte de disponibilité d'équipe	dépend du rattachement hiérarchique (managers)
Actions rapides vers un module (congés, réservations…)	permission `*.create` du module correspondant

Détails techniques

Backend : module app.jigi.dashboard, contrôleur DashboardController (GET /dashboard/overview, GET /dashboard/pending-approvals protégé par leave.manage, GET /dashboard/activities).
DTOs : DashboardOverviewDto (agrège StatCardDto[], QuickActionDto[], TeamMemberAvailabilityDto[], activités récentes).
Service : DashboardService calcule les stats à la volée à partir des modules Congés, Réservations et Approbations.
Fil d'activité : module app.jigi.dashboard.activity, entité ActivityLog, service ActivityLogService, alimenté par les événements applicatifs (ActivityLogEvent) publiés par les autres modules.
Frontend : frontend/src/app/(dashboard)/dashboard/page.tsx, requête TanStack Query dashboardApi.getOverview avec staleTime: 30s et rafraîchissement automatique (refetchInterval: 60s).

Cas d'erreur et FAQ¶

Mes cartes de statistiques n'affichent aucune donnée, pourquoi ? Vérifiez que vous avez bien des données dans les modules concernés (par exemple, aucune demande de congé créée cette année affichera un solde à 0, pas une erreur).

Le fil d'activité ne se met pas à jour immédiatement après une action. Le fil se rafraîchit automatiquement toutes les 60 secondes. Vous pouvez recharger la page pour forcer une mise à jour immédiate.

Je ne vois pas le widget « Approbations en attente ». Ce widget n'apparaît que si votre compte détient la permission leave.manage (managers et RH). Un employé sans équipe à gérer ne le voit pas.

Le tableau de bord affiche une erreur de chargement. Cliquez sur Réessayer. Si le problème persiste, il peut s'agir d'une coupure temporaire du service — contactez votre support interne.