Vue d'ensemble

L'écran Vue d'ensemble vous permet de voir sur une seule page la santé, l'usage et les dépenses de la plateforme pour le tenant courant, et d'aller directement à ce qui demande une décision. Chemin dans le portail : / (page d'accueil du portail). Tout utilisateur connecté l'ouvre : les responsables lisent le verdict, les administrateurs (platform_admin, tenant_admin) voient la même page intitulée Tableau de bord administrateur. L'écran est dessiné par portal/src/screens/overview.tsx et ne fait que lire des données : il ne modifie rien.

Ce que montre l'écran

La page compte cinq bandeaux, de haut en bas. Chaque bloc se charge seul : pendant le chargement il affiche un emplacement gris, quand son appel d'API échoue il affiche le message traduit de l'API, et quand l'appel répond sans donnée il affiche Aucune donnée pour l'instant.

Bandeau	Contenu	Source des données
Verdict	Surtitre Tableau de bord de direction ou Tableau de bord administrateur suivi du nom du tenant, puis une phrase : Tout est sous contrôle, Des points demandent votre attention, Situation critique : action immédiate requise ou État en cours d'évaluation. Dessous : N sujets demandent une décision ou Aucune approbation, alerte ni incident en attente., et trois chiffres à droite : Taux d'erreur, Latence p95, Coût du mois.	GET /v1/me, GET /v1/telemetry/overview, GET /v1/finops/summary
Pastilles d'action	Une pastille par sujet qui demande une décision : incidents ouverts, approbations en attente, alertes budgétaires, quotas au-delà de 80 %, portes qualité en échec, taux d'erreur au-delà de 1 %.	voir le tableau Actions
Chiffres clés	Six cartes : Requêtes (avec la fenêtre, par exemple 7 derniers jours), Coût du jour, Coût du mois, Agents actifs, Incidents ouverts, Portes qualité franchies (franchies / total, ou Aucune évaluation).	GET /v1/telemetry/overview, GET /v1/finops/summary, GET /v1/agents, GET /v1/incidents, GET /v1/evaluations/runs
Tendances	Trafic et erreurs par jour (courbe des requêtes et des erreurs) et Dépenses par jour (mois en cours) (barres de la dépense mesurée).	GET /v1/telemetry/overview, GET /v1/finops/summary
Argent et travail	Agents les plus coûteux (mois), Modèles les plus coûteux (mois) (barres classées) et Exécutions d'agents (total, Réussies, En cours, Échouées, Taux de réussite).	GET /v1/finops/summary, GET /v1/runs
Budgets et gouvernance	Budgets et quotas (les six quotas les plus consommés, consommé / plafond, pourcentage, rouge dès 90 %, orange dès 80 %) et Activité récente (audit) (les huit derniers événements d'audit, un événement refusé ou en échec en rouge).	GET /v1/quotas/usage, GET /v1/audit/events

Calcul du verdict (portal/src/lib/overview.ts) :

• Situation critique : un incident ouvert sévère, ou un taux d'erreur au-delà de 5 %.
• Des points demandent votre attention : un taux d'erreur au-delà de 1 %, ou au moins un incident ouvert, une approbation en attente, une alerte budgétaire, une porte qualité en échec ou un quota au-delà de 80 %.
• Tout est sous contrôle : aucun des cas précédents.
• État en cours d'évaluation : aucun de ces chiffres n'a encore pu être lu.

Les dépenses partent du premier jour du mois en cours. Les comptes d'approbations, d'exécutions, d'agents et d'incidents lisent au plus 200 lignes chacun, les exécutions d'évaluation au plus 100.

Actions

L'écran n'a ni formulaire ni bouton qui modifie des données : chaque élément est un lien vers l'écran qui porte le détail.

Bouton ou action	Ce qu'il fait	Appel d'API	Rôles
Carte Requêtes	Ouvre Événements d'usage (/finops/usage).	GET /v1/telemetry/overview	Tout utilisateur connecté ; le chiffre exige le droit de lire la télémétrie.
Cartes Coût du jour et Coût du mois	Ouvrent la Synthèse FinOps (/finops/summary).	GET /v1/finops/summary	Lecteurs FinOps
Carte Agents actifs	Ouvre le Registre des agents (/agents/registry).	GET /v1/agents	Lecteurs des agents
Carte Incidents ouverts	Ouvre Incidents (/security/incidents).	GET /v1/incidents	Lecteurs des incidents
Carte Portes qualité franchies	Ouvre Portes qualité (/quality/gates).	GET /v1/evaluations/runs	Lecteurs des évaluations
Lien Détails de Trafic et erreurs par jour	Ouvre Métriques en direct (/observability/metrics).	GET /v1/telemetry/overview	Lecteurs de l'observabilité
Lien Détails de Dépenses par jour (mois en cours), Agents les plus coûteux (mois), Modèles les plus coûteux (mois)	Ouvrent la Synthèse FinOps.	GET /v1/finops/summary	Lecteurs FinOps
Lien Détails de Exécutions d'agents	Ouvre Exécutions (/agents/runs).	GET /v1/runs	Lecteurs des exécutions
Lien Détails de Budgets et quotas	Ouvre Quotas (/finops/quotas).	GET /v1/quotas/usage	Lecteurs FinOps
Lien Détails de Activité récente (audit)	Ouvre Événements et chaîne (/audit/events).	GET /v1/audit/events	auditor, security_officer, tenant_admin, platform_admin
Pastille N incident(s) ouvert(s)	Ouvre Incidents ; rouge quand un incident est sévère.	GET /v1/incidents	Lecteurs des incidents
Pastille N approbation(s) en attente	Ouvre Approbations (/agents/approvals).	GET /v1/approvals	Lecteurs des approbations
Pastille N alerte(s) budgétaire(s)	Ouvre les Alertes FinOps (/finops/alerts).	GET /v1/finops/alerts	Lecteurs FinOps
Pastille N quota(s) au-delà de 80 %	Ouvre Quotas.	GET /v1/quotas/usage	Lecteurs FinOps
Pastille N porte(s) qualité en échec	Ouvre Portes qualité.	GET /v1/evaluations/runs	Lecteurs des évaluations
Pastille Taux d'erreur à N %	Ouvre Traces (/observability/traces) ; rouge au-delà de 5 %.	GET /v1/telemetry/overview	Lecteurs de l'observabilité

Rôles

• Tout utilisateur connecté peut ouvrir l'écran ; GET /v1/me donne le nom du tenant et les rôles.
• Le titre Tableau de bord administrateur s'affiche quand les rôles contiennent platform_admin ou tenant_admin, sinon Tableau de bord de direction.
• Chaque bloc garde les droits de sa propre route : un bloc dont la route refuse votre rôle affiche l'erreur de l'API (par exemple forbidden) et les autres blocs restent lisibles. Le bloc d'audit, par exemple, suit les lecteurs de GET /v1/audit/events déclarés dans ROLES.auditReaders de portal/src/lib/kit.ts : auditor, security_officer, tenant_admin, platform_admin.

Tâches courantes

Lire l'état de la plateforme le matin

1. Ouvrir la page d'accueil du portail. Le verdict résume tout le tenant en une phrase. Écran : Vue d'ensemble. Résultat attendu : le bandeau du verdict est vert (Tout est sous contrôle), orange ou rouge. En cas d'échec : un bandeau qui reste sur État en cours d'évaluation signifie qu'aucun chiffre n'a pu être lu ; lisez l'erreur affichée dans les blocs.
2. Lire les pastilles d'action. Chaque pastille nomme un sujet qui demande une décision et son nombre. Résultat attendu : de zéro à six pastilles sous le verdict. En cas d'échec : si aucune pastille n'apparaît alors que le verdict est orange, rechargez la page pour rafraîchir les comptes.
3. Cliquer la première pastille rouge. Les pastilles rouges (incident sévère, porte en échec, taux d'erreur au-delà de 5 %) passent en premier. Résultat attendu : l'écran cible s'ouvre (Incidents, Portes qualité ou Traces). En cas d'échec : une erreur forbidden sur l'écran cible signifie que votre rôle ne lit pas ce domaine ; adressez-vous à un tenant_admin.

Vérifier les dépenses du mois

1. Lire Coût du jour et Coût du mois. Ils viennent de la synthèse FinOps groupée par jour depuis le premier du mois. Résultat attendu : deux montants dans la devise du tenant. En cas d'échec : Aucun signifie qu'aucun usage n'a encore été valorisé ; vérifiez les grilles tarifaires dans les écrans FinOps.
2. Lire les agents et les modèles les plus coûteux. Ils montrent où va l'argent. Résultat attendu : des barres classées avec leurs montants. En cas d'échec : Aucune donnée pour l'instant signifie aucun événement d'usage ce mois-ci.
3. Ouvrir le détail. Cliquez Détails dans l'un de ces panneaux. Résultat attendu : la Synthèse FinOps s'ouvre. En cas d'échec : une erreur dans le panneau signifie que votre rôle n'est pas lecteur FinOps.

Retrouver qui a fait quoi récemment

1. Lire Activité récente (audit). Le panneau liste les huit derniers événements d'audit : action, type de ressource, acteur, date. Résultat attendu : une liste où les événements refusés ou en échec sont en rouge. En cas d'échec : un message forbidden signifie que vous n'êtes pas lecteur de l'audit.
2. Ouvrir la chaîne. Cliquez Détails pour ouvrir Événements et chaîne et filtrer les événements. Résultat attendu : l'écran d'audit s'ouvre. En cas d'échec : adressez-vous à un auditor ou à un security_officer.

Dépannage

Symptôme	Cause	Correction
Tous les blocs affichent « L'API Control Plane est injoignable »	Le portail ne joint pas l'API du Control Plane.	Vérifiez que l'API tourne et que NEXT_PUBLIC_EAI_API_URL pointe vers elle.
Un bloc affiche un message forbidden	Votre rôle ne lit pas la route de ce bloc (HTTP 403).	Demandez à un tenant_admin le rôle de lecture du domaine ; les autres blocs ne sont pas touchés.
Un bloc affiche Aucune donnée pour l'instant	La route a répondu avec une liste vide (aucun usage, aucune exécution, aucun quota ce mois-ci).	Normal sur un tenant neuf ; le bloc se remplit avec l'activité.
Coût du jour affiche Aucun	Aucun événement d'usage valorisé aujourd'hui.	Vérifiez les grilles tarifaires et les événements d'usage des écrans FinOps.
Portes qualité franchies affiche Aucune évaluation	Aucune exécution d'évaluation avec un résultat de porte.	Lancez une suite d'évaluation depuis les écrans Qualité.
Le verdict reste sur État en cours d'évaluation	Aucun des chiffres du verdict n'a pu être lu.	Ouvrez les blocs un par un pour lire leurs erreurs.

Pages liées

• Démarrer
• Tenants
• Membres et rôles
• Preuves et scellés
• Documentation sécurité