EXPO_PUBLIC_FIREBASE_API_KEY=AIzaSy...
EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN=wallettracker-xxx.firebaseapp.com
EXPO_PUBLIC_FIREBASE_PROJECT_ID=wallettracker-xxx
EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET=wallettracker-xxx.appspot.com
EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=123456789
EXPO_PUBLIC_FIREBASE_APP_ID=1:123456789:web:abc123
EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID=G-XXXXXXXXXX

Vérifiez que .env est bien dans .gitignore (déjà fait par défaut)

⚠️ IMPORTANT : Ne commitez JAMAIS le fichier .env dans Git ! Il contient vos identifiants secrets.

Étape 4 : Activer Authentication

Dans la console Firebase, allez dans Authentication
Cliquez sur "Commencer"
Dans l'onglet Sign-in method, activez :
- Email/Password : Activez cette méthode
- Cliquez sur "Enregistrer"

Étape 5 : Créer la base de données Firestore

Dans la console Firebase, allez dans Firestore Database
Cliquez sur "Créer une base de données"
Sélectionnez Mode production
Choisissez un emplacement (par exemple : europe-west1 pour l'Europe)
Cliquez sur "Activer"

Étape 6 : Configurer les règles Firestore

Dans Firestore Database, allez dans l'onglet Règles
Copiez le contenu du fichier firestore.rules de ce projet
Collez-le dans l'éditeur de règles Firebase
Cliquez sur "Publier"

Les règles configurées permettent :

✅ Chaque utilisateur peut lire/écrire uniquement ses propres données
✅ Protection contre les accès non autorisés
✅ Validation des champs requis lors de la création

Étape 7 : Activer Storage (optionnel)

Pour stocker les photos de tickets :

Dans la console Firebase, allez dans Storage
Cliquez sur "Commencer"
Sélectionnez Mode production
Cliquez sur "Suivant" puis "Terminé"
Dans l'onglet Règles, utilisez ces règles :

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /users/{userId}/{allPaths=**} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

Étape 8 : Créer les index Firestore (si nécessaire)

Si vous rencontrez des erreurs de requête, Firebase vous fournira un lien pour créer automatiquement les index nécessaires.

Les index recommandés :

Collection `transactions`

Champs : userId (Ascending), date (Descending)
Champs : userId (Ascending), type (Ascending), date (Descending)
Champs : userId (Ascending), category (Ascending), date (Descending)

Collection `subscriptions`

Champs : userId (Ascending), nextPaymentDate (Ascending)

Étape 9 : Tester la configuration

Lancez l'application : npm start
Créez un compte de test
Vérifiez dans la console Firebase :
- Authentication : Votre utilisateur doit apparaître
- Firestore : Les collections doivent se créer automatiquement

🔐 Sécurité

Bonnes pratiques

Ne jamais commiter vos identifiants Firebase dans Git
- Le fichier .env est automatiquement ignoré par Git
- Vérifiez toujours avant de commit : git status
Utilisez des variables d'environnement
- Développement : fichier .env local
- Production : secrets EAS ou variables CI/CD
Activez l'authentification à deux facteurs sur votre compte Firebase
Surveillez l'utilisation dans la console Firebase
- Vérifiez régulièrement les utilisateurs authentifiés
- Surveillez les lectures/écritures Firestore
Configurez des alertes de budget
- Firebase Console > Utilisation et facturation > Détails et paramètres
- Définissez des alertes pour éviter les surprises

🚨 Si vos identifiants ont été exposés

Si vous avez accidentellement commité vos identifiants Firebase :

Régénérez immédiatement vos clés API :
- Firebase Console > Paramètres du projet > Clés API
- Supprimez l'ancienne clé
- Créez-en une nouvelle
- Mettez à jour votre fichier .env
Vérifiez les accès non autorisés :
- Firebase Console > Authentication > Utilisateurs
- Supprimez les comptes suspects
- Vérifiez les logs d'activité

Nettoyez l'historique Git (si nécessaire) :

# Attention : ceci réécrit l'historique Git
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch src/config/firebase.ts" \
  --prune-empty --tag-name-filter cat -- --all

Renforcez la sécurité :
- Activez App Check dans Firebase
- Restreignez les clés API par domaine/application
- Revoyez vos règles Firestore

Variables d'environnement pour la production

Pour déployer en production avec EAS :

# Créer les secrets EAS
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_API_KEY --value "votre_clé"
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN --value "votre_domaine"
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_PROJECT_ID --value "votre_projet"
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET --value "votre_bucket"
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID --value "votre_sender_id"
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_APP_ID --value "votre_app_id"
eas secret:create --scope project --name EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID --value "votre_measurement_id"

Limites du plan gratuit (Spark)

Firestore : 1 Go de stockage, 50k lectures/jour, 20k écritures/jour
Authentication : 10k vérifications/mois
Storage : 5 Go de stockage, 1 Go de téléchargement/jour

Pour une utilisation en production avec plusieurs utilisateurs, envisagez le plan Blaze (paiement à l'usage).

🆘 Dépannage

Erreur : "Firebase: Error (auth/invalid-api-key)"

Vérifiez que vous avez bien copié l'apiKey correctement
Assurez-vous qu'il n'y a pas d'espaces avant/après

Erreur : "Missing or insufficient permissions"

Vérifiez que les règles Firestore sont bien publiées
Assurez-vous que l'utilisateur est bien authentifié

Les catégories ne s'affichent pas

Vérifiez que l'utilisateur est connecté
Les catégories par défaut se créent automatiquement au premier ajout de transaction

📚 Ressources

✅ Checklist de configuration

Projet Firebase créé
Application Web ajoutée
Identifiants copiés dans firebase.ts
Authentication activée (Email/Password)
Firestore Database créée
Règles Firestore configurées
Storage activé (optionnel)
Application testée avec succès

Une fois toutes ces étapes complétées, votre application WalletTracker est prête à être utilisée ! 🎉

🔥 Guide de configuration Firebase

Étape 1 : Créer un projet Firebase

Étape 2 : Ajouter une application Web

Étape 3 : Configurer l'application

🔒 Configuration sécurisée avec variables d'environnement