Le compte est un graphe.
Vous en êtes l'architecte.
En tant que SOA Senior, vous concevez les templates de compte technique de réassurance (patterns). Chaque pattern définit la structure d'un compte : lignes comptables, types de lien et nœuds FORMULA qui référencent les sorties quantitatives produites par le Manager.
Votre rôle dans la chaîne
Six rôles — une direction. Le module SOA se situe en fin de chaîne, traduisant le travail actuariel en comptes financiers.
Barre latérale des patterns
La barre latérale gauche liste tous vos patterns SOA. Chaque pattern est un template réutilisable pour un compte technique.
Utilisez la zone de recherche pour filtrer les patterns par nom ou identifiant. Cliquez sur ＋ New pattern pour en créer un — donnez-lui un libellé descriptif (ex. "XL Treaty Statement v1", "Quota Share — Annual").
Un badge ♻ à côté d'un pattern indique un cycle détecté — ce pattern ne peut pas être instancié par le Junior tant que le cycle n'est pas corrigé. Un petit compteur d'instances (ex. 3×) indique combien d'instances SOA actives référencent ce pattern.
Construire un pattern SOA
Un pattern est un graphe acyclique dirigé de lignes comptables. Chaque nœud représente une ligne du compte. Les liens encodent la structure hiérarchique (détail → sous-total → total).
Raccourcis clavier
| Touche | Action |
|---|---|
| Ctrl/Cmd + S | Sauvegarder le pattern actuel |
| Suppr / Retour arrière | Supprimer le nœud ou le lien sélectionné |
| Molette de défilement | Zoom avant / arrière |
| Glisser sur le canvas | Déplacer la vue |
| Double-clic canvas | Ajouter un nœud au curseur |
Types de lien SOA
Chaque nœud et chaque lien d'un pattern SOA porte un type de lien — son rôle comptable dans le compte. Cela remplace les opérandes de calcul utilisés par l'Actuaire.
Vous pouvez étendre la liste depuis 🏷 SOA Link Types dans la barre latérale. Les nouveaux codes sont immédiatement disponibles dans l'éditeur de nœuds. La suppression d'un code est bloquée si un nœud ou un lien l'utilise encore.
Panneau inspecteur
Cliquer sur un nœud ouvre l'inspecteur à droite — deux onglets pour un nœud sélectionné.
| Onglet | Ce que vous faites ici |
|---|---|
| Properties | Modifiez le libellé, le type de lien et le type de valeur du nœud. Cliquez sur Apply pour mettre à jour l'état en mémoire — puis Save (barre d'outils) pour persister. |
| Dimensions | Ajoutez ou retirez des attachements de dimensions documentaires. Chaque dimension que vous attachez devient un formulaire de saisie que le SOA Junior doit compléter pour cette ligne. |
Cliquer sur un lien ouvre l'inspecteur avec un sélecteur de type de lien — modifiez le type et cliquez sur Apply.
Cliquer sur le fond du pattern (aucun nœud sélectionné) affiche l'inspecteur du pattern : clauses liées, restrictions de types de traité, nombre d'instances et boutons d'action rapide (renommer, modifier les clauses, modifier les types de traité, supprimer).
Nœuds FORMULA — le pont vers les données Manager
Un nœud FORMULA est une ligne comptable spéciale dont la valeur n'est pas saisie directement par le SOA Junior — à la place, le Junior cite un nœud précis d'une instance de graphe Manager.
Comment créer un nœud FORMULA
Ce que fait le SOA Junior avec les nœuds FORMULA
Quand le Junior ouvre un nœud FORMULA, un picker en trois groupes apparaît — Même contrat, Même type de traité, Même clause. Le Junior sélectionne le graphe Manager pertinent et le nœud spécifique dont la sortie alimente cette ligne de compte. La référence est stockée sous forme de citation JSON — aucune valeur n'est copiée, seulement le pointeur.
Opérandes de lien IF / THEN / ELSE
Lorsqu'un nœud de pattern SOA est relié à un nœud de graphe Actuary de type CONDITION, trois opérandes de lien spécialisés structurent explicitement la relation conditionnelle.
Avant le patch 035, les nœuds CONDITION utilisaient l'opérande générique ARGUMENT pour tous les parents, rendant l'intention graphique ambiguë. Les trois opérandes dédiés ci-dessous remplacent ARGUMENT sur les liens CONDITION et rendent la logique de prédicat immédiatement lisible sur le canvas.
Quand ces opérandes sont-ils pertinents pour le SOA Senior ?
En tant que SOA Senior, vous ne construisez pas de graphes Actuary — mais vous reliez les nœuds FORMULA à leurs homologues Manager, qui eux-mêmes référencent les sorties de graphes Actuary. Comprendre ce que produit un nœud CONDITION vous aide à libeller avec précision la ligne FORMULA correspondante dans le statement.
Exemple typique : un nœud FORMULA Profit Commission Payable after Loss Corridor doit citer la sortie d'un nœud CONDITION dans le graphe Actuary. Ce CONDITION évalue un seuil de loss corridor — le parent IF est le test, le parent THEN est la commission si le corridor est franchi, le parent ELSE est zéro. Votre ligne FORMULA capture le résultat de ce branchement.
Nœuds THRESHOLD
Un nœud THRESHOLD (orange, introduit dans le patch 035) est un nœud feuille représentant une borne unique — plancher, plafond, point d'attachement ou déclencheur. Il est toujours parent d'un nœud CONDITION ou LOOKUP. Les nœuds THRESHOLD n'apparaissent pas directement comme cibles FORMULA dans les patterns SOA : ce sont des entrées intermédiaires dans le graphe Actuary, pas des quantités de sortie. Ne créez pas de lignes FORMULA citant des nœuds THRESHOLD.
Dimensions
Les dimensions sont des axes documentaires — des formulaires de saisie optionnels attachés aux nœuds du pattern. Le SOA Senior peut attacher n'importe quelle dimension du catalogue du tenant à n'importe quel nœud.
Le catalogue de dimensions appartient au Senior Underwriter et est partagé entre tous les profils. Une catégorie de dimensions dédiée SOA est provisionnée à la création du tenant avec trois axes de base : Périodicité, Quote-part et Contrepartie — le contexte documentaire le plus courant pour une ligne de compte.
| Dimension de base | Usage typique sur un nœud SOA |
|---|---|
| PERIODICITY | Trimestriel / annuel / ajustement / complémentaire — le cycle comptable de cette ligne |
| SHARE | 100% / quote-part réassureur / quote-part cédante — la proportion applicable |
| COUNTERPART | Réassureur / courtier — la partie payante ou réceptrice |
Restrictions de patterns
Deux restrictions optionnelles aident le SOA Junior à trouver le bon pattern pour chaque contrat.
Clauses liées
Un pattern peut être ancré à une ou plusieurs clauses validées (ex. "clause de réintégration XL"). C'est informatif — cela signale la famille de clauses pour laquelle ce pattern a été conçu. La restriction n'est pas imposée à l'instanciation.
Pour gérer : cliquez sur 🔗 Clauses dans la barre d'outils, ou utilisez le bouton Edit linked clauses de l'inspecteur du pattern.
Restrictions de types de traité
Si vous restreignez un pattern à un ou plusieurs types de traité (ex. TREATY_XL), l'écran de création d'instance du Junior affiche un badge de compatibilité — ✓ Compatible ou ⚠ Mismatch. Un mismatch est un avertissement, pas un blocage — le Junior peut toujours continuer.
Laissez tous les types de traité décochés pour rendre le pattern universel — applicable à tout contrat quel que soit son type de traité.
Pour gérer : cliquez sur 📋 Treaty types dans la barre d'outils, ou utilisez l'inspecteur du pattern.
Détection de cycle
Un DAG doit être acyclique — aucune ligne ne peut être son propre ancêtre. RI-TOOL détecte les cycles automatiquement à chaque sauvegarde.
Si un cycle est détecté, une bannière orange apparaît en haut de l'éditeur et la ligne du pattern dans la barre latérale affiche un badge ♻ cycle. Le pattern est quand même sauvegardé mais est marqué comme non instanciable.
Explorateur de patterns
Vue de production de tous vos patterns — filtrable par statut d'instance et flag de cycle.
Cliquez sur 🔭 Pattern Explorer dans la barre latérale pour ouvrir la vue plein écran. Chaque carte affiche l'identifiant du pattern, son libellé, le nombre de nœuds, le pourcentage de couverture des dimensions et le nombre d'instances. Cliquez sur une carte pour accéder directement à ce pattern dans l'éditeur.
Couverture des dimensions
La couverture est le pourcentage de nœuds ayant au moins une dimension attachée. 🧩 80% signifie que 80% des nœuds ont des exigences de documentation. Un pattern avec 0% de couverture est valide mais ne génère aucun formulaire de saisie pour le Junior.
Data Checks
Requêtes SQL en temps réel sur les données de votre tenant — accessibles depuis 📊 Data Checks dans la barre latérale.
| Vue | Ce qu'elle affiche |
|---|---|
| SOA Templates — overview | Tous les patterns avec nombre de nœuds, nœuds FORMULA, nombre d'instances, types de traité et clauses liées |
| FORMULA nodes — missing dimension | Nœuds FORMULA sans dimension FORMULA attachée — anomalies de configuration à corriger |
| Dimension coverage by node | Tous les nœuds avec leurs dimensions attachées et le nombre d'instructions — utile pour l'audit de couverture |
Chaque vue dispose d'un bouton ▶ Run. Les résultats s'affichent en ligne avec un lien ⬇ Download CSV pour l'export complet.
Maintenance
Quatre vérifications de nettoyage accessibles depuis la barre latérale. Toujours diagnostiquer avant d'exécuter — l'exécution est irréversible.
| Code | Ce qu'il nettoie | Risque |
|---|---|---|
| S1 | Patterns sans nœuds — coques vides laissées par une création avortée | Faible |
| S2 | Patterns avec un cycle détecté — diagnostic uniquement, pas de suppression. Corriger manuellement dans l'éditeur. | Moyen |
| S3 | Nœuds orphelins dont le pattern parent a été supprimé hors flux normal | Moyen |
| S4 | Rattachements de dimensions orphelins dont le nœud ou la dimension a été supprimé | Faible |
Ordre recommandé : S1 → S3 → S4. S2 est un diagnostic en lecture seule — il met en évidence les cycles à corriger manuellement, il ne supprime rien.