docs: ajoute index+ancres et capitalise app-alexandrie

10_frontend_risques_et_vigilance.md

@@ -7,7 +7,7 @@ Ce fichier recense des risques front-end susceptibles de provoquer :
 - dette technique rapide,
 - régressions UX/perf/a11y.
 
-Dernière mise à jour : 25-01-2026
+Dernière mise à jour : 09-03-2026
 
 ---
 
@@ -21,6 +21,18 @@ Dernière mise à jour : 25-01-2026
 
 ---
 
+## Index
+
+- [Auth côté client](#risque-auth-cote-client)
+- [Erreurs silencieuses / écrans blancs](#risque-erreurs-silencieuses)
+- [Mélange server state / client state](#risque-melange-server-client-state)
+- [Appels API en state local d’écran](#risque-api-state-local-ecran)
+- [Performances : sur-renders + bundle](#risque-performances-sur-renders)
+- [Accessibilité oubliée (a11y)](#risque-accessibilite-oubliee)
+
+---
+
+<a id="risque-auth-cote-client"></a>
 ## Auth côté client (mauvaise séparation des responsabilités)
 
 ### Risques
@@ -49,6 +61,7 @@ Dernière mise à jour : 25-01-2026
 
 ---
 
+<a id="risque-erreurs-silencieuses"></a>
 ## Erreurs silencieuses / écrans blancs
 
 ### Risques
@@ -70,6 +83,7 @@ Dernière mise à jour : 25-01-2026
 
 ---
 
+<a id="risque-melange-server-client-state"></a>
 ## Mélange server state / client state
 
 ### Risques
@@ -92,6 +106,30 @@ Dernière mise à jour : 25-01-2026
 
 ---
 
+<a id="risque-api-state-local-ecran"></a>
+## Appels API gérés en state local d’écran (refactor coûteux)
+
+### Risques
+
+- Server state non partageable entre écrans (liste/detail, wizard, tabs) → duplication et incohérences
+- Pas de cache / invalidation standard → bugs subtils et re-fetchs inutiles
+- Refactor tardif quand l’epic s’étend (mutations, cache, offline, pagination)
+
+### Symptômes
+
+- Même appel API recopié dans plusieurs écrans
+- Un écran “A” modifie une ressource mais l’écran “B” n’est jamais rafraîchi
+- Code review qui force un refactor vers un store/cache au milieu d’un epic
+
+### Bonnes pratiques / mitigations
+
+- Par défaut : créer un store de domaine (ex : Zustand) ou un cache de server state pour tout domaine susceptible d’être réutilisé
+- Centraliser `isLoading`/`error`/`data` et la stratégie de refresh/invalidation
+- Exception acceptable : état purement UI, local et jetable (ex : input de recherche, filtres temporaires non persistés)
+
+---
+
+<a id="risque-performances-sur-renders"></a>
 ## Performances : sur-renders + bundle non maîtrisé
 
 ### Risques
@@ -115,6 +153,7 @@ Dernière mise à jour : 25-01-2026
 
 ---
 
+<a id="risque-accessibilite-oubliee"></a>
 ## Accessibilité oubliée (a11y)
 
 ### Risques