Refonte Structure

knowledge/frontend/risques/navigation.md

@@ -0,0 +1,83 @@
+# Frontend — Risques & vigilance : Navigation
+
+> Extrait de la base de connaissance Lead_tech. Voir `knowledge/frontend/risques/README.md` pour l'index complet.
+
+---
+
+<a id="risque-store-vide-deep-link"></a>
+## Écran détail Expo Router — store vide en deep link / reload
+
+### Risques
+
+- L'écran détail (`[slug].tsx`) lit ses données depuis un store Zustand peuplé par l'écran liste
+- En deep link, kill + reopen ou navigation OS back, le store est vide → "introuvable" affiché à tort
+
+### Symptômes
+
+- Écran détail vide ou erreur "non trouvé" sur accès direct (pas via la liste)
+- Fonctionne normalement en navigation standard mais échoue sur reload
+
+### Bonnes pratiques / mitigations
+
+```typescript
+// useEffect de secours dans l'écran détail
+useEffect(() => {
+  if (!accessToken) return;
+  if (items.length > 0 || isLoading || errorState) return;
+  void fetchItems(accessToken);
+}, [accessToken, items.length, isLoading, errorState, fetchItems]);
+```
+
+- Ne pas afficher "introuvable" avant d'avoir vérifié que le store a bien été peuplé
+- Contexte technique : Expo Router / Zustand — app-alexandrie story 4.1, 20-03-2026
+
+---
+
+<a id="risque-useeffect-guard-incomplet"></a>
+## `useEffect` fetch — guard incomplet sur les états terminaux
+
+### Risques
+
+- Si l'état "zéro résultat intentionnel" (ex : `paywallRequired`) n'est pas dans les conditions de court-circuit, le fetch est re-déclenché à chaque re-render ou focus
+- Boucle de fetch infini sur un état métier normal
+
+### Symptômes
+
+- `forums.length === 0` et `isLoading === false` → le guard ne court-circuite pas → fetch re-déclenché en boucle
+- Visible en focus sur l'écran depuis un autre onglet
+
+### Bonnes pratiques / mitigations
+
+```typescript
+// ❌ Pattern à risque — re-fetch si paywallRequired (forums vide + isLoading false)
+if (forums.length > 0 || isLoading) return;
+
+// ✅ Pattern correct — court-circuit sur l'état terminal
+if (forums.length > 0 || isLoading || paywallRequired) return;
+```
+
+**Règle** : les états "zéro résultat intentionnel" (liste vide + flag métier) doivent être traités comme "données présentes" dans le guard de fetch.
+
+- Contexte technique : React Native / Zustand / Expo Router — app-alexandrie story 4.1, 20-03-2026
+
+---
+
+<a id="risque-zustand-collection-sans-cle-contexte"></a>
+## Store Zustand : collections sans clé de contexte (navigation inter-contexte)
+
+### Risques
+
+- Un store qui stocke des collections dépendant d'un paramètre de navigation (forumSlug, threadId...) sans stocker ce paramètre affiche des données périmées lors d'une navigation inter-contexte
+
+### Symptômes
+
+- Naviguer du forum A vers le forum B affiche encore les catégories/threads du forum A
+- Guard `if (items.length > 0) return` empêche le rechargement lors d'un changement de contexte
+
+### Bonnes pratiques / mitigations
+
+- Stocker la clé de contexte avec les données : `categoriesForumSlug: string | null`
+- Invalider si `categoriesForumSlug !== currentForumSlug` avant de retourner depuis le cache
+- Ou supprimer le guard et dépendre uniquement du changement de paramètre dans le `useEffect`
+
+- Contexte technique : React Native / Zustand / Expo Router — app-alexandrie 23-03-2026