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
2026-03-15 02:12:17 +00:00
parent bbc409de9d
commit e8ad874015
635 changed files with 58160 additions and 20674 deletions
--- a/unionflow/unionflow-mobile-apps/lib/features/members/bloc/membres_bloc.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/bloc/membres_bloc.dart
@@ -3,15 +3,40 @@ library membres_bloc;

 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:dio/dio.dart';
+import 'package:injectable/injectable.dart';
 import 'membres_event.dart';
 import 'membres_state.dart';
-import '../data/repositories/membre_repository_impl.dart';
+import '../domain/usecases/get_members.dart';
+import '../domain/usecases/get_member_by_id.dart';
+import '../domain/usecases/create_member.dart' as uc;
+import '../domain/usecases/update_member.dart' as uc;
+import '../domain/usecases/delete_member.dart' as uc;
+import '../domain/usecases/search_members.dart';
+import '../domain/usecases/get_member_stats.dart';
+import '../domain/repositories/membre_repository.dart';

-/// BLoC pour la gestion des membres
+/// BLoC pour la gestion des membres (Clean Architecture)
+@injectable
 class MembresBloc extends Bloc<MembresEvent, MembresState> {
-  final MembreRepository _repository;
+  final GetMembers _getMembers;
+  final GetMemberById _getMemberById;
+  final uc.CreateMember _createMember;
+  final uc.UpdateMember _updateMember;
+  final uc.DeleteMember _deleteMember;
+  final SearchMembers _searchMembers;
+  final GetMemberStats _getMemberStats;
+  final IMembreRepository _repository; // Pour méthodes non-couvertes par use cases

-  MembresBloc(this._repository) : super(const MembresInitial()) {
+  MembresBloc(
+    this._getMembers,
+    this._getMemberById,
+    this._createMember,
+    this._updateMember,
+    this._deleteMember,
+    this._searchMembers,
+    this._getMemberStats,
+    this._repository,
+  ) : super(const MembresInitial()) {
    on<LoadMembres>(_onLoadMembres);
    on<LoadMembreById>(_onLoadMembreById);
    on<CreateMembre>(_onCreateMembre);
@@ -39,7 +64,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
        emit(const MembresLoading());
      }

-      final result = await _repository.getMembres(
+      final result = await _getMembers(
        page: event.page,
        size: event.size,
        recherche: event.recherche,
@@ -74,7 +99,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
    try {
      emit(const MembresLoading());

-      final membre = await _repository.getMembreById(event.id);
+      final membre = await _getMemberById(event.id);

      if (membre != null) {
        emit(MembreDetailLoaded(membre));
@@ -106,7 +131,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
    try {
      emit(const MembresLoading());

-      final membre = await _repository.createMembre(event.membre);
+      final membre = await _createMember(event.membre);

      emit(MembreCreated(membre));
    } on DioException catch (e) {
@@ -141,7 +166,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
    try {
      emit(const MembresLoading());

-      final membre = await _repository.updateMembre(event.id, event.membre);
+      final membre = await _updateMember(event.id, event.membre);

      emit(MembreUpdated(membre));
    } on DioException catch (e) {
@@ -175,7 +200,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
    try {
      emit(const MembresLoading());

-      await _repository.deleteMembre(event.id);
+      await _deleteMember(event.id);

      emit(MembreDeleted(event.id));
    } on DioException catch (e) {
@@ -250,7 +275,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
    try {
      emit(const MembresLoading());

-      final result = await _repository.searchMembres(
+      final result = await _searchMembers(
        criteria: event.criteria,
        page: event.page,
        size: event.size,
@@ -353,7 +378,7 @@ class MembresBloc extends Bloc<MembresEvent, MembresState> {
    try {
      emit(const MembresLoading());

-      final stats = await _repository.getMembresStats();
+      final stats = await _getMemberStats();

      emit(MembresStatsLoaded(stats));
    } on DioException catch (e) {
--- a/unionflow/unionflow-mobile-apps/lib/features/members/data/repositories/membre_repository_impl.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/data/repositories/membre_repository_impl.dart
@@ -1,62 +1,22 @@
-/// Repository pour la gestion des membres
+/// Implémentation du repository pour la gestion des membres
 /// Interface avec l'API backend MembreResource
-library membre_repository;
+library membre_repository_impl;

 import 'package:dio/dio.dart';
+import 'package:unionflow_mobile_apps/core/network/api_client.dart';
+import 'package:injectable/injectable.dart';
+import '../../domain/repositories/membre_repository.dart';
 import '../models/membre_complete_model.dart';
 import '../../../../shared/models/membre_search_result.dart';
 import '../../../../shared/models/membre_search_criteria.dart';

-/// Interface du repository des membres
-abstract class MembreRepository {
-  /// Récupère la liste des membres avec pagination
-  Future<MembreSearchResult> getMembres({
-    int page = 0,
-    int size = 20,
-    String? recherche,
-  });
-
-  /// Récupère un membre par son ID
-  Future<MembreCompletModel?> getMembreById(String id);
-
-  /// Crée un nouveau membre
-  Future<MembreCompletModel> createMembre(MembreCompletModel membre);
-
-  /// Met à jour un membre
-  Future<MembreCompletModel> updateMembre(String id, MembreCompletModel membre);
-
-  /// Supprime un membre
-  Future<void> deleteMembre(String id);
-
-  /// Active un membre
-  Future<MembreCompletModel> activateMembre(String id);
-
-  /// Désactive un membre
-  Future<MembreCompletModel> deactivateMembre(String id);
-
-  /// Recherche avancée de membres
-  Future<MembreSearchResult> searchMembres({
-    required MembreSearchCriteria criteria,
-    int page = 0,
-    int size = 20,
-  });
-
-  /// Récupère les membres actifs
-  Future<MembreSearchResult> getActiveMembers({int page = 0, int size = 20});
-
-  /// Récupère les membres du bureau
-  Future<MembreSearchResult> getBureauMembers({int page = 0, int size = 20});
-
-  /// Récupère les statistiques des membres
-  Future<Map<String, dynamic>> getMembresStats();
-}
-
 /// Implémentation du repository des membres
-class MembreRepositoryImpl implements MembreRepository {
-  final Dio _dio;
+@LazySingleton(as: IMembreRepository)
+class MembreRepositoryImpl implements IMembreRepository {
+  final ApiClient _apiClient;
  static const String _baseUrl = '/api/membres';

-  MembreRepositoryImpl(this._dio);
+  MembreRepositoryImpl(this._apiClient);

  @override
  Future<MembreSearchResult> getMembres({
@@ -67,7 +27,7 @@ class MembreRepositoryImpl implements MembreRepository {
    try {
      // Si une recherche est fournie, utiliser l'endpoint de recherche
      if (recherche?.isNotEmpty == true) {
-        final response = await _dio.get(
+        final response = await _apiClient.get(
          '$_baseUrl/recherche',
          queryParameters: {
            'q': recherche,
@@ -80,7 +40,7 @@ class MembreRepositoryImpl implements MembreRepository {
      }

      // Sinon, récupérer tous les membres
-      final response = await _dio.get(
+      final response = await _apiClient.get(
        _baseUrl,
        queryParameters: {
          'page': page,
@@ -96,6 +56,26 @@ class MembreRepositoryImpl implements MembreRepository {
    }
  }

+  /// Normalise les clés backend pour alignement API ↔ modèle (cohérence des données).
+  MembreCompletModel _normalizeAndParseMembre(Map<String, dynamic> map) {
+    if (map.containsKey('associationNom') && !map.containsKey('organisationNom')) {
+      map['organisationNom'] = map['associationNom'];
+    }
+    if (map.containsKey('organisationId') && map['organisationId'] != null && map['organisationId'] is! String) {
+      map['organisationId'] = map['organisationId'].toString();
+    }
+    if (map.containsKey('statutCompte') && !map.containsKey('statut')) {
+      map['statut'] = map['statutCompte'];
+    }
+    if (map.containsKey('photoUrl') && !map.containsKey('photo')) {
+      map['photo'] = map['photoUrl'];
+    }
+    if (map['id'] != null && map['id'] is! String) {
+      map['id'] = map['id'].toString();
+    }
+    return MembreCompletModel.fromJson(map);
+  }
+
  /// Parse la réponse API et retourne un MembreSearchResult
  /// Gère les deux formats possibles : List (simple) ou Map (paginé)
  MembreSearchResult _parseMembreSearchResult(
@@ -112,7 +92,7 @@ class MembreRepositoryImpl implements MembreRepository {
    if (response.data is List) {
      final List<dynamic> listData = response.data as List<dynamic>;
      final membres = listData
-          .map((e) => MembreCompletModel.fromJson(e as Map<String, dynamic>))
+          .map((e) => _normalizeAndParseMembre(e as Map<String, dynamic>))
          .toList();

      return MembreSearchResult(
@@ -131,8 +111,33 @@ class MembreRepositoryImpl implements MembreRepository {
      );
    }

-    // Format paginé : objet avec métadonnées
-    return MembreSearchResult.fromJson(response.data as Map<String, dynamic>);
+    // Format paginé : PagedResponse backend (data, total, page, size, totalPages)
+    final Map<String, dynamic> data = response.data as Map<String, dynamic>;
+    final List<dynamic>? listData = data['data'] as List<dynamic>?;
+    if (listData != null) {
+      final membres = listData
+          .map((e) => _normalizeAndParseMembre(Map<String, dynamic>.from(e as Map<String, dynamic>)))
+          .toList();
+      final total = (data['total'] as num?)?.toInt() ?? membres.length;
+      final currentPage = (data['page'] as num?)?.toInt() ?? page;
+      final pageSize = (data['size'] as num?)?.toInt() ?? size;
+      final totalPages = (data['totalPages'] as num?)?.toInt() ?? (total > 0 ? 1 : 0);
+      return MembreSearchResult(
+        membres: membres,
+        totalElements: total,
+        totalPages: totalPages,
+        currentPage: currentPage,
+        pageSize: pageSize,
+        numberOfElements: membres.length,
+        hasNext: currentPage + 1 < totalPages,
+        hasPrevious: currentPage > 0,
+        isFirst: currentPage == 0,
+        isLast: currentPage >= totalPages - 1,
+        criteria: criteria,
+        executionTimeMs: 0,
+      );
+    }
+    return MembreSearchResult.fromJson(data);
  }


@@ -140,7 +145,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<MembreCompletModel?> getMembreById(String id) async {
    try {
-      final response = await _dio.get('$_baseUrl/$id');
+      final response = await _apiClient.get('$_baseUrl/$id');

      if (response.statusCode == 200) {
        return MembreCompletModel.fromJson(response.data as Map<String, dynamic>);
@@ -162,7 +167,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<MembreCompletModel> createMembre(MembreCompletModel membre) async {
    try {
-      final response = await _dio.post(
+      final response = await _apiClient.post(
        _baseUrl,
        data: membre.toJson(),
      );
@@ -182,7 +187,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<MembreCompletModel> updateMembre(String id, MembreCompletModel membre) async {
    try {
-      final response = await _dio.put(
+      final response = await _apiClient.put(
        '$_baseUrl/$id',
        data: membre.toJson(),
      );
@@ -202,7 +207,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<void> deleteMembre(String id) async {
    try {
-      final response = await _dio.delete('$_baseUrl/$id');
+      final response = await _apiClient.delete('$_baseUrl/$id');

      if (response.statusCode != 204 && response.statusCode != 200) {
        throw Exception('Erreur lors de la suppression du membre: ${response.statusCode}');
@@ -217,7 +222,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<MembreCompletModel> activateMembre(String id) async {
    try {
-      final response = await _dio.post('$_baseUrl/$id/activer');
+      final response = await _apiClient.post('$_baseUrl/$id/activer');

      if (response.statusCode == 200) {
        return MembreCompletModel.fromJson(response.data as Map<String, dynamic>);
@@ -234,7 +239,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<MembreCompletModel> deactivateMembre(String id) async {
    try {
-      final response = await _dio.post('$_baseUrl/$id/desactiver');
+      final response = await _apiClient.post('$_baseUrl/$id/desactiver');

      if (response.statusCode == 200) {
        return MembreCompletModel.fromJson(response.data as Map<String, dynamic>);
@@ -257,7 +262,7 @@ class MembreRepositoryImpl implements MembreRepository {
    try {
      // Les paramètres de pagination vont dans queryParameters
      // Les critères de recherche vont directement dans le body
-      final response = await _dio.post(
+      final response = await _apiClient.post(
        '$_baseUrl/search/advanced',
        queryParameters: {
          'page': page,
@@ -303,7 +308,7 @@ class MembreRepositoryImpl implements MembreRepository {
  @override
  Future<Map<String, dynamic>> getMembresStats() async {
    try {
-      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>;
--- a/unionflow/unionflow-mobile-apps/lib/features/members/data/services/membre_search_service.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/data/services/membre_search_service.dart
@@ -1,14 +1,18 @@
 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 '../../../../shared/models/membre_search_criteria.dart';
 import '../../../../shared/models/membre_search_result.dart';

 /// Service pour la recherche avancée de membres
 /// Gère les appels API vers l'endpoint de recherche sophistiquée
+@lazySingleton
 class MembreSearchService {
-  final Dio _dio;
+  final ApiClient _apiClient;

-  MembreSearchService(this._dio);
+  MembreSearchService(this._apiClient);

  /// Effectue une recherche avancée de membres
  ///
@@ -26,7 +30,7 @@ class MembreSearchService {
    String sortField = 'nom',
    String sortDirection = 'asc',
  }) async {
-    print('Recherche avancée de membres: ${criteria.description}');
+    AppLogger.info('Recherche avancée de membres: ${criteria.description}');

    try {
      // Validation des critères
@@ -47,7 +51,7 @@ class MembreSearchService {
      };

      // Appel API
-      final response = await _dio.post(
+      final response = await _apiClient.post(
        '/api/membres/search/advanced',
        data: criteria.toJson(),
        queryParameters: queryParams,
@@ -56,14 +60,14 @@ class MembreSearchService {
      // Parsing de la réponse
      final result = MembreSearchResult.fromJson(response.data);

-      print('Recherche terminée: ${result.totalElements} résultats en ${result.executionTimeMs}ms');
+      AppLogger.info('Recherche terminée: ${result.totalElements} résultats en ${result.executionTimeMs}ms');

      return result;
-    } on DioException catch (e) {
-      print('Erreur lors de la recherche avancée: $e');
+    } on DioException catch (e, st) {
+      AppLogger.error('MembreSearchService: recherche avancée échouée', error: e, stackTrace: st);
      rethrow;
-    } catch (e) {
-      print('Erreur inattendue lors de la recherche: $e');
+    } catch (e, st) {
+      AppLogger.error('MembreSearchService: erreur inattendue recherche', error: e, stackTrace: st);
      rethrow;
    }
  }
@@ -246,12 +250,12 @@ class MembreSearchService {
  /// Valide les critères de recherche avant envoi
  bool validateCriteria(MembreSearchCriteria criteria) {
    if (!criteria.hasAnyCriteria) {
-      print('Aucun critère de recherche spécifié');
+      AppLogger.warning('MembreSearchService: aucun critère de recherche spécifié');
      return false;
    }

    if (!criteria.isValid) {
-      print('Critères de recherche invalides: ${criteria.description}');
+      AppLogger.warning('MembreSearchService: critères invalides', tag: criteria.description);
      return false;
    }

--- a/unionflow/unionflow-mobile-apps/lib/features/members/di/membres_di.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/di/membres_di.dart
@@ -1,45 +0,0 @@
-/// Module de Dependency Injection pour les membres
-library membres_di;
-
-import 'package:get_it/get_it.dart';
-import 'package:dio/dio.dart';
-import '../data/repositories/membre_repository_impl.dart';
-import '../data/services/membre_search_service.dart';
-import '../bloc/membres_bloc.dart';
-
-/// Configuration de l'injection de dépendances pour le module Membres
-class MembresDI {
-  static final GetIt _getIt = GetIt.instance;
-
-  /// Enregistre toutes les dépendances du module Membres
-  static void register() {
-    // Repository
-    _getIt.registerLazySingleton<MembreRepository>(
-      () => MembreRepositoryImpl(_getIt<Dio>()),
-    );
-
-    // Service de recherche de membres (utilisé par adhésions, etc.)
-    _getIt.registerLazySingleton<MembreSearchService>(
-      () => MembreSearchService(_getIt<Dio>()),
-    );
-
-    // BLoC - Factory pour créer une nouvelle instance à chaque fois
-    _getIt.registerFactory<MembresBloc>(
-      () => MembresBloc(_getIt<MembreRepository>()),
-    );
-  }
-
-  /// Désenregistre toutes les dépendances (pour les tests)
-  static void unregister() {
-    if (_getIt.isRegistered<MembresBloc>()) {
-      _getIt.unregister<MembresBloc>();
-    }
-    if (_getIt.isRegistered<MembreSearchService>()) {
-      _getIt.unregister<MembreSearchService>();
-    }
-    if (_getIt.isRegistered<MembreRepository>()) {
-      _getIt.unregister<MembreRepository>();
-    }
-  }
-}
-
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/repositories/membre_repository.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/repositories/membre_repository.dart
@@ -0,0 +1,51 @@
+/// Interface du repository des membres (Clean Architecture)
+library membre_repository_interface;
+
+import '../../data/models/membre_complete_model.dart';
+import '../../../../shared/models/membre_search_result.dart';
+import '../../../../shared/models/membre_search_criteria.dart';
+
+/// Interface définissant le contrat du repository des membres
+/// Implémentée par MembreRepositoryImpl dans la couche data
+abstract class IMembreRepository {
+  /// Récupère la liste des membres avec pagination
+  Future<MembreSearchResult> getMembres({
+    int page = 0,
+    int size = 20,
+    String? recherche,
+  });
+
+  /// Récupère un membre par son ID
+  Future<MembreCompletModel?> getMembreById(String id);
+
+  /// Crée un nouveau membre
+  Future<MembreCompletModel> createMembre(MembreCompletModel membre);
+
+  /// Met à jour un membre
+  Future<MembreCompletModel> updateMembre(String id, MembreCompletModel membre);
+
+  /// Supprime un membre
+  Future<void> deleteMembre(String id);
+
+  /// Active un membre
+  Future<MembreCompletModel> activateMembre(String id);
+
+  /// Désactive un membre
+  Future<MembreCompletModel> deactivateMembre(String id);
+
+  /// Recherche avancée de membres
+  Future<MembreSearchResult> searchMembres({
+    required MembreSearchCriteria criteria,
+    int page = 0,
+    int size = 20,
+  });
+
+  /// Récupère les membres actifs
+  Future<MembreSearchResult> getActiveMembers({int page = 0, int size = 20});
+
+  /// Récupère les membres du bureau
+  Future<MembreSearchResult> getBureauMembers({int page = 0, int size = 20});
+
+  /// Récupère les statistiques des membres
+  Future<Map<String, dynamic>> getMembresStats();
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/create_member.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/create_member.dart
@@ -0,0 +1,25 @@
+/// Use case: Créer un nouveau membre
+library create_member;
+
+import 'package:injectable/injectable.dart';
+import '../../data/models/membre_complete_model.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour créer un membre
+/// Réservé aux utilisateurs avec le rôle HR_MANAGER
+@injectable
+class CreateMember {
+  final IMembreRepository _repository;
+
+  CreateMember(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [membre] - Modèle complet du membre à créer
+  ///
+  /// Retourne le membre créé avec son ID généré
+  /// Lève une exception en cas d'erreur de validation ou de création
+  Future<MembreCompletModel> call(MembreCompletModel membre) async {
+    return _repository.createMembre(membre);
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/delete_member.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/delete_member.dart
@@ -0,0 +1,25 @@
+/// Use case: Supprimer un membre
+library delete_member;
+
+import 'package:injectable/injectable.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour supprimer un membre
+/// Réservé aux utilisateurs avec le rôle HR_MANAGER ou ADMIN_ORGANISATION
+@injectable
+class DeleteMember {
+  final IMembreRepository _repository;
+
+  DeleteMember(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [id] - UUID du membre à supprimer
+  ///
+  /// Supprime le membre de manière définitive ou le marque comme inactif
+  /// selon la configuration de l'organisation
+  /// Lève une exception si le membre n'existe pas ou ne peut être supprimé
+  Future<void> call(String id) async {
+    return _repository.deleteMembre(id);
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/export_members.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/export_members.dart
@@ -0,0 +1,49 @@
+/// Use case: Exporter la liste des membres
+library export_members;
+
+import 'package:injectable/injectable.dart';
+import '../../../../shared/models/membre_search_criteria.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour exporter la liste des membres au format CSV ou PDF
+/// Réservé aux utilisateurs avec le rôle ADMIN_ORGANISATION
+@injectable
+class ExportMembers {
+  final IMembreRepository _repository;
+
+  ExportMembers(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [criteria] - Critères de filtre pour l'export (optionnel)
+  /// [format] - Format d'export ('csv' ou 'pdf')
+  ///
+  /// Retourne les données exportées (liste complète des membres selon critères)
+  /// TODO: Ajouter endpoint backend GET /api/membres/export?format=csv|pdf
+  /// Le use case actuel récupère toutes les données, l'export final se fait côté UI
+  Future<List<Map<String, dynamic>>> call({
+    MembreSearchCriteria? criteria,
+    String format = 'csv',
+  }) async {
+    // Récupérer tous les membres (pagination large)
+    final result = await _repository.searchMembres(
+      criteria: criteria ?? const MembreSearchCriteria(),
+      page: 0,
+      size: 10000, // Grande pagination pour export complet
+    );
+
+    // Convertir en liste de maps pour l'export
+    return result.membres.map((membre) => {
+      'id': membre.id,
+      'nom': membre.nom,
+      'prenom': membre.prenom,
+      'email': membre.email,
+      'telephone': membre.telephone,
+      'adresse': membre.adresse,
+      'dateNaissance': membre.dateNaissance?.toIso8601String(),
+      'dateAdhesion': membre.dateAdhesion?.toIso8601String(),
+      'statut': membre.statut,
+      'actif': membre.actif,
+    }).toList();
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/get_member_by_id.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/get_member_by_id.dart
@@ -0,0 +1,24 @@
+/// Use case: Récupérer un membre par son ID
+library get_member_by_id;
+
+import 'package:injectable/injectable.dart';
+import '../../data/models/membre_complete_model.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour récupérer le détail complet d'un membre
+@injectable
+class GetMemberById {
+  final IMembreRepository _repository;
+
+  GetMemberById(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [id] - UUID du membre
+  ///
+  /// Retourne le détail complet du membre avec toutes ses informations
+  /// Retourne null si le membre n'existe pas
+  Future<MembreCompletModel?> call(String id) async {
+    return _repository.getMembreById(id);
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/get_member_stats.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/get_member_stats.dart
@@ -0,0 +1,29 @@
+/// Use case: Récupérer les statistiques des membres
+library get_member_stats;
+
+import 'package:injectable/injectable.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour récupérer les statistiques globales des membres
+/// Réservé aux utilisateurs avec le rôle ADMIN_ORGANISATION
+@injectable
+class GetMemberStats {
+  final IMembreRepository _repository;
+
+  GetMemberStats(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// Retourne un Map contenant les statistiques:
+  /// - totalMembres: Nombre total de membres
+  /// - membresActifs: Nombre de membres actifs
+  /// - membresInactifs: Nombre de membres inactifs
+  /// - nouveauxMembres30j: Nouveaux membres sur les 30 derniers jours
+  /// - membresBureau: Nombre de membres du bureau
+  /// - tauxActivite: Taux d'activité en pourcentage
+  ///
+  /// Lève une exception en cas d'erreur d'accès
+  Future<Map<String, dynamic>> call() async {
+    return _repository.getMembresStats();
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/get_members.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/get_members.dart
@@ -0,0 +1,33 @@
+/// Use case: Récupérer la liste des membres
+library get_members;
+
+import 'package:injectable/injectable.dart';
+import '../../../../shared/models/membre_search_result.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour récupérer la liste des membres avec pagination
+@injectable
+class GetMembers {
+  final IMembreRepository _repository;
+
+  GetMembers(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [page] - Numéro de page (pagination)
+  /// [size] - Taille de la page
+  /// [recherche] - Terme de recherche simple (optionnel)
+  ///
+  /// Retourne la liste paginée des membres
+  Future<MembreSearchResult> call({
+    int page = 0,
+    int size = 20,
+    String? recherche,
+  }) async {
+    return _repository.getMembres(
+      page: page,
+      size: size,
+      recherche: recherche,
+    );
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/search_members.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/search_members.dart
@@ -0,0 +1,35 @@
+/// Use case: Recherche avancée de membres
+library search_members;
+
+import 'package:injectable/injectable.dart';
+import '../../../../shared/models/membre_search_result.dart';
+import '../../../../shared/models/membre_search_criteria.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour effectuer une recherche avancée de membres
+/// avec critères multiples (nom, email, téléphone, statut, rôle, organisation, etc.)
+@injectable
+class SearchMembers {
+  final IMembreRepository _repository;
+
+  SearchMembers(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [criteria] - Critères de recherche avancée
+  /// [page] - Numéro de page (pagination)
+  /// [size] - Taille de la page
+  ///
+  /// Retourne la liste paginée des membres correspondant aux critères
+  Future<MembreSearchResult> call({
+    required MembreSearchCriteria criteria,
+    int page = 0,
+    int size = 20,
+  }) async {
+    return _repository.searchMembres(
+      criteria: criteria,
+      page: page,
+      size: size,
+    );
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/update_member.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/domain/usecases/update_member.dart
@@ -0,0 +1,26 @@
+/// Use case: Mettre à jour un membre existant
+library update_member;
+
+import 'package:injectable/injectable.dart';
+import '../../data/models/membre_complete_model.dart';
+import '../repositories/membre_repository.dart';
+
+/// Use case pour modifier un membre
+/// Réservé aux utilisateurs avec le rôle HR_MANAGER
+@injectable
+class UpdateMember {
+  final IMembreRepository _repository;
+
+  UpdateMember(this._repository);
+
+  /// Exécute le use case
+  ///
+  /// [id] - UUID du membre à modifier
+  /// [membre] - Données mises à jour
+  ///
+  /// Retourne le membre modifié
+  /// Lève une exception si le membre n'existe pas ou erreur de validation
+  Future<MembreCompletModel> call(String id, MembreCompletModel membre) async {
+    return _repository.updateMembre(id, membre);
+  }
+}
--- a/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/advanced_search_page.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/advanced_search_page.dart
@@ -1,7 +1,9 @@
 import 'package:flutter/material.dart';
-import 'package:get_it/get_it.dart';
+import '../../../../core/di/injection_container.dart';
 import '../../../../shared/models/membre_search_criteria.dart';
 import '../../../../shared/models/membre_search_result.dart';
+import '../../../organizations/data/repositories/organization_repository.dart';
+import '../../../organizations/data/models/organization_model.dart';
 import '../../data/services/membre_search_service.dart';
 import '../widgets/membre_search_results.dart';
 import '../widgets/search_statistics_card.dart';
@@ -18,8 +20,10 @@ class AdvancedSearchPage extends StatefulWidget {
 class _AdvancedSearchPageState extends State<AdvancedSearchPage>
    with TickerProviderStateMixin {
  late TabController _tabController;
-  final MembreSearchService _searchService = GetIt.instance<MembreSearchService>();
+  late final MembreSearchService _searchService = sl<MembreSearchService>();
  MembreSearchCriteria _currentCriteria = MembreSearchCriteria.empty;
+  List<OrganizationModel> _organisations = [];
+  bool _organisationsLoaded = false;
  MembreSearchResult? _currentResult;
  bool _isSearching = false;
  String? _errorMessage;
@@ -44,10 +48,53 @@ class _AdvancedSearchPageState extends State<AdvancedSearchPage>
  bool _membreBureau = false;
  bool _responsable = false;

+  /// Rôles Keycloak utilisables pour le filtre (noms envoyés à l'API)
+  static const List<String> _searchRoleCodes = [
+    'MEMBRE_ACTIF',
+    'MEMBRE_SIMPLE',
+    'ADMIN_ORGANISATION',
+    'SECRETAIRE',
+    'TRESORIER',
+    'CONSULTANT',
+    'GESTIONNAIRE_RH',
+    'SUPER_ADMINISTRATEUR',
+  ];
+
  @override
  void initState() {
    super.initState();
    _tabController = TabController(length: 3, vsync: this);
+    _loadOrganisations();
+  }
+
+  static String _roleDisplayName(String code) {
+    const labels = {
+      'MEMBRE_ACTIF': 'Membre actif',
+      'MEMBRE_SIMPLE': 'Membre',
+      'ADMIN_ORGANISATION': 'Admin organisation',
+      'SECRETAIRE': 'Secrétaire',
+      'TRESORIER': 'Trésorier',
+      'CONSULTANT': 'Consultant',
+      'GESTIONNAIRE_RH': 'Gestionnaire RH',
+      'SUPER_ADMINISTRATEUR': 'Super admin',
+    };
+    return labels[code] ?? code;
+  }
+
+  Future<void> _loadOrganisations() async {
+    if (_organisationsLoaded) return;
+    try {
+      final repo = sl<OrganizationRepository>();
+      final list = await repo.getOrganizations(page: 0, size: 200);
+      if (mounted) {
+        setState(() {
+          _organisations = list;
+          _organisationsLoaded = true;
+        });
+      }
+    } catch (_) {
+      if (mounted) setState(() => _organisationsLoaded = true);
+    }
  }

  @override
@@ -226,7 +273,7 @@ class _AdvancedSearchPageState extends State<AdvancedSearchPage>
              controller: _emailController,
              decoration: const InputDecoration(
                labelText: 'Email',
-                hintText: 'exemple@unionflow.com',
+                hintText: 'email@domaine.org',
                border: OutlineInputBorder(),
              ),
            ),
@@ -305,6 +352,74 @@ class _AdvancedSearchPageState extends State<AdvancedSearchPage>
            ),
            const SizedBox(height: 16),

+            // Organisations (multi-select)
+            Text(
+              'Organisations',
+              style: Theme.of(context).textTheme.titleSmall?.copyWith(
+                    fontWeight: FontWeight.w600,
+                  ),
+            ),
+            const SizedBox(height: 8),
+            _organisations.isEmpty && !_organisationsLoaded
+                ? const SizedBox(
+                    height: 24,
+                    child: Center(child: CircularProgressIndicator(strokeWidth: 2)),
+                  )
+                : Wrap(
+                    spacing: 8,
+                    runSpacing: 8,
+                    children: _organisations
+                        .where((o) => o.id != null && o.id!.isNotEmpty)
+                        .map((org) {
+                      final id = org.id!;
+                      final selected = _selectedOrganisations.contains(id);
+                      return FilterChip(
+                        label: Text(org.nomCourt ?? org.nom, overflow: TextOverflow.ellipsis, maxLines: 1),
+                        selected: selected,
+                        onSelected: (v) {
+                          setState(() {
+                            if (v) {
+                              _selectedOrganisations.add(id);
+                            } else {
+                              _selectedOrganisations.remove(id);
+                            }
+                          });
+                        },
+                      );
+                    }).toList(),
+                  ),
+            const SizedBox(height: 16),
+
+            // Rôles (multi-select)
+            Text(
+              'Rôles',
+              style: Theme.of(context).textTheme.titleSmall?.copyWith(
+                    fontWeight: FontWeight.w600,
+                  ),
+            ),
+            const SizedBox(height: 8),
+            Wrap(
+              spacing: 8,
+              runSpacing: 8,
+              children: _searchRoleCodes.map((code) {
+                final selected = _selectedRoles.contains(code);
+                return FilterChip(
+                  label: Text(_roleDisplayName(code)),
+                  selected: selected,
+                  onSelected: (v) {
+                    setState(() {
+                      if (v) {
+                        _selectedRoles.add(code);
+                      } else {
+                        _selectedRoles.remove(code);
+                      }
+                    });
+                  },
+                );
+              }).toList(),
+            ),
+            const SizedBox(height: 16),
+
            // Options booléennes
            CheckboxListTile(
              title: const Text('Inclure les membres inactifs'),
--- a/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/members_page.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/members_page.dart
@@ -1,8 +1,10 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:url_launcher/url_launcher.dart';
 import '../../../../shared/design_system/unionflow_design_system.dart';
 import '../../../../features/authentication/presentation/bloc/auth_bloc.dart';
 import '../../../../features/authentication/data/models/user_role.dart';
+import '../../../adhesions/presentation/pages/adhesions_page_wrapper.dart';

 /// Page de gestion des membres - Interface sophistiquée et exhaustive
 ///
@@ -1131,12 +1133,23 @@ class _MembersPageState extends State<MembersPage> with TickerProviderStateMixin
      context: context,
      builder: (context) => AlertDialog(
        title: const Text('Ajouter un membre'),
-        content: const Text('Fonctionnalité d\'ajout de membre à implémenter'),
+        content: const Text(
+          'Pour enregistrer un nouveau membre, créez une adhésion depuis le module Adhésions.',
+        ),
        actions: [
          TextButton(
            onPressed: () => Navigator.of(context).pop(),
            child: const Text('Fermer'),
          ),
+          ElevatedButton(
+            onPressed: () {
+              Navigator.of(context).pop();
+              Navigator.of(context).push(
+                MaterialPageRoute<void>(builder: (_) => const AdhesionsPageWrapper()),
+              );
+            },
+            child: const Text('Créer une adhésion'),
+          ),
        ],
      ),
    );
@@ -1144,10 +1157,35 @@ class _MembersPageState extends State<MembersPage> with TickerProviderStateMixin

  /// Affiche les actions groupées
  void _showBulkActions() {
-    ScaffoldMessenger.of(context).showSnackBar(
-      const SnackBar(
-        content: Text('Actions groupées à implémenter'),
-        backgroundColor: Color(0xFF6C5CE7),
+    showModalBottomSheet<void>(
+      context: context,
+      builder: (context) => SafeArea(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            ListTile(
+              leading: const Icon(Icons.file_download_outlined),
+              title: const Text('Exporter la sélection'),
+              onTap: () {
+                Navigator.pop(context);
+                _exportMembers();
+              },
+            ),
+            ListTile(
+              leading: const Icon(Icons.email_outlined),
+              title: const Text('Envoyer un message groupé'),
+              onTap: () {
+                Navigator.pop(context);
+                ScaffoldMessenger.of(context).showSnackBar(
+                  const SnackBar(
+                    content: Text('Messagerie groupée à venir. Utilisez l\'action « Message » sur un membre.'),
+                    backgroundColor: Color(0xFF6C5CE7),
+                  ),
+                );
+              },
+            ),
+          ],
+        ),
      ),
    );
  }
@@ -1190,25 +1228,10 @@ class _MembersPageState extends State<MembersPage> with TickerProviderStateMixin
    }
  }

-  /// Dialog d'édition de membre
+  /// Dialog d'édition de membre : ouvre la fiche détail (édition complète à venir)
  void _showEditMemberDialog(Map<String, dynamic> member) {
-    showDialog(
-      context: context,
-      builder: (context) => AlertDialog(
-        title: Text('Modifier ${member['name']}'),
-        content: const Text('Fonctionnalité de modification à implémenter'),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.of(context).pop(),
-            child: const Text('Annuler'),
-          ),
-          ElevatedButton(
-            onPressed: () => Navigator.of(context).pop(),
-            child: const Text('Sauvegarder'),
-          ),
-        ],
-      ),
-    );
+    Navigator.of(context).pop(); // ferme le dialog éventuel
+    _showMemberDetails(member);
  }

  /// Envoie un message à un membre
--- a/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/members_page_connected.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/members_page_connected.dart
--- a/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/members_page_wrapper.dart
+++ b/unionflow/unionflow-mobile-apps/lib/features/members/presentation/pages/members_page_wrapper.dart
@@ -15,6 +15,7 @@ import '../../bloc/membres_bloc.dart';
 import '../../bloc/membres_event.dart';
 import '../../bloc/membres_state.dart';
 import '../../data/models/membre_complete_model.dart';
+import '../widgets/add_member_dialog.dart';
 import 'members_page_connected.dart';

 final _getIt = GetIt.instance;
@@ -50,6 +51,11 @@ class MembersPageConnected extends StatelessWidget {
  Widget build(BuildContext context) {
    return BlocListener<MembresBloc, MembresState>(
      listener: (context, state) {
+        // Après création : recharger la liste
+        if (state is MembreCreated) {
+          context.read<MembresBloc>().add(const LoadMembres(refresh: true));
+        }
+
        // Gestion des erreurs avec SnackBar
        if (state is MembresError) {
          ScaffoldMessenger.of(context).showSnackBar(
@@ -67,12 +73,6 @@ class MembersPageConnected extends StatelessWidget {
            ),
          );
        }
-
-        // Message de succès après création
-        if (state is MembresLoaded && state.membres.isNotEmpty) {
-          // Note: On pourrait ajouter un flag dans le state pour savoir si c'est après une création
-          // Pour l'instant, on ne fait rien ici
-        }
      },
      child: BlocBuilder<MembresBloc, MembresState>(
        builder: (context, state) {
@@ -109,6 +109,16 @@ class MembersPageConnected extends StatelessWidget {
          );
        }

+        // Après création : on recharge la liste (listener a dispatché LoadMembres)
+        if (state is MembreCreated) {
+          return Container(
+            color: const Color(0xFFF8F9FA),
+            child: const Center(
+              child: AppLoadingWidget(message: 'Actualisation...'),
+            ),
+          );
+        }
+
        // État chargé avec succès
        if (state is MembresLoaded) {
          final membres = state.membres;
@@ -122,14 +132,23 @@ class MembersPageConnected extends StatelessWidget {
            totalCount: state.totalElements,
            currentPage: state.currentPage,
            totalPages: state.totalPages,
-            onPageChanged: (newPage) {
+            onPageChanged: (newPage, recherche) {
              AppLogger.userAction('Load page', data: {'page': newPage});
-              context.read<MembresBloc>().add(LoadMembres(page: newPage));
+              context.read<MembresBloc>().add(LoadMembres(page: newPage, recherche: recherche));
            },
            onRefresh: () {
              AppLogger.userAction('Refresh membres');
              context.read<MembresBloc>().add(const LoadMembres(refresh: true));
            },
+            onSearch: (query) {
+              context.read<MembresBloc>().add(LoadMembres(page: 0, recherche: query));
+            },
+            onAddMember: () async {
+              await showDialog<void>(
+                context: context,
+                builder: (_) => const AddMemberDialog(),
+              );
+            },
          );
        }

@@ -195,10 +214,10 @@ class MembersPageConnected extends StatelessWidget {
      'phone': membre.telephone ?? '',
      'department': membre.profession ?? '',
      'location': '${membre.ville ?? ''}, ${membre.pays ?? ''}',
-      'permissions': 15, // Calcul permissions non implémenté côté backend
-      'contributionScore': 0, // Pas de champ backend correspondant
+      'permissions': 15, // Valeurs par défaut tant que l'API ne fournit pas permissions
+      'contributionScore': 0, // Valeurs par défaut tant que l'API ne fournit pas contributionScore
      'eventsAttended': membre.nombreEvenementsParticipes,
-      'projectsInvolved': 0, // Pas de champ backend correspondant
+      'projectsInvolved': 0, // Valeurs par défaut tant que l'API ne fournit pas projectsInvolved
      
      // Champs supplémentaires du modèle
      'prenom': membre.prenom,