docs: réorganisation et simplification de la documentation
- Fusion de Quick-Start.md dans Installation.md - Suppression des doublons dans Dépannage.md - Ajout d'une table des matières dans Dépannage.md - Simplification de la navigation dans Home.md - Enrichissement de la section sécurité dans Configuration-Firebase.md - Mise à jour du Changelog avec les correctifs de sécurité - Suppression de Quick-Start.md (fusionné) La documentation est maintenant plus claire avec moins de redirections.
@@ -7,6 +7,15 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).
|
|||||||
|
|
||||||
## [Non publié]
|
## [Non publié]
|
||||||
|
|
||||||
|
### Corrigé - 2025-10-23
|
||||||
|
|
||||||
|
- **Sécurité critique** : Identifiants Firebase déplacés vers des variables d'environnement
|
||||||
|
- Les clés API ne sont plus hardcodées dans le code
|
||||||
|
- Ajout du fichier `.env` au `.gitignore`
|
||||||
|
- Configuration via `process.env.EXPO_PUBLIC_*`
|
||||||
|
- Validation automatique des variables au démarrage
|
||||||
|
- Documentation mise à jour dans `Configuration-Firebase.md`
|
||||||
|
|
||||||
### À venir
|
### À venir
|
||||||
- Notifications push pour les rappels d'abonnements
|
- Notifications push pour les rappels d'abonnements
|
||||||
- Mode sombre
|
- Mode sombre
|
||||||
|
|||||||
@@ -20,19 +20,29 @@ Ce guide vous aidera à configurer Firebase pour WalletTracker.
|
|||||||
|
|
||||||
## Étape 3 : Configurer l'application
|
## Étape 3 : Configurer l'application
|
||||||
|
|
||||||
1. Ouvrez le fichier `src/config/firebase.ts`
|
### 🔒 Configuration sécurisée avec variables d'environnement
|
||||||
2. Remplacez les valeurs par défaut par vos identifiants Firebase :
|
|
||||||
|
|
||||||
```typescript
|
Pour des raisons de sécurité, les identifiants Firebase sont stockés dans des variables d'environnement.
|
||||||
const firebaseConfig = {
|
|
||||||
apiKey: "AIzaSy...", // Votre clé API
|
1. **Copiez le fichier d'exemple** :
|
||||||
authDomain: "wallettracker-xxx.firebaseapp.com",
|
```bash
|
||||||
projectId: "wallettracker-xxx",
|
cp .env.example .env
|
||||||
storageBucket: "wallettracker-xxx.appspot.com",
|
```
|
||||||
messagingSenderId: "123456789",
|
|
||||||
appId: "1:123456789:web:abc123"
|
2. **Remplissez vos identifiants Firebase** dans le fichier `.env` :
|
||||||
};
|
```env
|
||||||
```
|
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
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **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
|
## Étape 4 : Activer Authentication
|
||||||
|
|
||||||
@@ -110,10 +120,65 @@ Les index recommandés :
|
|||||||
### Bonnes pratiques
|
### Bonnes pratiques
|
||||||
|
|
||||||
1. **Ne jamais commiter vos identifiants Firebase** dans Git
|
1. **Ne jamais commiter vos identifiants Firebase** dans Git
|
||||||
2. Utilisez des variables d'environnement pour la production
|
- Le fichier `.env` est automatiquement ignoré par Git
|
||||||
3. Activez l'authentification à deux facteurs sur votre compte Firebase
|
- Vérifiez toujours avant de commit : `git status`
|
||||||
4. Surveillez l'utilisation dans la console Firebase
|
|
||||||
5. Configurez des alertes de budget
|
2. **Utilisez des variables d'environnement**
|
||||||
|
- Développement : fichier `.env` local
|
||||||
|
- Production : secrets EAS ou variables CI/CD
|
||||||
|
|
||||||
|
3. **Activez l'authentification à deux facteurs** sur votre compte Firebase
|
||||||
|
|
||||||
|
4. **Surveillez l'utilisation** dans la console Firebase
|
||||||
|
- Vérifiez régulièrement les utilisateurs authentifiés
|
||||||
|
- Surveillez les lectures/écritures Firestore
|
||||||
|
|
||||||
|
5. **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 :
|
||||||
|
|
||||||
|
1. **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`
|
||||||
|
|
||||||
|
2. **Vérifiez les accès non autorisés** :
|
||||||
|
- Firebase Console > Authentication > Utilisateurs
|
||||||
|
- Supprimez les comptes suspects
|
||||||
|
- Vérifiez les logs d'activité
|
||||||
|
|
||||||
|
3. **Nettoyez l'historique Git** (si nécessaire) :
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **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 :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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)
|
### Limites du plan gratuit (Spark)
|
||||||
|
|
||||||
|
|||||||
187
Dépannage.md
187
Dépannage.md
@@ -1,8 +1,20 @@
|
|||||||
# 🔧 Guide de dépannage - WalletTracker
|
# 🔧 Guide de dépannage
|
||||||
|
|
||||||
## Problème : L'app charge jusqu'au timeout après scan du QR code
|
Solutions aux problèmes courants de WalletTracker.
|
||||||
|
|
||||||
### ✅ Solutions appliquées
|
## 📝 Table des matières
|
||||||
|
|
||||||
|
1. [L'app ne charge pas / timeout](#app-ne-charge-pas)
|
||||||
|
2. [Erreurs Firebase](#erreurs-firebase)
|
||||||
|
3. [Erreurs de modules](#erreurs-modules)
|
||||||
|
4. [Problèmes réseau](#problemes-reseau)
|
||||||
|
5. [Commandes utiles](#commandes-utiles)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## <a name="app-ne-charge-pas"></a>🔴 L'app ne charge pas / timeout
|
||||||
|
|
||||||
|
### Solutions
|
||||||
|
|
||||||
1. **Mise à jour des dépendances incompatibles**
|
1. **Mise à jour des dépendances incompatibles**
|
||||||
```bash
|
```bash
|
||||||
@@ -18,7 +30,7 @@
|
|||||||
- Remplacé par un placeholder dans `AnalysisScreen`
|
- Remplacé par un placeholder dans `AnalysisScreen`
|
||||||
- Sera réactivé après configuration complète
|
- Sera réactivé après configuration complète
|
||||||
|
|
||||||
### 🚀 Relancer l'application
|
### Redémarrage complet
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Nettoyer le cache
|
# Nettoyer le cache
|
||||||
@@ -30,7 +42,7 @@ npm install
|
|||||||
npm start -- --clear
|
npm start -- --clear
|
||||||
```
|
```
|
||||||
|
|
||||||
### 📱 Vérifications réseau
|
## <a name="problemes-reseau"></a>🌐 Problèmes réseau
|
||||||
|
|
||||||
1. **Même réseau Wi-Fi**
|
1. **Même réseau Wi-Fi**
|
||||||
- Votre ordinateur et téléphone doivent être sur le même réseau
|
- Votre ordinateur et téléphone doivent être sur le même réseau
|
||||||
@@ -46,7 +58,7 @@ npm start -- --clear
|
|||||||
```
|
```
|
||||||
⚠️ Plus lent mais fonctionne même avec des réseaux différents
|
⚠️ Plus lent mais fonctionne même avec des réseaux différents
|
||||||
|
|
||||||
### 🔍 Diagnostic
|
### Diagnostic réseau
|
||||||
|
|
||||||
Si le problème persiste, vérifiez :
|
Si le problème persiste, vérifiez :
|
||||||
|
|
||||||
@@ -61,7 +73,7 @@ ping 192.168.1.132
|
|||||||
npm run web
|
npm run web
|
||||||
```
|
```
|
||||||
|
|
||||||
### 📊 Réactiver les graphiques (plus tard)
|
### Réactiver les graphiques
|
||||||
|
|
||||||
Une fois l'app fonctionnelle, pour réactiver les graphiques :
|
Une fois l'app fonctionnelle, pour réactiver les graphiques :
|
||||||
|
|
||||||
@@ -76,7 +88,7 @@ Une fois l'app fonctionnelle, pour réactiver les graphiques :
|
|||||||
|
|
||||||
3. Rebuild l'app
|
3. Rebuild l'app
|
||||||
|
|
||||||
### 🆘 Autres problèmes courants
|
## <a name="erreurs-modules"></a>⚠️ Erreurs de modules
|
||||||
|
|
||||||
#### Erreur "Unable to resolve module"
|
#### Erreur "Unable to resolve module"
|
||||||
```bash
|
```bash
|
||||||
@@ -96,13 +108,13 @@ npm start -- --clear
|
|||||||
- Redémarrez Expo Go
|
- Redémarrez Expo Go
|
||||||
- Rescannez le QR code
|
- Rescannez le QR code
|
||||||
|
|
||||||
### 💡 Conseils
|
## <a name="commandes-utiles"></a>💻 Commandes utiles
|
||||||
|
|
||||||
1. **Première fois** : Utilisez `npm start -- --clear` pour un démarrage propre
|
1. **Première fois** : Utilisez `npm start -- --clear` pour un démarrage propre
|
||||||
2. **Développement** : Le rechargement à chaud peut parfois causer des bugs, rechargez manuellement (secouer le téléphone > Reload)
|
2. **Développement** : Le rechargement à chaud peut parfois causer des bugs, rechargez manuellement (secouer le téléphone > Reload)
|
||||||
3. **Production** : Les graphiques fonctionneront mieux dans un build natif
|
3. **Production** : Les graphiques fonctionneront mieux dans un build natif
|
||||||
|
|
||||||
### 📞 Besoin d'aide ?
|
## 🆘 Besoin d'aide ?
|
||||||
|
|
||||||
Si le problème persiste :
|
Si le problème persiste :
|
||||||
|
|
||||||
@@ -110,6 +122,26 @@ Si le problème persiste :
|
|||||||
2. Regardez les erreurs dans Expo Go (secouer > Show Dev Menu > Debug)
|
2. Regardez les erreurs dans Expo Go (secouer > Show Dev Menu > Debug)
|
||||||
3. Consultez la documentation Expo : https://docs.expo.dev/
|
3. Consultez la documentation Expo : https://docs.expo.dev/
|
||||||
|
|
||||||
|
## <a name="erreurs-firebase"></a>🔥 Erreurs Firebase
|
||||||
|
|
||||||
|
### Configuration manquante
|
||||||
|
|
||||||
|
Si vous voyez l'erreur "Configuration Firebase manquante" :
|
||||||
|
|
||||||
|
1. Vérifiez que le fichier `.env` existe
|
||||||
|
2. Vérifiez que toutes les variables sont remplies
|
||||||
|
3. Redémarrez le serveur : `npm start -- --clear`
|
||||||
|
|
||||||
|
### Erreurs d'authentification
|
||||||
|
|
||||||
|
- **"auth/invalid-email"** : Vérifiez le format de l'email
|
||||||
|
- **"auth/user-not-found"** : Créez un compte d'abord
|
||||||
|
- **"auth/wrong-password"** : Vérifiez le mot de passe
|
||||||
|
|
||||||
|
Consultez **[[Configuration-Firebase]]** pour plus de détails.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## ✅ Checklist de vérification
|
## ✅ Checklist de vérification
|
||||||
|
|
||||||
- [ ] Dépendances mises à jour (`npx expo install --fix`)
|
- [ ] Dépendances mises à jour (`npx expo install --fix`)
|
||||||
@@ -122,138 +154,3 @@ Si le problème persiste :
|
|||||||
---
|
---
|
||||||
|
|
||||||
**L'app devrait maintenant se charger correctement ! 🎉**
|
**L'app devrait maintenant se charger correctement ! 🎉**
|
||||||
# ⚡ Corrections rapides - WalletTracker
|
|
||||||
|
|
||||||
## 🔴 L'app reste bloquée sur "New update available, downloading..."
|
|
||||||
|
|
||||||
### Solution rapide (30 secondes)
|
|
||||||
|
|
||||||
1. **Sur votre téléphone** :
|
|
||||||
- Fermez complètement Expo Go (swipe up)
|
|
||||||
- Rouvrez Expo Go
|
|
||||||
- Rescannez le QR code
|
|
||||||
|
|
||||||
2. **Si ça ne marche toujours pas** :
|
|
||||||
- Secouez le téléphone
|
|
||||||
- Appuyez sur "Go Home"
|
|
||||||
- Rescannez le QR code
|
|
||||||
|
|
||||||
3. **Dernière option** :
|
|
||||||
- Dans Expo Go : Profil (en bas à droite) → Settings → Clear cache
|
|
||||||
- Rescannez le QR code
|
|
||||||
|
|
||||||
### Solution définitive (appliquée)
|
|
||||||
|
|
||||||
J'ai désactivé les mises à jour automatiques dans `app.json`.
|
|
||||||
|
|
||||||
**Redémarrez le serveur** :
|
|
||||||
```bash
|
|
||||||
# Arrêtez le serveur (Ctrl+C)
|
|
||||||
npm start -- --clear
|
|
||||||
```
|
|
||||||
|
|
||||||
Puis **rescannez le QR code**.
|
|
||||||
|
|
||||||
## 🔴 Écran blanc / App ne charge pas
|
|
||||||
|
|
||||||
### 1. Vérifier le serveur Metro
|
|
||||||
|
|
||||||
Dans le terminal, vous devez voir :
|
|
||||||
```
|
|
||||||
› Metro waiting on exp://192.168.1.132:8081
|
|
||||||
```
|
|
||||||
|
|
||||||
Si ce n'est pas le cas :
|
|
||||||
```bash
|
|
||||||
npm start -- --clear
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. Vérifier la connexion réseau
|
|
||||||
|
|
||||||
- Téléphone et ordinateur sur le **même Wi-Fi**
|
|
||||||
- Pas de VPN actif
|
|
||||||
- Pare-feu autorise Expo (port 8081)
|
|
||||||
|
|
||||||
### 3. Mode tunnel (si problème réseau)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm start -- --tunnel
|
|
||||||
```
|
|
||||||
⚠️ Plus lent mais fonctionne même avec des réseaux différents
|
|
||||||
|
|
||||||
## 🔴 Erreur "Unable to resolve module"
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Nettoyer complètement
|
|
||||||
rm -rf node_modules
|
|
||||||
npm install
|
|
||||||
npm start -- --clear
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🔴 Erreur Firebase
|
|
||||||
|
|
||||||
Vérifiez `src/config/firebase.ts` :
|
|
||||||
- Les identifiants sont corrects
|
|
||||||
- Authentication est activée dans Firebase Console
|
|
||||||
- Firestore Database est créée
|
|
||||||
|
|
||||||
## 🔴 L'app crash au démarrage
|
|
||||||
|
|
||||||
1. **Regardez les logs** dans le terminal
|
|
||||||
2. **Vérifiez les erreurs** :
|
|
||||||
- Erreur Firebase → Configurez Firebase
|
|
||||||
- Erreur de module → Nettoyez le cache
|
|
||||||
- Erreur de syntaxe → Vérifiez le dernier commit
|
|
||||||
|
|
||||||
## 🔴 Bouton qui charge à l'infini
|
|
||||||
|
|
||||||
C'est corrigé ! Si ça persiste :
|
|
||||||
```bash
|
|
||||||
# Rechargez l'app
|
|
||||||
# Secouez le téléphone > Reload
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🔴 Les modifications ne s'appliquent pas
|
|
||||||
|
|
||||||
1. **Rechargement à chaud désactivé** :
|
|
||||||
- Secouez le téléphone
|
|
||||||
- Appuyez sur "Enable Fast Refresh"
|
|
||||||
|
|
||||||
2. **Forcer le rechargement** :
|
|
||||||
- Secouez le téléphone
|
|
||||||
- Appuyez sur "Reload"
|
|
||||||
|
|
||||||
3. **Nettoyer le cache** :
|
|
||||||
```bash
|
|
||||||
npm start -- --clear
|
|
||||||
```
|
|
||||||
|
|
||||||
## 📱 Commandes utiles
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Démarrage normal
|
|
||||||
npm start
|
|
||||||
|
|
||||||
# Avec cache nettoyé
|
|
||||||
npm start -- --clear
|
|
||||||
|
|
||||||
# Mode tunnel (problèmes réseau)
|
|
||||||
npm start -- --tunnel
|
|
||||||
|
|
||||||
# Réinstaller les dépendances
|
|
||||||
rm -rf node_modules && npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🆘 Toujours bloqué ?
|
|
||||||
|
|
||||||
1. **Vérifiez les logs** dans le terminal
|
|
||||||
2. **Consultez** `TROUBLESHOOTING.md` pour plus de détails
|
|
||||||
3. **Redémarrez tout** :
|
|
||||||
- Fermez Expo Go
|
|
||||||
- Arrêtez le serveur (Ctrl+C)
|
|
||||||
- Relancez : `npm start -- --clear`
|
|
||||||
- Rescannez le QR code
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Dans 99% des cas, un simple rechargement suffit ! 🚀**
|
|
||||||
|
|||||||
35
Home.md
35
Home.md
@@ -28,31 +28,30 @@ WalletTracker est une application mobile complète développée avec React Nativ
|
|||||||
- Statistiques mensuelles
|
- Statistiques mensuelles
|
||||||
- Vue d'ensemble du budget
|
- Vue d'ensemble du budget
|
||||||
|
|
||||||
## 🚀 Démarrage rapide
|
## 🚀 Démarrage
|
||||||
|
|
||||||
1. **[[Installation]]** - Installer le projet
|
**Nouveau sur le projet ?** Suivez ce parcours :
|
||||||
|
|
||||||
|
1. **[[Installation]]** - Installer et lancer en 5 minutes (ou installation complète)
|
||||||
2. **[[Configuration-Firebase]]** - Configurer Firebase
|
2. **[[Configuration-Firebase]]** - Configurer Firebase
|
||||||
3. **[[Quick-Start]]** - Lancer en 5 minutes
|
3. **[[Tests]]** - Tester l'application
|
||||||
|
|
||||||
## 📖 Documentation
|
## 📖 Documentation
|
||||||
|
|
||||||
### Pour commencer
|
### 🎯 Essentiel
|
||||||
- **[[Quick-Start]]** - Démarrage rapide en 5 minutes
|
- **[[Installation]]** - Installation rapide ou complète
|
||||||
- **[[Installation]]** - Installation complète
|
- **[[Configuration-Firebase]]** - Configuration Firebase détaillée
|
||||||
- **[[Configuration-Firebase]]** - Setup Firebase
|
- **[[Dépannage]]** - Solutions aux problèmes courants
|
||||||
|
|
||||||
### Développement
|
### 💻 Développement
|
||||||
- **[[Développement]]** - Architecture et structure
|
- **[[Développement]]** - Architecture et contribution
|
||||||
|
- **[[API-Reference]]** - Documentation technique des services
|
||||||
- **[[Tests]]** - Guide de test complet
|
- **[[Tests]]** - Guide de test complet
|
||||||
- **[[API-Reference]]** - Documentation des services
|
|
||||||
|
|
||||||
### Déploiement
|
### 🚀 Production
|
||||||
- **[[Déploiement]]** - Publication sur les stores
|
- **[[Déploiement]]** - Publication sur les stores
|
||||||
- **[[Changelog]]** - Historique des versions
|
- **[[Changelog]]** - Historique des versions
|
||||||
|
|
||||||
### Support
|
|
||||||
- **[[Dépannage]]** - Solutions aux problèmes courants
|
|
||||||
|
|
||||||
## 🛠️ Stack Technique
|
## 🛠️ Stack Technique
|
||||||
|
|
||||||
```
|
```
|
||||||
@@ -82,10 +81,12 @@ Librairies:
|
|||||||
- **Écrans** : 6 écrans principaux
|
- **Écrans** : 6 écrans principaux
|
||||||
- **TypeScript** : 100% typé
|
- **TypeScript** : 100% typé
|
||||||
|
|
||||||
## 🎯 Prochaines étapes
|
## 🎯 Par où commencer ?
|
||||||
|
|
||||||
Consultez **[[Quick-Start]]** pour démarrer immédiatement !
|
- **Débutant** : Commencez par **[[Installation]]** (section démarrage rapide)
|
||||||
|
- **Développeur** : Consultez **[[Développement]]** et **[[API-Reference]]**
|
||||||
|
- **Problème** : Allez directement à **[[Dépannage]]**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Version 1.0.0** | Dernière mise à jour : Octobre 2025
|
**Version 1.0.0** | Dernière mise à jour : Octobre 2024
|
||||||
@@ -1,8 +1,43 @@
|
|||||||
# 📦 Installation
|
# 📦 Installation et démarrage rapide
|
||||||
|
|
||||||
Guide d'installation complet de WalletTracker.
|
Guide complet pour installer et lancer WalletTracker.
|
||||||
|
|
||||||
## Prérequis
|
## 🚀 Démarrage rapide (5 minutes)
|
||||||
|
|
||||||
|
Vous voulez tester rapidement ? Suivez ces étapes :
|
||||||
|
|
||||||
|
### 1. Prérequis minimum
|
||||||
|
- Node.js v16+ installé
|
||||||
|
- Expo Go sur votre téléphone ([iOS](https://apps.apple.com/app/expo-go/id982107779) | [Android](https://play.google.com/store/apps/details?id=host.exp.exponent))
|
||||||
|
|
||||||
|
### 2. Installation express
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Cloner et installer
|
||||||
|
git clone git@git.fnix.fr:alempereur/WalletTracker.git
|
||||||
|
cd WalletTracker
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# Configurer Firebase (copiez vos identifiants)
|
||||||
|
cp .env.example .env
|
||||||
|
# Éditez .env avec vos identifiants Firebase
|
||||||
|
|
||||||
|
# Lancer l'app
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Scanner et tester
|
||||||
|
1. Scannez le QR code avec Expo Go
|
||||||
|
2. Créez un compte de test
|
||||||
|
3. Ajoutez votre première transaction !
|
||||||
|
|
||||||
|
**Pour la configuration Firebase détaillée** : consultez [[Configuration-Firebase]]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 Installation complète
|
||||||
|
|
||||||
|
### Prérequis détaillés
|
||||||
|
|
||||||
- **Node.js** v16 ou supérieur ([Télécharger](https://nodejs.org/))
|
- **Node.js** v16 ou supérieur ([Télécharger](https://nodejs.org/))
|
||||||
- **npm** ou **yarn**
|
- **npm** ou **yarn**
|
||||||
@@ -10,16 +45,16 @@ Guide d'installation complet de WalletTracker.
|
|||||||
- **Compte Firebase** (gratuit) ([Créer un compte](https://firebase.google.com/))
|
- **Compte Firebase** (gratuit) ([Créer un compte](https://firebase.google.com/))
|
||||||
- **Git** ([Télécharger](https://git-scm.com/))
|
- **Git** ([Télécharger](https://git-scm.com/))
|
||||||
|
|
||||||
## Installation
|
### Étapes d'installation
|
||||||
|
|
||||||
### 1. Cloner le projet
|
#### 1. Cloner le projet
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone git@git.fnix.fr:alempereur/WalletTracker.git
|
git clone git@git.fnix.fr:alempereur/WalletTracker.git
|
||||||
cd WalletTracker
|
cd WalletTracker
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2. Installer les dépendances
|
#### 2. Installer les dépendances
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm install
|
npm install
|
||||||
@@ -27,7 +62,7 @@ npm install
|
|||||||
|
|
||||||
Cette commande installera toutes les dépendances nécessaires listées dans `package.json`.
|
Cette commande installera toutes les dépendances nécessaires listées dans `package.json`.
|
||||||
|
|
||||||
### 3. Configurer Firebase
|
#### 3. Configurer Firebase
|
||||||
|
|
||||||
Consultez le guide **[[Configuration-Firebase]]** pour les détails complets.
|
Consultez le guide **[[Configuration-Firebase]]** pour les détails complets.
|
||||||
|
|
||||||
@@ -38,7 +73,7 @@ Consultez le guide **[[Configuration-Firebase]]** pour les détails complets.
|
|||||||
4. Créez une base Firestore
|
4. Créez une base Firestore
|
||||||
5. Configurez les règles de sécurité
|
5. Configurez les règles de sécurité
|
||||||
|
|
||||||
### 4. Vérifier l'installation
|
#### 4. Vérifier l'installation
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Vérifier que tout est installé
|
# Vérifier que tout est installé
|
||||||
@@ -48,7 +83,7 @@ npm run check
|
|||||||
npx tsc --noEmit
|
npx tsc --noEmit
|
||||||
```
|
```
|
||||||
|
|
||||||
### 5. Lancer l'application
|
#### 5. Lancer l'application
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm start
|
npm start
|
||||||
@@ -56,7 +91,7 @@ npm start
|
|||||||
|
|
||||||
Un QR code s'affichera dans le terminal.
|
Un QR code s'affichera dans le terminal.
|
||||||
|
|
||||||
### 6. Tester sur votre appareil
|
#### 6. Tester sur votre appareil
|
||||||
|
|
||||||
**Sur téléphone** :
|
**Sur téléphone** :
|
||||||
1. Ouvrez Expo Go
|
1. Ouvrez Expo Go
|
||||||
@@ -169,19 +204,21 @@ npm start
|
|||||||
npm start -- --no-dev --minify
|
npm start -- --no-dev --minify
|
||||||
```
|
```
|
||||||
|
|
||||||
## Prochaines étapes
|
## 📚 Prochaines étapes
|
||||||
|
|
||||||
- **[[Quick-Start]]** - Démarrage rapide
|
Maintenant que l'installation est terminée :
|
||||||
- **[[Configuration-Firebase]]** - Configurer Firebase
|
|
||||||
- **[[Tests]]** - Tester l'application
|
1. **[[Configuration-Firebase]]** - Configurer Firebase en détail
|
||||||
- **[[Développement]]** - Comprendre l'architecture
|
2. **[[Tests]]** - Tester toutes les fonctionnalités
|
||||||
|
3. **[[Développement]]** - Comprendre l'architecture du code
|
||||||
|
4. **[[Déploiement]]** - Publier sur les stores
|
||||||
|
|
||||||
## 🆘 Besoin d'aide ?
|
## 🆘 Besoin d'aide ?
|
||||||
|
|
||||||
- **[[Dépannage]]** - Solutions aux problèmes courants
|
- **[[Dépannage]]** - Solutions aux problèmes courants
|
||||||
- **[[Quick-Start]]** - Guide rapide
|
|
||||||
- Documentation Expo : https://docs.expo.dev/
|
- Documentation Expo : https://docs.expo.dev/
|
||||||
|
- Documentation Firebase : https://firebase.google.com/docs
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Installation terminée ! Passez à [[Quick-Start]] pour lancer l'app. 🚀**
|
**Installation terminée ! L'app devrait maintenant fonctionner. 🎉**
|
||||||
|
|||||||
162
Quick-Start.md
162
Quick-Start.md
@@ -1,162 +0,0 @@
|
|||||||
# 🚀 Démarrage rapide - WalletTracker
|
|
||||||
|
|
||||||
Guide pour lancer l'application en 5 minutes.
|
|
||||||
|
|
||||||
## Étape 1 : Vérifier les prérequis
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Vérifier Node.js (v16+)
|
|
||||||
node --version
|
|
||||||
|
|
||||||
# Vérifier npm
|
|
||||||
npm --version
|
|
||||||
```
|
|
||||||
|
|
||||||
## Étape 2 : Installer les dépendances
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd WalletTracker
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
## Étape 3 : Configurer Firebase
|
|
||||||
|
|
||||||
### Option A : Configuration rapide (pour tester)
|
|
||||||
|
|
||||||
1. Allez sur https://console.firebase.google.com/
|
|
||||||
2. Créez un nouveau projet "WalletTracker"
|
|
||||||
3. Ajoutez une application Web
|
|
||||||
4. Copiez les identifiants dans `src/config/firebase.ts`
|
|
||||||
|
|
||||||
### Option B : Configuration complète
|
|
||||||
|
|
||||||
Suivez le guide détaillé dans **[[Configuration-Firebase]]**
|
|
||||||
|
|
||||||
## Étape 4 : Lancer l'application
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm start
|
|
||||||
```
|
|
||||||
|
|
||||||
Vous verrez un QR code s'afficher dans le terminal.
|
|
||||||
|
|
||||||
## Étape 5 : Tester sur votre téléphone
|
|
||||||
|
|
||||||
### Sur iOS ou Android :
|
|
||||||
|
|
||||||
1. Téléchargez **Expo Go** depuis l'App Store ou Google Play
|
|
||||||
2. Ouvrez Expo Go
|
|
||||||
3. Scannez le QR code affiché dans le terminal
|
|
||||||
4. L'application se chargera automatiquement
|
|
||||||
|
|
||||||
### Sur émulateur :
|
|
||||||
|
|
||||||
**iOS (Mac uniquement)** :
|
|
||||||
```bash
|
|
||||||
npm run ios
|
|
||||||
```
|
|
||||||
|
|
||||||
**Android** :
|
|
||||||
```bash
|
|
||||||
npm run android
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🎉 C'est prêt !
|
|
||||||
|
|
||||||
Vous devriez voir l'écran de connexion de WalletTracker.
|
|
||||||
|
|
||||||
### Première utilisation :
|
|
||||||
|
|
||||||
1. Cliquez sur **"Créer un compte"**
|
|
||||||
2. Remplissez le formulaire :
|
|
||||||
- Nom : Votre nom
|
|
||||||
- Email : votre@email.com
|
|
||||||
- Mot de passe : minimum 6 caractères
|
|
||||||
3. Cliquez sur **"Créer mon compte"**
|
|
||||||
4. Vous êtes redirigé vers le Dashboard !
|
|
||||||
|
|
||||||
### Ajouter votre première transaction :
|
|
||||||
|
|
||||||
1. Cliquez sur le bouton **"Dépense"** ou **"Revenu"**
|
|
||||||
2. Entrez le montant
|
|
||||||
3. Sélectionnez une catégorie
|
|
||||||
4. Ajoutez une note (optionnel)
|
|
||||||
5. Cliquez sur **"Ajouter la transaction"**
|
|
||||||
|
|
||||||
## 📱 Commandes utiles
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Lancer l'application
|
|
||||||
npm start
|
|
||||||
|
|
||||||
# Lancer sur iOS
|
|
||||||
npm run ios
|
|
||||||
|
|
||||||
# Lancer sur Android
|
|
||||||
npm run android
|
|
||||||
|
|
||||||
# Lancer sur le web
|
|
||||||
npm run web
|
|
||||||
|
|
||||||
# Nettoyer le cache
|
|
||||||
npm start -- --clear
|
|
||||||
|
|
||||||
# Mode tunnel (problèmes réseau)
|
|
||||||
npm start -- --tunnel
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🐛 Problèmes courants
|
|
||||||
|
|
||||||
### L'application ne se lance pas
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Nettoyer et réinstaller
|
|
||||||
rm -rf node_modules
|
|
||||||
npm install
|
|
||||||
npm start -- --clear
|
|
||||||
```
|
|
||||||
|
|
||||||
### Erreur Firebase
|
|
||||||
|
|
||||||
Vérifiez que vous avez bien :
|
|
||||||
- Copié les identifiants Firebase dans `src/config/firebase.ts`
|
|
||||||
- Activé Authentication (Email/Password) dans Firebase Console
|
|
||||||
- Créé la base de données Firestore
|
|
||||||
|
|
||||||
### QR code ne fonctionne pas
|
|
||||||
|
|
||||||
- Assurez-vous que votre téléphone et ordinateur sont sur le même réseau Wi-Fi
|
|
||||||
- Essayez de scanner avec l'appareil photo puis ouvrir avec Expo Go
|
|
||||||
- Utilisez le mode tunnel : `npm start -- --tunnel`
|
|
||||||
|
|
||||||
### L'app reste bloquée sur "downloading..."
|
|
||||||
|
|
||||||
1. Fermez complètement Expo Go
|
|
||||||
2. Supprimez WalletTracker de la liste des projets dans Expo Go
|
|
||||||
3. Rescannez le QR code
|
|
||||||
|
|
||||||
Consultez **[[Dépannage]]** pour plus de solutions.
|
|
||||||
|
|
||||||
## 📚 Prochaines étapes
|
|
||||||
|
|
||||||
- **[[Installation]]** - Installation complète
|
|
||||||
- **[[Configuration-Firebase]]** - Configuration Firebase détaillée
|
|
||||||
- **[[Tests]]** - Tester toutes les fonctionnalités
|
|
||||||
- **[[Développement]]** - Comprendre l'architecture
|
|
||||||
|
|
||||||
## 💡 Conseils
|
|
||||||
|
|
||||||
- **Développement** : Utilisez `npm start` et Expo Go pour un rechargement rapide
|
|
||||||
- **Production** : Utilisez EAS Build pour créer des binaires iOS/Android
|
|
||||||
- **Débogage** : Secouez votre téléphone pour ouvrir le menu de développement
|
|
||||||
|
|
||||||
## 🆘 Besoin d'aide ?
|
|
||||||
|
|
||||||
- **[[Dépannage]]** - Solutions aux problèmes courants
|
|
||||||
- Documentation Expo : https://docs.expo.dev/
|
|
||||||
- Documentation Firebase : https://firebase.google.com/docs
|
|
||||||
- React Native : https://reactnative.dev/docs/getting-started
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Bon développement ! 💪**
|
|
||||||
Reference in New Issue
Block a user