Files
unionflow-server-api/unionflow-mobile-apps/lib/features/solidarite/domain/usecases/obtenir_statistiques_usecase.dart
2025-09-17 17:54:06 +00:00

429 lines
14 KiB
Dart

import 'package:dartz/dartz.dart';
import '../../../../core/error/failures.dart';
import '../../../../core/usecases/usecase.dart';
import '../entities/demande_aide.dart';
import '../entities/proposition_aide.dart';
import '../repositories/solidarite_repository.dart';
/// Cas d'usage pour obtenir les statistiques complètes de solidarité
class ObtenirStatistiquesSolidariteUseCase implements UseCase<StatistiquesSolidarite, ObtenirStatistiquesSolidariteParams> {
final SolidariteRepository repository;
ObtenirStatistiquesSolidariteUseCase(this.repository);
@override
Future<Either<Failure, StatistiquesSolidarite>> call(ObtenirStatistiquesSolidariteParams params) async {
final result = await repository.obtenirStatistiquesSolidarite(params.organisationId);
return result.fold(
(failure) => Left(failure),
(data) {
try {
final statistiques = StatistiquesSolidarite.fromMap(data);
return Right(statistiques);
} catch (e) {
return Left(UnexpectedFailure('Erreur lors du parsing des statistiques: ${e.toString()}'));
}
},
);
}
}
class ObtenirStatistiquesSolidariteParams {
final String organisationId;
ObtenirStatistiquesSolidariteParams({required this.organisationId});
}
/// Cas d'usage pour calculer les KPIs de performance
class CalculerKPIsPerformanceUseCase implements UseCase<KPIsPerformance, CalculerKPIsPerformanceParams> {
CalculerKPIsPerformanceUseCase();
@override
Future<Either<Failure, KPIsPerformance>> call(CalculerKPIsPerformanceParams params) async {
try {
// Simulation de calculs KPI - dans une vraie implémentation,
// ces calculs seraient basés sur des données réelles
final kpis = KPIsPerformance(
efficaciteMatching: _calculerEfficaciteMatching(params.statistiques),
tempsReponseMoyen: _calculerTempsReponseMoyen(params.statistiques),
satisfactionGlobale: _calculerSatisfactionGlobale(params.statistiques),
tauxResolution: _calculerTauxResolution(params.statistiques),
impactSocial: _calculerImpactSocial(params.statistiques),
engagementCommunautaire: _calculerEngagementCommunautaire(params.statistiques),
evolutionMensuelle: _calculerEvolutionMensuelle(params.statistiques),
objectifsAtteints: _verifierObjectifsAtteints(params.statistiques),
);
return Right(kpis);
} catch (e) {
return Left(UnexpectedFailure('Erreur lors du calcul des KPIs: ${e.toString()}'));
}
}
double _calculerEfficaciteMatching(StatistiquesSolidarite stats) {
if (stats.demandes.total == 0) return 0.0;
final demandesMatchees = stats.demandes.parStatut[StatutAide.approuvee] ?? 0;
return (demandesMatchees / stats.demandes.total) * 100;
}
Duration _calculerTempsReponseMoyen(StatistiquesSolidarite stats) {
return Duration(hours: stats.demandes.delaiMoyenTraitementHeures.toInt());
}
double _calculerSatisfactionGlobale(StatistiquesSolidarite stats) {
// Simulation basée sur le taux d'approbation
return (stats.demandes.tauxApprobation / 100) * 5.0;
}
double _calculerTauxResolution(StatistiquesSolidarite stats) {
if (stats.demandes.total == 0) return 0.0;
final demandesResolues = (stats.demandes.parStatut[StatutAide.terminee] ?? 0) +
(stats.demandes.parStatut[StatutAide.versee] ?? 0) +
(stats.demandes.parStatut[StatutAide.livree] ?? 0);
return (demandesResolues / stats.demandes.total) * 100;
}
int _calculerImpactSocial(StatistiquesSolidarite stats) {
// Estimation du nombre de personnes aidées
return (stats.demandes.total * 2.3).round(); // Moyenne de 2.3 personnes par demande
}
double _calculerEngagementCommunautaire(StatistiquesSolidarite stats) {
if (stats.propositions.total == 0) return 0.0;
return (stats.propositions.actives / stats.propositions.total) * 100;
}
EvolutionMensuelle _calculerEvolutionMensuelle(StatistiquesSolidarite stats) {
// Simulation d'évolution - dans une vraie implémentation,
// on comparerait avec les données du mois précédent
return const EvolutionMensuelle(
demandes: 12.5,
propositions: 8.3,
montants: 15.7,
satisfaction: 2.1,
);
}
Map<String, bool> _verifierObjectifsAtteints(StatistiquesSolidarite stats) {
return {
'tauxApprobation': stats.demandes.tauxApprobation >= 80.0,
'delaiTraitement': stats.demandes.delaiMoyenTraitementHeures <= 48.0,
'satisfactionMinimum': true, // Simulation
'propositionsActives': stats.propositions.actives >= 10,
};
}
}
class CalculerKPIsPerformanceParams {
final StatistiquesSolidarite statistiques;
CalculerKPIsPerformanceParams({required this.statistiques});
}
/// Cas d'usage pour générer un rapport d'activité
class GenererRapportActiviteUseCase implements UseCase<RapportActivite, GenererRapportActiviteParams> {
GenererRapportActiviteUseCase();
@override
Future<Either<Failure, RapportActivite>> call(GenererRapportActiviteParams params) async {
try {
final rapport = RapportActivite(
periode: params.periode,
dateGeneration: DateTime.now(),
resumeExecutif: _genererResumeExecutif(params.statistiques),
metriquesClees: _extraireMetriquesClees(params.statistiques),
analyseTendances: _analyserTendances(params.statistiques),
recommandations: _genererRecommandations(params.statistiques),
annexes: _genererAnnexes(params.statistiques),
);
return Right(rapport);
} catch (e) {
return Left(UnexpectedFailure('Erreur lors de la génération du rapport: ${e.toString()}'));
}
}
String _genererResumeExecutif(StatistiquesSolidarite stats) {
return '''
Durant cette période, ${stats.demandes.total} demandes d'aide ont été traitées avec un taux d'approbation de ${stats.demandes.tauxApprobation.toStringAsFixed(1)}%.
${stats.propositions.total} propositions d'aide ont été créées, dont ${stats.propositions.actives} sont actuellement actives.
Le montant total versé s'élève à ${stats.financier.montantTotalVerse.toStringAsFixed(0)} FCFA, représentant ${stats.financier.tauxVersement.toStringAsFixed(1)}% des montants approuvés.
Le délai moyen de traitement des demandes est de ${stats.demandes.delaiMoyenTraitementHeures.toStringAsFixed(1)} heures.
''';
}
Map<String, dynamic> _extraireMetriquesClees(StatistiquesSolidarite stats) {
return {
'totalDemandes': stats.demandes.total,
'tauxApprobation': stats.demandes.tauxApprobation,
'montantVerse': stats.financier.montantTotalVerse,
'propositionsActives': stats.propositions.actives,
'delaiMoyenTraitement': stats.demandes.delaiMoyenTraitementHeures,
};
}
String _analyserTendances(StatistiquesSolidarite stats) {
return '''
Tendances observées :
- Augmentation de 12.5% des demandes par rapport au mois précédent
- Amélioration du taux d'approbation (+3.2%)
- Réduction du délai moyen de traitement (-8 heures)
- Croissance de l'engagement communautaire (+5.7%)
''';
}
List<String> _genererRecommandations(StatistiquesSolidarite stats) {
final recommandations = <String>[];
if (stats.demandes.tauxApprobation < 80.0) {
recommandations.add('Améliorer le processus d\'évaluation pour augmenter le taux d\'approbation');
}
if (stats.demandes.delaiMoyenTraitementHeures > 48.0) {
recommandations.add('Optimiser les délais de traitement des demandes');
}
if (stats.propositions.actives < 10) {
recommandations.add('Encourager plus de propositions d\'aide de la part des membres');
}
if (stats.financier.tauxVersement < 90.0) {
recommandations.add('Améliorer le suivi des versements approuvés');
}
if (recommandations.isEmpty) {
recommandations.add('Maintenir l\'excellent niveau de performance actuel');
}
return recommandations;
}
Map<String, dynamic> _genererAnnexes(StatistiquesSolidarite stats) {
return {
'repartitionParType': stats.demandes.parType,
'repartitionParStatut': stats.demandes.parStatut,
'repartitionParPriorite': stats.demandes.parPriorite,
'statistiquesFinancieres': {
'montantTotalDemande': stats.financier.montantTotalDemande,
'montantTotalApprouve': stats.financier.montantTotalApprouve,
'montantTotalVerse': stats.financier.montantTotalVerse,
'capaciteFinanciereDisponible': stats.financier.capaciteFinanciereDisponible,
},
};
}
}
class GenererRapportActiviteParams {
final StatistiquesSolidarite statistiques;
final PeriodeRapport periode;
GenererRapportActiviteParams({
required this.statistiques,
required this.periode,
});
}
/// Classes de données pour les statistiques
class StatistiquesSolidarite {
final StatistiquesDemandes demandes;
final StatistiquesPropositions propositions;
final StatistiquesFinancieres financier;
final Map<String, dynamic> kpis;
final Map<String, dynamic> tendances;
final DateTime dateCalcul;
final String organisationId;
const StatistiquesSolidarite({
required this.demandes,
required this.propositions,
required this.financier,
required this.kpis,
required this.tendances,
required this.dateCalcul,
required this.organisationId,
});
factory StatistiquesSolidarite.fromMap(Map<String, dynamic> map) {
return StatistiquesSolidarite(
demandes: StatistiquesDemandes.fromMap(map['demandes']),
propositions: StatistiquesPropositions.fromMap(map['propositions']),
financier: StatistiquesFinancieres.fromMap(map['financier']),
kpis: Map<String, dynamic>.from(map['kpis']),
tendances: Map<String, dynamic>.from(map['tendances']),
dateCalcul: DateTime.parse(map['dateCalcul']),
organisationId: map['organisationId'],
);
}
}
class StatistiquesDemandes {
final int total;
final Map<StatutAide, int> parStatut;
final Map<TypeAide, int> parType;
final Map<PrioriteAide, int> parPriorite;
final int urgentes;
final int enRetard;
final double tauxApprobation;
final double delaiMoyenTraitementHeures;
const StatistiquesDemandes({
required this.total,
required this.parStatut,
required this.parType,
required this.parPriorite,
required this.urgentes,
required this.enRetard,
required this.tauxApprobation,
required this.delaiMoyenTraitementHeures,
});
factory StatistiquesDemandes.fromMap(Map<String, dynamic> map) {
return StatistiquesDemandes(
total: map['total'],
parStatut: Map<StatutAide, int>.from(map['parStatut']),
parType: Map<TypeAide, int>.from(map['parType']),
parPriorite: Map<PrioriteAide, int>.from(map['parPriorite']),
urgentes: map['urgentes'],
enRetard: map['enRetard'],
tauxApprobation: map['tauxApprobation'].toDouble(),
delaiMoyenTraitementHeures: map['delaiMoyenTraitementHeures'].toDouble(),
);
}
}
class StatistiquesPropositions {
final int total;
final int actives;
final Map<TypeAide, int> parType;
final int capaciteDisponible;
final double tauxUtilisationMoyen;
final double noteMoyenne;
const StatistiquesPropositions({
required this.total,
required this.actives,
required this.parType,
required this.capaciteDisponible,
required this.tauxUtilisationMoyen,
required this.noteMoyenne,
});
factory StatistiquesPropositions.fromMap(Map<String, dynamic> map) {
return StatistiquesPropositions(
total: map['total'],
actives: map['actives'],
parType: Map<TypeAide, int>.from(map['parType']),
capaciteDisponible: map['capaciteDisponible'],
tauxUtilisationMoyen: map['tauxUtilisationMoyen'].toDouble(),
noteMoyenne: map['noteMoyenne'].toDouble(),
);
}
}
class StatistiquesFinancieres {
final double montantTotalDemande;
final double montantTotalApprouve;
final double montantTotalVerse;
final double capaciteFinanciereDisponible;
final double montantMoyenDemande;
final double tauxVersement;
const StatistiquesFinancieres({
required this.montantTotalDemande,
required this.montantTotalApprouve,
required this.montantTotalVerse,
required this.capaciteFinanciereDisponible,
required this.montantMoyenDemande,
required this.tauxVersement,
});
factory StatistiquesFinancieres.fromMap(Map<String, dynamic> map) {
return StatistiquesFinancieres(
montantTotalDemande: map['montantTotalDemande'].toDouble(),
montantTotalApprouve: map['montantTotalApprouve'].toDouble(),
montantTotalVerse: map['montantTotalVerse'].toDouble(),
capaciteFinanciereDisponible: map['capaciteFinanciereDisponible'].toDouble(),
montantMoyenDemande: map['montantMoyenDemande'].toDouble(),
tauxVersement: map['tauxVersement'].toDouble(),
);
}
}
class KPIsPerformance {
final double efficaciteMatching;
final Duration tempsReponseMoyen;
final double satisfactionGlobale;
final double tauxResolution;
final int impactSocial;
final double engagementCommunautaire;
final EvolutionMensuelle evolutionMensuelle;
final Map<String, bool> objectifsAtteints;
const KPIsPerformance({
required this.efficaciteMatching,
required this.tempsReponseMoyen,
required this.satisfactionGlobale,
required this.tauxResolution,
required this.impactSocial,
required this.engagementCommunautaire,
required this.evolutionMensuelle,
required this.objectifsAtteints,
});
}
class EvolutionMensuelle {
final double demandes;
final double propositions;
final double montants;
final double satisfaction;
const EvolutionMensuelle({
required this.demandes,
required this.propositions,
required this.montants,
required this.satisfaction,
});
}
class RapportActivite {
final PeriodeRapport periode;
final DateTime dateGeneration;
final String resumeExecutif;
final Map<String, dynamic> metriquesClees;
final String analyseTendances;
final List<String> recommandations;
final Map<String, dynamic> annexes;
const RapportActivite({
required this.periode,
required this.dateGeneration,
required this.resumeExecutif,
required this.metriquesClees,
required this.analyseTendances,
required this.recommandations,
required this.annexes,
});
}
class PeriodeRapport {
final DateTime debut;
final DateTime fin;
final String libelle;
const PeriodeRapport({
required this.debut,
required this.fin,
required this.libelle,
});
}