Gestion des etiquettes - MTES-MCT/histologe GitHub Wiki

Gestion des étiquettes

Sommaire

Introduction

Les étiquettes sont très utilisées par les territoires (80% des territoires les utilisent, au 18 juillet 2024). Il y a en moyenne 26 étiquettes par territoire. Ce chiffre est à prendre avec précaution parce qu'on a de gros écarts d'un territoire à l'autre (de 1 à 239 étiquettes en fonction du territoire).

Analyse

Les étiquettes peuvent être regroupées en catégories d'usage :

Catégorie	Définition	Analyse
Action / progression	concerne une orientation, une procédure engagée ou l'état d'un dossier	Valide l'orientation en mode action / instruction
Agent responsable	les étiquettes sont utilisées pour identifier un agent en particulier qui sera en charge du dossier	Valide la gestion par agent plutôt que par partenaire
Partenaire / programme	quand l'étiquette indique un partenaire, un type de partenaire (ex : Bailleur social, copro) ou un programme (OPAH, PIG)	Etudier l'ajout d'un champ dédié "programme"
Zone géographique / EPCI	quand l'étiquette indique une zone géographique ou un EPCI	Valide la fonctionnalité de zonage du territoire
Comité	permet de marquer les dossiers qui vont être revus en comité (COTECH, COPIL, PDLHI, etc.)	En phase avec la feature étiquettes
Qualification	concerne la qualification de la situation, le type de locataire ou le type de logement	Etudier la possibilité pour le RT de renseigner une pré-qualification
Source	indique la provenance du signalement (ADIL, guichet unique, etc.)	En phase avec la feature étiquettes
Autre	Les inclassables ou étiquettes nommées "Autre"	En phase avec la feature étiquettes

Problèmes détectés

La fonctionnalité n'ayant jamais fait l'objet d'étude ou de spécifications fonctionnelles, elle présente des défauts :

Tous les agents peuvent créer des étiquettes "à la volée" alors qu'une gestion niveau territoire paraît plus pertinente
Des étiquettes sont régulièrement supprimées par accident
Des doublons sont régulièrement créés

Pour résoudre ce problème, et favoriser l'usage des étiquettes, la fonctionnalité doit être revue.

Gérer les étiquettes du territoire

Liste des étiquettes

Le prototype est dispo en ligne.

Prérequis

Avoir un compte actif sur la plateforme
Avoir le rôle Responsable territoire ou supérieur

Accès

La liste des étiquettes est accessible depuis le BO (/bo/etiquettes) via le menu Outils admin > Etiquettes. Elle reprend la liste des étiquettes :

Pour le RT : toutes les étiquettes de son territoire
Pour le Super Admin toutes les étiquettes de tous les territoires

Header et filtre

L'en-tête de la page contient :

Un fil d'ariane
Le titre de page
Un texte d'introduction
Un bouton d'ajout de l'étiquette : ouvre la modale de création
Des filtres :
- Un champ de recherche sur le nom et l'ID de l'étiquette, dispo pour le RT et le SA
- Un filtre liste déroulante sur le territoire, dispo pour le SA uniquement
- Un bouton permettant de réinitialiser les résultats

Tableau / info

Champ	Type de champ	Tri	Resp. Territoire	Super Admin
ID	ID de l'étiquette	Oui, par ordre de grandeur	Oui	Oui
Territoire	Numéro de département et nom du territoire	Oui, par ordre de grandeur	Non	Oui
Etiquette	Nom de l'étiquette, sous forme de label	Par défaut : ordre alphabétique	Oui	Oui
Nombre d'utilisations	Nbr. de fois où l'étiquette est utilisées dans les signalements (hors archivés)	Non	Oui	Oui

Actions du tableau

Sur chaque ligne, 3 actions sont disponibles :

Editer l'étiquette : ouvre la modale d'édition
Accéder aux signalements : renvoie à la liste des signalements avec la vue filtrée sur l'étiquette en question. Pour le Super Admin, la vue est également filtrée sur le territoire concerné grâce au filtre territoire.
Supprimer l'étiquette : ouvre la modale de suppression

Ajouter une étiquette

Le prototype est dispo en ligne.

User flow

Accéder à la liste des étiquettes
Cliquer sur le bouton Ajouter une étiquette
Accéder à la modale avec le formulaire de création
- Titre de la modale : Ajouter une étiquette
- Texte : Une fois créée, les agents pourront ajouter l'étiquette aux signalements et l'utiliser pour filtrer la liste des signalements.
- Champ territoire avec liste déroulante : pour le SA uniquement
- Champ de saisie Etiquette
Remplir le formulaire
Cliquer sur valider

Conséquences

Une vérification est faite sur le nom saisi. Si l'étiquette existe déjà pour le territoire (nom correspondant strictement, peu importe la casse) :

On reste sur la modale et on affiche un message d'erreur sous le champ Ce nom d'étiquette est déjà utilisé. Veuillez saisir une autre nom.
L'étiquette n'est pas créée

Sinon :

Retour sur la liste des étiquettes avec un message de succès L'étiquette a bien été créée.
L'étiquette est créée et est visible dans la liste : on passe le nom saisi en uppercase
L'étiquette peut être attribuée aux signalements du territoire,
L'étiquette est disponible dans les filtres de la liste signalements et de statistiques

