Trois points d’entrée en lecture seule exposent les chiffres qui intéressent la direction : un tableau de bord adaptatif, une prévision de staffing et la santé des budgets de mission. Ce sont tous des requêtes GET qui renvoient 200 OK.

Tableau de bord

GET /kpi/dashboard n’accepte aucun paramètre et s’adapte au rôle de l’appelant. Un responsable voit toute l’équipe ; un consultant ne voit que sa propre part.

GET /kpi/dashboard HTTP/1.1
Authorization: Bearer <access_token>

La réponse (DashboardSnapshot) mélange des blocs d’équipe et des blocs personnels. Les blocs qui ne s’appliquent pas à votre rôle reviennent à null au lieu d’être omis :

• Blocs d’équipe (non destinés aux appelants avec le rôle consultant) : team, active_mission_count, allocation, ending_soon.
• Bloc de revue (administrateurs et responsables) : review_queue.
• Blocs personnels (titulaires d’un profil de consultant lié) : my_assignments, my_time_off, current_sheet.
• is_empty est vrai lorsqu’il n’y a encore rien à afficher.

Comme la structure s’adapte, vérifiez si chaque bloc vaut null avant de le lire.

Staffing

GET /kpi/staffing renvoie une grille de staffing par consultant et par période. Elle est réservée aux rôles administrateur et direction (403 sinon).

GET /kpi/staffing?granularity=month&from=2026-01-01&to=2026-06-30 HTTP/1.1
Authorization: Bearer <access_token>

Le rapport contient trois tableaux parallèles : periods, consultants et totals. Chaque ligne de consultant porte un tableau cells aligné sur periods ; chaque cellule renseigne capacity_days, actual_days, projected_days et staffing_percent. Les périodes sont étiquetées past, current ou forecast, ce qui vous permet d’afficher l’historique et la projection sur la même grille.

Budgets de mission

GET /kpi/mission-budgets compare le budget, la prévision et l’écart pour un ensemble de missions à la fois. Il est ouvert aux rôles de consultation métier (administrateur, opérations, direction).

GET /kpi/mission-budgets?ids=0190a1c2-...,0190a1c3-... HTTP/1.1
Authorization: Bearer <access_token>

ids est une liste d’identifiants de missions séparés par des virgules (obligatoire). Chaque ligne renseigne name, status, sale_mode, health (unknown, on_track, at_risk, over), progress_percent, budget_revenue, budget_cost, forecast_margin et variance_margin. Les champs de coût et de marge sont null pour les appelants avec le rôle consultant. Pour le détail complet d’une seule mission, utilisez GET /missions/{id}/budget (voir Piloter une mission).

Points d’entrée en un coup d’œil