Refactoring

unionflow-mobile-apps/lib/features/analytics/domain/entities/analytics_data.dart

@@ -0,0 +1,323 @@
+import 'package:equatable/equatable.dart';
+
+/// Énumération des types de métriques disponibles
+enum TypeMetrique {
+  // Métriques membres
+  nombreMembresActifs('Nombre de membres actifs', 'membres', 'count'),
+  nombreMembresInactifs('Nombre de membres inactifs', 'membres', 'count'),
+  tauxCroissanceMembres('Taux de croissance des membres', 'membres', 'percentage'),
+  moyenneAgeMembres('Âge moyen des membres', 'membres', 'average'),
+  
+  // Métriques financières
+  totalCotisationsCollectees('Total des cotisations collectées', 'finance', 'amount'),
+  cotisationsEnAttente('Cotisations en attente', 'finance', 'amount'),
+  tauxRecouvrementCotisations('Taux de recouvrement', 'finance', 'percentage'),
+  moyenneCotisationMembre('Cotisation moyenne par membre', 'finance', 'average'),
+  
+  // Métriques événements
+  nombreEvenementsOrganises('Nombre d\'événements organisés', 'evenements', 'count'),
+  tauxParticipationEvenements('Taux de participation aux événements', 'evenements', 'percentage'),
+  moyenneParticipantsEvenement('Moyenne de participants par événement', 'evenements', 'average'),
+  
+  // Métriques solidarité
+  nombreDemandesAide('Nombre de demandes d\'aide', 'solidarite', 'count'),
+  montantAidesAccordees('Montant des aides accordées', 'solidarite', 'amount'),
+  tauxApprobationAides('Taux d\'approbation des aides', 'solidarite', 'percentage');
+
+  const TypeMetrique(this.libelle, this.categorie, this.typeValeur);
+
+  final String libelle;
+  final String categorie;
+  final String typeValeur;
+
+  /// Retourne l'unité de mesure appropriée
+  String get unite {
+    switch (typeValeur) {
+      case 'percentage':
+        return '%';
+      case 'amount':
+        return 'XOF';
+      case 'average':
+        return typeValeur == 'moyenneAgeMembres' ? 'ans' : '';
+      default:
+        return '';
+    }
+  }
+
+  /// Retourne l'icône Material Design appropriée
+  String get icone {
+    switch (categorie) {
+      case 'membres':
+        return 'people';
+      case 'finance':
+        return 'attach_money';
+      case 'evenements':
+        return 'event';
+      case 'solidarite':
+        return 'favorite';
+      default:
+        return 'analytics';
+    }
+  }
+
+  /// Retourne la couleur appropriée
+  String get couleur {
+    switch (categorie) {
+      case 'membres':
+        return '#2196F3';
+      case 'finance':
+        return '#4CAF50';
+      case 'evenements':
+        return '#FF9800';
+      case 'solidarite':
+        return '#E91E63';
+      default:
+        return '#757575';
+    }
+  }
+}
+
+/// Énumération des périodes d'analyse
+enum PeriodeAnalyse {
+  aujourdHui('Aujourd\'hui', 'today'),
+  hier('Hier', 'yesterday'),
+  cetteSemaine('Cette semaine', 'this_week'),
+  semaineDerniere('Semaine dernière', 'last_week'),
+  ceMois('Ce mois', 'this_month'),
+  moisDernier('Mois dernier', 'last_month'),
+  troisDerniersMois('3 derniers mois', 'last_3_months'),
+  sixDerniersMois('6 derniers mois', 'last_6_months'),
+  cetteAnnee('Cette année', 'this_year'),
+  anneeDerniere('Année dernière', 'last_year'),
+  septDerniersJours('7 derniers jours', 'last_7_days'),
+  trenteDerniersJours('30 derniers jours', 'last_30_days'),
+  periodePersonnalisee('Période personnalisée', 'custom');
+
+  const PeriodeAnalyse(this.libelle, this.code);
+
+  final String libelle;
+  final String code;
+
+  /// Vérifie si la période est courte (moins d'un mois)
+  bool get isPeriodeCourte {
+    return [
+      aujourdHui,
+      hier,
+      cetteSemaine,
+      semaineDerniere,
+      septDerniersJours
+    ].contains(this);
+  }
+
+  /// Vérifie si la période est longue (plus d'un an)
+  bool get isPeriodeLongue {
+    return [cetteAnnee, anneeDerniere].contains(this);
+  }
+}
+
+/// Entité représentant une donnée analytics
+class AnalyticsData extends Equatable {
+  const AnalyticsData({
+    required this.id,
+    required this.typeMetrique,
+    required this.periodeAnalyse,
+    required this.valeur,
+    this.valeurPrecedente,
+    this.pourcentageEvolution,
+    required this.dateDebut,
+    required this.dateFin,
+    required this.dateCalcul,
+    this.organisationId,
+    this.nomOrganisation,
+    this.utilisateurId,
+    this.nomUtilisateur,
+    this.libellePersonnalise,
+    this.description,
+    this.donneesDetaillees,
+    this.configurationGraphique,
+    this.metadonnees,
+    this.indicateurFiabilite = 95.0,
+    this.nombreElementsAnalyses,
+    this.tempsCalculMs,
+    this.tempsReel = false,
+    this.necessiteMiseAJour = false,
+    this.niveauPriorite = 3,
+    this.tags,
+  });
+
+  final String id;
+  final TypeMetrique typeMetrique;
+  final PeriodeAnalyse periodeAnalyse;
+  final double valeur;
+  final double? valeurPrecedente;
+  final double? pourcentageEvolution;
+  final DateTime dateDebut;
+  final DateTime dateFin;
+  final DateTime dateCalcul;
+  final String? organisationId;
+  final String? nomOrganisation;
+  final String? utilisateurId;
+  final String? nomUtilisateur;
+  final String? libellePersonnalise;
+  final String? description;
+  final String? donneesDetaillees;
+  final String? configurationGraphique;
+  final Map<String, dynamic>? metadonnees;
+  final double indicateurFiabilite;
+  final int? nombreElementsAnalyses;
+  final int? tempsCalculMs;
+  final bool tempsReel;
+  final bool necessiteMiseAJour;
+  final int niveauPriorite;
+  final List<String>? tags;
+
+  /// Retourne le libellé à afficher
+  String get libelleAffichage {
+    return libellePersonnalise?.isNotEmpty == true
+        ? libellePersonnalise!
+        : typeMetrique.libelle;
+  }
+
+  /// Retourne l'unité de mesure
+  String get unite => typeMetrique.unite;
+
+  /// Retourne l'icône
+  String get icone => typeMetrique.icone;
+
+  /// Retourne la couleur
+  String get couleur => typeMetrique.couleur;
+
+  /// Vérifie si la métrique a évolué positivement
+  bool get hasEvolutionPositive {
+    return pourcentageEvolution != null && pourcentageEvolution! > 0;
+  }
+
+  /// Vérifie si la métrique a évolué négativement
+  bool get hasEvolutionNegative {
+    return pourcentageEvolution != null && pourcentageEvolution! < 0;
+  }
+
+  /// Vérifie si la métrique est stable
+  bool get isStable {
+    return pourcentageEvolution != null && pourcentageEvolution! == 0;
+  }
+
+  /// Retourne la tendance sous forme de texte
+  String get tendance {
+    if (hasEvolutionPositive) return 'hausse';
+    if (hasEvolutionNegative) return 'baisse';
+    return 'stable';
+  }
+
+  /// Vérifie si les données sont fiables
+  bool get isDonneesFiables => indicateurFiabilite >= 80.0;
+
+  /// Vérifie si la métrique est critique
+  bool get isCritique => niveauPriorite >= 4;
+
+  /// Formate la valeur avec l'unité appropriée
+  String get valeurFormatee {
+    switch (typeMetrique.typeValeur) {
+      case 'amount':
+        return '${valeur.toStringAsFixed(0)} ${unite}';
+      case 'percentage':
+        return '${valeur.toStringAsFixed(1)}${unite}';
+      case 'average':
+        return valeur.toStringAsFixed(1);
+      default:
+        return valeur.toStringAsFixed(0);
+    }
+  }
+
+  /// Formate le pourcentage d'évolution
+  String get evolutionFormatee {
+    if (pourcentageEvolution == null) return '';
+    final signe = pourcentageEvolution! >= 0 ? '+' : '';
+    return '$signe${pourcentageEvolution!.toStringAsFixed(1)}%';
+  }
+
+  @override
+  List<Object?> get props => [
+        id,
+        typeMetrique,
+        periodeAnalyse,
+        valeur,
+        valeurPrecedente,
+        pourcentageEvolution,
+        dateDebut,
+        dateFin,
+        dateCalcul,
+        organisationId,
+        nomOrganisation,
+        utilisateurId,
+        nomUtilisateur,
+        libellePersonnalise,
+        description,
+        donneesDetaillees,
+        configurationGraphique,
+        metadonnees,
+        indicateurFiabilite,
+        nombreElementsAnalyses,
+        tempsCalculMs,
+        tempsReel,
+        necessiteMiseAJour,
+        niveauPriorite,
+        tags,
+      ];
+
+  AnalyticsData copyWith({
+    String? id,
+    TypeMetrique? typeMetrique,
+    PeriodeAnalyse? periodeAnalyse,
+    double? valeur,
+    double? valeurPrecedente,
+    double? pourcentageEvolution,
+    DateTime? dateDebut,
+    DateTime? dateFin,
+    DateTime? dateCalcul,
+    String? organisationId,
+    String? nomOrganisation,
+    String? utilisateurId,
+    String? nomUtilisateur,
+    String? libellePersonnalise,
+    String? description,
+    String? donneesDetaillees,
+    String? configurationGraphique,
+    Map<String, dynamic>? metadonnees,
+    double? indicateurFiabilite,
+    int? nombreElementsAnalyses,
+    int? tempsCalculMs,
+    bool? tempsReel,
+    bool? necessiteMiseAJour,
+    int? niveauPriorite,
+    List<String>? tags,
+  }) {
+    return AnalyticsData(
+      id: id ?? this.id,
+      typeMetrique: typeMetrique ?? this.typeMetrique,
+      periodeAnalyse: periodeAnalyse ?? this.periodeAnalyse,
+      valeur: valeur ?? this.valeur,
+      valeurPrecedente: valeurPrecedente ?? this.valeurPrecedente,
+      pourcentageEvolution: pourcentageEvolution ?? this.pourcentageEvolution,
+      dateDebut: dateDebut ?? this.dateDebut,
+      dateFin: dateFin ?? this.dateFin,
+      dateCalcul: dateCalcul ?? this.dateCalcul,
+      organisationId: organisationId ?? this.organisationId,
+      nomOrganisation: nomOrganisation ?? this.nomOrganisation,
+      utilisateurId: utilisateurId ?? this.utilisateurId,
+      nomUtilisateur: nomUtilisateur ?? this.nomUtilisateur,
+      libellePersonnalise: libellePersonnalise ?? this.libellePersonnalise,
+      description: description ?? this.description,
+      donneesDetaillees: donneesDetaillees ?? this.donneesDetaillees,
+      configurationGraphique: configurationGraphique ?? this.configurationGraphique,
+      metadonnees: metadonnees ?? this.metadonnees,
+      indicateurFiabilite: indicateurFiabilite ?? this.indicateurFiabilite,
+      nombreElementsAnalyses: nombreElementsAnalyses ?? this.nombreElementsAnalyses,
+      tempsCalculMs: tempsCalculMs ?? this.tempsCalculMs,
+      tempsReel: tempsReel ?? this.tempsReel,
+      necessiteMiseAJour: necessiteMiseAJour ?? this.necessiteMiseAJour,
+      niveauPriorite: niveauPriorite ?? this.niveauPriorite,
+      tags: tags ?? this.tags,
+    );
+  }
+}

