ajout patterns

10_frontend_patterns_valides.md

@@ -12,7 +12,7 @@ Il sert de **mémoire durable** pour éviter :
 - de redélibérer éternellement sur des sujets déjà tranchés,
 - de propager des “bonnes pratiques” théoriques non éprouvées.
 
-Dernière mise à jour : 09-03-2026
+Dernière mise à jour : 12-03-2026
 
 ---
 
@@ -22,6 +22,7 @@ Dernière mise à jour : 09-03-2026
 - [Séparation claire server state / client state](#pattern-separation-server-state-client-state)
 - [Formulaire robuste avec validation et erreurs explicites](#pattern-formulaire-robuste)
 - [Navigation réactive post-action async (React / Expo Router)](#pattern-navigation-reactive-post-action-async)
+- [Refresh idempotent sur store de liste paginée](#pattern-refresh-idempotent-liste-paginee)
 
 ---
 
@@ -290,6 +291,51 @@ const handleOAuth = async () => {
 
 ---
 
+<a id="pattern-refresh-idempotent-liste-paginee"></a>
+## Pattern : Refresh idempotent sur store de liste paginée
+
+### Synthèse
+
+- **Objectif** : garantir qu’un pull-to-refresh recharge une liste paginée sans doublons, sans courses réseau et sans état intermédiaire incohérent.
+- **Contexte** : app mobile ou SPA avec store de domaine (ex. Zustand) et pagination incrémentale.
+- **Quand l’utiliser** : dès qu’une même liste supporte à la fois `loadMore` et `refresh`.
+- **Quand l’éviter** : listes purement statiques ou données entièrement remplacées sans pagination.
+
+### Analyse
+
+- **Avantages** :
+  - évite les doublons lors des refresh concurrents
+  - garde une transition atomique entre ancien et nouvel état
+  - rend le comportement async testable côté store
+- **Limites / vigilance** :
+  - impose une discipline claire entre `refresh` et `loadMore`
+  - demande une clé d’identité stable pour dédupliquer les items
+
+### Validation
+
+- Validé le : 10-03-2026
+- Contexte technique : React Native / Expo / Zustand / listes paginées
+
+### Implémentation (exemple minimal)
+
+```txt
+- conserver une promesse de refresh partagée tant qu’un refresh est en vol
+- refuser ou réutiliser tout refresh concurrent au lieu d’en lancer un second
+- remplacer atomiquement la liste à la fin du refresh
+- dédupliquer les items par identifiant au merge des pages suivantes
+- empêcher `loadMore` de fusionner sur un snapshot devenu obsolète
+```
+
+### Checklist
+
+- [ ] Une seule promesse de refresh en vol à la fois
+- [ ] `refresh` et `loadMore` ont des garde-fous explicites
+- [ ] La liste est remplacée atomiquement après refresh
+- [ ] Les pages suivantes sont dédupliquées par identifiant stable
+- [ ] Tests sur refresh concurrent + refresh suivi de pagination
+
+---
+
 ### Principes transverses
 
 - Un pattern = une responsabilité claire