Vous formalisez la logique.
Le graphe est votre langage.
En tant qu'Actuaire, vous transformez les clauses de réassurance validées en graphes DAG formels. Chaque nœud est un élément de calcul. Chaque lien est une dépendance. Vous attachez les dimensions documentaires que le Manager renseignera sur les contrats réels.
Votre rôle dans la chaîne
Quatre rôles — une direction. Chaque étape déverrouille la suivante.
| Étape | Profil | Ce qu'il fait | Ce que vous recevez |
|---|---|---|---|
| 1 | Junior | Déconstruit le texte des clauses — crée des clauses structurées avec libellé, famille, types de traité, dépendances | Clauses en brouillon |
| 2 | Senior | Valide les clauses et conçoit le catalogue de dimensions — les axes que vous attacherez aux nœuds de graphes | Clauses validées + palette de dimensions |
| 3 | Actuary ← vous | Construit les graphes DAG par clause validée. Attache les dimensions nœud par nœud. Relie les graphes entre clauses. | Graphes prêts pour le Manager |
| 4 | Manager | Crée des contrats, instancie un graphe, renseigne les valeurs de dimensions par nœud | — |
Construire un DAG
Un graphe acyclique dirigé encode la logique de calcul d'une clause comme une structure traversable de nœuds et de liens dirigés.
Une clause de réassurance contient des formules imbriquées — "perte nette conservée, nette des recours, en excédent de la rétention, plafonnée à la limite." Chaque élément devient un nœud. Chaque dépendance devient un lien dirigé. Le nœud racine contient la valeur finale de la clause.
Le graphe n'est pas une calculatrice. C'est une structure de documentation. Le Manager la lit, comprend exactement ce qu'il doit renseigner, et le résultat est un enregistrement non ambigu de la paramétrisation de la clause sur un contrat.
Flux de travail
Panneau inspecteur
Cliquer sur n'importe quel nœud ouvre l'inspecteur à droite — trois onglets, un nœud à la fois.
| Onglet | Ce que vous faites ici |
|---|---|
| Properties | Définissez le libellé, l'opérande, le type de valeur et (pour les nœuds SUB_GRAPH) le graphe référencé. Cliquez sur Apply pour confirmer — les modifications sont locales jusqu'à la sauvegarde du graphe. |
| Dimensions | Ajoutez ou retirez des attachements de dimensions documentaires. Chaque dimension que vous attachez ici devient un formulaire de saisie que le Manager doit compléter pour ce nœud. |
| Ext. links | Gérez les contributions entrantes depuis des nœuds d'autres graphes. Voir la section Parents externes pour le flux complet. |
Opérandes de nœuds
L'opérande définit le rôle de calcul d'un nœud et détermine son rendu — couleur et style de bordure.
Chaque nœud doit avoir un type de valeur — le genre de valeur que le Manager saisira : montant, pourcentage, durée, nombre, etc. Les types de valeur sont configurés par le Senior.
Opérandes de liens
Un lien connecte un nœud parent à un nœud enfant. Son opérande décrit comment le parent contribue au calcul de l'enfant.
| Type de nœud | Opérandes de liens attendus | Exemple |
|---|---|---|
| SUM | PLUS + MINUS | Perte brute + ALAE − recours |
| PRODUCT | FACTOR × n | Taux × Prime de base |
| QUOTIENT | NUMERATOR × 1 + DENOMINATOR × 1 | Perte nette / Valeur totale assurée |
| MAX / MIN | PLUS × n | MAX(rétention nette, plancher franchise) |
| CONDITION | ARGUMENT × n | Si point d'attache > seuil ALORS sous-limite |
| SUB_GRAPH | ARGUMENT | Prime de réintégration via graphe séparé |
| INPUT | Aucun — feuille | Perte par événement, franchise, limite… |
Dimensions — le moteur créatif
Les dimensions expliquent pourquoi RI-TOOL s'adapte à toute organisation sans imposer de modèle. C'est là que vit l'identité de votre tenant.
Quatre couches, trois rôles
Attacher une dimension à un nœud
Sélectionnez un nœud → ouvrez l'onglet Dimensions → cliquez sur ＋ Add dimension → choisissez dans le catalogue construit par le Senior. L'attachement est local jusqu'à la sauvegarde du graphe. Vous pouvez attacher plusieurs dimensions au même nœud.
Choix d'attachement typiques par type de nœud
| Type de nœud | Choix de dimensions typiques | Raisonnement |
|---|---|---|
| INPUT | Zone + Risque + Temps + Montant ou Taux | Les valeurs feuilles sont la cible principale de documentation — contextualisez-les toujours. |
| SUM / PRODUCT | Montant (résultat) — optionnellement axes de périmètre si le contexte change à ce niveau | Les nœuds d'agrégation peuvent nécessiter une annotation de résultat ; le contexte est généralement hérité des enfants. |
| MIN / MAX | Généralement aucun, ou Montant pour documenter la valeur du plafond/plancher | Les nœuds structurels de plafond/plancher nécessitent rarement des dimensions contextuelles. |
| CONDITION | Dimension personnalisée si le Senior en a défini une (ex. Déclencheur) | Les conditions peuvent nécessiter un axe dédié si la logique de la clause le requiert. |
| SUB_GRAPH | Généralement aucun — le contexte vit dans le graphe référencé | Les nœuds de délégation reportent la documentation à la source. |
La chaîne de protection
La plateforme prévient la perte silencieuse de données dans les deux sens. Vous ne pouvez pas retirer un attachement de dimension si le Manager a déjà renseigné des valeurs contre lui. Le Senior ne peut pas supprimer une dimension que vous avez attachée à un nœud. Chaque couche protège celle qui est en dessous.
Parents externes
Un nœud d'un graphe peut recevoir une contribution d'un nœud d'un graphe entièrement différent — le mécanisme de réutilisation inter-clauses.
Exemple : Clause A — Perte nette conservée et Clause B — Prime de réintégration. La formule de réintégration dépend de la perte nette conservée. Plutôt que de dupliquer des nœuds, déclarez la racine du graphe A comme parent externe du nœud pertinent du graphe B.
Comment ajouter un parent externe
Pour supprimer un parent externe existant, cliquez sur le bouton ✕ à côté de lui dans l'onglet Ext. links. Si le graphe enfant est instancié, un avertissement est affiché — le nœud fantôme référençant ce lien devient invalide pour les instances existantes.
Risk links
Un Risk link connecte un nœud Actuary à un nœud Risk Modeler, intégrant la description d'exposition dans le graphe de clauses.
Le Risk Modeler construit des graphes d'exposition — sites, périls, conditions de couverture. Votre rôle est de relier son travail à vos graphes de clauses en déclarant quel nœud relate à quel nœud Risk, et comment. Cette connexion est stockée dans m_graph_risk_link et qualifiée par un opérande Risk link.
| Opérande | Signification | Exemple |
|---|---|---|
EXPOSED_TO | Nœud Actuary lié à un péril | Nœud perte Cat XL ← Péril tempête |
LOCATED_AT | Nœud Actuary lié à un site | Nœud property ← Site industriel de Lyon |
COVERED_BY | Nœud Actuary lié à une condition de couverture | Nœud rétention ← Couverture tous risques property |
AGGREGATES | Nœud Actuary agrège plusieurs objets de risque | Nœud accumulation ← Site portefeuille |
Ajouter un Risk link
Une fois créé, le nœud Risk apparaît comme un phantom coloré sur le canvas — style selon le type de nœud (bleu pour site, rouge pour péril, vert pour couverture), avec une bordure en pointillés rouge brique et un libellé indiquant le nom du graphe Risk. Le phantom apparaît immédiatement, sans rechargement de page.
Effet sur le Manager
Chaque Risk link créé génère un bloc Risk Dimensions dans le drawer de saisie du Manager pour ce nœud. Le Manager voit le libellé du nœud Risk, l'opérande, le nom du graphe Risk, et les champs de saisie définis par le Risk Modeler (adresse, type de péril, valeur assurée…). Les dimensions Risk sont sauvegardées séparément des dimensions Actuary mais en une seule action de sauvegarde.
Détection de cycle
Un DAG doit être acyclique — aucun nœud ne peut être son propre ancêtre. RI-TOOL détecte les cycles automatiquement à chaque sauvegarde.
Après la sauvegarde, la plateforme vérifie la structure complète du graphe. Si un cycle est trouvé, une bannière orange apparaît en haut de l'éditeur et la ligne du graphe dans la barre latérale affiche un badge ♻ cycle.
Verrou d'instance
Une fois qu'un Manager instancie un graphe sur un contrat, la structure de ce graphe est figée.
La plateforme bloque toute modification structurelle d'un graphe instancié — vous ne pouvez pas sauvegarder des modifications ni le supprimer. Cela protège la saisie existante du Manager contre une invalidation silencieuse.
Explorateur de graphes
Vue de production de tous vos graphes en un seul endroit — filtrable, inspectable et exportable.
Cliquez sur 🔭 Graph Explorer dans la section Analytics de la barre latérale pour ouvrir l'explorateur plein écran. Le panneau d'inspection à droite reste visible en permanence — cliquez sur une carte pour charger son détail.
Barre de filtres
Six filtres combinables s'appliquent en temps réel :
| Filtre | Ce qu'il cible |
|---|---|
| Famille de clause | Famille de la clause liée au graphe (depuis la liste de référence du tenant) |
| Statut de clause | Statut de validation de la clause — ex. filtrer uniquement VALIDATED |
| Type de traité | Tout code de type de traité associé à la clause |
| Instances | Instancié (≥ 1 instance Manager active) ou Non instancié |
| Cycle | Graphes marqués d'un cycle de référence par la dernière sauvegarde |
| Dimensions | Niveau de couverture — Complète (100%), Partielle, Aucune couverture, ou Graphe vide (sans nœuds) |
Utilisez ↺ Reset filters pour tout effacer d'un coup. L'état des filtres est persisté en localStorage et restauré à votre prochaine visite.
Cartes et inspecteur
Chaque carte affiche l'identifiant et le libellé du graphe, sa clause, et une rangée de badges sémantiques — nombre de nœuds, nombre d'instances, flag de cycle, liens inter-graphes et pourcentage de couverture des dimensions avec codage couleur. Cliquez sur une carte pour charger le détail complet dans l'inspecteur de droite : identité du graphe, libellé de la clause, pastilles de types de traité et barre de couverture visuelle.
Depuis l'inspecteur, cliquez sur ↗ Open in DAG editor pour accéder directement à ce graphe sur le canvas.
Export
Le bouton ⬇ Export CSV dans l'en-tête de l'Explorateur exporte la vue filtrée actuelle en CSV — pas tous les graphes, uniquement ce que les filtres actifs affichent. Colonnes : id graphe, libellé, id clause, titre clause, famille clause, statut clause, types de traité (séparés par |), nombre de nœuds, nœuds avec dimensions, % couverture dimensions, nombre d'instances, liens inter-graphes, flag cycle.
Data Checks
Requêtes en temps réel sur les données de votre tenant, chacune exportable en CSV — accessibles depuis la section Analytics de la barre latérale.
Cliquez sur 📊 Data Checks pour ouvrir le panneau plein écran. Chaque vue configurée affiche une description et un bouton ▶ Run. Les résultats s'affichent sous forme de tableau paginé avec un lien ⬇ Download CSV. La barre d'outils DAG propose également un export ⬇ CSV par graphe des nœuds et liens du graphe courant.
Maintenance
Quatre opérations de nettoyage accessibles depuis le pied de la barre latérale. Toujours exécuter le diagnostic d'abord — il indique exactement ce qui sera supprimé sans toucher à quoi que ce soit.
| Code | Ce qu'il nettoie | Quand cela se produit |
|---|---|---|
| A1 | Nœuds dont le graphe parent a été supprimé — en cascade sur leurs liens et rattachements de dimensions | Graphe supprimé hors flux normal |
| A2 | Liens intra-graphe orphelins dont le nœud parent ou enfant n'existe plus | Nœud supprimé sans cascade sur les liens |
| A3 | Liens inter-graphe fantômes pointant vers un graphe supprimé (côté parent ou enfant) | Un graphe impliqué dans un cross-link a été supprimé |
| A4 | Rattachements de dimensions orphelins (nœud ou dimension supprimé) — peut aussi supprimer les valeurs Manager associées | Nœud ou dimension supprimé laissant des rattachements obsolètes |
Ordre recommandé : A1 → A2 → A3 → A4. Exécuter A1 en premier élimine les nœuds dont les liens seraient autrement aussi capturés par A2 et A3.