Roadmap Produit — Documentation Fonctionnelle

Consultez les développements à venir d'Isi-APP, trimestre par trimestre, au même endroit que le journal de version.

À quoi ça sert

Le journal de version raconte ce qui a été livré. Il ne disait rien de ce qui arrive ensuite : les clients n'avaient aucune visibilité sur les évolutions prévues, et l'équipe produit n'avait pas de canal pour les annoncer. La roadmap comble ce manque dans la même zone de consultation, pour que « ce qui a été livré » et « ce qui arrive » se lisent d'un même endroit.

Comment ça marche (côté utilisateur)

Accès

• Menu : icône d'information dans la barre de navigation → page Évolutions du produit
• Deux onglets en tête de page : Journal de version (contenu existant, inchangé) et Roadmap
• Chaque onglet a sa propre adresse, partageable telle quelle

⚠️ La roadmap est au stade alpha. Elle n'est visible que d'ISI-Groupe et des super-développeurs. Pour les autres, l'onglet n'apparaît pas et l'adresse directe répond 403.

En assistance, la règle suit le mode : « avec moi », sans utilisateur choisi, vous restez vous-même et voyez la page ; avec un utilisateur choisi, vous ne la voyez pas, puisque l'intérêt du mode est précisément de montrer ce que voit réellement cet utilisateur. Un badge Alpha le rappelle en tête de page. Pour l'ouvrir aux clients, voir le cycle de vie des nouveautés progressives (dev → alpha → beta → stable).

La frise

La roadmap se lit comme la planche « Roadmap {année} » présentée aux clients : une carte par trimestre, posée au-dessus d'un axe, et le fil rouge en bandeau dessous.

• Une année à la fois. Quand plusieurs années ont du contenu publié, des onglets permettent de passer de l'une à l'autre ; l'année choisie se retrouve dans l'adresse, donc dans un lien partagé. Par défaut : l'année en cours si elle a du contenu, sinon la première à venir.
• Les trimestres affichés suivent le calendrier, pas seulement le contenu : pour l'année en cours, du trimestre courant à T4 (un trimestre déjà planifié avant reste visible) ; pour une année à venir, T1 à T4 ; pour une année écoulée, du premier au dernier trimestre garni. Un trimestre sans rien à montrer garde sa carte, vide.
• Chaque carte porte un en-tête coloré (une teinte par trimestre, grise une fois le trimestre écoulé), l'étiquette Maintenant sur le trimestre en cours, et ses développements regroupés par catégorie (CRM, Tickets, GMAO…) comme les blocs thématiques de la planche. Un développement sans catégorie se range sous « Autres ».
• Chaque développement est une ligne : pastille d'avancement, intitulé, et son niveau d'impact quand il est renseigné. Pas de description : la roadmap annonce ce qui arrive, pas le détail de ce qui est fait.
• L'axe relie les trimestres : nœud plein et coché pour un trimestre écoulé, nœud creux pour un trimestre à venir, tronçon coloré jusqu'à aujourd'hui. Un repère Aujourd'hui traverse la carte du trimestre en cours, placé au prorata du temps écoulé.
• Le fil rouge, sous l'axe, liste les développements travaillés en continu sur l'année (par exemple « CRM / Marketing »), avec leur catégorie. Il n'apparaît que si l'année en a.

En tête de page, un bandeau rappelle la promesse et affiche trois compteurs — Prévu, En cours, Livré — pour l'année affichée, fil rouge compris, filtres ou non.

Ce que dit une carte, et rien de plus. Le type d'évolution se lit dans la catégorie qui titre le groupe (CRM, Tickets, Santé…). La portée se lit dans le niveau d'impact utilisateur, facultatif :

Ces deux échelles sont rappelées en clair sur la page, dans un bandeau Guide de lecture placé juste au-dessus de la frise : un client n'a pas à deviner ce que recouvre « Moyen ».

Quand les cartes ne tiennent plus en largeur, la frise se fait défiler horizontalement ; seule la frise bouge, la page reste en place. Sur mobile, on la parcourt au pouce, une carte par écran.

Filtrer

• Recherche : porte sur l'intitulé public
• Catégories : mêmes catégories que le journal de version (CRM, Tickets, GMAO…). Seules celles effectivement portées par un élément publié sont proposées.

Administration (équipe ISI)

• Menu : Administration → Roadmap (onglet voisin de Release Notes et Catégories)
• Accès : développeurs et super-administrateurs ISI, exactement comme les release notes

Depuis cet écran, l'équipe produit peut :

• Créer un élément : intitulé public, statut, niveau d'impact (facultatif), trimestre cible, catégories, et le drapeau Fil rouge pour un chantier travaillé toute l'année (bandeau sous la frise plutôt qu'une carte de trimestre)
• Modifier un élément existant
• Publier / dépublier en un clic depuis la liste
• Supprimer un élément (l'enregistrement est conservé en base, invisible côté public)
• Filtrer par publication, statut, impact et jalon, exporter la liste
• Masquer une année entière depuis le panneau Années publiées, en tête d'écran

Années proposées. Le choix d'année couvre l'an dernier jusqu'à trois ans devant — la fenêtre de planification courante — plus toutes les années déjà portées par un élément existant. Un jalon ancien conservé pour l'historique, ou posé très loin, retrouve donc toujours sa propre année à l'édition comme au filtre.

Masquer une année

Une année à peine garnie — un seul développement annoncé pour douze mois — dessert le produit. Le panneau Années publiées liste chaque année, son nombre d'éléments publiés et de brouillons, et permet de la retirer de la frise d'un clic.

Une année masquée disparaît entièrement de la page publique, onglet compris, sans que ses éléments soient dépubliés : il suffit de la réactiver pour tout retrouver. Une année non renseignée dans ce panneau est visible par défaut.

Publication : rien ne sort par défaut

Un élément créé part en brouillon. Il reste invisible des clients tant qu'il n'a pas été publié explicitement. C'est la seule barrière entre la saisie et la page publique : il n'y a pas de validation à plusieurs niveaux.

L'intitulé saisi est lu par tous les clients. Il se rédige comme une annonce produit, pas comme un ticket interne : la roadmap n'est pas alimentée automatiquement par le backlog de développement, précisément parce que celui-ci contient des demandes clients nominatives.

Règles d'accès

Les éléments non publiés ne sont visibles d'aucun client, quel que soit son profil.

Points d'attention

• La roadmap n'est pas un engagement contractuel. Un encart le rappelle en tête de page ; le contenu et le calendrier peuvent évoluer.
• Gouvernance de mise à jour : rien ne synchronise automatiquement la roadmap avec l'avancement réel des développements. Un élément livré reste affiché « Prévu » tant que personne ne change son statut — il faut une revue régulière, sans quoi l'écart avec la réalité se voit tout de suite.
• Granularité du jalon : le trimestre est volontairement la maille la plus fine. Annoncer une date précise engagerait sur un calendrier qui bouge. Le fil rouge est l'exception assumée : il n'a pas de trimestre visible, seulement une année.
• Pas de description, volontairement. Rentrer dans le détail d'une évolution non livrée engage sur un contenu qui bouge encore. L'intitulé, la catégorie et le niveau d'impact suffisent à situer ce qui arrive.
• Le journal de version n'est pas modifié : les versions publiées restent toutes accessibles dans leur onglet.

Voir aussi

• Documentation technique : .claude/technical-docs/dev/roadmap.md
• Journal de version : docs/dev/release-notes.md