feat: Version 3.3.5 - Optimisations pages, améliorations ergonomie et affichages dynamiques stats

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

app/docs/README-APP.md

@@ -950,6 +950,107 @@ Chaque amicale dispose de son **propre compte Stripe Connect** :
 9. Vérification statut compte
 10. Affichage "✅ Compte actif"
 
+### 🔑 Configuration des clés API Stripe par environnement
+
+GEOSECTOR utilise des **clés Stripe différentes** selon l'environnement pour séparer les données de test et de production.
+
+#### **Fichier de configuration**
+
+`/home/pierre/dev/geosector/api/src/Config/AppConfig.php`
+
+#### **Répartition des clés par environnement**
+
+| Environnement | URL | Plateforme Stripe | Clés utilisées | Mode | Usage |
+|---------------|-----|-------------------|----------------|------|-------|
+| **DEV** | `dapp.geosector.fr` | Test Pierre | `pk_test_51QwoVN...`<br>`sk_test_51QwoVN...` | `test` | Développement |
+| **REC** | `rapp.geosector.fr` | Test Client | `CLIENT_PK_TEST_A_REMPLACER`<br>`CLIENT_SK_TEST_A_REMPLACER` | `test` | Recette |
+| **PROD** | `app.geosector.fr` | Live Client | `CLIENT_PK_LIVE_A_REMPLACER`<br>`CLIENT_SK_LIVE_A_REMPLACER` | `live` | Production |
+
+#### **Types de clés Stripe**
+
+**Clés obligatoires (2) :**
+
+| Clé | Format | Où la trouver | Utilisation |
+|-----|--------|---------------|-------------|
+| **Publishable key** | `pk_test_51XXXXX...` ou `pk_live_XXXXX...` | Dashboard → Developers → API Keys | Client-side (Flutter app) |
+| **Secret key** | `sk_test_51XXXXX...` ou `sk_live_XXXXX...` | Dashboard → Developers → API Keys (révéler) | Server-side (API PHP) |
+
+**Clé optionnelle :**
+
+| Clé | Format | Où la trouver | Utilisation |
+|-----|--------|---------------|-------------|
+| **Webhook secret** | `whsec_test_XXXXX...` ou `whsec_live_XXXXX...` | Dashboard → Webhooks → Endpoint → Signing secret | Validation webhooks (non utilisé actuellement) |
+
+#### **Récupération des clés client**
+
+Pour configurer REC et PROD, le client doit fournir ses clés depuis son **Dashboard Stripe** :
+
+**Pour REC (clés TEST) :**
+1. Se connecter sur https://dashboard.stripe.com/test/apikeys
+2. Copier la **Publishable key** → `CLIENT_PK_TEST_A_REMPLACER`
+3. Révéler et copier la **Secret key** → `CLIENT_SK_TEST_A_REMPLACER`
+
+**Pour PROD (clés LIVE) :**
+1. Se connecter sur https://dashboard.stripe.com/apikeys (mode live)
+2. Copier la **Publishable key** → `CLIENT_PK_LIVE_A_REMPLACER`
+3. Révéler et copier la **Secret key** → `CLIENT_SK_LIVE_A_REMPLACER`
+
+#### **Configuration dans AppConfig.php**
+
+**Structure du fichier :**
+
+```php
+// Configuration DÉVELOPPEMENT (dapp.geosector.fr)
+'stripe' => [
+  'public_key_test' => 'pk_test_51QwoVN...', // Clés Pierre (opérationnel)
+  'secret_key_test' => 'sk_test_51QwoVN...',
+  'mode' => 'test',
+],
+
+// Configuration RECETTE (rapp.geosector.fr)
+'stripe' => [
+  'public_key_test' => 'CLIENT_PK_TEST_A_REMPLACER', // À remplacer
+  'secret_key_test' => 'CLIENT_SK_TEST_A_REMPLACER', // À remplacer
+  'mode' => 'test',
+],
+
+// Configuration PRODUCTION (app.geosector.fr)
+'stripe' => [
+  'public_key_live' => 'CLIENT_PK_LIVE_A_REMPLACER', // À remplacer
+  'secret_key_live' => 'CLIENT_SK_LIVE_A_REMPLACER', // À remplacer
+  'mode' => 'live',
+],
+```
+
+#### **Points importants**
+
+⚠️ **Isolation des environnements** :
+- DEV utilise la plateforme de test de Pierre (développement isolé)
+- REC utilise la plateforme de test du client (tests en conditions réelles)
+- PROD utilise la plateforme live du client (vraies transactions)
+
+⚠️ **Sécurité** :
+- Ne JAMAIS commiter les vraies clés dans Git
+- Vérifier que `AppConfig.php` est dans `.gitignore`
+- Les clés secrètes ne doivent jamais être exposées côté client
+
+⚠️ **Mode de fonctionnement** :
+- L'API détecte automatiquement l'environnement via l'URL
+- Le `mode` (`test` ou `live`) détermine quelle paire de clés utiliser
+- En mode `test` : utilise `public_key_test` et `secret_key_test`
+- En mode `live` : utilise `public_key_live` et `secret_key_live`
+
+#### **Déploiement après modification**
+
+Après avoir remplacé les placeholders par les vraies clés :
+
+```bash
+cd /home/pierre/dev/geosector/api
+./deploy-api.sh
+```
+
+L'API sera redéployée sur l'environnement correspondant avec les nouvelles clés.
+
 ### 📱 Tap to Pay V2 - Paiement sans contact
 
 #### **Fonctionnalités prévues**