DOCS/test-plan-manager-app.md

# Plan de test — manager-app (modifications du 2026-08-09 au 2026-08-12)

Périmètre : les 8 commits livrés entre le 9 et le 12 août 2026 sur `manager-app`.
Rien ici n'a été vérifié à l'œil dans un navigateur — c'est justement l'objet de ce document.

Mode d'emploi : coche la case si le comportement attendu est constaté, laisse-la vide sinon
et note l'écart sur la ligne. `→` = résultat attendu.

Commits couverts :

| Réf | Commit | Sujet |
|---|---|---|
| §1 | `eb8e849` | Socle visuel (constants.dart) |
| §2 | `bb4d4fe` `eb8e849` | Guide IA — 2 onglets |
| §3 | `bb4d4fe` | Statistiques refondues + export PDF |
| §4 | `bb4d4fe` | Onboarding self-service (auth, abonnement, quota IA) |
| §5 | `b39854a` | DB4 — éditeur de parcours unifié |
| §6 | `bb4d4fe` | Mode de progression du parcours |
| §7 | `5066b6c` | Lot E — PDF en média d'étape, QuestionType |
| §8 | `762448c` | Lot F — écran Activité + compteur d'utilisateurs |
| §9 | `608231f` | C4 — compression des images à l'upload |
| §10 | `9d9f4bc` | Nettoyage du client généré |
| §11 | — | i18n FR / EN / NL et non-régression |

---

## §0. Porte d'entrée

- [ ] `flutter build web` passe sans erreur
- [ ] `flutter analyze` ne remonte que les 3 problèmes connus de `test/widget_test.dart`
- [ ] Connexion, sélection d'instance, chargement du menu latéral → aucun écran blanc

---

## §1. Socle visuel

Le socle (11 rôles typo, 8 espacements, 5 rayons) n'est appliqué que sur les écrans neufs :
Guide IA, Statistiques, Activité. Le reste de l'app garde son style d'origine — c'est voulu.

- [ ] Les écrans Guide IA / Statistiques / Activité utilisent la même palette que le reste de l'app (pas de seconde identité visuelle)
- [ ] Titres, sous-titres et cartes cohérents entre ces trois écrans
- [ ] En 1280 px de large : pas de débordement horizontal, pas de texte tronqué
- [ ] En ~900 px (fenêtre réduite) : les cartes passent en colonne au lieu de se compresser

---

## §2. Guide IA

