lot4

docs/pedagogie/00-plan-preparation-soutenance.md

@@ -2,7 +2,7 @@
 
 > **Méthode :** pour chaque lot, l’agent décrit ce qu’il compte faire → **tu valides ou ajustes** → on exécute → on coche.
 
-**Dernière mise à jour :** lot 3 livré ([fiche-soutenance-orale.md](fiche-soutenance-orale.md)).
+**Dernière mise à jour :** lot 4 livré (commentaires `lib/` + DEBUG conservé).
 
 ---
 
@@ -15,7 +15,7 @@
 | `.env` | **Uniquement** `swifty_companion/.env` en local ; **jamais** dans Git ; `.env.example` versionné (sujet : échec direct si secrets publics) |
 | Fiche orale (lot 3) | **Déroulé de soutenance** détaillé (sujet, points critiques, réalisation, commandes expliquées) — un fichier structuré logiquement |
 | Commentaires code | **Français** — sujet ne l’interdit pas |
-| Bouton DEBUG | Voir [fiche-depot-soutenance.md §8](fiche-depot-soutenance.md) — pas lié aux secrets ; visible seulement en build debug ; choix garder/retirer avant rendu final |
+| Bouton DEBUG | **Garder** — aide à démontrer le bonus refresh en `flutter run` ; absent en release (`kDebugMode`) — [fiche-depot-soutenance.md §8](fiche-depot-soutenance.md) |
 
 ---
 
@@ -37,7 +37,7 @@
 | B | 1 Dépôt + branche | ✅ [fiche-depot-soutenance.md](fiche-depot-soutenance.md) |
 | C | 2 README rendu autonome | ✅ fait |
 | D | 3 Fiche soutenance orale | ✅ [fiche-soutenance-orale.md](fiche-soutenance-orale.md) |
-| E | 4 Commentaires `lib/` | ☐ à faire |
+| E | 4 Commentaires `lib/` | ✅ fait |
 
 ---
 
@@ -47,19 +47,18 @@
 - `.env.example` commenté (racine + `swifty_companion/.env.example`).
 - `swifty_companion/README.md` : pointeur court vers le README racine.
 
-**Prochaine étape :** dis **« OK lot 4 »** pour les commentaires FR dans `lib/` (+ décision bouton DEBUG).
-
----
-
 ## Lot 3 — Livré
 
 - [fiche-soutenance-orale.md](fiche-soutenance-orale.md) — déroulé oral, commandes commentées, démo, FAQ.
 
 ---
 
-## Lot 4 — Commentaires code
+## Lot 4 — Livré
 
-`lib/` en français, sans lien vers doc externe ; décision DEBUG bouton documentée en oral.
+- Commentaires / dartdoc en **français** dans `swiftyCompanion/swifty_companion/lib/`.
+- Bouton **DEBUG** conservé (`kDebugMode`) pour la démo du bonus refresh — pas présent en APK release.
+
+**Plan préparation :** tous les lots 0–4 sont cochés ; prochaine action opérationnelle = branche `soutenance` + push Vogosphere ([fiche-depot-soutenance.md](fiche-depot-soutenance.md)).
 
 ---
 
@@ -71,4 +70,4 @@
 | 1 | ✅ |
 | 2 | ✅ |
 | 3 | ✅ |
-| 4 | ☐ |
+| 4 | ✅ |

docs/pedagogie/fiche-depot-soutenance.md

@@ -204,9 +204,9 @@ Dans `search_screen.dart`, un bouton **« DEBUG : simuler token expiré »** n
 |----------|---------|
 | Le sujet l’interdit ? | **Non** — rien dans le PDF sur les boutons de debug. |
 | Risque en soutenance ? | L’évaluateur peut le voir en `flutter run` ; tu peux l’expliquer pour le **bonus refresh**, ou le retirer avant rendu final si tu veux une UI plus « propre ». |
-| Décision à prendre (lot 4 ou avant push) | **Garder** (démo bonus) **ou** **retirer** le bouton — les deux sont défendables. |
+| Décision (lot 4) | **Garder** — le bonus sujet = refresh token ; le bouton ne fait qu’**invalider l’access** en debug pour tester le refresh sans attendre l’expiration. Absent en `flutter build apk --release`. |
 
-→ Détails oraux : [fiche-soutenance-orale.md](fiche-soutenance-orale.md) (lot 3, à rédiger).
+→ Démo orale : [fiche-soutenance-orale.md](fiche-soutenance-orale.md) §7.
 
 ---
 

docs/pedagogie/fiche-soutenance-orale.md

@@ -209,7 +209,7 @@ Si refresh échoue → IntraUnauthorizedException, l’utilisateur se reconnecte
 
 **Si évaluateur en release :** montrer `flutter test` sur `intra_oauth_tokens_test.dart` + expliquer le flux §7.
 
-**Bouton DEBUG au rendu final :** voir [fiche-depot-soutenance.md §8](fiche-depot-soutenance.md) — garder (visible seulement en debug) ou retirer avant push ; décision à trancher au lot 4.
+**Bouton DEBUG au rendu :** **conservé** — visible uniquement en build debug (`kDebugMode`), utile pour prouver le bonus refresh ; absent en release. Voir [fiche-depot-soutenance.md §8](fiche-depot-soutenance.md).
 
 ---