refactor(#93): extraire un widget UserList réutilisable

Centralise le pattern d'affichage des listes utilisateurs pour garantir une UI homogène entre gestionnaires, parents, assistantes maternelles et administrateurs.

Co-authored-by: Cursor <cursoragent@cursor.com>

frontend/lib/screens/administrateurs/admin_dashboardScreen.dart

@@ -1,10 +1,7 @@
 import 'package:flutter/material.dart';
 import 'package:p_tits_pas/services/configuration_service.dart';
-import 'package:p_tits_pas/widgets/admin/assistante_maternelle_management_widget.dart';
-import 'package:p_tits_pas/widgets/admin/gestionnaire_management_widget.dart';
-import 'package:p_tits_pas/widgets/admin/parent_managmant_widget.dart';
-import 'package:p_tits_pas/widgets/admin/admin_management_widget.dart';
 import 'package:p_tits_pas/widgets/admin/parametres_panel.dart';
+import 'package:p_tits_pas/widgets/admin/user_management_panel.dart';
 import 'package:p_tits_pas/widgets/app_footer.dart';
 import 'package:p_tits_pas/widgets/admin/dashboard_admin.dart';
 
@@ -18,7 +15,6 @@ class AdminDashboardScreen extends StatefulWidget {
 class _AdminDashboardScreenState extends State<AdminDashboardScreen> {
   bool? _setupCompleted;
   int mainTabIndex = 0;
-  int subIndex = 0;
   int settingsSubIndex = 0;
 
   @override
@@ -27,6 +23,11 @@ class _AdminDashboardScreenState extends State<AdminDashboardScreen> {
     _loadSetupStatus();
   }
 
+  @override
+  void dispose() {
+    super.dispose();
+  }
+
   Future<void> _loadSetupStatus() async {
     try {
       final completed = await ConfigurationService.getSetupStatus();
@@ -51,12 +52,6 @@ class _AdminDashboardScreenState extends State<AdminDashboardScreen> {
     });
   }
 
-  void onSubTabChange(int index) {
-    setState(() {
-      subIndex = index;
-    });
-  }
-
   void onSettingsSubTabChange(int index) {
     setState(() {
       settingsSubIndex = index;
@@ -89,10 +84,7 @@ class _AdminDashboardScreenState extends State<AdminDashboardScreen> {
       body: Column(
         children: [
           if (mainTabIndex == 0)
-            DashboardUserManagementSubBar(
+            const SizedBox.shrink()
-              selectedSubIndex: subIndex,
-              onSubTabChange: onSubTabChange,
-            )
           else
             DashboardSettingsSubBar(
               selectedSubIndex: settingsSubIndex,
@@ -114,17 +106,6 @@ class _AdminDashboardScreenState extends State<AdminDashboardScreen> {
         selectedSettingsTabIndex: settingsSubIndex,
       );
     }
-    switch (subIndex) {
+    return const AdminUserManagementPanel();
-      case 0:
-        return const GestionnaireManagementWidget();
-      case 1:
-        return const ParentManagementWidget();
-      case 2:
-        return const AssistanteMaternelleManagementWidget();
-      case 3:
-        return const AdminManagementWidget();
-      default:
-        return const Center(child: Text('Page non trouvée'));
-    }
   }
 }

frontend/lib/widgets/admin/admin_management_widget.dart

@@ -1,8 +1,8 @@
 import 'package:flutter/material.dart';
 import 'package:p_tits_pas/models/user.dart';
 import 'package:p_tits_pas/services/user_service.dart';
-import 'package:p_tits_pas/widgets/admin/common/admin_list_state.dart';
 import 'package:p_tits_pas/widgets/admin/common/admin_user_card.dart';
+import 'package:p_tits_pas/widgets/admin/common/user_list.dart';
 
 class AdminManagementWidget extends StatefulWidget {
   final String searchQuery;
@@ -60,42 +60,32 @@ class _AdminManagementWidgetState extends State<AdminManagementWidget> {
       return name.contains(query) || email.contains(query);
     }).toList();
 
-    return Padding(
+    return UserList(
-      padding: const EdgeInsets.all(16),
+      isLoading: _isLoading,
-      child: Column(
+      error: _error,
-        crossAxisAlignment: CrossAxisAlignment.stretch,
+      isEmpty: filteredAdmins.isEmpty,
-        children: [
+      emptyMessage: 'Aucun administrateur trouvé.',
-          AdminListState(
+      itemCount: filteredAdmins.length,
-            isLoading: _isLoading,
+      itemBuilder: (context, index) {
-            error: _error,
+        final user = filteredAdmins[index];
-            isEmpty: filteredAdmins.isEmpty,
+        return AdminUserCard(
-            emptyMessage: 'Aucun administrateur trouvé.',
+          title: user.fullName,
-            list: ListView.builder(
+          subtitleLines: [
-              itemCount: filteredAdmins.length,
+            user.email,
-              itemBuilder: (context, index) {
+            'Rôle : ${user.role}',
-                final user = filteredAdmins[index];
+          ],
-                return AdminUserCard(
+          avatarUrl: user.photoUrl,
-                  title: user.fullName,
+          actions: [
-                  subtitleLines: [
+            IconButton(
-                    user.email,
+              icon: const Icon(Icons.edit),
-                    'Rôle : ${user.role}',
+              tooltip: 'Modifier',
-                  ],
+              onPressed: () {
-                  avatarUrl: user.photoUrl,
+                // TODO: Modifier admin
-                  actions: [
-                    IconButton(
-                      icon: const Icon(Icons.edit),
-                      tooltip: 'Modifier',
-                      onPressed: () {
-                        // TODO: Modifier admin
-                      },
-                    ),
-                  ],
-                );
               },
             ),
-          ),
+          ],
-        ],
+        );
-      ),
+      },
     );
   }
 }

frontend/lib/widgets/admin/assistante_maternelle_management_widget.dart

@@ -2,8 +2,8 @@ import 'package:flutter/material.dart';
 import 'package:p_tits_pas/models/assistante_maternelle_model.dart';
 import 'package:p_tits_pas/services/user_service.dart';
 import 'package:p_tits_pas/widgets/admin/common/admin_detail_modal.dart';
-import 'package:p_tits_pas/widgets/admin/common/admin_list_state.dart';
 import 'package:p_tits_pas/widgets/admin/common/admin_user_card.dart';
+import 'package:p_tits_pas/widgets/admin/common/user_list.dart';
 
 class AssistanteMaternelleManagementWidget extends StatefulWidget {
   final String searchQuery;
@@ -68,43 +68,33 @@ class _AssistanteMaternelleManagementWidgetState
       return matchesName && matchesCapacity;
     }).toList();
 
-    return Padding(
+    return UserList(
-      padding: const EdgeInsets.all(16),
+      isLoading: _isLoading,
-      child: Column(
+      error: _error,
-        crossAxisAlignment: CrossAxisAlignment.start,
+      isEmpty: filteredAssistantes.isEmpty,
-        children: [
+      emptyMessage: 'Aucune assistante maternelle trouvée.',
-          AdminListState(
+      itemCount: filteredAssistantes.length,
-            isLoading: _isLoading,
+      itemBuilder: (context, index) {
-            error: _error,
+        final assistante = filteredAssistantes[index];
-            isEmpty: filteredAssistantes.isEmpty,
+        return AdminUserCard(
-            emptyMessage: 'Aucune assistante maternelle trouvée.',
+          title: assistante.user.fullName,
-            list: ListView.builder(
+          avatarUrl: assistante.user.photoUrl,
-              itemCount: filteredAssistantes.length,
+          fallbackIcon: Icons.face,
-              itemBuilder: (context, index) {
+          subtitleLines: [
-                final assistante = filteredAssistantes[index];
+            assistante.user.email,
-                return AdminUserCard(
+            'Zone : ${assistante.residenceCity ?? 'N/A'} | Capacité : ${assistante.maxChildren ?? 0}',
-                  title: assistante.user.fullName,
+          ],
-                  avatarUrl: assistante.user.photoUrl,
+          actions: [
-                  fallbackIcon: Icons.face,
+            IconButton(
-                  subtitleLines: [
+              icon: const Icon(Icons.edit),
-                    assistante.user.email,
+              tooltip: 'Modifier',
-                    'Zone : ${assistante.residenceCity ?? 'N/A'} | Capacité : ${assistante.maxChildren ?? 0}',
+              onPressed: () {
-                  ],
+                _openAssistanteDetails(assistante);
-                  actions: [
-                    IconButton(
-                      icon: const Icon(Icons.edit),
-                      tooltip: 'Modifier',
-                      onPressed: () {
-                        _openAssistanteDetails(assistante);
-                      },
-                    ),
-                  ],
-                );
               },
             ),
-          ),
+          ],
-        ],
+        );
-      ),
+      },
     );
   }
 

frontend/lib/widgets/admin/common/user_list.dart

@@ -0,0 +1,45 @@
+import 'package:flutter/material.dart';
+import 'package:p_tits_pas/widgets/admin/common/admin_list_state.dart';
+
+class UserList extends StatelessWidget {
+  final bool isLoading;
+  final String? error;
+  final bool isEmpty;
+  final String emptyMessage;
+  final int itemCount;
+  final Widget Function(BuildContext context, int index) itemBuilder;
+  final EdgeInsetsGeometry padding;
+
+  const UserList({
+    super.key,
+    required this.isLoading,
+    required this.error,
+    required this.isEmpty,
+    required this.emptyMessage,
+    required this.itemCount,
+    required this.itemBuilder,
+    this.padding = const EdgeInsets.all(16),
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return Padding(
+      padding: padding,
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          AdminListState(
+            isLoading: isLoading,
+            error: error,
+            isEmpty: isEmpty,
+            emptyMessage: emptyMessage,
+            list: ListView.builder(
+              itemCount: itemCount,
+              itemBuilder: itemBuilder,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

frontend/lib/widgets/admin/gestionnaire_management_widget.dart

@@ -3,9 +3,16 @@ import 'package:p_tits_pas/models/relais_model.dart';
 import 'package:p_tits_pas/models/user.dart';
 import 'package:p_tits_pas/services/relais_service.dart';
 import 'package:p_tits_pas/services/user_service.dart';
+import 'package:p_tits_pas/widgets/admin/common/admin_user_card.dart';
+import 'package:p_tits_pas/widgets/admin/common/user_list.dart';
 
 class GestionnaireManagementWidget extends StatefulWidget {
-  const GestionnaireManagementWidget({Key? key}) : super(key: key);
+  final String searchQuery;
+
+  const GestionnaireManagementWidget({
+    Key? key,
+    required this.searchQuery,
+  }) : super(key: key);
 
   @override
   State<GestionnaireManagementWidget> createState() =>
@@ -18,21 +25,15 @@ class _GestionnaireManagementWidgetState
   String? _error;
   List<AppUser> _gestionnaires = [];
   List<RelaisModel> _relais = [];
-  List<AppUser> _filteredGestionnaires = [];
-  final TextEditingController _searchController = TextEditingController();
 
   @override
   void initState() {
     super.initState();
     _loadGestionnaires();
-    _searchController.addListener(_onSearchChanged);
   }
 
   @override
-  void dispose() {
+  void dispose() => super.dispose();
-    _searchController.dispose();
-    super.dispose();
-  }
 
   Future<void> _loadGestionnaires() async {
     setState(() {
@@ -52,7 +53,6 @@ class _GestionnaireManagementWidgetState
       setState(() {
         _gestionnaires = gestionnaires;
         _relais = relais;
-        _filteredGestionnaires = gestionnaires;
         _isLoading = false;
       });
     } catch (e) {
@@ -64,17 +64,6 @@ class _GestionnaireManagementWidgetState
     }
   }
 
-  void _onSearchChanged() {
-    final query = _searchController.text.toLowerCase();
-    setState(() {
-      _filteredGestionnaires = _gestionnaires.where((u) {
-        final name = u.fullName.toLowerCase();
-        final email = u.email.toLowerCase();
-        return name.contains(query) || email.contains(query);
-      }).toList();
-    });
-  }
-
   Future<void> _openRelaisAssignmentDialog(AppUser user) async {
     String? selectedRelaisId = user.relaisId;
     final saved = await showDialog<bool>(
@@ -155,92 +144,45 @@ class _GestionnaireManagementWidgetState
 
   @override
   Widget build(BuildContext context) {
-    return Padding(
+    final query = widget.searchQuery.toLowerCase();
-      padding: const EdgeInsets.all(16),
+    final filteredGestionnaires = _gestionnaires.where((u) {
-      child: Column(
+      final name = u.fullName.toLowerCase();
-        crossAxisAlignment: CrossAxisAlignment.stretch,
+      final email = u.email.toLowerCase();
-        children: [
+      return name.contains(query) || email.contains(query);
-          Row(
+    }).toList();
-            children: [
+
-              Expanded(
+    return UserList(
-                child: TextField(
+      isLoading: _isLoading,
-                  controller: _searchController,
+      error: _error,
-                  decoration: const InputDecoration(
+      isEmpty: filteredGestionnaires.isEmpty,
-                    hintText: 'Rechercher un gestionnaire...',
+      emptyMessage: 'Aucun gestionnaire trouvé.',
-                    prefixIcon: Icon(Icons.search),
+      itemCount: filteredGestionnaires.length,
-                    border: OutlineInputBorder(),
+      itemBuilder: (context, index) {
-                  ),
+        final user = filteredGestionnaires[index];
-                ),
+        return AdminUserCard(
-              ),
+          title: user.fullName,
-              const SizedBox(width: 16),
+          avatarUrl: user.photoUrl,
-              ElevatedButton.icon(
+          subtitleLines: [
-                onPressed: () {
+            user.email,
-                  // TODO: Rediriger vers la page de creation.
+            'Statut : ${user.statut ?? 'Inconnu'}',
-                },
+            'Relais : ${user.relaisNom ?? 'Non rattaché'}',
-                icon: const Icon(Icons.add),
+          ],
-                label: const Text('Creer un gestionnaire'),
+          actions: [
-              ),
+            IconButton(
-            ],
+              icon: const Icon(Icons.location_city_outlined),
-          ),
+              tooltip: 'Rattacher un relais',
-          const SizedBox(height: 24),
+              onPressed: () => _openRelaisAssignmentDialog(user),
-          if (_isLoading)
-            const Center(child: CircularProgressIndicator())
-          else if (_error != null)
-            Center(
-              child: Text(
-                'Erreur: $_error',
-                style: const TextStyle(color: Colors.red),
-              ),
-            )
-          else if (_filteredGestionnaires.isEmpty)
-            const Center(child: Text('Aucun gestionnaire trouve.'))
-          else
-            Expanded(
-              child: ListView.builder(
-                itemCount: _filteredGestionnaires.length,
-                itemBuilder: (context, index) {
-                  final user = _filteredGestionnaires[index];
-                  return Card(
-                    margin: const EdgeInsets.only(bottom: 10),
-                    child: ListTile(
-                      leading: CircleAvatar(
-                        child: Text(
-                          (user.prenom?.isNotEmpty == true
-                                  ? user.prenom!.substring(0, 1)
-                                  : user.email.substring(0, 1))
-                              .toUpperCase(),
-                        ),
-                      ),
-                      title: Text(
-                        user.fullName.isNotEmpty ? user.fullName : 'Sans nom',
-                      ),
-                      subtitle: Text(
-                        '${user.email} • Relais: ${user.relaisNom ?? 'Non rattache'}',
-                      ),
-                      trailing: Row(
-                        mainAxisSize: MainAxisSize.min,
-                        children: [
-                          IconButton(
-                            icon: const Icon(Icons.location_city_outlined),
-                            tooltip: 'Rattacher un relais',
-                            onPressed: () => _openRelaisAssignmentDialog(user),
-                          ),
-                          IconButton(
-                            icon: const Icon(Icons.edit),
-                            tooltip: 'Modifier',
-                            onPressed: () {
-                              // TODO: Modifier gestionnaire.
-                            },
-                          ),
-                        ],
-                      ),
-                    ),
-                  );
-                },
-              ),
             ),
-        ],
+            IconButton(
-      ),
+              icon: const Icon(Icons.edit),
+              tooltip: 'Modifier',
+              onPressed: () {
+                // TODO: Modifier gestionnaire.
+              },
+            ),
+          ],
+        );
+      },
     );
   }
 }

frontend/lib/widgets/admin/parent_managmant_widget.dart

@@ -2,8 +2,8 @@ import 'package:flutter/material.dart';
 import 'package:p_tits_pas/models/parent_model.dart';
 import 'package:p_tits_pas/services/user_service.dart';
 import 'package:p_tits_pas/widgets/admin/common/admin_detail_modal.dart';
-import 'package:p_tits_pas/widgets/admin/common/admin_list_state.dart';
 import 'package:p_tits_pas/widgets/admin/common/admin_user_card.dart';
+import 'package:p_tits_pas/widgets/admin/common/user_list.dart';
 
 class ParentManagementWidget extends StatefulWidget {
   final String searchQuery;
@@ -65,42 +65,32 @@ class _ParentManagementWidgetState extends State<ParentManagementWidget> {
       return matchesName && matchesStatus;
     }).toList();
 
-    return Padding(
+    return UserList(
-      padding: const EdgeInsets.all(16),
+      isLoading: _isLoading,
-      child: Column(
+      error: _error,
-        crossAxisAlignment: CrossAxisAlignment.start,
+      isEmpty: filteredParents.isEmpty,
-        children: [
+      emptyMessage: 'Aucun parent trouvé.',
-          AdminListState(
+      itemCount: filteredParents.length,
-            isLoading: _isLoading,
+      itemBuilder: (context, index) {
-            error: _error,
+        final parent = filteredParents[index];
-            isEmpty: filteredParents.isEmpty,
+        return AdminUserCard(
-            emptyMessage: 'Aucun parent trouvé.',
+          title: parent.user.fullName,
-            list: ListView.builder(
+          avatarUrl: parent.user.photoUrl,
-              itemCount: filteredParents.length,
+          subtitleLines: [
-              itemBuilder: (context, index) {
+            parent.user.email,
-                final parent = filteredParents[index];
+            'Statut : ${_displayStatus(parent.user.statut)} | Enfants : ${parent.childrenCount}',
-                return AdminUserCard(
+          ],
-                  title: parent.user.fullName,
+          actions: [
-                  avatarUrl: parent.user.photoUrl,
+            IconButton(
-                  subtitleLines: [
+              icon: const Icon(Icons.edit),
-                    parent.user.email,
+              tooltip: 'Modifier',
-                    'Statut : ${_displayStatus(parent.user.statut)} | Enfants : ${parent.childrenCount}',
+              onPressed: () {
-                  ],
+                _openParentDetails(parent);
-                  actions: [
-                    IconButton(
-                      icon: const Icon(Icons.edit),
-                      tooltip: 'Modifier',
-                      onPressed: () {
-                        _openParentDetails(parent);
-                      },
-                    ),
-                  ],
-                );
               },
             ),
-          ),
+          ],
-        ],
+        );
-      ),
+      },
     );
   }
 

frontend/lib/widgets/admin/user_management_panel.dart

@@ -0,0 +1,176 @@
+import 'package:flutter/material.dart';
+import 'package:p_tits_pas/widgets/admin/admin_management_widget.dart';
+import 'package:p_tits_pas/widgets/admin/assistante_maternelle_management_widget.dart';
+import 'package:p_tits_pas/widgets/admin/dashboard_admin.dart';
+import 'package:p_tits_pas/widgets/admin/gestionnaire_management_widget.dart';
+import 'package:p_tits_pas/widgets/admin/parent_managmant_widget.dart';
+
+class AdminUserManagementPanel extends StatefulWidget {
+  const AdminUserManagementPanel({super.key});
+
+  @override
+  State<AdminUserManagementPanel> createState() =>
+      _AdminUserManagementPanelState();
+}
+
+class _AdminUserManagementPanelState extends State<AdminUserManagementPanel> {
+  int _subIndex = 0;
+  final TextEditingController _searchController = TextEditingController();
+  final TextEditingController _amCapacityController = TextEditingController();
+  String? _parentStatus;
+
+  @override
+  void initState() {
+    super.initState();
+    _searchController.addListener(_onFilterChanged);
+    _amCapacityController.addListener(_onFilterChanged);
+  }
+
+  @override
+  void dispose() {
+    _searchController.removeListener(_onFilterChanged);
+    _amCapacityController.removeListener(_onFilterChanged);
+    _searchController.dispose();
+    _amCapacityController.dispose();
+    super.dispose();
+  }
+
+  void _onFilterChanged() {
+    if (!mounted) return;
+    setState(() {});
+  }
+
+  void _onSubTabChange(int index) {
+    setState(() {
+      _subIndex = index;
+      _searchController.clear();
+      _parentStatus = null;
+      _amCapacityController.clear();
+    });
+  }
+
+  String _searchHintForTab() {
+    switch (_subIndex) {
+      case 0:
+        return 'Rechercher un gestionnaire...';
+      case 1:
+        return 'Rechercher un parent...';
+      case 2:
+        return 'Rechercher une assistante...';
+      case 3:
+        return 'Rechercher un administrateur...';
+      default:
+        return 'Rechercher...';
+    }
+  }
+
+  Widget? _subBarFilterControl() {
+    if (_subIndex == 1) {
+      return DropdownButtonHideUnderline(
+        child: DropdownButton<String?>(
+          value: _parentStatus,
+          isExpanded: true,
+          hint: const Padding(
+            padding: EdgeInsets.only(left: 10),
+            child: Text('Statut', style: TextStyle(fontSize: 12)),
+          ),
+          items: const [
+            DropdownMenuItem<String?>(
+              value: null,
+              child: Padding(
+                padding: EdgeInsets.only(left: 10),
+                child: Text('Tous', style: TextStyle(fontSize: 12)),
+              ),
+            ),
+            DropdownMenuItem<String?>(
+              value: 'actif',
+              child: Padding(
+                padding: EdgeInsets.only(left: 10),
+                child: Text('Actif', style: TextStyle(fontSize: 12)),
+              ),
+            ),
+            DropdownMenuItem<String?>(
+              value: 'en_attente',
+              child: Padding(
+                padding: EdgeInsets.only(left: 10),
+                child: Text('En attente', style: TextStyle(fontSize: 12)),
+              ),
+            ),
+            DropdownMenuItem<String?>(
+              value: 'suspendu',
+              child: Padding(
+                padding: EdgeInsets.only(left: 10),
+                child: Text('Suspendu', style: TextStyle(fontSize: 12)),
+              ),
+            ),
+          ],
+          onChanged: (value) {
+            setState(() {
+              _parentStatus = value;
+            });
+          },
+        ),
+      );
+    }
+
+    if (_subIndex == 2) {
+      return TextField(
+        controller: _amCapacityController,
+        decoration: const InputDecoration(
+          hintText: 'Capacité min',
+          hintStyle: TextStyle(fontSize: 12),
+          border: InputBorder.none,
+          isDense: true,
+          contentPadding: EdgeInsets.symmetric(horizontal: 10, vertical: 8),
+        ),
+        keyboardType: TextInputType.number,
+      );
+    }
+    return null;
+  }
+
+  Widget _buildBody() {
+    switch (_subIndex) {
+      case 0:
+        return GestionnaireManagementWidget(
+          searchQuery: _searchController.text,
+        );
+      case 1:
+        return ParentManagementWidget(
+          searchQuery: _searchController.text,
+          statusFilter: _parentStatus,
+        );
+      case 2:
+        return AssistanteMaternelleManagementWidget(
+          searchQuery: _searchController.text,
+          capacityMin: int.tryParse(_amCapacityController.text),
+        );
+      case 3:
+        return AdminManagementWidget(
+          searchQuery: _searchController.text,
+        );
+      default:
+        return const Center(child: Text('Page non trouvée'));
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        DashboardUserManagementSubBar(
+          selectedSubIndex: _subIndex,
+          onSubTabChange: _onSubTabChange,
+          searchController: _searchController,
+          searchHint: _searchHintForTab(),
+          filterControl: _subBarFilterControl(),
+          onAddPressed: () {
+            // TODO: brancher création selon onglet actif
+          },
+          addLabel: 'Ajouter',
+        ),
+        Expanded(child: _buildBody()),
+      ],
+    );
+  }
+}