🎵 Concertothèque

📌 Aperçu du projet

Concertothèque est une application de bureau (Windows, prioritaire) et mobile (Android / iOS) développée avec Flutter. Elle permet à un utilisateur de tenir un journal personnel de tous les concerts qu'il a assistés ou prévoit d'assister, en gérant les artistes, les salles et les statistiques associées.

Les données sont synchronisées en temps réel via Cloud Firestore et l'authentification est assurée par Firebase Auth. Des notifications locales rappellent les concerts à venir (J-7 et J-1).

✨ Fonctionnalités

Gestion des concerts

• Création / édition / suppression avec confirmation
• Types d'événement : Concert, Festival, Soirée, Showcase, Comédie musicale
• Placements : Fosse, Gradin, Catégorie 1–4, Carré Or
• Liaison à une salle (avec création inline) et à des artistes (multi-sélection)
• Images : affiche et couverture par URL
• Archivage automatique lorsque la date est passée
• Filtres avancés (nom, ville, artiste, type) + tri multi-colonnes
• Sélection multiple pour suppression groupée

Gestion des artistes & lieux

• CRUD complet avec pagination (25 éléments / page)
• Recherche instantanée par nom / genre
• Page de détail avec liste des concerts associés

Dashboard & statistiques

• Nombre total de concerts, à venir, archivés
• Total des dépenses (billets + dépenses supplémentaires)
• Top 5 artistes les plus vus (barres de progression)
• Top 5 salles les plus visitées
• Prochains concerts à venir

Notifications

• Rappels automatiques J-7 et J-1 au démarrage de l'app
• Notifications depuis Firestore Inbox (Firebase Console / Cloud Functions)
• Windows : Toast natif via flutter_local_notifications
• Mobile : FCM + flutter_local_notifications
• Anti-doublon via SharedPreferences

Fonctionnalités Windows spécifiques

• Icône dans la barre des tâches (system tray) avec menu contextuel
• Option "Minimiser dans le systray" au lieu de fermer
• Démarrage automatique au lancement de Windows (registre HKCU\…\Run)

Paramètres & compte

