Isi-APP Docs fonctionnelles
Toutes les docs
Markdown brut
Catalogue des modules ISI (/admin/modules)
Actif platform functional Revu le 2026-09-17 platform/module-catalog.md

Catalogue des modules ISI (/admin/modules)

Doc fonctionnelle : décrit le quoi et le pourquoi (point de vue utilisateur / chef de projet).

À quoi ça sert

C'est l'écran d'administration du catalogue : la liste des modules vendus aux clients (Isi-Basic, Isi-Ticket, Isi-CRM…) et de leurs modules enfants, les fonctionnalités qu'un module découpe en briques activables séparément (« Isi-Basic - Personne », « Isi-Pilot - Intervention »…).

On y crée un module, on corrige son libellé ou sa description, et surtout on l'active ou on le désactive — ce qui décide de sa présence dans les menus et dans le catalogue proposé aux clients.

À ne pas confondre avec :

  • my-account.md — ce qu'un client voit de ses modules et de ceux qu'il peut encore découvrir ;
  • module-management-rules.md — les règles d'engagement qui s'appliquent quand un client souscrit ou résilie.

Comment ça marche (côté utilisateur)

Deux onglets, un tableau chacun, avec la recherche, les filtres, le choix des colonnes, le tri et l'export communs à tous les tableaux de l'application.

Onglet « Modules »

Une ligne par module : son identifiant, son nom, sa description, son tag, le nombre d'enfants actifs sur le total, et son statut.

Onglet « Modules enfants »

Une ligne par fonctionnalité, avec le module parent auquel elle est rattachée. Un enfant n'est visible chez le client que si son parent est actif : désactiver un parent suffit à masquer tous ses enfants, sans toucher à leur état — qui est retrouvé tel quel à la réactivation.

Un enfant dont le parent a disparu de la base est signalé en rouge (« Parent introuvable ») plutôt que laissé avec une cellule vide.

Le statut

La colonne Statut affiche l'état : pastille verte « Actif », grise « Inactif ». Elle est en lecture seule.

Pour activer ou désactiver un module, ouvrez sa fiche avec le bouton Modifier et changez le champ Statut. C'est volontaire : désactiver un module le retire de tous les clients qui y sont abonnés, une conséquence trop lourde pour tenir à un clic dans une liste — et la fiche montre le reste de la configuration au moment de décider.

L'écran ouvrait auparavant sur un onglet « Statuts » : une carte et un interrupteur par module, plus une ligne par enfant, sans nom de tag ni description sous les yeux. Il a été retiré.

Créer, modifier, supprimer

  • Créer : le bouton de chaque onglet ouvre un formulaire (identifiant, nom, description, statut, tag ; plus le module parent pour un enfant). L'identifiant se choisit à la main, dans la continuité des modules existants — s'il est déjà pris, le message le dit et le formulaire reste ouvert pour en saisir un autre. Même chose si le tag est déjà porté par un autre module, ou si le module parent choisi n'existe pas.
  • Modifier : le bouton en début de ligne, qui ouvre le formulaire générique du module — c'est aussi là que se change le statut.
  • Supprimer : dans le menu ⋮ de la ligne, comme sur les autres tableaux. Après confirmation, la ligne disparaît du tableau sans quitter la page. Un module encore rattaché à des modules enfants ou à des configurations d'abonnement est refusé, en disant ce qui bloque : détachez-les d'abord.

Les fenêtres de création ne se ferment pas si vous cliquez à côté — seules la croix, « Annuler » et la touche Échap les referment, pour ne pas perdre une saisie en cours.

Règles d'accès

Écran réservé aux membres ISI-DSI (middleware isidsi) : il n'est visible d'aucun compte client. Il se trouve sous /admin/modules, atteignable depuis la tuile Modules de la page d'administration. Malgré l'adresse, il reste ouvert à tout ISI-DSI et pas seulement aux super-admins. Les deux tableaux vérifient ce droit pour leur propre compte, y compris sur la bascule de statut.

Points d'attention

  • Le tag est ce que lisent les middlewares qui ouvrent l'accès à un module (hardEnsureHasModule:ticket). Le renommer coupe l'accès au module pour tous les clients abonnés : c'est une donnée technique, pas un libellé d'affichage.
  • Désactiver un module le retire de tous les clients abonnés, pas seulement du catalogue de vente. La confirmation le rappelle.
  • La suppression d'un module est définitive (ces tables n'ont pas de corbeille).