Menu conditionné à `isAssistant` (même drapeau que la garde d'`AiController`).

### 2.1 Accès

- [ ] Instance avec assistant activé → l'entrée « Guide IA » apparaît dans le menu
- [ ] Instance sans assistant → l'entrée est absente

### 2.2 Onglet « Configuration »

- [ ] Les deux onglets sont visibles et basculent sans rechargement
- [ ] Persona : saisie puis « Enregistrer » → message de succès, valeur retrouvée après F5
- [ ] Réponses de repli : ajout, modification, suppression d'une ligne
- [ ] Wakeword vocal affiché avec le nom configuré
- [ ] Carte « Ce que connaît votre guide » (`GET /api/Ai/knowledge/{id}`) : le nombre de morceaux de contenu s'affiche
- [ ] Une section désactivée puis réindexée → le compteur baisse (l'index vectoriel est la source, pas les tables de contenu)
- [ ] Bouton de réindexation : lancement, retour visible, pas de double envoi si on reclique
- [ ] Aperçu de conversation : une question envoyée reçoit une vraie réponse (`POST /api/AI/chat`, pas une simulation)
- [ ] Aperçu avec des modifications non enregistrées → mention « non enregistré » affichée
- [ ] Échec réseau sur l'enregistrement → snackbar rouge, la saisie n'est pas perdue

### 2.3 Onglet « Ce que demandent vos visiteurs »

Alimenté par `GET /api/Ai/insights/{id}`. **L'endpoint backend n'existe peut-être pas encore** :
si c'est le cas, seul le premier point ci-dessous s'applique, le reste est à rejouer après livraison.

- [ ] Aucune donnée / endpoint absent → état vide illustré (icône + texte), **pas** de cadre creux ni d'erreur
- [ ] Avec des données : les 4 tuiles (questions, sans réponse, thèmes, langues) affichent les bons totaux
- [ ] La tuile « sans réponse » est en ambre, les trois autres en encre normale
- [ ] Bloc ambre « questions sans réponse » listé avec le compteur `n ×` à droite
- [ ] Une carte dont la liste est vide (thèmes non encore regroupés) est **masquée**, pas affichée vide
- [ ] Barres : la plus longue correspond bien à la valeur la plus haute, une seule teinte par carte
- [ ] > 1100 px : les cartes sont côte à côte ; en dessous : empilées
- [ ] Note de confidentialité affichée en bas

---

## §3. Statistiques — écran « Fréquentation »

⚠️ Écran réécrit (+1832 lignes) et **jamais ouvert dans un navigateur** avant ce test.

### 3.1 Chargement et filtres

- [ ] Instance sans droit statistiques → message « indisponible » explicite (pas d'écran vide)
- [ ] Erreur réseau → message d'erreur avec icône, pas de spinner infini
- [ ] Instance sans aucune donnée → message « pas de données »
- [ ] Sélecteur de période : 7 / 30 / 90 / 365 jours → la plage de dates affichée en sous-titre suit
- [ ] Filtre canal : « Tous » + un bouton par canal (Mobile / Tablette / Web / VR / Voix)
- [ ] Chaque bouton de canal affiche son volume
- [ ] Un canal sans donnée sur la période est absent ou inactif
- [ ] Filtre sur un canal unique → message « pas de données pour ce type » si le canal est vide
- [ ] Retour à « Tous » → les valeurs redeviennent celles du total

### 3.2 KPI et bandeau

- [ ] 4 KPI affichés : visites, durée moyenne, contenus par visite, et part vocale **ou** vues totales
- [ ] Chaque KPI porte sa variation vs période précédente (flèche + %)
- [ ] Variation nulle → « stable » avec l'icône neutre, pas « 0 % »
- [ ] Les variations sont cohérentes : passer de 30 à 7 jours change les chiffres ET les variations
- [ ] Bandeau « à retenir » : phrases cohérentes avec les chiffres affichés au-dessus
- [ ] Durée : `1 min 30 s` au-delà de 60 s, `45 s` en dessous

### 3.3 Courbe et tableaux

- [ ] Courbe en aire des visites par jour, un point par jour de la période
- [ ] Bandes de week-end visibles et alignées sur les bons jours (vérifier un samedi précis)
- [ ] Jour de pic annoté avec la bonne date et la bonne valeur
- [ ] Barres horizontales : top contenus, canaux, langues
- [ ] Tableaux détaillés : POI, agenda, quiz, jeux, articles, menu — un tableau vide est masqué
- [ ] Les totaux des tableaux ne contredisent pas les KPI

### 3.4 Export PDF

- [ ] Bouton d'export → le PDF se télécharge
- [ ] Nom du fichier : nom d'instance + intitulé + date
- [ ] **Les chiffres du PDF sont identiques à ceux de l'écran** (KPI, pic, tops) — c'est le point critique
- [ ] La plage de dates du PDF correspond au filtre actif
- [ ] Export avec un filtre canal actif → le PDF reflète ce filtre
- [ ] Le sommaire ne promet **pas** de données inexistantes (parcours terminés, questions au guide IA)
- [ ] Échec de génération → snackbar rouge, l'écran reste utilisable
- [ ] Export sur une période sans données → soit bouton désactivé, soit PDF cohérent (à noter selon le constat)

---

## §4. Onboarding self-service

⚠️ Aucun parcours joué de bout en bout avant ce test.

### 4.1 Mot de passe oublié

- [ ] Lien « mot de passe oublié » accessible depuis l'écran de connexion
- [ ] E-mail inconnu → message neutre (pas de fuite d'existence de compte)
- [ ] E-mail connu → confirmation d'envoi
- [ ] Le mail arrive et son lien ouvre l'écran de définition du mot de passe

### 4.2 Définition du mot de passe

- [ ] Lien valide → formulaire affiché
- [ ] Lien expiré ou déjà consommé → message clair, pas d'erreur technique brute
- [ ] Mot de passe trop court / confirmation différente → erreur de validation avant envoi
- [ ] Définition réussie → redirection vers la connexion, connexion effective avec le nouveau mot de passe

### 4.3 Écran Abonnement

- [ ] Entrée « Abonnement » présente dans le menu
- [ ] Période d'essai en cours → « essai actif » + date de fin correcte
- [ ] Essai sans date de fin → texte de repli, pas de date vide ni de `null`
- [ ] Plan payant actif → intitulé et description du plan
- [ ] Liste « inclus dans votre plan » cohérente avec le plan réel de l'instance
- [ ] Bouton de montée en gamme → ouvre bien la page cible dans un nouvel onglet
- [ ] Section modules complémentaires → mention « bientôt disponible »

### 4.4 Indicateur de quota IA

- [ ] Sous le bouton « Traduire via IA » : `Quota IA : X / Y utilisés ce mois`
- [ ] Plan sans plafond (quota = 0) → « Quota IA : illimité »
- [ ] ≥ 80 % → texte orange + gras + mention « partagé avec l'assistant visiteur »
- [ ] ≥ 95 % → texte rouge
- [ ] Après une traduction, le compteur se met à jour (il ne se rafraîchit que si la clé change — à vérifier)
- [ ] Endpoint quota en échec → **rien** ne s'affiche, la traduction reste possible

---

## §5. Éditeur de parcours unifié (DB4)

Les trois anciennes fenêtres (`showNewOrUpdateGuidedPath` / `GuidedStep` / `QuizQuestion`) sont supprimées.
Profondeur maximale attendue : 2 surfaces (l'éditeur, puis la traduction).

### 5.1 Structure

- [ ] Ouverture d'un parcours → une seule fenêtre : rail d'étapes à gauche, détail à droite
- [ ] Ajouter une question → elle se déplie **sur place**, aucune fenêtre supplémentaire
- [ ] Traduire un champ → la fenêtre de traduction est la seule surface superposée
- [ ] Fenêtre large (≈ 1180 px max) et centrée, pas de barre de défilement horizontale

### 5.2 Sauvegarde au fil de l'eau

Il n'y a **plus** de bouton « Sauvegarder », et plus d'avertissement de perte de travail (garde-fou retiré volontairement).

- [ ] Saisie dans un champ → écriture partie ~700 ms après la dernière frappe (vérifier dans l'onglet Réseau)
- [ ] Frappe continue → une seule requête à la fin, pas une par caractère
- [ ] Ajout / suppression / réordonnancement d'étape → écriture immédiate, sans attendre le débounce
- [ ] Fermer la fenêtre juste après une frappe → la dernière saisie est bien enregistrée (purge à la fermeture)
- [ ] F5 après édition → tout est retrouvé
- [ ] Ouvrir une fenêtre neuve puis la refermer sans rien toucher → **aucun parcours créé en base**
- [ ] Première modification sur une fenêtre neuve → le parcours est créé à ce moment-là

### 5.3 Erreurs et fermeture

- [ ] Backend coupé pendant l'édition → la fenêtre **refuse de se fermer**, un « Réessayer » apparaît en pied de page
- [ ] Backend rétabli + « Réessayer » → l'écriture passe et la fermeture devient possible
- [ ] Retour arrière du navigateur pendant l'édition → passe par la même fermeture (rien n'est perdu)
- [ ] Suppression d'étape → demande de confirmation
- [ ] Confirmation refusée → l'étape reste, aucune requête partie

### 5.4 Pièges backend à vérifier en base

- [ ] Ajouter deux étapes d'affilée → **pas de doublon** en base (les étapes sans id partent par `CreateGuidedStep`)
- [ ] Créer une question, fermer, rouvrir → la question a le bon id et n'est pas dupliquée
- [ ] Réordonner puis ajouter une question → la question reste rattachée à la bonne étape (récupération de l'id par `order`)
- [ ] Supprimer une étape du milieu → les `order` des suivantes sont recalculés

### 5.5 Les deux hébergements du parcours

- [ ] Parcours sous une **SectionParcours** : création, édition, suppression
- [ ] Parcours sous une **SectionMap** : mêmes opérations, même comportement
- [ ] Aucun écart de comportement entre les deux

---

## §6. Mode de progression du parcours

3 questions au lieu des 9 booléens précédents.

- [ ] Trois modes proposés : Libre / Dans l'ordre / Étape par étape, chacun avec sa description
- [ ] Un parcours existant s'ouvre sur le mode correspondant à ses booléens actuels
- [ ] « Libre » → en base : `isLinear = false`, `requireSuccessToAdvance = false`, `hideNextStepsUntilComplete = false`
- [ ] « Dans l'ordre » → `isLinear = true`, `requireSuccessToAdvance = false`
- [ ] « Étape par étape » → `isLinear = true`, `requireSuccessToAdvance = true`
- [ ] Aller-retour entre deux modes puis rechargement → le mode affiché est celui choisi
- [ ] Le comportement côté visitapp correspond au mode choisi (test croisé, cf. `test-plan.md` §19.13)

---

## §7. Lot E — médias d'étape et types de question

- [ ] Média d'une **étape de parcours** : le sélecteur propose Image, Vidéo, Audio **et PDF**
- [ ] Média d'un **slider** : la liste est inchangée (pas de PDF)
- [ ] PDF sélectionné sur une étape → enregistré, retrouvé après rechargement
- [ ] Types de question : Simple / Choix multiple / Puzzle correctement libellés (plus de `number0/1/2`)
- [ ] Changer le type d'une question existante → les champs affichés suivent le type
- [ ] Une question Puzzle enregistrée se rouvre bien en Puzzle
- [ ] Champ « fournisseur de carte » toujours présent, présenté comme réglage mobile/tablette (visitapp-web reste sur Leaflet)

---

## §8. Lot F — Activité et utilisateurs

### 8.1 Accès à l'écran Activité

- [ ] SuperAdmin → entrée « Activité » visible dans le menu (icône historique)
- [ ] InstanceAdmin → entrée **absente**
- [ ] Utilisateur standard → entrée absente
- [ ] Passer de SuperAdmin à un autre rôle sans recharger → l'entrée disparaît

### 8.2 Journal

- [ ] Liste chargée avec colonnes : date, instance, entité, action, utilisateur, id d'entité
- [ ] Actions traduites (Créer / Modifier / Supprimer), pas les valeurs brutes
- [ ] Entités traduites (Section, Ressource, Configuration, Device, Utilisateur)
- [ ] Ids d'instance et d'utilisateur résolus en **noms**
- [ ] Un id qui ne correspond plus à rien (entité supprimée) reste affiché tel quel, sans casser la ligne
- [ ] Clic sur une ligne → détail avant/après en **table**, pas de JSON brut
- [ ] Une création (pas de valeur « avant ») s'affiche proprement
- [ ] Journal vide → message dédié
- [ ] Erreur backend → message d'erreur, pas de spinner infini

### 8.3 Filtres et pagination

- [ ] Filtre instance
- [ ] Filtre type d'entité
- [ ] Filtre utilisateur
- [ ] Filtres de date « du » / « au »
- [ ] Combinaison de plusieurs filtres → résultats cohérents
- [ ] Tout changement de filtre ramène à la page 1
- [ ] **« Réinitialiser les filtres » vide aussi l'affichage des listes déroulantes** (c'était le bug corrigé)
- [ ] Pagination 50 : suivant / précédent, compteur « X–Y sur Z » exact
- [ ] Bouton précédent inactif en page 1, suivant inactif en dernière page

### 8.4 Compteur d'utilisateurs

- [ ] Écran Utilisateurs : compteur « X / 5 » affiché
- [ ] À 5 utilisateurs → bouton d'ajout désactivé
- [ ] SuperAdmin → **pas** de compteur ni de blocage (sa liste couvre toutes les instances)
- [ ] Création avec un e-mail déjà utilisé (409) → snackbar rouge avec le message serveur
- [ ] Création avec un rôle refusé (403) → snackbar rouge
- [ ] Création valide → utilisateur ajouté à la liste
- [ ] InstanceAdmin → le rôle SuperAdmin n'est pas proposé dans la liste des rôles

> Dettes serveur connues, hors périmètre de ce test : le plafond de 5 n'est pas appliqué par
> `UserController` (un POST direct passe), et aucune section n'est journalisée dans l'audit.

---

## §9. C4 — compression des images à l'upload

Règle : redimensionnement à 2560 px sur le côté long, JPEG q82 — sauf PNG à canal alpha qui reste PNG.

- [ ] Upload d'un JPEG de 6000 px → l'image stockée fait 2560 px sur son côté long
- [ ] Photo en **portrait** → c'est bien la hauteur qui est ramenée à 2560, pas la largeur
- [ ] Le poids affiché dans la liste des ressources correspond au fichier **compressé**, pas à l'original
- [ ] PNG **avec transparence** → reste un PNG, transparence intacte (pas de fond noir)
- [ ] PNG **sans transparence** → ressort en JPEG, et le type MIME suit (vérifier le `Content-Type` servi par Firebase)
- [ ] Petite image déjà bien encodée → l'original est conservé (pas de fichier plus lourd qu'avant)
- [ ] Fichier image corrompu → l'upload passe quand même avec l'original, pas de blocage
- [ ] Fichier non image (PDF, vidéo, audio) → aucun traitement, upload inchangé
- [ ] **Les deux chemins d'upload** (création de ressource et ajout de fichier) compressent identiquement
- [ ] Le quota de stockage augmente de la taille compressée, pas de la taille d'origine
- [ ] Le second chemin d'upload renseigne désormais `sizeBytes` (avant : 0 octet au quota)
- [ ] Upload multiple de plusieurs images → toutes compressées, aucune perdue

> Les ressources créées avant ce commit par le second chemin comptent 0 octet au quota :
> c'est l'existant, il attend le backfill C2 — ne pas le noter comme une régression.

---

## §10. Nettoyage du client généré

- [ ] `flutter analyze manager_api_new` : 3 avertissements légitimes, plus les 67 d'avant
- [ ] `lib/api/openApiTest.dart` a bien disparu (le déclencheur de génération est verrouillé)
- [ ] Aucun écran ne casse à cause d'un modèle supprimé (statistiques, carte, utilisateurs surtout)
- [ ] `tablet-app` compile toujours avec ce client
- [ ] `mymuseum-visitapp` compile toujours avec ce client
- [ ] Le mapping `isGood` → `isCorrect` des QCM est toujours en place

---

## §11. i18n et non-régression

### 11.1 Langues

- [ ] Sélecteur de langue dans le menu latéral : FR / EN / NL
- [ ] Changement de langue → l'interface bascule immédiatement, sans rechargement
- [ ] La langue est conservée après F5
- [ ] Guide IA : aucune clé manquante en EN, aucune en NL
- [ ] Statistiques : idem
- [ ] Activité : idem (40 clés ajoutées au lot F)
- [ ] Éditeur de parcours : idem (14 clés ajoutées, 3 retirées)
- [ ] Aucun texte du type `guideIaXxx` ou `auditXxx` affiché brut à l'écran
- [ ] En NL et EN, les libellés longs ne débordent pas des boutons et des cartes

### 11.2 Écrans non touchés (contrôle rapide)

- [ ] Configurations : ouverture, édition, enregistrement d'une section de chaque type
- [ ] Ressources : liste, filtre, suppression
- [ ] Applications / liaison configuration : aperçu bento toujours fonctionnel
- [ ] Devices kiosk
- [ ] Clés API
- [ ] Notifications push
- [ ] Déconnexion / reconnexion

---

## Écarts constatés

| § | Ce qui a été observé | Gravité |
|---|---|---|
|  |  |  |
|  |  |  |