ajout doc interne a l'appli

- bouton ajouter
+ bouton effacer sur l'image de cible

CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [v0.0.1] - 2026-01-29
+
+### Ajouté
+-   **Interface d'Analyse** :
+    -   Implémentation d'un bouton de sauvegarde "Morphing" : le bouton flottant se transforme en un bouton large en bas de page lors du défilement.
+    -   Ajout de la gestion du défilement et de l'espacement pour une meilleure ergonomie.
+    -   Visualisation des impacts et statistiques de groupement.
+-   **Support Desktop (Windows)** :
+    -   Configuration de la base de données SQLite pour fonctionner sur Windows via `sqflite_common_ffi`.
+    -   Initialisation conditionnelle selon la plateforme.
+
+### Corrigé
+-   **Crash Windows** : Résolution du plantage dû à l'initialisation manquante de la factory de base de données FFI.
+-   **Dépendances** : Fixation de la version de `sqflite_common_ffi` à `2.3.3` pour contourner un problème de cache/corruption avec la version `2.4.0+2`.
+-   **UI/UX** :
+    -   Correction des débordements de texte ("zebra stripes") dans le bouton de sauvegarde lors de l'animation grâce à `FittedBox`.
+    -   Optimisation de l'affichage du titre "Groupement" dans les statistiques pour éviter les dépassements sur petits écrans.
+    -   Nettoyage des appels redondants (`super.initState`) et correction de la structure des widgets (`Stack` mal fermé).
+
+### Historique des Commits
+-   `db7160b` - +désactivation (2026-01-29)
+-   `f1a8eef` - ajout correctif (2026-01-28)
+-   `031d4a4` - premier app version beta (2026-01-18)

README.md

@@ -1,17 +1,35 @@
-# bully
+# Bully - Analyseur de Cible
 
-A new Flutter project.
+Application Flutter multiplateforme pour l'analyse et le suivi de vos séances de tir.
 
-## Getting Started
+## Fonctionnalités Principales
 
-This project is a starting point for a Flutter application.
+*   **Capture et Analyse** : Prenez une photo de votre cible et analysez vos impacts.
+*   **Détection Automatique** : Utilise des algorithmes pour détecter automatiquement les impacts de balle sur la cible.
+*   **Calibration** : Outils de calibration précis pour définir la taille et le centre de la cible, assurant des mesures exactes.
+*   **Statistiques Détaillées** :
+    *   Calcul du score total.
+    *   Analyse du groupement (H+L, diamètre moyen).
+    *   Visualisation graphique de la dispersion.
+*   **Historique** : Sauvegardez vos sessions avec des notes et consultez votre progression au fil du temps.
+*   **Interface Intuitive** : Design moderne et fluide, avec un bouton de sauvegarde dynamique qui s'adapte à votre navigation.
 
-A few resources to get you started if this is your first Flutter project:
+## Détails Techniques
 
-- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
-- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)
+*   **Framework** : Flutter (Compatible Android, iOS, Windows, Linux, macOS).
+*   **Base de Données** : SQLite (via `sqflite` et `sqflite_common_ffi` pour le support Desktop).
+*   **Graphiques** : `fl_chart` pour la visualisation des données.
+*   **Architecture** : Provider pour la gestion d'état.
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+## Installation
+
+1.  Assurez-vous d'avoir Flutter installé.
+2.  Clonez le dépôt.
+3.  Installez les dépendances :
+    ```bash
+    flutter pub get
+    ```
+4.  Lancez l'application :
+    ```bash
+    flutter run
+    ```

devtools_options.yaml

@@ -0,0 +1,3 @@
+description: This file stores settings for Dart & Flutter DevTools.
+documentation: https://docs.flutter.dev/tools/devtools/extensions#configure-extension-enablement-states
+extensions:

docs/README.md