• Sélecteur de thème : Système / Clair / Sombre
• Modification du profil (nom d'affichage)
• Suppression de compte avec ré-authentification
• Export CSV séparé pour chaque collection
• Journalisation des erreurs (Crashlytics mobile, Firestore desktop)

🛠️ Stack technique

📁 Structure des fichiers

concertotheque_app/
├── lib/
│   ├── main.dart                         ← Point d'entrée, init Firebase & services
│   ├── app_settings.dart                 ← État global (thème, notifications, tray)
│   ├── firebase_options.dart             ← Clés Firebase par plateforme
│   │
│   ├── models/
│   │   ├── artiste.dart                  ← Modèle Artiste
│   │   ├── concert.dart                  ← Modèle Evenement (concert)
│   │   └── lieu.dart                     ← Modèle Lieu (salle)
│   │
│   ├── screens/
│   │   ├── login_screen.dart             ← Connexion email/password
│   │   ├── register_screen.dart          ← Inscription
│   │   ├── dashboard_screen.dart         ← Tableau de bord & statistiques
│   │   ├── concerts_screen.dart          ← Liste concerts (filtre, tri, multi-select)
│   │   ├── concert_detail_screen.dart    ← Détail d'un concert
│   │   ├── evenement_edit_screen.dart    ← Création / édition concert
│   │   ├── artistes_screen.dart          ← Liste artistes paginée
│   │   ├── artiste_detail_screen.dart    ← Détail artiste + concerts
│   │   ├── artiste_edit_screen.dart      ← Création / édition artiste
│   │   ├── lieux_screen.dart             ← Liste des salles
│   │   ├── lieu_detail_screen.dart       ← Détail salle + concerts
│   │   ├── lieu_edit_screen.dart         ← Création / édition salle
│   │   ├── settings_screen.dart          ← Paramètres app (4 sections)
│   │   └── about_screen.dart             ← À propos & debug
│   │
│   ├── services/
│   │   ├── evenement_service.dart        ← CRUD concerts (Firestore)
│   │   ├── artiste_service.dart          ← CRUD artistes (Firestore)
│   │   ├── lieu_service.dart             ← CRUD lieux (Firestore)
│   │   ├── notification_service.dart     ← Toast / FCM
│   │   ├── reminder_service.dart         ← Rappels J-7 / J-1
│   │   ├── inbox_service.dart            ← Listener Firestore inbox
│   │   ├── export_service.dart           ← Export CSV
│   │   ├── tray_service.dart             ← Systray Windows
│   │   ├── autostart_service.dart        ← Démarrage auto Windows
│   │   └── crash_logger.dart             ← Crashlytics / Firestore logs
│   │
│   └── widgets/
│       ├── main_layout.dart              ← Sidebar + zone contenu
│       └── artiste_picker_dialog.dart    ← Sélecteur artistes multi-choix
│
├── android/                              ← Config Android
├── ios/                                  ← Config iOS
├── macos/                                ← Config macOS
├── windows/                              ← Config Windows (runner, icône .ico)
├── web/                                  ← Config Web (limité)
├── linux/                                ← Config Linux
├── docs/                                 ← Documentation technique
│   ├── ARCHITECTURE.md
│   ├── BUILD_RELEASE.md
│   ├── FIREBASE.md
│   └── notifications.md
├── pubspec.yaml                          ← Dépendances & métadonnées app
├── firebase.json                         ← Config FlutterFire CLI
└── documentation.html                    ← Ce fichier

🗂️ Modèles de données

Artiste — lib/models/artiste.dart

// Méthodes
factory Artiste.fromDoc(DocumentSnapshot doc)
Map<String, dynamic> toMap()

Evenement (Concert) — lib/models/concert.dart

// Getter calculé
bool get isArchive => date.isBefore(DateTime.now());

// Codes types → libellés
const typeLabels = {
  'CON': 'Concert',  'FES': 'Festival',
  'SOI': 'Soirée',   'SHO': 'Showcase',  'COM': 'Comédie musicale'
};

// Codes placement → libellés
const placementLabels = {
  'FOSS': 'Fosse',  'GRAD': 'Gradin',
  'CAT1': 'Catégorie 1',  'CAT2': 'Catégorie 2',
  'CAT3': 'Catégorie 3',  'CAT4': 'Catégorie 4',
  'CARO': 'Carré Or'
};

Lieu (Salle) — lib/models/lieu.dart

⚙️ Services

Services de données Firestore

Les trois services (EvenementService, ArtisteService, LieuService) suivent le même patron :

• Collection : users/{uid}/{evenements|artistes|lieux}
• Pagination curseur : 25 éléments par page

NotificationService

Gère les notifications locales et push selon la plateforme :

ReminderService

Au démarrage de l'app, interroge Firestore pour les concerts dans les 7 prochains jours :

• Rappel à J-7 (clé SharedPreferences : {id}_j7)
• Rappel à J-1 (clé SharedPreferences : {id}_j1)
• Anti-doublon : les rappels déjà envoyés ne sont plus réémis

InboxService

Écoute la collection users/{uid}/inbox en temps réel :

• Déclenchement sur tout document avec read: false
• Marque automatiquement le document read: true après affichage
• Cycle de vie géré manuellement : start() / stop() (login/logout)

ExportService

• Exports CSV avec BOM UTF-8 (compatibilité Excel)
• Dialogue natif "Enregistrer sous" via file_picker
• Séparateur : virgule, valeurs entre guillemets si nécessaire
• Format date : ISO 8601 (YYYY-MM-DD)

TrayService Windows

• Singleton implémentant TrayListener et WindowListener
• Menu contextuel : "Ouvrir Concertothèque" / "Quitter"
• Intercepte la fermeture si minimizeToTray est activé
• Icône : windows/runner/resources/concertotheque.ico

AutostartService Windows

• Registre : HKCU\Software\Microsoft\Windows\CurrentVersion\Run
• Commande reg add / reg delete via Process.run
• Méthodes : isEnabled(), setEnabled(bool)

CrashLogger

• Mobile : délègue à Firebase Crashlytics
• Desktop : écrit dans users/{uid}/crash_logs (Firestore)
• Champs : error, stack, platform, fatal, timestamp
• Intégré dans runZonedGuarded (erreurs async non gérées)

📱 Écrans (Screens)

Authentification

Dashboard

DashboardScreen (dashboard_screen.dart) — page d'accueil après connexion :

• Compteurs : total concerts, à venir, archivés
• Total des dépenses (billets + dépenses supplémentaires)
• Artistes uniques et lieux uniques
• Top 5 artistes avec barres de progression (occurrences)
• Top 5 lieux visités
• Liste des prochains concerts (triés par date)

Concerts

Artistes

Lieux

Paramètres

SettingsScreen est divisé en 4 sections :

1. Apparence — sélecteur de thème (Système / Clair / Sombre)
2. Notifications — activation/désactivation, vérification permission OS, bouton test
3. Système — démarrage auto (Windows), minimiser dans systray (Windows)
4. Données — export CSV (concerts, artistes, lieux), modification profil, suppression compte

À propos

AboutScreen — icône app, version, développeur (Julien Gournay), liens GitHub, stack technologique, bouton debug crash.

🧩 Widgets

MainLayout — lib/widgets/main_layout.dart

Disposition principale de l'application (après authentification) :

• Sidebar fixe de 250 px + zone contenu extensible
• Logo + 6 entrées de navigation (Dashboard, Concerts, Artistes, Lieux, Paramètres, À propos)
• Indicateur de route active : bordure gauche orange + fond teinté
• Carte utilisateur en bas (initiale + email) + dialogue de déconnexion au clic
• Couleurs adaptatives light/dark
• Transitions de page sans animation (PageRouteBuilder)

ArtistePickerDialog — lib/widgets/artiste_picker_dialog.dart

Dialog modal pour la sélection multiple d'artistes :

• Champ de recherche filtrant par nom en temps réel
• Stream Firestore live (ArtisteService.stream())
• Checkbox avec accent orange pour chaque artiste
• Sous-titre = genre musical
• Badge indiquant le nombre de sélections
• Retourne List<String> (noms) ou null si annulé

🔥 Configuration Firebase

Projet Firebase : concertotheque

Services activés

• Firebase Authentication (email/password)
• Cloud Firestore
• Firebase Cloud Messaging (FCM)
• Firebase Crashlytics (mobile)

Règles Firestore recommandées

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId}/{document=**} {
      allow read, write: if request.auth != null
                         && request.auth.uid == userId;
    }
  }
}

