Console SuperAdmin — Monitoring, audit et suggestion de KPI

Spécification technique pour Heriade Rapport. Couvre l'accès transverse de Heriade/Lamare Conseil à l'ensemble des environnements clients, pour l'administration déléguée (forfait géré) et la supervision qualité.

1. Objectif

Permettre à Heriade ou Lamare Conseil, en tant que SuperAdmin, de :

• Surveiller rapidement l'état de santé de chaque environnement client (Portfolio)
• Détecter les incohérences avant qu'un client ne les remarque (Audit)
• Suggérer des KPI pertinents selon le profil sectoriel du client (Suggestion)

2. Rôle SuperAdmin — portée et distinction avec Admin

Le rôle Admin (docs/permissions-model.md) a une portée limitée à une entreprise. Le SuperAdmin est un rôle distinct, à portée transverse : accès en lecture (a minima) à tous les environnements clients rattachés à Heriade/Lamare Conseil.

interface SuperAdminAccess {
  userId: string                    // compte Heriade/Lamare, pas un compte client
  entreprisesAccessibles: string[]  // vide = toutes (Heriade), liste = portefeuille (consultant Lamare dédié)
  niveauAcces: 'lecture_seule' | 'intervention'   // intervention = peut aussi agir (classer un élément, ajuster un KPI) pour le compte du client
}

Le SuperAdmin est un rôle au-dessus de la console d'administration centrale (qui crée les entreprises et gère les modules souscrits) — il s'agit ici d'un outil opérationnel propre à Rapport, pas de la gestion des abonnements.

3. Écran Portfolio — vue multi-clients

Liste de toutes les entreprises accessibles, avec un indicateur de santé synthétique par ligne :

Colonne	Source
Entreprise	Console admin centrale
Dernier import Movement	Date du dernier import manuel (cf. docs/spec-vue-pivot.md, fraîcheur des données)
Éléments non classés	Compte des ElementNonClasse au statut en_attente (cf. docs/spec-onboarding-entreprise.md)
Ajustements ouverts	Provisions de gestion non dénouées depuis plus de N mois (cf. discussion ajustements CDG)
KPI actifs	Nombre de KPI définis et effectivement utilisés dans au moins un TDB
Dernière connexion utilisateur	Détecter un client inactif qui aurait décroché de l'outil

Tri par défaut : entreprises nécessitant une attention en premier (éléments non classés > 0, ajustements ouverts anciens, ou import ancien).

4. Outil d'audit — règles de cohérence

Pour une entreprise donnée, liste de vérifications automatiques, chacune avec une sévérité :

Règle	Sévérité	Référence
Éléments non classés en attente	Élevée	docs/spec-onboarding-entreprise.md
Provision de gestion ouverte depuis plus de N mois sans dénouement	Élevée	discussion ajustements CDG multi-niveaux
Import Source Heriade rafraîchi mais non réimporté dans Movement depuis plus de N jours	Moyenne	docs/spec-vue-pivot.md section 2bis
KPI défini mais jamais inséré dans un TDB (orphelin)	Faible	docs/spec-bibliotheque-kpi.md
Pastille ad hoc encore dupliquée par copier-coller, non migrée en bibliothèque	Faible	docs/spec-bibliotheque-widgets-restitution.md section 7
Référentiel incomplet pour un établissement actif (ex. capacité non renseignée)	Élevée	docs/spec-bibliotheque-kpi.md section 5
Ventilation d'ajustement référençant une version obsolète de l'ajustement parent	Moyenne	discussion ajustements CDG, point de vigilance asynchronisme

Chaque règle renvoie vers l'écran concerné pour traiter l'anomalie (ex. clic sur "éléments non classés" → écran Modélisation de l'entreprise concernée), sans que le SuperAdmin ait à naviguer manuellement jusque-là.

5. Outil de suggestion de KPI

À partir des éléments déjà présents dans l'environnement client (axes, segments, référentiels), suggérer des KPI du pattern remplissage/rendement pertinents, sur le modèle de la table de rôles génériques sectoriels (docs/meta-modele-dimensions.md, section 4).

Logique de suggestion

Si la dimension Structure a un segment "type d'hébergement" ET un référentiel "capacité" existe
  → suggérer "Taux d'occupation" (préremplir le wizard KPI avec ce mapping)

Si un axe "Métier" contient une notion de quantité produite ET un référentiel "capacité machine" existe
  → suggérer "TRS"

Si aucune suggestion ne correspond à un pattern connu
  → ne rien suggérer plutôt que de forcer un mapping inadapté (cf. principe déjà posé : mieux vaut une absence que du faux)

La suggestion reste une proposition pré-remplie dans le wizard KPI existant (docs/spec-bibliotheque-kpi.md) — jamais une création automatique sans validation, cohérent avec le principe déjà posé pour les éléments non classés (aucune action structurante sans validation humaine explicite).

6. Droits et traçabilité

L'accès SuperAdmin donne à un tiers (Heriade ou Lamare Conseil) une visibilité sur les données d'un client — point sensible à traiter explicitement, pas seulement techniquement :

• Toute action en mode intervention (pas seulement lecture) doit être tracée : qui, quand, quelle entreprise, quelle action — journal d'audit consultable par l'entreprise cliente elle-même si elle le demande.
• La bascule lecture_seule / intervention doit être explicite au niveau de chaque session SuperAdmin, pas un mode par défaut permanent — pour qu'une intervention reste un acte volontaire et identifiable, pas un état ambiant.
• Ce point mérite d'être clarifié contractuellement avec les clients (mention dans le contrat de service Lamare Conseil ou les CGU Heriade) — la conformité RGPD applicable dépend de la nature des données visibles (la masse salariale nominative, par exemple, est une donnée sensible).

7. Phasage suggéré

1. Étape 1 : écran Portfolio en lecture seule, basé sur les indicateurs déjà calculables aujourd'hui (dernier import, éléments non classés une fois spec-onboarding-entreprise.md implémenté).
2. Étape 2 : outil d'audit avec les règles de cohérence (section 4), classées par sévérité, sans action corrective directe depuis cet écran — juste diagnostic et redirection.
3. Étape 3 : mode intervention avec traçabilité, pour permettre au SuperAdmin d'agir directement (classer un élément, ajuster un référentiel) sans changer de compte.
4. Étape 4 : outil de suggestion de KPI, une fois que plusieurs profils sectoriels réels (au-delà d'EHPAD) existent pour calibrer les règles de suggestion sur des cas concrets plutôt que des hypothèses.

8. Point de vigilance

Ne pas construire l'étape 4 (suggestion de KPI) avant d'avoir un deuxième ou troisième client hors EHPAD en production — les règles de suggestion actuelles ne reposent que sur un seul cas réel validé, un risque de sur-généraliser à partir d'un échantillon insuffisant.