@@ -0,0 +1,26 @@
+# Documentation du Projet Bully
+
+Bienvenue dans la documentation développeur de l'application **Bully**.
+
+Ce projet est une application Flutter d'analyse de cibles de tir (Impact Detection).
+
+## Architecture
+
+Le code source est organisé dans le dossier `lib/` selon les couches suivantes :
+
+- **Features (`lib/features`)** : Contient les écrans et la logique UI (Vues/Pages). C'est ici que réside l'interface utilisateur.
+- **Services (`lib/services`)** : Services "métier" et utilitaires (traitement d'image, calculs, etc.). Indépendant de l'UI.
+- **Data (`lib/data`)** : Gestion des données (Modèles, Base de données locale, Repositories).
+
+## Sections de la Documentation
+
+Pour plus de détails sur chaque partie, consultez les sections dédiées :
+
+- 🏗️ **[Services (Logique Métier)](services/README.md)** : Documentation des services comme le traitement d'image et le calcul de score.
+- 📱 **[Vues & Features (UI)](features/README.md)** : Documentation des écrans principaux (ex: Analyse).
+- 💾 **[Base de Données & Modèles](data/README.md)** : Structure des données et persistance.
+
+## Pour commencer
+
+1. Assurez-vous d'avoir Flutter installé.
+2. Lancez `flutter run` pour démarrer l'application.

docs/data/README.md

@@ -0,0 +1,17 @@
+# Data & Persistance
+
+Cette couche gère la sauvegarde et la récupération des données.
+
+## Base de Données
+L'application utilise une base de données locale (probablement SQLite/Drift ou Hive, à vérifier dans `lib/data/database`).
+
+## Modèles (`lib/data/models`)
+Les classes représentant les objets métier persistés.
+
+Exemples probables :
+- `Session` : Une session de tir.
+- `Impact` : Un impact de balle sur la cible.
+- `Target` : Configuration d'une cible.
+
+## Repositories (`lib/data/repositories`)
+Le pattern Repository est utilisé pour abstraire la source de données (DB locale, API distante, etc.) du reste de l'application.

docs/features/README.md

@@ -0,0 +1,17 @@
+# Features & Vues
+
+Cette section documente les écrans principaux de l'application et leur organisation.
+
+## Écrans Principaux
+
+### Analysis (`lib/features/analysis`)
+C'est le cœur de l'application. Il permet à l'utilisateur de prendre une photo ou choisir une image pour analyser les impacts.
+
+- **AnalysisScreen** (`analysis_screen.dart`): L'écran principal qui orchestre la capture et l'affichage des résultats.
+- **AnalysisProvider** (`analysis_provider.dart`): Gestionnaire d'état (State Management) pour cet écran. Il fait le pont entre la vue et les services.
+
+## Structure d'une Feature
+Chaque feature est généralement composée de :
+- `_screen.dart` : Le Widget de la page.
+- `_provider.dart` : La logique d'état (ChangeNotifier, Bloc, etc.).
+- `widgets/` : Widgets spécifiques à cette feature.

docs/services/README.md

@@ -0,0 +1,20 @@
+# Services
+
+Les services contiennent la logique métier de l'application, isolée de l'interface utilisateur.
+
+## Liste des Services Principaux
+
+| Service | Description | Fichier |
+| :--- | :--- | :--- |
+| **ImageProcessingService** | Gère le traitement lourd des images (filtres, détection). | `lib/services/image_processing_service.dart` |
+| **DistortionCorrection** | Corrige la distorsion de perspective des cibles. | `lib/services/distortion_correction_service.dart` |
+| **ScoreCalculator** | Calcule le score en fonction des impacts détectés. | `lib/services/score_calculator_service.dart` |
+| **StatisticsService** | Génère des statistiques sur les sessions de tir. | `lib/services/statistics_service.dart` |
+
+## Exemple d'utilisation (Fictif)
+
+```dart
+// Exemple d'appel au service de calcul de score
+final calculator = ScoreCalculatorService();
+final score = calculator.calculate(impacts);
+```

lib/features/analysis/analysis_provider.dart

@@ -34,11 +34,11 @@ class AnalysisProvider extends ChangeNotifier {
     required GroupingAnalyzerService groupingAnalyzerService,
     required SessionRepository sessionRepository,
     DistortionCorrectionService? distortionService,
-  })  : _detectionService = detectionService,
-        _scoreCalculatorService = scoreCalculatorService,
-        _groupingAnalyzerService = groupingAnalyzerService,
-        _sessionRepository = sessionRepository,
-        _distortionService = distortionService ?? DistortionCorrectionService();
+  }) : _detectionService = detectionService,
+       _scoreCalculatorService = scoreCalculatorService,
+       _groupingAnalyzerService = groupingAnalyzerService,
+       _sessionRepository = sessionRepository,
+       _distortionService = distortionService ?? DistortionCorrectionService();
 
   AnalysisState _state = AnalysisState.initial;
   String? _errorMessage;
