feat: WebSocket temps réel + Finance Workflow + corrections

- Task #6: WebSocket /ws/dashboard + Kafka events (5 topics)
  * Backend: KafkaEventProducer, KafkaEventConsumer
  * Mobile: WebSocketService (reconnection, heartbeat, typed events)
  * DashboardBloc: Auto-refresh depuis WebSocket events

- Finance Workflow: approbations + budgets (backend + mobile)
  * Backend: entities, services, resources, migrations Flyway V6
  * Mobile: features finance_workflow complète avec BLoC

- Corrections DI: interfaces IRepository partout
  * IProfileRepository, IOrganizationRepository, IMembreRepository
  * GetIt configuré avec @injectable

- Spec-Kit: constitution + templates mis à jour
  * .specify/memory/constitution.md enrichie
  * Templates agent, plan, spec, tasks, checklist

- Nettoyage: fichiers temporaires supprimés

Signed-off-by: lions dev Team

unionflow/unionflow-mobile-apps/lib/features/contributions/data/models/contribution_model.dart

@@ -12,6 +12,8 @@ enum ContributionStatus {
   payee,
   @JsonValue('NON_PAYEE')
   nonPayee,
+  @JsonValue('EN_ATTENTE')
+  enAttente,
   @JsonValue('EN_RETARD')
   enRetard,
   @JsonValue('PARTIELLE')
@@ -56,6 +58,23 @@ enum PaymentMethod {
   autre,
 }
 
+/// Extension pour obtenir le code API d'une méthode de paiement (ex: pour icônes assets).
+extension PaymentMethodCode on PaymentMethod {
+  String get code {
+    switch (this) {
+      case PaymentMethod.especes: return 'ESPECES';
+      case PaymentMethod.cheque: return 'CHEQUE';
+      case PaymentMethod.virement: return 'VIREMENT';
+      case PaymentMethod.carteBancaire: return 'CARTE_BANCAIRE';
+      case PaymentMethod.waveMoney: return 'WAVE_MONEY';
+      case PaymentMethod.orangeMoney: return 'ORANGE_MONEY';
+      case PaymentMethod.freeMoney: return 'FREE_MONEY';
+      case PaymentMethod.mobileMoney: return 'MOBILE_MONEY';
+      case PaymentMethod.autre: return 'AUTRE';
+    }
+  }
+}
+
 /// Modèle complet d'une contribution
 @JsonSerializable(explicitToJson: true)
 class ContributionModel extends Equatable {

unionflow/unionflow-mobile-apps/lib/features/contributions/data/models/contribution_model.g.dart

@@ -93,6 +93,7 @@ const _$ContributionTypeEnumMap = {
 const _$ContributionStatusEnumMap = {
   ContributionStatus.payee: 'PAYEE',
   ContributionStatus.nonPayee: 'NON_PAYEE',
+  ContributionStatus.enAttente: 'EN_ATTENTE',
   ContributionStatus.enRetard: 'EN_RETARD',
   ContributionStatus.partielle: 'PARTIELLE',
   ContributionStatus.annulee: 'ANNULEE',

unionflow/unionflow-mobile-apps/lib/features/contributions/data/repositories/contribution_repository.dart

@@ -1,17 +1,109 @@
-/// Repository pour la gestion des cotisations via l'API backend
-library contribution_repository;
+/// Implémentation du repository des cotisations via l'API backend
+library contribution_repository_impl;
 
-import 'package:dio/dio.dart';
+import 'package:injectable/injectable.dart';
+import 'package:unionflow_mobile_apps/core/network/api_client.dart';
+import 'package:unionflow_mobile_apps/core/utils/logger.dart';
+import '../../domain/repositories/contribution_repository.dart';
 import '../models/contribution_model.dart';
 
-/// Repository des cotisations - appels API réels vers /api/cotisations
-class ContributionRepository {
-  final Dio _dio;
+/// Implémentation du repository des cotisations - appels API réels vers /api/cotisations
+@LazySingleton(as: IContributionRepository)
+class ContributionRepositoryImpl implements IContributionRepository {
+  final ApiClient _apiClient;
   static const String _baseUrl = '/api/cotisations';
 
-  ContributionRepository(this._dio);
+  ContributionRepositoryImpl(this._apiClient);
 
-  /// Récupère la liste des cotisations avec pagination
+  /// Toutes les cotisations du membre connecté (GET /api/cotisations/mes-cotisations).
+  Future<ContributionPageResult> getMesCotisations({int page = 0, int size = 50}) async {
+    final response = await _apiClient.get(
+      '$_baseUrl/mes-cotisations',
+      queryParameters: {'page': page, 'size': size},
+    );
+    if (response.statusCode != 200) {
+      throw Exception(
+        'Erreur lors de la récupération des cotisations: ${response.statusCode}',
+      );
+    }
+    final data = response.data;
+    final List<dynamic> list = data is List ? data as List<dynamic> : <dynamic>[];
+    final contributions = list.map((e) => _summaryToModel(e as Map<String, dynamic>)).toList();
+    return ContributionPageResult(
+      contributions: contributions,
+      total: contributions.length,
+      page: page,
+      size: size,
+      totalPages: list.isEmpty ? 0 : 1,
+    );
+  }
+
+  /// Récupère les cotisations en attente du membre connecté (endpoint dédié).
+  Future<ContributionPageResult> getMesCotisationsEnAttente() async {
+    final path = '$_baseUrl/mes-cotisations/en-attente';
+    final response = await _apiClient.get(path);
+    if (response.statusCode != 200) {
+      throw Exception(
+        'Erreur lors de la récupération des cotisations: ${response.statusCode}',
+      );
+    }
+    final data = response.data;
+    final List<dynamic> list = data is List ? data : (data is Map ? (data['data'] ?? data['content'] ?? []) as List<dynamic>? ?? [] : []);
+    final contributions = list
+        .map((e) => _summaryToModel(e as Map<String, dynamic>))
+        .toList();
+    return ContributionPageResult(
+      contributions: contributions,
+      total: contributions.length,
+      page: 0,
+      size: contributions.length,
+      totalPages: contributions.isEmpty ? 0 : 1,
+    );
+  }
+
+  static ContributionModel _summaryToModel(Map<String, dynamic> json) {
+    final id = json['id']?.toString();
+    final statutStr = json['statut'] as String? ?? 'EN_ATTENTE';
+    final statut = _mapStatut(statutStr);
+    final montantDu = (json['montantDu'] as num?)?.toDouble() ?? 0.0;
+    final montantPaye = (json['montantPaye'] as num?)?.toDouble();
+    final dateEcheanceStr = json['dateEcheance'] as String?;
+    final dateEcheance = dateEcheanceStr != null
+        ? DateTime.tryParse(dateEcheanceStr) ?? DateTime.now()
+        : DateTime.now();
+    final annee = (json['annee'] as num?)?.toInt() ?? dateEcheance.year;
+    return ContributionModel(
+      id: id,
+      membreId: '', // membre implicite (endpoint "mes cotisations")
+      membreNom: (json['nomMembre'] ?? json['nomCompletMembre']) as String?,
+      type: ContributionType.annuelle,
+      statut: statut,
+      montant: montantDu,
+      montantPaye: montantPaye,
+      devise: 'XOF',
+      dateEcheance: dateEcheance,
+      annee: annee,
+    );
+  }
+
+  static ContributionStatus _mapStatut(String code) {
+    switch (code.toUpperCase()) {
+      case 'PAYEE':
+        return ContributionStatus.payee;
+      case 'EN_RETARD':
+        return ContributionStatus.enRetard;
+      case 'PARTIELLE':
+        return ContributionStatus.partielle;
+      case 'ANNULEE':
+        return ContributionStatus.annulee;
+      case 'EN_ATTENTE':
+      case 'NON_PAYEE':
+      default:
+        return ContributionStatus.nonPayee;
+    }
+  }
+
+  /// Récupère la liste des cotisations avec pagination (toutes cotisations, nécessite droits admin)
   Future<ContributionPageResult> getCotisations({
     int page = 0,
     int size = 20,
@@ -29,7 +121,7 @@ class ContributionRepository {
     if (type != null) queryParams['type'] = type;
     if (annee != null) queryParams['annee'] = annee;
 
-    final response = await _dio.get(
+    final response = await _apiClient.get(
       _baseUrl,
       queryParameters: queryParams,
     );
@@ -66,25 +158,96 @@ class ContributionRepository {
 
   /// Récupère une cotisation par ID
   Future<ContributionModel> getCotisationById(String id) async {
-    final response = await _dio.get('$_baseUrl/$id');
+    final response = await _apiClient.get('$_baseUrl/$id');
     if (response.statusCode == 200) {
       return ContributionModel.fromJson(response.data as Map<String, dynamic>);
     }
     throw Exception('Cotisation non trouvée');
   }
 
-  /// Crée une nouvelle cotisation
+  /// Crée une nouvelle cotisation (payload conforme au backend CreateCotisationRequest)
   Future<ContributionModel> createCotisation(ContributionModel contribution) async {
-    final response = await _dio.post(_baseUrl, data: contribution.toJson());
+    final body = _toCreateCotisationRequest(contribution);
+    final response = await _apiClient.post(_baseUrl, data: body);
     if (response.statusCode == 201 || response.statusCode == 200) {
-      return ContributionModel.fromJson(response.data as Map<String, dynamic>);
+      final data = Map<String, dynamic>.from(response.data as Map<String, dynamic>);
+      _normalizeCotisationResponse(data);
+      return ContributionModel.fromJson(data);
     }
-    throw Exception('Erreur lors de la création: ${response.statusCode}');
+    final message = response.data is Map
+        ? (response.data as Map)['error'] ?? response.data.toString()
+        : response.data?.toString() ?? 'Erreur ${response.statusCode}';
+    throw Exception('Erreur lors de la création: $message');
+  }
+
+  /// Construit le body attendu par POST /api/cotisations (CreateCotisationRequest)
+  static Map<String, dynamic> _toCreateCotisationRequest(ContributionModel c) {
+    if (c.organisationId == null || c.organisationId!.trim().isEmpty) {
+      throw Exception('L\'organisation du membre est requise pour créer une cotisation.');
+    }
+    final typeStr = _contributionTypeToBackend(c.type);
+    final dateStr = _formatLocalDate(c.dateEcheance);
+    final desc = c.description?.trim();
+    final libelle = desc != null && desc.isNotEmpty
+        ? (desc.length > 100 ? desc.substring(0, 100) : desc)
+        : 'Cotisation $typeStr ${c.annee}';
+    final description = desc != null && desc.isNotEmpty
+        ? (desc.length > 500 ? desc.substring(0, 500) : desc)
+        : null;
+    return {
+      'membreId': c.membreId,
+      'organisationId': c.organisationId!.trim(),
+      'typeCotisation': typeStr,
+      'libelle': libelle,
+      if (description != null) 'description': description,
+      'montantDu': c.montant,
+      'codeDevise': c.devise.length == 3 ? c.devise : 'XOF',
+      'dateEcheance': dateStr,
+      'periode': '${_monthName(c.dateEcheance.month)} ${c.dateEcheance.year}',
+      'annee': c.annee,
+      'mois': c.mois ?? c.dateEcheance.month,
+      'recurrente': false,
+      if (c.notes != null && c.notes!.isNotEmpty) 'observations': c.notes,
+    };
+  }
+
+  static String _contributionTypeToBackend(ContributionType t) {
+    switch (t) {
+      case ContributionType.mensuelle:
+        return 'MENSUELLE';
+      case ContributionType.trimestrielle:
+        return 'TRIMESTRIELLE';
+      case ContributionType.semestrielle:
+        return 'SEMESTRIELLE';
+      case ContributionType.annuelle:
+        return 'ANNUELLE';
+      case ContributionType.exceptionnelle:
+        return 'EXCEPTIONNELLE';
+    }
+  }
+
+  static String _formatLocalDate(DateTime d) =>
+      '${d.year}-${d.month.toString().padLeft(2, '0')}-${d.day.toString().padLeft(2, '0')}';
+
+  static String _monthName(int month) {
+    const names = ['Janvier', 'Février', 'Mars', 'Avril', 'Mai', 'Juin', 'Juillet', 'Août', 'Septembre', 'Octobre', 'Novembre', 'Décembre'];
+    return month >= 1 && month <= 12 ? names[month - 1] : 'Mois $month';
+  }
+
+  /// Adapte les clés de la réponse backend (CotisationResponse) vers le modèle mobile
+  static void _normalizeCotisationResponse(Map<String, dynamic> data) {
+    if (data.containsKey('nomMembre') && !data.containsKey('membreNom')) data['membreNom'] = data['nomMembre'];
+    if (data.containsKey('nomOrganisation') && !data.containsKey('organisationNom')) data['organisationNom'] = data['nomOrganisation'];
+    if (data.containsKey('codeDevise') && !data.containsKey('devise')) data['devise'] = data['codeDevise'];
+    if (data.containsKey('montantDu') && !data.containsKey('montant')) data['montant'] = data['montantDu'];
+    if (data['id'] != null && data['id'] is! String) data['id'] = data['id'].toString();
+    if (data['membreId'] != null && data['membreId'] is! String) data['membreId'] = data['membreId'].toString();
+    if (data['organisationId'] != null && data['organisationId'] is! String) data['organisationId'] = data['organisationId'].toString();
   }
 
   /// Met à jour une cotisation
   Future<ContributionModel> updateCotisation(String id, ContributionModel contribution) async {
-    final response = await _dio.put('$_baseUrl/$id', data: contribution.toJson());
+    final response = await _apiClient.put('$_baseUrl/$id', data: contribution.toJson());
     if (response.statusCode == 200) {
       return ContributionModel.fromJson(response.data as Map<String, dynamic>);
     }
@@ -93,12 +256,46 @@ class ContributionRepository {
 
   /// Supprime une cotisation
   Future<void> deleteCotisation(String id) async {
-    final response = await _dio.delete('$_baseUrl/$id');
+    final response = await _apiClient.delete('$_baseUrl/$id');
     if (response.statusCode != 200 && response.statusCode != 204) {
       throw Exception('Erreur lors de la suppression: ${response.statusCode}');
     }
   }
 
+  /// Initie un paiement en ligne (Wave Checkout API).
+  /// Retourne l'URL à ouvrir (wave_launch_url) pour que le membre confirme dans l'app Wave.
+  /// Spec: https://docs.wave.com/checkout
+  Future<WavePaiementInitResult> initierPaiementEnLigne({
+    required String cotisationId,
+    required String methodePaiement,
+    required String numeroTelephone,
+  }) async {
+    final response = await _apiClient.post(
+      '/api/paiements/initier-paiement-en-ligne',
+      data: {
+        'cotisationId': cotisationId,
+        'methodePaiement': methodePaiement,
+        'numeroTelephone': numeroTelephone.replaceAll(RegExp(r'\D'), ''),
+      },
+    );
+    if (response.statusCode != 201 && response.statusCode != 200) {
+      final msg = response.data is Map
+          ? (response.data['message'] ?? response.data['error'] ?? response.statusCode)
+          : response.statusCode;
+      throw Exception('Impossible d\'initier le paiement: $msg');
+    }
+    final data = response.data is Map<String, dynamic>
+        ? response.data as Map<String, dynamic>
+        : Map<String, dynamic>.from(response.data as Map);
+    return WavePaiementInitResult(
+      redirectUrl: data['redirectUrl'] as String? ?? data['waveLaunchUrl'] as String? ?? '',
+      waveLaunchUrl: data['waveLaunchUrl'] as String? ?? data['redirectUrl'] as String? ?? '',
+      waveCheckoutSessionId: data['waveCheckoutSessionId'] as String?,
+      clientReference: data['clientReference'] as String?,
+      message: data['message'] as String? ?? 'Ouvrez Wave pour confirmer le paiement.',
+    );
+  }
+
   /// Enregistre un paiement
   Future<ContributionModel> enregistrerPaiement(
     String cotisationId, {
@@ -108,7 +305,7 @@ class ContributionRepository {
     String? numeroPaiement,
     String? referencePaiement,
   }) async {
-    final response = await _dio.post(
+    final response = await _apiClient.post(
       '$_baseUrl/$cotisationId/paiement',
       data: {
         'montant': montant,
@@ -124,9 +321,27 @@ class ContributionRepository {
     throw Exception('Erreur lors de l\'enregistrement du paiement: ${response.statusCode}');
   }
 
-  /// Récupère les statistiques des cotisations
+  /// Synthèse personnelle du membre connecté (GET /api/cotisations/mes-cotisations/synthese)
+  Future<Map<String, dynamic>?> getMesCotisationsSynthese() async {
+    try {
+      final response = await _apiClient.get('$_baseUrl/mes-cotisations/synthese');
+      if (response.statusCode == 200 && response.data != null) {
+        final data = response.data is Map<String, dynamic>
+            ? response.data as Map<String, dynamic>
+            : Map<String, dynamic>.from(response.data as Map);
+        data['isMesSynthese'] = true;
+        return data;
+      }
+      return null;
+    } catch (e, st) {
+      AppLogger.error('ContributionRepository: getMesCotisationsSynthese échoué', error: e, stackTrace: st);
+      rethrow;
+    }
+  }
+
+  /// Récupère les statistiques des cotisations (globales ou mes selon usage)
   Future<Map<String, dynamic>> getStatistiques() async {
-    final response = await _dio.get('$_baseUrl/statistiques');
+    final response = await _apiClient.get('$_baseUrl/statistiques');
     if (response.statusCode == 200) {
       return response.data as Map<String, dynamic>;
     }
@@ -135,7 +350,7 @@ class ContributionRepository {
 
   /// Envoie un rappel de paiement
   Future<void> envoyerRappel(String cotisationId) async {
-    final response = await _dio.post('$_baseUrl/$cotisationId/rappel');
+    final response = await _apiClient.post('$_baseUrl/$cotisationId/rappel');
     if (response.statusCode != 200) {
       throw Exception('Erreur lors de l\'envoi du rappel');
     }
@@ -143,7 +358,7 @@ class ContributionRepository {
 
   /// Génère les cotisations annuelles
   Future<int> genererCotisationsAnnuelles(int annee) async {
-    final response = await _dio.post(
+    final response = await _apiClient.post(
       '$_baseUrl/generer',
       data: {'annee': annee},
     );
@@ -154,6 +369,23 @@ class ContributionRepository {
   }
 }
 
+/// Résultat de l'initiation d'un paiement Wave (redirection vers l'app Wave).
+class WavePaiementInitResult {
+  final String redirectUrl;
+  final String waveLaunchUrl;
+  final String? waveCheckoutSessionId;
+  final String? clientReference;
+  final String message;
+
+  const WavePaiementInitResult({
+    required this.redirectUrl,
+    required this.waveLaunchUrl,
+    this.waveCheckoutSessionId,
+    this.clientReference,
+    required this.message,
+  });
+}
+
 /// Résultat paginé de cotisations
 class ContributionPageResult {
   final List<ContributionModel> contributions;