Planerz - App mobile voyage entre amis

Application Flutter multiplateforme (Android, iOS, Web) pour centraliser la gestion d'un voyage entre amis:

• covoiturage
• courses
• planification des repas
• partage des depenses
• suggestion et planification d'activtés
• informations pratiques
• messagerie

Vision

Offrir un seul espace collaboratif pour preparer et suivre un voyage de groupe sans jongler entre plusieurs applis.

Stack technique cible

• Frontend: Flutter (Dart)
• Backend as a Service: Firebase
  • Authentication
  • Cloud Firestore
  • Cloud Functions (optionnel au debut)
  • Firebase Storage (pieces jointes, photos)
  • Firebase Cloud Messaging (notifications)

Demarrage rapide (nouvelle machine)

1. Prerequis systeme

• Installer Flutter SDK (canal stable) et ajouter <flutter>/bin au PATH.
• Installer Android Studio (inclut SDK Android, outils Gradle et JDK jbr).
• Sur Windows, activer Mode developpeur (plugins Flutter avec symlinks).
• Installer Node.js LTS (necessaire pour npm), puis la Firebase CLI:
  • npm install -g firebase-tools
• Installer Java 17+ (recommande: JDK inclus d'Android Studio: ...\Android Studio\jbr).
• Configurer les variables d'environnement Windows:
  • JAVA_HOME -> chemin du JDK sans \bin (ex: C:\Program Files\Android\Android Studio\jbr)
  • ajouter %JAVA_HOME%\bin au Path
  • ajouter C:\Users\<ton-user>\AppData\Local\Pub\Cache\bin au Path (pour flutterfire)
• Ouvrir un nouveau terminal et verifier:

flutter --version
dart --version
java -version
firebase --version

Verification complementaire recommandee sous Windows (utile si Gradle ne trouve pas Java):

echo $env:JAVA_HOME
where.exe java
java -version

Si where.exe java ne retourne rien:

• verifier que JAVA_HOME pointe bien vers le dossier JDK (pas ...\jbr\bin)
• verifier que %JAVA_HOME%\bin est present dans Path
• fermer completement Cursor/terminal puis reouvrir une nouvelle session

2. Cloner et installer les dependances

git clone <url-du-repo> Planerz
cd Planerz
flutter pub get

3. Auth Firebase / outils CLI

firebase login
dart pub global activate flutterfire_cli

Si flutterfire n'est pas reconnu, utiliser:

dart pub global run flutterfire_cli:flutterfire --version

4. Configurer Firebase (console)

Dans la console Firebase:

• Creer ou choisir le projet (ex: planerz)
• Authentication -> Sign-in method -> activer Google
• Firestore Database -> creer la base (mode dev/test)
• Creer les apps de plateforme necessaires (Android, iOS, Web)

5. Android: SHA-1/SHA-256 + google-services.json

Depuis android/:

./gradlew signingReport

.\gradlew signingReport

• Copier la valeur SHA1 (et idealement SHA-256) du variant debug.
• Firebase -> Project settings -> app Android -> Add fingerprint.
• Sur une nouvelle machine de dev physique, refaire cette etape: le keystore debug local peut changer, donc il faut ajouter les nouveaux fingerprints.
• Pour extraire les empreintes du keystore de signature (.jks) (release), utiliser keytool:

keytool -list -v -keystore ".\planerz-keystore.jks" -alias "planerz"

Si tu ne connais pas l'alias du keystore:

keytool -list -keystore ".\planerz-keystore.jks"

• Telecharger google-services.json apres ajout des fingerprints, puis le placer selon le flavor:
  • android/app/src/preview/google-services.json pour --flavor preview
  • android/app/src/prod/google-services.json pour --flavor prod

6. iOS: GoogleService-Info.plist

• Telecharger GoogleService-Info.plist depuis l'app iOS Firebase.
• Le placer dans ios/Runner/GoogleService-Info.plist.
• Verifier que ios/Runner/Info.plist contient CFBundleURLTypes avec le REVERSED_CLIENT_ID.

7. Lier Flutter au projet Firebase (FlutterFire, flavors preview/prod)

Ne pas utiliser une config unique (lib/firebase_options.dart) pour ce projet: on maintient explicitement deux fichiers:

• lib/firebase_options_preview.dart
• lib/firebase_options_prod.dart

Depuis la racine du projet, lancer les deux commandes suivantes:

dart pub global run flutterfire_cli:flutterfire configure --project=planerz-preview --out=lib/firebase_options_preview.dart --android-package-name=fr.centuryspine.planerz.preview --ios-bundle-id=fr.centuryspine.planerz.preview --yes

dart pub global run flutterfire_cli:flutterfire configure --project=planerz --out=lib/firebase_options_prod.dart --android-package-name=fr.centuryspine.planerz --ios-bundle-id=fr.centuryspine.planerz --yes

Notes importantes:

• Si FlutterFire propose de reutiliser des apps avec un mauvais package/bundle id, refuser et recreer les bonnes apps.
• Pour le web, il n'y a pas de package name Android/iOS, mais il faut garder une web app dediee par projet (planerz-preview vs planerz) et regenerer les options pour recuperer les bons appId/apiKey.
• Verifier ensuite que les fichiers Android restent bien separes par flavor:
  • android/app/src/preview/google-services.json
  • android/app/src/prod/google-services.json

8. Lancer l'application

flutter clean
flutter pub get
flutter run -d windows

Flux de test minimal:

• Ecran Connexion -> bouton Continuer avec Google
• Ecran Mes voyages
• Bouton Nouveau voyage -> creation visible dans Firestore (trips)
• Document utilisateur cree/maj dans Firestore (users/{uid})

Emulateurs Firebase (developpement local)

Le depot est configure pour parler aux emulateurs Auth, Firestore, Cloud Functions et Storage sur ta machine, uniquement quand tu compiles la cible preview avec le flag Dart USE_FIREBASE_EMULATOR=true (voir lib/core/firebase/firebase_emulator_wiring.dart). Les ports correspondent a firebase.json :

This is the beginning of the README. Read the rest at the original. Read the full README ↗