Ressources visuelles

Le code d'un modèle de règles est difficile à lire pour un juriste, et un texte de loi laisse des ambiguïtés que le développeur doit trancher. Les diagrammes donnent aux deux un support commun. Cette page présente les diagrammes employés à chaque étape d'un projet.

Diagrammes de modélisation

Juristes et développeurs s'accordent sur l'interprétation du texte avant d'écrire le code.

L'arbre de décision annoté

Chaque embranchement de l'arbre cite les articles dont il découle. C'est le support des ateliers entre juristes et développeurs.

Périodes de référence

Les règles socio-fiscales emploient plusieurs périodes de référence : revenus de l'année N-2, ressources des douze derniers mois, situation au 1er janvier. Un diagramme de Gantt les montre à l'équipe technique et aux usagers. Par exemple, les aides au logement se calculent sur les ressources des douze derniers mois, actualisées tous les trois mois (service-public.fr).

Usage : spécification des périodes dans le modèle (OpenFisca) et explication aux usagers.

Le graphe de dépendances de variables

Ce graphe montre comment les données d'entrée produisent le résultat. Il répond à la question posée à chaque modification réglementaire : si le plafond change, quelles règles changent ?

Diagrammes de parcours

Le parcours conditionnel

Quand le questionnaire est décrit dans un fichier séparé des règles, un diagramme de flux montre les conditions d'affichage des questions (visibleWhen).

Ce diagramme peut se générer à partir du fichier JSON du questionnaire.

Explication d'un résultat

Un simulateur montre comment il obtient son résultat. Avec @publicodes/react-ui, l'usager remonte le calcul variable par variable. Exemple avec l'aide Mobili-Jeune et les montants du cas type dem-log-001 :

Générer les diagrammes depuis le code

Des diagrammes dessinés à la main (Figma, PowerPoint) se modifient librement, et doivent être repris à chaque modification du code. Générés à partir du code ou de la configuration, ils suivent le modèle à chaque version : c'est la pratique que Cyrille Martraire décrit dans Living Documentation (2019).