Aller au contenu

Refonte du module Accompagnements — Suivi générique et Orientations

Document natif, écrit à la demande de Bernard le 2026-07-10 pour expliquer le chantier de retrait du module Accompagnements générique, sa justification et son usage. Fait suite à l'échange qui a établi que ce module n'avait pas de raison d'être sous sa forme d'origine (voir ProjetESM/debug/20260710_1344_execution-refonte-accompagnements-suivi-orientations pour le détail technique complet du chantier).

Ce qui a été fait

Retiré — le modèle générique Accompagnement (dossier de cas avec statut EN_COURS/ SUSPENDU/TERMINE/ABANDONNE) et son référentiel TypeAccompagnement (11 types : formation artisanale, soutien psychosocial, appui alimentaire...), ainsi que SuiviAccompagnement (le suivi qui lui était rattaché). Zéro donnée en production sur ces 3 tables — retrait sans perte réelle. Les pages, le menu latéral et les routes correspondantes ont été retirés côté frontend.

Conservé et repensé — deux capacités jugées utiles indépendamment de l'ancien modèle :

  1. Orientations (CasOriente) — traçabilité d'un enfant référé vers un service externe (GUPS, centre de santé, service social). Auparavant rattaché à l'Accompagnement disparu, maintenant rattaché directement à l'Enfant.
  2. Suivi — remplace SuiviAccompagnement par un modèle générique unique, réutilisable pour trois cibles différentes via un champ cible (HOLISTIQUE / MICRO_SUBVENTION / INSTALLATION) plutôt que trois modèles quasi identiques :
  3. suivi de la situation globale de l'enfant (prise en charge holistique) ;
  4. suivi d'une micro-subvention octroyée (l'activité génératrice de revenus tourne-t-elle encore ?) ;
  5. suivi d'une installation professionnelle après CQM (l'installation tient-elle dans la durée ?).

Comment l'utiliser

Orientations et suivi holistique — sur la fiche d'un enfant (/enfants/:id), deux nouvelles sections apparaissent après les volets de prise en charge holistique : - « Suivi de la prise en charge » : liste des entrées de suivi (date, agent, observations, évolution, prochaine étape) + formulaire d'ajout en bas de section. - « Orientations » : liste des orientations vers un service externe + formulaire d'ajout (service destinataire, type d'orientation, date, suites données).

Suivi micro-subvention / installation — sur la page de détail d'un parcours d'insertion (/insertion/parcours/:id), chaque ligne de micro-subvention et chaque ligne d'installation CQM porte désormais un lien discret « Suivi (N) » en bas de carte. Cliquer dessus déplie la liste des suivis de cette subvention/installation précise, avec le même formulaire d'ajout compact.

Dans les trois cas, la suppression d'une entrée de suivi ou d'orientation se fait via un bouton « Supprimer » sur la ligne concernée — pas de statut, pas de workflow de validation MEAL sur ces entrées (choix délibéré, voir plus bas).

Pourquoi ce choix

Le module Accompagnement original ne correspondait à aucune activité ni indicateur du cadre logique (vérifié en détail dans ProjetESM/Documents/20260709_1130_transcription-sous-activites-donnees-indicateurs) — c'était une structure de suivi de dossier générique construite avant la décomposition rigoureuse en 37 sous-activités, et son référentiel TypeAccompagnement dupliquait des sous-activités déjà tracées ailleurs avec un vrai lien à un indicateur (les 4 volets holistiques pour l'activité 3.1.3, le module Insertion pour l'activité 3.1.4). Le pire symptôme : la sous-fonctionnalité « Orientations » du module prétendait alimenter l'indicateur 2.1.2, qui dans le cadre logique réel concerne la formation des maîtres coraniques — rien à voir. Un module avec deux couches (dossier générique + orientation) qui n'apportait de valeur métier ni pour le reporting bailleur ni pour une gestion de cas clairement définie.

Après discussion, deux besoins réels et distincts sont ressortis, indépendants de tout indicateur : - pouvoir suivre dans la durée une situation qui n'est pas un acte ponctuel (contrairement aux 4 volets holistiques ou aux octrois de micro-subvention/installation, qui sont chacun un événement daté) ; - pouvoir tracer une orientation vers un service externe, utile pour la coordination opérationnelle même sans indicateur bailleur derrière.

Le choix d'un seul modèle Suivi générique (plutôt que trois modèles quasi identiques SuiviHolistique/SuiviMicroSubvention/SuiviInstallation) suit le principe déjà appliqué plusieurs fois dans ce projet : réutiliser l'existant avant de créer, un discriminant cible + FK optionnelles étant suffisant puisque la structure des trois cas est rigoureusement identique (date, agent, observations, évolution, prochaine étape) — seule la cible change.

Pas de workflow de validation MEAL sur Suivi/CasOriente (contrairement aux 4 volets holistiques ou aux enregistrements d'enfant) : ce sont des entrées de journal narratif append-only, pas des données statistiques comptées pour un indicateur — le même choix de conception que l'ancien SuiviAccompagnement, conservé par cohérence.

Valeur ajoutée pour l'application

  • Moins de code mort : ~150 fichiers backend/frontend retirés ou simplifiés (module générique, son référentiel, ses pages) sans perte de capacité réelle puisqu'aucune donnée n'existait dessus.
  • Fin d'une confusion structurelle : un agent de terrain ou un chargé de projet qui consulte la fiche enfant ne voit plus deux notions d'« accompagnement » qui se chevauchent sans lien entre elles (le dossier générique d'un côté, les volets holistiques de l'autre).
  • Suivi opérationnel réel, au bon endroit : le suivi narratif est maintenant visible directement là où l'information a du sens — sur la fiche enfant pour la situation globale, sur la micro-subvention/installation précise pour vérifier qu'un appui économique tient dans la durée — plutôt que caché dans un dossier « accompagnement » séparé qu'il fallait ouvrir à part.
  • Base saine pour étendre le suivi plus tard : si un besoin de suivi apparaît pour une autre entité (ex. suivi d'une formation professionnelle en cours), il suffit d'ajouter une valeur à l'enum CibleSuivi et une FK optionnelle — pas de nouveau module à construire.

Liens connexes