@@ -80,7 +80,8 @@ class AnalysisProvider extends ChangeNotifier {
   double get targetCenterY => _targetCenterY;
   double get targetRadius => _targetRadius;
   int get ringCount => _ringCount;
-  List<double>? get ringRadii => _ringRadii != null ? List.unmodifiable(_ringRadii!) : null;
+  List<double>? get ringRadii =>
+      _ringRadii != null ? List.unmodifiable(_ringRadii!) : null;
   double get imageAspectRatio => _imageAspectRatio;
   List<Shot> get shots => List.unmodifiable(_shots);
   ScoreResult? get scoreResult => _scoreResult;
@@ -97,13 +98,22 @@ class AnalysisProvider extends ChangeNotifier {
   DistortionParameters? get distortionParams => _distortionParams;
   String? get correctedImagePath => _correctedImagePath;
   bool get hasDistortion => _distortionParams?.needsCorrection ?? false;
+
   /// Retourne le chemin de l'image à afficher (corrigée si activée, originale sinon)
-  String? get displayImagePath => _distortionCorrectionEnabled && _correctedImagePath != null
+  String? get displayImagePath =>
+      _distortionCorrectionEnabled && _correctedImagePath != null
       ? _correctedImagePath
       : _imagePath;
 
   /// Analyze an image
-  Future<void> analyzeImage(String imagePath, TargetType targetType) async {
+  ///
+  /// [autoAnalyze] determines if we should run automatic detection immediately.
+  /// If false, only the image is loaded and default target parameters are set.
+  Future<void> analyzeImage(
+    String imagePath,
+    TargetType targetType, {
+    bool autoAnalyze = true,
+  }) async {
     _state = AnalysisState.loading;
     _imagePath = imagePath;
     _targetType = targetType;
@@ -119,6 +129,20 @@ class AnalysisProvider extends ChangeNotifier {
       _imageAspectRatio = frame.image.width / frame.image.height;
       frame.image.dispose();
 
+      if (!autoAnalyze) {
+        // Just setup default values without running detection
+        _targetCenterX = 0.5;
+        _targetCenterY = 0.5;
+        _targetRadius = 0.4;
+
+        // Initialize empty shots list
+        _shots = [];
+
+        _state = AnalysisState.success;
+        notifyListeners();
+        return;
+      }
+
       // Detect target and impacts
       final result = _detectionService.detectTarget(imagePath, targetType);
 
@@ -162,13 +186,7 @@ class AnalysisProvider extends ChangeNotifier {
   /// Add a manual shot
   void addShot(double x, double y) {
     final score = _calculateShotScore(x, y);
-    final shot = Shot(
-      id: _uuid.v4(),
-      x: x,
-      y: y,
-      score: score,
-      sessionId: '',
-    );
+    final shot = Shot(id: _uuid.v4(), x: x, y: y, score: score, sessionId: '');
 
     _shots.add(shot);
     _recalculateScores();
@@ -190,11 +208,7 @@ class AnalysisProvider extends ChangeNotifier {
     if (index == -1) return;
 
     final newScore = _calculateShotScore(newX, newY);
-    _shots[index] = _shots[index].copyWith(
-      x: newX,
-      y: newY,
-      score: newScore,
-    );
+    _shots[index] = _shots[index].copyWith(x: newX, y: newY, score: newScore);
 
     _recalculateScores();
     _recalculateGrouping();
@@ -334,7 +348,9 @@ class AnalysisProvider extends ChangeNotifier {
     double tolerance = 2.0,
     bool clearExisting = false,
   }) async {
-    if (_imagePath == null || _targetType == null || _referenceImpacts.length < 2) {
+    if (_imagePath == null ||
+        _targetType == null ||
+        _referenceImpacts.length < 2) {
       return 0;
     }
 
@@ -343,16 +359,17 @@ class AnalysisProvider extends ChangeNotifier {
         .map((shot) => ReferenceImpact(x: shot.x, y: shot.y))
         .toList();
 
-    final detectedImpacts = _detectionService.detectImpactsWithOpenCVFromReferences(
-      _imagePath!,
-      _targetType!,
-      _targetCenterX,
-      _targetCenterY,
-      _targetRadius,
-      _ringCount,
-      references,
-      tolerance: tolerance,
-    );
+    final detectedImpacts = _detectionService
+        .detectImpactsWithOpenCVFromReferences(
+          _imagePath!,
+          _targetType!,
+          _targetCenterX,
+          _targetCenterY,
+          _targetRadius,
+          _ringCount,
+          references,
+          tolerance: tolerance,
+        );
 
     if (clearExisting) {
       _shots.clear();
@@ -381,13 +398,7 @@ class AnalysisProvider extends ChangeNotifier {
   /// Add a reference impact for calibrated detection
   void addReferenceImpact(double x, double y) {
     final score = _calculateShotScore(x, y);
-    final shot = Shot(
-      id: _uuid.v4(),
-      x: x,
-      y: y,
-      score: score,
-      sessionId: '',
-    );
+    final shot = Shot(id: _uuid.v4(), x: x, y: y, score: score, sessionId: '');
     _referenceImpacts.add(shot);
     notifyListeners();
   }
@@ -428,7 +439,9 @@ class AnalysisProvider extends ChangeNotifier {
     double tolerance = 2.0,
     bool clearExisting = false,
   }) async {
-    if (_imagePath == null || _targetType == null || _learnedCharacteristics == null) {
+    if (_imagePath == null ||
+        _targetType == null ||
+        _learnedCharacteristics == null) {
       return 0;
     }
 
@@ -468,7 +481,13 @@ class AnalysisProvider extends ChangeNotifier {
   }
 
   /// Adjust target position
-  void adjustTargetPosition(double centerX, double centerY, double radius, {int? ringCount, List<double>? ringRadii}) {
+  void adjustTargetPosition(
+    double centerX,
+    double centerY,
+    double radius, {
+    int? ringCount,
+    List<double>? ringRadii,
+  }) {
     _targetCenterX = centerX;
     _targetCenterY = centerY;
     _targetRadius = radius;
@@ -529,8 +548,7 @@ class AnalysisProvider extends ChangeNotifier {
     }
   }
 
-
-/* version deux a tester*/
+  /* version deux a tester*/
   /// Calcule ET applique la correction pour un feedback immédiat
   Future<void> calculateAndApplyDistortion() async {
     // 1. Calcul des paramètres (votre code actuel)
@@ -566,7 +584,7 @@ class AnalysisProvider extends ChangeNotifier {
       notifyListeners();
     }
   }
-/* fin section deux a tester*/
+  /* fin section deux a tester*/
 
   int _calculateShotScore(double x, double y) {
     if (_targetType == TargetType.concentric) {

lib/features/home/home_screen.dart

@@ -148,21 +148,27 @@ class _HomeScreenState extends State<HomeScreen> {
         Text(
           'Statistiques',
           style: Theme.of(context).textTheme.titleLarge?.copyWith(
-            fontWeight: FontWeight.bold,
-          ),
+                fontWeight: FontWeight.bold,
+              ),
         ),
         const SizedBox(height: 12),
         Row(
           children: [
+            // --- BOUTON SESSIONS (Redirige vers Statistiques) ---
             Expanded(
-              child: StatsCard(
-                icon: Icons.assessment,
-                title: 'Sessions',
-                value: '${_stats!['totalSessions']}',
-                color: AppTheme.primaryColor,
+              child: InkWell(
+                onTap: () => _navigateToStatistics(context),
+                borderRadius: BorderRadius.circular(AppConstants.borderRadius),
+                child: StatsCard(
+                  icon: Icons.assessment,
+                  title: 'Sessions',
+                  value: '${_stats!['totalSessions']}',
+                  color: AppTheme.primaryColor,
+                ),
               ),
             ),
             const SizedBox(width: 12),
+            // Ce bouton reste statique (ou tu peux ajouter une action)
             Expanded(
               child: StatsCard(
                 icon: Icons.gps_fixed,
@@ -176,15 +182,21 @@ class _HomeScreenState extends State<HomeScreen> {
         const SizedBox(height: 12),
         Row(
           children: [
+            // --- BOUTON SCORE MOYEN (Redirige vers Historique) ---
             Expanded(
-              child: StatsCard(
-                icon: Icons.trending_up,
-                title: 'Score Moyen',
-                value: (_stats!['averageScore'] as double).toStringAsFixed(1),
-                color: AppTheme.warningColor,
+              child: InkWell(
+                onTap: () => _navigateToHistory(context),
+                borderRadius: BorderRadius.circular(AppConstants.borderRadius),
+                child: StatsCard(
+                  icon: Icons.trending_up,
+                  title: 'Historique',
+                  value: (_stats!['averageScore'] as double).toStringAsFixed(1),
+                  color: AppTheme.warningColor,
+                ),
               ),
             ),
             const SizedBox(width: 12),
+            // Ce bouton reste statique
             Expanded(
               child: StatsCard(
                 icon: Icons.emoji_events,