unionflow-mobile-apps/lib/features/analytics/domain/entities/kpi_trend.dart

@@ -0,0 +1,351 @@
+import 'package:equatable/equatable.dart';
+import 'analytics_data.dart';
+
+/// Point de données pour une tendance KPI
+class PointDonnee extends Equatable {
+  const PointDonnee({
+    required this.date,
+    required this.valeur,
+    this.libelle,
+    this.anomalie = false,
+    this.prediction = false,
+    this.metadonnees,
+  });
+
+  final DateTime date;
+  final double valeur;
+  final String? libelle;
+  final bool anomalie;
+  final bool prediction;
+  final String? metadonnees;
+
+  @override
+  List<Object?> get props => [
+        date,
+        valeur,
+        libelle,
+        anomalie,
+        prediction,
+        metadonnees,
+      ];
+
+  PointDonnee copyWith({
+    DateTime? date,
+    double? valeur,
+    String? libelle,
+    bool? anomalie,
+    bool? prediction,
+    String? metadonnees,
+  }) {
+    return PointDonnee(
+      date: date ?? this.date,
+      valeur: valeur ?? this.valeur,
+      libelle: libelle ?? this.libelle,
+      anomalie: anomalie ?? this.anomalie,
+      prediction: prediction ?? this.prediction,
+      metadonnees: metadonnees ?? this.metadonnees,
+    );
+  }
+}
+
+/// Entité représentant les tendances et évolutions d'un KPI
+class KPITrend extends Equatable {
+  const KPITrend({
+    required this.id,
+    required this.typeMetrique,
+    required this.periodeAnalyse,
+    this.organisationId,
+    this.nomOrganisation,
+    required this.dateDebut,
+    required this.dateFin,
+    required this.pointsDonnees,
+    required this.valeurActuelle,
+    this.valeurMinimale,
+    this.valeurMaximale,
+    this.valeurMoyenne,
+    this.ecartType,
+    this.coefficientVariation,
+    this.tendanceGenerale,
+    this.coefficientCorrelation,
+    this.pourcentageEvolutionGlobale,
+    this.predictionProchainePeriode,
+    this.margeErreurPrediction,
+    this.seuilAlerteBas,
+    this.seuilAlerteHaut,
+    this.alerteActive = false,
+    this.typeAlerte,
+    this.messageAlerte,
+    this.configurationGraphique,
+    this.intervalleRegroupement,
+    this.formatDate,
+    this.dateDerniereMiseAJour,
+    this.frequenceMiseAJourMinutes,
+  });
+
+  final String id;
+  final TypeMetrique typeMetrique;
+  final PeriodeAnalyse periodeAnalyse;
+  final String? organisationId;
+  final String? nomOrganisation;
+  final DateTime dateDebut;
+  final DateTime dateFin;
+  final List<PointDonnee> pointsDonnees;
+  final double valeurActuelle;
+  final double? valeurMinimale;
+  final double? valeurMaximale;
+  final double? valeurMoyenne;
+  final double? ecartType;
+  final double? coefficientVariation;
+  final double? tendanceGenerale;
+  final double? coefficientCorrelation;
+  final double? pourcentageEvolutionGlobale;
+  final double? predictionProchainePeriode;
+  final double? margeErreurPrediction;
+  final double? seuilAlerteBas;
+  final double? seuilAlerteHaut;
+  final bool alerteActive;
+  final String? typeAlerte;
+  final String? messageAlerte;
+  final String? configurationGraphique;
+  final String? intervalleRegroupement;
+  final String? formatDate;
+  final DateTime? dateDerniereMiseAJour;
+  final int? frequenceMiseAJourMinutes;
+
+  /// Retourne le libellé de la métrique
+  String get libelleMetrique => typeMetrique.libelle;
+
+  /// Retourne l'unité de mesure
+  String get unite => typeMetrique.unite;
+
+  /// Retourne l'icône de la métrique
+  String get icone => typeMetrique.icone;
+
+  /// Retourne la couleur de la métrique
+  String get couleur => typeMetrique.couleur;
+
+  /// Vérifie si la tendance est positive
+  bool get isTendancePositive {
+    return tendanceGenerale != null && tendanceGenerale! > 0;
+  }
+
+  /// Vérifie si la tendance est négative
+  bool get isTendanceNegative {
+    return tendanceGenerale != null && tendanceGenerale! < 0;
+  }
+
+  /// Vérifie si la tendance est stable
+  bool get isTendanceStable {
+    return tendanceGenerale != null && tendanceGenerale! == 0;
+  }
+
+  /// Retourne la volatilité du KPI
+  String get volatilite {
+    if (coefficientVariation == null) return 'inconnue';
+    
+    if (coefficientVariation! <= 0.1) return 'faible';
+    if (coefficientVariation! <= 0.3) return 'moyenne';
+    return 'élevée';
+  }
+
+  /// Vérifie si la prédiction est fiable
+  bool get isPredictionFiable {
+    return coefficientCorrelation != null && coefficientCorrelation! >= 0.7;
+  }
+
+  /// Retourne le nombre de points de données
+  int get nombrePointsDonnees => pointsDonnees.length;
+
+  /// Vérifie si des anomalies ont été détectées
+  bool get hasAnomalies {
+    return pointsDonnees.any((point) => point.anomalie);
+  }
+
+  /// Retourne les points d'anomalies
+  List<PointDonnee> get pointsAnomalies {
+    return pointsDonnees.where((point) => point.anomalie).toList();
+  }
+
+  /// Retourne les points de prédiction
+  List<PointDonnee> get pointsPredictions {
+    return pointsDonnees.where((point) => point.prediction).toList();
+  }
+
+  /// Formate la valeur actuelle
+  String get valeurActuelleFormatee {
+    switch (typeMetrique.typeValeur) {
+      case 'amount':
+        return '${valeurActuelle.toStringAsFixed(0)} ${unite}';
+      case 'percentage':
+        return '${valeurActuelle.toStringAsFixed(1)}${unite}';
+      case 'average':
+        return valeurActuelle.toStringAsFixed(1);
+      default:
+        return valeurActuelle.toStringAsFixed(0);
+    }
+  }
+
+  /// Formate l'évolution globale
+  String get evolutionGlobaleFormatee {
+    if (pourcentageEvolutionGlobale == null) return '';
+    final signe = pourcentageEvolutionGlobale! >= 0 ? '+' : '';
+    return '$signe${pourcentageEvolutionGlobale!.toStringAsFixed(1)}%';
+  }
+
+  /// Formate la prédiction
+  String get predictionFormatee {
+    if (predictionProchainePeriode == null) return '';
+    
+    switch (typeMetrique.typeValeur) {
+      case 'amount':
+        return '${predictionProchainePeriode!.toStringAsFixed(0)} ${unite}';
+      case 'percentage':
+        return '${predictionProchainePeriode!.toStringAsFixed(1)}${unite}';
+      case 'average':
+        return predictionProchainePeriode!.toStringAsFixed(1);
+      default:
+        return predictionProchainePeriode!.toStringAsFixed(0);
+    }
+  }
+
+  /// Retourne la description de la tendance
+  String get descriptionTendance {
+    if (isTendancePositive) {
+      return 'Tendance à la hausse';
+    } else if (isTendanceNegative) {
+      return 'Tendance à la baisse';
+    } else {
+      return 'Tendance stable';
+    }
+  }
+
+  /// Retourne l'icône de la tendance
+  String get iconeTendance {
+    if (isTendancePositive) {
+      return 'trending_up';
+    } else if (isTendanceNegative) {
+      return 'trending_down';
+    } else {
+      return 'trending_flat';
+    }
+  }
+
+  /// Retourne la couleur de la tendance
+  String get couleurTendance {
+    if (isTendancePositive) {
+      return '#4CAF50'; // Vert
+    } else if (isTendanceNegative) {
+      return '#F44336'; // Rouge
+    } else {
+      return '#FF9800'; // Orange
+    }
+  }
+
+  /// Retourne le niveau de confiance de la prédiction
+  String get niveauConfiancePrediction {
+    if (coefficientCorrelation == null) return 'Inconnu';
+    
+    if (coefficientCorrelation! >= 0.9) return 'Très élevé';
+    if (coefficientCorrelation! >= 0.7) return 'Élevé';
+    if (coefficientCorrelation! >= 0.5) return 'Moyen';
+    if (coefficientCorrelation! >= 0.3) return 'Faible';
+    return 'Très faible';
+  }
+
+  @override
+  List<Object?> get props => [
+        id,
+        typeMetrique,
+        periodeAnalyse,
+        organisationId,
+        nomOrganisation,
+        dateDebut,
+        dateFin,
+        pointsDonnees,
+        valeurActuelle,
+        valeurMinimale,
+        valeurMaximale,
+        valeurMoyenne,
+        ecartType,
+        coefficientVariation,
+        tendanceGenerale,
+        coefficientCorrelation,
+        pourcentageEvolutionGlobale,
+        predictionProchainePeriode,
+        margeErreurPrediction,
+        seuilAlerteBas,
+        seuilAlerteHaut,
+        alerteActive,
+        typeAlerte,
+        messageAlerte,
+        configurationGraphique,
+        intervalleRegroupement,
+        formatDate,
+        dateDerniereMiseAJour,
+        frequenceMiseAJourMinutes,
+      ];
+
+  KPITrend copyWith({
+    String? id,
+    TypeMetrique? typeMetrique,
+    PeriodeAnalyse? periodeAnalyse,
+    String? organisationId,
+    String? nomOrganisation,
+    DateTime? dateDebut,
+    DateTime? dateFin,
+    List<PointDonnee>? pointsDonnees,
+    double? valeurActuelle,
+    double? valeurMinimale,
+    double? valeurMaximale,
+    double? valeurMoyenne,
+    double? ecartType,
+    double? coefficientVariation,
+    double? tendanceGenerale,
+    double? coefficientCorrelation,
+    double? pourcentageEvolutionGlobale,
+    double? predictionProchainePeriode,
+    double? margeErreurPrediction,
+    double? seuilAlerteBas,
+    double? seuilAlerteHaut,
+    bool? alerteActive,
+    String? typeAlerte,
+    String? messageAlerte,
+    String? configurationGraphique,
+    String? intervalleRegroupement,
+    String? formatDate,
+    DateTime? dateDerniereMiseAJour,
+    int? frequenceMiseAJourMinutes,
+  }) {
+    return KPITrend(
+      id: id ?? this.id,
+      typeMetrique: typeMetrique ?? this.typeMetrique,
+      periodeAnalyse: periodeAnalyse ?? this.periodeAnalyse,
+      organisationId: organisationId ?? this.organisationId,
+      nomOrganisation: nomOrganisation ?? this.nomOrganisation,
+      dateDebut: dateDebut ?? this.dateDebut,
+      dateFin: dateFin ?? this.dateFin,
+      pointsDonnees: pointsDonnees ?? this.pointsDonnees,
+      valeurActuelle: valeurActuelle ?? this.valeurActuelle,
+      valeurMinimale: valeurMinimale ?? this.valeurMinimale,
+      valeurMaximale: valeurMaximale ?? this.valeurMaximale,
+      valeurMoyenne: valeurMoyenne ?? this.valeurMoyenne,
+      ecartType: ecartType ?? this.ecartType,
+      coefficientVariation: coefficientVariation ?? this.coefficientVariation,
+      tendanceGenerale: tendanceGenerale ?? this.tendanceGenerale,
+      coefficientCorrelation: coefficientCorrelation ?? this.coefficientCorrelation,
+      pourcentageEvolutionGlobale: pourcentageEvolutionGlobale ?? this.pourcentageEvolutionGlobale,
+      predictionProchainePeriode: predictionProchainePeriode ?? this.predictionProchainePeriode,
+      margeErreurPrediction: margeErreurPrediction ?? this.margeErreurPrediction,
+      seuilAlerteBas: seuilAlerteBas ?? this.seuilAlerteBas,
+      seuilAlerteHaut: seuilAlerteHaut ?? this.seuilAlerteHaut,
+      alerteActive: alerteActive ?? this.alerteActive,
+      typeAlerte: typeAlerte ?? this.typeAlerte,
+      messageAlerte: messageAlerte ?? this.messageAlerte,
+      configurationGraphique: configurationGraphique ?? this.configurationGraphique,
+      intervalleRegroupement: intervalleRegroupement ?? this.intervalleRegroupement,
+      formatDate: formatDate ?? this.formatDate,
+      dateDerniereMiseAJour: dateDerniereMiseAJour ?? this.dateDerniereMiseAJour,
+      frequenceMiseAJourMinutes: frequenceMiseAJourMinutes ?? this.frequenceMiseAJourMinutes,
+    );
+  }
+}