Editer une étiquette

Le prototype est dispo en ligne.

User flow

Accéder à la liste des étiquettes
Cliquer sur le bouton d'édition dans le tableau
Accéder à la modale avec le formulaire de création
- Titre de la modale : Modifier l'étiquette : {{name}} pour le SA, le titre est : {{Num dpt}} {{nom territoire}} - Modifier l'étiquette : {{name}}
- Texte : L'étiquette sera mise à jour sur tous les signalements dans lesquelles elle est utilisée, et dans les filtres sur la liste de signalements.
- Champ de saisie Etiquette avec l'étiquette actuelle
Remplir le formulaire
Cliquer sur valider

Conséquences

Une vérification est faite sur le nom saisi. Si l'étiquette existe déjà pour le territoire (nom correspondant strictement, peu importe la casse) :

On reste sur la modale et on affiche un message d'erreur sous le champ Ce nom d'étiquette est déjà utilisé. Veuillez saisir une autre nom.
L'étiquette n'est pas modifiée

Sinon :

Retour sur la liste des étiquettes avec un message de succès L'étiquette a bien été modifiée.
L'étiquette est modifiée et est visible dans la liste : : on passe le nom saisi en uppercase
L'étiquette est mise à jour sur les signalements correspondants
L'étiquette est mise à jour dans les filtres de la liste signalements et de statistiques

Supprimer une étiquette

Le prototype est dispo en ligne.

User flow

Accéder à la liste des étiquettes
Cliquer sur le bouton de suppression dans le tableau
Accéder à la modale avec le formulaire de création
- Titre de la modale : Supprimer l'étiquette : {{name}} pour le SA, le titre est : {{Num dpt}} {{nom territoire}} - Supprimer l'étiquette : {{name}}
- Texte : Vous êtes sur le point de supprimer une étiquette. Une fois l'étiquette supprimée : - Elle sera retirée de tous les signalements où elle apparaît actuellement - Elle ne pourra plus être utilisée dans le filtre Etiquettes de la liste de signalements. - Les signalements associés ne seront pas supprimés. Si vous recréez une étiquette du même nom par la suite, la nouvelle étiquette ne sera pas automatiquement ajoutée sur les signalements.
- Message d'info : Voulez-vous vraiment supprimer l'étiquette ?
Cliquer sur le bouton Oui, supprimer

Conséquences

Retour sur la liste des étiquettes avec un message de succès L'étiquette a bien été supprimée.
L'étiquette est archivée, elle n'apparaît plus dans la liste
L'étiquette est retirer des signalements correspondants
L'étiquette est supprimée des filtres de la liste signalements et de statistiques

Gérer les étiquettes d'un signalement

Le prototype est dispo en ligne.

Prérequis :

Avoir un compte actif
Avoir le rôle agent ou supérieur
Agent : que le partenaire ait été affecté au signalement et qu'il ait accepté l'affectation
RT / SA : avoir validé le signalement

Attribuer des étiquettes à un signalement

User flow :

Accéder à la fiche signalement
Cliquer sur le bouton Gérer les étiquettes
Accéder à la modale qui contient :
- Un titre Gérer les étiquettes du signalement
- Un texte : Sélectionnez les étiquettes à attribuer au signalement dans la liste déroulante. Cliquez sur une étiquette pour la retirer du signalement.
- Une colonne intitulée Sélectionner les étiquettes contenant une liste déroulante enrichie avec un champ de recherche
- Une colonne intitulée Etiquettes du signalement contenant les étiquettes sélectionnées, affichées sous forme de labels supprimables.
Choisir les étiquettes dans la liste déroulante enrichie : au fur et à mesure de la sélection, les étiquettes sont affichées sous forme de label supprimable. Cliquer sur le bouton Valider

Conséquences

Retour à la fiche signalement avec le message de succès Les étiquettes du signalement ont bien été mises à jour.
Les étiquettes sont ajoutées au signalement et visibles sur la fiche signalement

Retirer des étiquettes à un signalement

User flow :

Accéder à la fiche signalement
Cliquer sur le bouton Gérer les étiquettes
Accéder à la modale qui contient :
- Un titre Gérer les étiquettes du signalement
- Un texte : Sélectionnez les étiquettes à attribuer au signalement dans la liste déroulante. Cliquez sur une étiquette pour la retirer du signalement.
- Une colonne intitulée Sélectionner les étiquettes contenant une liste déroulante enrichie avec un champ de recherche
- Une colonne intitulée Etiquettes du signalement contenant les étiquettes sélectionnées, affichées sous forme de labels supprimables.
Retirer les étiquettes, 2 manières possibles :
- En cliquant sur les labels supprimables
- En décochant l'étiquette dans la liste déroulante : les labels sont mis à jour au fur et à mesure
Cliquer sur le bouton Valider

Conséquences

Retour à la fiche signalement avec le message de succès Les étiquettes du signalement ont bien été mises à jour.
Les étiquettes sont retirées du signalement, elles ne sont plus visibles sur la fiche signalement