Module Organisation

Chemin : Gestion de l'Organisation (menu latéral) → Unités, Agents. (Selon déploiement : Régions, Structures, Types, Services en sous-menu Organisation.)

Ce module regroupe la gestion des unités (services), agents (utilisateurs), et selon la configuration : régions, structures, types de structures (source Keycloak pour les utilisateurs).

En bref : que faire dans ce module ?

Objectif	Où aller	Guide pas à pas
Consulter ou créer des unités (services)	Gestion de l'Organisation → Unités	Tutoriel : Unités et agents
Consulter ou gérer les agents (utilisateurs)	Gestion de l'Organisation → Agents	Tutoriel : Unités et agents
Gérer régions, structures, types, services (si visibles)	Organisation → sous-menu	Référence : Organisation

1. Régions

Chemin : Organisation → Régions (si visible).

Aspects fonctionnels implémentés

Liste paginée : affichage des régions avec pagination, tri et nombre total.
Filtres : recherche par nom ou code, filtre par statut actif/inactif.
Statistiques : nombre de structures, de services et d’utilisateurs par région (selon l’API).
Création : formulaire de création (nom, code optionnel) ; validation et enregistrement.
Modification : formulaire d’édition des informations de la région.
Suppression : suppression avec confirmation ; refus si des structures sont rattachées (intégrité référentielle).
Activation / Désactivation : bascule du statut actif/inactif de la région.
Actions par ligne : menu ou boutons (modifier, supprimer, activer/désactiver) selon les droits.
Rafraîchissement : rechargement des données depuis le backend.
Gestion des erreurs : affichage des erreurs API (toast, message) ; gestion des conflits (409).

2. Structures

Chemin : Organisation → Structures.

Aspects fonctionnels implémentés

Liste paginée : structures avec pagination, tri, colonnes (nom, code, région, type, statut, etc.).
Filtres : recherche textuelle, filtre par région, par type de structure, par statut, par actif/inactif.
Statistiques : indicateurs sur les structures (nombre total, par type, etc.) selon l’API.
Création : formulaire (nom, code, région, type de structure, adresse, statut actif/inactif, métadonnées selon le modèle).
Modification : édition des champs de la structure.
Suppression : suppression avec confirmation ; refus si des services ou plannings sont rattachés.
Activation / Désactivation : bascule du statut actif/inactif.
Vue hiérarchique : affichage Région → Structures → Services (arbre ou liste hiérarchique) si implémenté.
Vue MCD / district : vue par district (MCD) pour les structures AGSP (CSPS, CM, CMA) avec rattachement au district ; recherche et filtrage par district.
Actions par ligne : modifier, supprimer, activer/désactiver, voir le détail.
Rafraîchissement : rechargement des données.
Gestion des erreurs : erreurs API, conflits (409), messages utilisateur.

3. Types de structures

Chemin : Organisation → Types de structures.

Aspects fonctionnels implémentés

Liste paginée : types de structures (CHU, CHR, CMA, CSPS, etc.) avec pagination et tri.
Filtres : recherche par code ou libellé, filtre par actif/inactif.
Statistiques : indicateurs sur les types (nombre de structures par type, etc.) si exposés par l’API.
Création : formulaire (code, libellé, description optionnelle, actif).
Modification : édition des champs du type de structure.
Suppression : suppression avec confirmation ; refus si des structures utilisent ce type.
Activation / Désactivation : bascule du statut actif.
Actions par ligne : modifier, supprimer, activer/désactiver.
Rafraîchissement : rechargement des données.
Gestion des erreurs : erreurs API et conflits.

4. Services

Chemin : Organisation → Services.

Aspects fonctionnels implémentés

Liste : services avec liste ou grille, pagination, tri ; colonnes (nom, structure, couleur, statut, etc.).
Filtres : recherche textuelle, filtre par structure, par actif/inactif.
Statistiques globales : indicateurs agrégés (nombre total de services, par structure) si fournis par l’API.
Création : formulaire (nom, structure, couleur, description, statut actif).
Modification : édition des champs du service.
Suppression : suppression avec confirmation ; refus si des postes de garde ou plannings sont rattachés.
Détail d’un service : fiche détaillée (informations, statistiques, liste des postes ou équipes selon le modèle).
Import : import de services (fichier Excel ou CSV) selon le modèle ; prévisualisation, validation puis enregistrement.
Export : export de la liste des services (Excel, CSV) avec les filtres en cours.
Rafraîchissement : rechargement des données depuis le backend.
Actions par ligne : modifier, supprimer, voir détail.
Gestion des erreurs : erreurs API, conflits, messages utilisateur.

5. Utilisateurs

Chemin : Organisation → Utilisateurs.

Aspects fonctionnels implémentés

Liste paginée : utilisateurs (source Keycloak) avec pagination, tri ; colonnes (nom, prénom, email, username, rôles, actif, etc.).
Filtres : recherche textuelle (nom, email, username), filtre par actif/inactif, par rôle si disponible.
Statistiques : indicateurs par utilisateur (nombre de gardes, heures, etc.) si exposés par l’API.
Création : création d’utilisateur (prénom, nom, email, spécialité, téléphone optionnel) ; enregistrement côté backend/Keycloak selon l’architecture.
Modification : édition des informations du profil utilisateur (selon champs exposés).
Activation / Désactivation : bascule du statut actif (enabled) ; appel API PATCH statut selon la spec.
Gestion des rôles : affectation et retrait de rôles realm et rôles client (Keycloak) ; interface liste / cases à cocher selon l’implémentation.
Affectation aux services : affectation de l’utilisateur à un ou plusieurs services (dates, service principal) si géré dans l’app.
Suppression : suppression ou désactivation selon les règles métier et la spec.
Actions par ligne : modifier, activer/désactiver, gérer les rôles, voir le détail.
Rafraîchissement : rechargement des données.
Gestion des erreurs : erreurs API (404, 403, 409), messages utilisateur.

Droits et permissions

Les actions (créer, modifier, supprimer, exporter, importer) sont soumises aux droits définis dans la matrice des permissions (rôles : ADMIN, CHEF_REGIONAL, CHEF_STRUCTURE, CHEF_SERVICE, etc.). Les boutons et menus sont affichés ou désactivés selon ces droits.

Intégrité référentielle

Impossible de supprimer une région si des structures y sont rattachées.
Impossible de supprimer une structure si des services ou d’autres entités dépendantes existent.
Impossible de supprimer un type de structure s’il est utilisé par des structures.
Impossible de supprimer un service s’il est utilisé par des postes de garde ou des plannings.

Voir aussi

Tutoriels — Prise en main
FAQ — Questions fréquentes