🗄️ Structure Firestore

🔔 Système de notifications

Architecture

Trois canaux de notification coexistent :

1. Rappels automatiques (ReminderService)
   Au démarrage, interroge Firestore pour les concerts dans les 7 prochains jours. Envoie une notification J-7 et J-1. Résistant aux redémarrages grâce à SharedPreferences ({id}_j7 / {id}_j1).
2. Inbox Firestore (InboxService)
   Listener temps réel sur users/{uid}/inbox. Tout document read: false déclenche une notification et est marqué read: true. Utile pour les campagnes depuis Firebase Console ou Cloud Functions.
3. Push mobile (FCM)
   Firebase Cloud Messaging reçoit les messages push en arrière-plan sur Android/iOS. Le token FCM est récupérable via NotificationService.getToken().

Par plateforme

🎨 Thème & Couleurs

Couleurs principales

Couleurs par type d'événement

Configuration Material 3

ColorScheme.fromSeed(
  seedColor: Color(0xFFFF6B35),
  brightness: Brightness.dark,   // ou light selon le mode
)

Le mode thème est piloté par AppSettings.themeMode (ChangeNotifier). Il est appliqué via AnimatedBuilder dans main.dart et n'est pas persisté entre les sessions (retour à "Système" au redémarrage).

🗺️ Navigation

Flux d'authentification

1. Démarrage → LoginScreen (toujours, pas d'auto-login)
2. Connexion réussie → MainLayout + DashboardScreen
3. Déconnexion depuis la carte utilisateur → retour à LoginScreen

Navigation principale (Sidebar)

Navigation secondaire

• Clic sur un concert → ConcertDetailScreen
• Bouton "Modifier" → EvenementEditScreen
• Clic sur un artiste (depuis détail concert) → ArtisteDetailScreen
• Clic sur un lieu (depuis détail concert) → LieuDetailScreen
• FAB "+" dans chaque liste → écran d'édition correspondant

🏗️ Compilation

Prérequis

• Flutter SDK ≥ 3.x (flutter --version)
• Dart ≥ 3.0
• FlutterFire CLI (dart pub global activate flutterfire_cli)
• Pour Windows : Visual Studio 2022 + workload "Desktop development with C++"
• Pour Android : Android Studio + NDK
• Inno Setup 6 (optionnel, pour l'installeur .exe)

Commandes

# Installer les dépendances
flutter pub get

# Lancer en développement
flutter run -d windows
flutter run -d android

# Build release Windows
flutter build windows --release

# Build release Android (APK)
flutter build apk --release

# Build release Android (Bundle)
flutter build appbundle --release

# Regénérer les options Firebase
flutterfire configure

Installeur Windows (Inno Setup)

Après flutter build windows --release, l'exécutable se trouve dans build/windows/x64/runner/Release/. Inno Setup crée un installeur .exe avec raccourci bureau et désinstalleur.

📦 Dépendances

Firebase

Notifications

Desktop Windows

Utilitaires