Lei formalizza la clausola.
Lei costruisce il grafo.
Come Attuario, traduce le clausole di riassicurazione validate in grafi aciclici diretti (DAG). Ogni nodo è un elemento di calcolo; ogni collegamento è una dipendenza. Il Manager istanzia poi i suoi grafi su contratti reali e inserisce i valori.
Il suo ruolo nella catena
Quattro ruoli, una direzione. Ogni passo sblocca il successivo.
| Passo | Profilo | Cosa fa | Cosa riceve lei |
|---|---|---|---|
| 1 | Junior | Decostruisce il testo delle clausole: crea clausole strutturate con testo, famiglia, tipi di trattato, dipendenze | Clausole in bozza |
| 2 | Senior | Valida le clausole e progetta il catalogo dimensioni: assi da allegare ai nodi del grafo | Clausole validate + palette dimensioni |
| 3 | Actuary ← lei | Costruisce grafi DAG per clausola validata. Allega dimensioni nodo per nodo. Collega grafi tra le clausole. | Grafi pronti per il Manager |
| 4 | Manager | Crea contratti, istanzia un grafo, compila i valori delle dimensioni per nodo | — |
Costruire un DAG
Un grafo aciclico diretto codifica la logica di calcolo di una clausola come struttura traversabile di nodi e collegamenti diretti.
Una clausola di riassicurazione contiene formule annidate: perdita netta trattenuta, al netto dei recuperi, in eccesso della ritenzione, limitata al massimale. Ogni elemento diventa un nodo. Ogni dipendenza diventa un collegamento diretto. Il nodo radice contiene il valore finale della clausola.
Il grafo non è una calcolatrice. È una struttura di documentazione. Il Manager lo legge, capisce esattamente cosa compilare e il risultato è un registro inequivocabile della parametrizzazione della clausola su un contratto.
Flusso di lavoro
Pannello inspector
Fare clic su qualsiasi nodo apre l'inspector a destra: tre schede, un nodo alla volta.
| Scheda | Cosa si fa qui |
|---|---|
| Properties | Impostare l'etichetta, l'operando, il tipo di valore del nodo e (per i nodi SUB_GRAPH) il grafo referenziato. Fare clic su Apply per confermare: le modifiche sono locali finché non si salva il grafo. |
| Dimensions | Aggiungere o rimuovere allegati di dimensioni documentali. Ogni dimensione allegata diventa un modulo di compilazione che il Manager deve completare per questo nodo. |
| Ext. links | Gestire i contributi in entrata da nodi in altri grafi. Vedere la sezione Genitori esterni per il flusso completo. |
Operandi dei nodi
L'operando definisce il ruolo di calcolo di un nodo e ne determina il rendering: colore e stile del bordo.
Ogni nodo deve avere un tipo di valore: il tipo di valore che il Manager inserirà (importo, percentuale, durata, conteggio, ecc.). I tipi di valore sono configurati dal Senior.
Operandi dei collegamenti
Un collegamento connette un nodo genitore a un nodo figlio. Il suo operando descrive come il genitore contribuisce al calcolo del figlio.
| Tipo di nodo | Operandi di collegamento attesi | Esempio |
|---|---|---|
| SUM | PLUS + MINUS | Perdita lorda + ALAE − recupero |
| PRODUCT | FACTOR × n | Tasso × Premio base |
| QUOTIENT | NUMERATOR × 1 + DENOMINATOR × 1 | Perdita netta / Valore totale assicurato |
| MAX / MIN | PLUS × n | MAX(netto trattenuto, pavimento di franchigia) |
| CONDITION | ARGUMENT × n | Se punto di attacco > soglia ALLORA sub-limite |
| SUB_GRAPH | ARGUMENT | Premio di reintegrazione tramite grafo separato |
| INPUT | Nessuno — foglia | Perdita per sinistro, franchigia, limite… |
Dimensioni — il motore creativo
Le dimensioni spiegano perché RI-TOOL si adatta a qualsiasi organizzazione senza imporre un template. Qui vive l'identità del tenant.
Quattro livelli, tre ruoli
Allegare una dimensione a un nodo
Selezionare un nodo → aprire la scheda Dimensions → fare clic su ＋ Add dimension → scegliere dal catalogo creato dal Senior. L'allegato è locale finché non si salva il grafo. È possibile allegare più dimensioni allo stesso nodo.
Scelte tipiche di allegato per tipo di nodo
| Tipo di nodo | Scelte tipiche di dimensione | Ragionamento |
|---|---|---|
| INPUT | Zona + Rischio + Tempo + Importo o Tasso | I valori foglia sono l'obiettivo principale di documentazione: contestualizzarli sempre. |
| SUM / PRODUCT | Importo (risultato) — opzionalmente assi di ambito se il contesto cambia a questo livello | I nodi di aggregazione possono necessitare di un'annotazione del risultato; il contesto è di solito ereditato dai figli. |
| MIN / MAX | In genere nessuna, o Importo per documentare il valore di soffitto/pavimento | I nodi strutturali di soffitto/pavimento raramente necessitano di dimensioni contestuali. |
| CONDITION | Dimensione personalizzata se il Senior ne ha definita una (es. Trigger) | Le condizioni possono necessitare di un asse dedicato se la logica della clausola lo richiede. |
| SUB_GRAPH | Di solito nessuna: il contesto vive nel grafo referenziato | I nodi di delega rinviano la documentazione alla fonte. |
La catena di protezione
La piattaforma previene la perdita silenziosa di dati in entrambe le direzioni. Non è possibile rimuovere un allegato di dimensione se il Manager ha già compilato valori per esso. Il Senior non può eliminare una dimensione allegata a un nodo. Ogni livello protegge quello sottostante.
Genitori esterni
Un nodo in un grafo può ricevere un contributo da un nodo in un grafo completamente diverso: il meccanismo per il riutilizzo tra clausole.
Esempio: Clausola A — Perdita netta trattenuta e Clausola B — Premio di reintegrazione. La formula di reintegrazione dipende dalla perdita netta trattenuta. Invece di duplicare i nodi, dichiarare la radice del grafo A come genitore esterno del nodo rilevante nel grafo B.
Come aggiungere un genitore esterno
Per rimuovere un genitore esterno esistente, fare clic sul pulsante ✕ accanto ad esso nella scheda Ext. links. Se il grafo figlio è istanziato, viene mostrato un avviso: il nodo fantasma che fa riferimento a questo collegamento diventa non valido per le istanze esistenti.
Risk links
Un Risk link collega un nodo Actuary a un nodo Risk Modeler, portando la descrizione dell'esposizione nel grafo delle clausole.
Il Risk Modeler costruisce grafi di esposizione — siti, pericoli, condizioni di copertura. Il vostro ruolo è collegare questo lavoro ai vostri grafi di clausole dichiarando quale nodo si riferisce a quale nodo Risk e come. Questa connessione è memorizzata in m_graph_risk_link e qualificata da un operando Risk link.
| Operando | Significato | Esempio |
|---|---|---|
EXPOSED_TO | Nodo Actuary collegato a un pericolo | Nodo perdita Cat XL ← Pericolo tempesta |
LOCATED_AT | Nodo Actuary collegato a un sito | Nodo property ← Impianto industriale Lione |
COVERED_BY | Nodo Actuary collegato a una condizione di copertura | Nodo ritenzione ← Copertura all risks property |
AGGREGATES | Nodo Actuary aggrega più oggetti di rischio | Nodo accumulazione ← Sito portafoglio |
Aggiungere un Risk link
Una volta creato, il nodo Risk appare come un phantom colorato sul canvas — stile per tipo di nodo (blu per sito, rosso per pericolo, verde per copertura), con bordo tratteggiato rosso mattone. Il phantom appare immediatamente, senza ricaricare la pagina.
Effetto sul Manager
Ogni Risk link creato genera un blocco Risk Dimensions nel cassetto di compilazione del Manager per quel nodo. Il Manager vede il label del nodo Risk, l'operando, il nome del grafo Risk e i campi definiti dal Risk Modeler. Le dimensioni Risk vengono salvate separatamente dalle dimensioni Actuary ma in un'unica azione di salvataggio.
Rilevamento dei cicli
Un DAG deve essere aciclico: nessun nodo può essere il proprio antenato. RI-TOOL rileva i cicli automaticamente ad ogni salvataggio.
Dopo il salvataggio, la piattaforma controlla l'intera struttura del grafo. Se viene trovato un ciclo, appare un banner arancione in cima all'editor e la riga del grafo nella barra laterale mostra un badge ♻ cycle.
Blocco dell'istanza
Una volta che un Manager istanzia un grafo su un contratto, la struttura di quel grafo viene bloccata.
La piattaforma blocca qualsiasi modifica strutturale a un grafo istanziato: non è possibile salvare modifiche o eliminarlo. Questo protegge l'inserimento dati esistente del Manager da un'invalidazione silenziosa.
Esploratore grafi
Vista di produzione di tutti i grafi in un unico posto: filtrabile, ispezionabile ed esportabile.
Fare clic su 🔭 Graph Explorer nella sezione Analytics della barra laterale per aprire l'esploratore a schermo intero. Il pannello di ispezione a destra rimane visibile durante tutta la navigazione: fare clic su qualsiasi scheda per caricare il dettaglio.
Barra dei filtri
Sei filtri combinabili si applicano in tempo reale:
| Filtro | Cosa mira |
|---|---|
| Famiglia clausola | Famiglia della clausola collegata al grafo (dall'elenco di riferimento del tenant) |
| Stato clausola | Stato di validazione della clausola: es. filtrare solo VALIDATED |
| Tipo di trattato | Qualsiasi codice di tipo di trattato associato alla clausola |
| Istanze | Istanziato (≥ 1 istanza Manager attiva) o Non istanziato |
| Ciclo | Grafi contrassegnati con un ciclo di riferimento dall'ultimo salvataggio |
| Dimensioni | Livello di copertura: Completa (100%), Parziale, Nessuna copertura o Grafo vuoto (nessun nodo) |
Usare ↺ Reset filters per cancellare tutto in una volta. Lo stato dei filtri viene persistito nel localStorage e ripristinato alla visita successiva.
Schede e inspector
Ogni scheda mostra l'id e l'etichetta del grafo, la sua clausola e una riga di badge semantici: conteggio nodi, conteggio istanze, flag ciclo, collegamenti inter-grafo e percentuale di copertura delle dimensioni con codice colore. Fare clic su una scheda per caricare il dettaglio completo nell'inspector destro: identità del grafo, testo della clausola, pillole dei tipi di trattato e barra di copertura visiva.
Dall'inspector, fare clic su ↗ Open in DAG editor per andare direttamente a quel grafo nel canvas.
Esportare
Il pulsante ⬇ Export CSV nell'intestazione dell'esploratore esporta la vista filtrata corrente come CSV: non tutti i grafi, solo quelli mostrati dai filtri attivi. Colonne: id grafo, etichetta, id clausola, titolo clausola, famiglia clausola, stato clausola, tipi di trattato (separati da |), conteggio nodi, nodi con dimensioni, % copertura dimensioni, conteggio istanze, collegamenti inter-grafo, flag ciclo.
Data Checks
Query in tempo reale sui dati del tenant, ciascuna esportabile come CSV, accessibili dalla sezione Analytics della barra laterale.
Fare clic su 📊 Data Checks per aprire il pannello a schermo intero. Ogni vista configurata mostra una descrizione e un pulsante ▶ Run. I risultati vengono visualizzati come tabella paginata con un link ⬇ Download CSV. La barra degli strumenti DAG offre anche un export ⬇ CSV per grafo dei nodi e collegamenti del grafo corrente.
Manutenzione
Quattro operazioni di pulizia accessibili dal piè della barra laterale. Eseguire sempre prima la diagnostica — mostra esattamente cosa verrà rimosso senza toccare nulla.
| Codice | Cosa pulisce | Quando si verifica |
|---|---|---|
| A1 | Nodi il cui grafo padre è stato eliminato — a cascata sui loro link e allegati dimensioni | Grafo eliminato fuori dal flusso normale |
| A2 | Link intra-grafo orfani il cui nodo padre o figlio non esiste più | Nodo eliminato senza cascata sui link |
| A3 | Link inter-grafo fantasma che puntano a un grafo eliminato (lato padre o figlio) | Un grafo coinvolto in un cross-link è stato eliminato |
| A4 | Allegati dimensioni orfani (nodo o dimensione eliminati) — può rimuovere anche i valori Manager associati | Nodo o dimensione eliminati lasciando allegati obsoleti |
Ordine consigliato: A1 → A2 → A3 → A4. Eseguire A1 per primo elimina i nodi i cui link verrebbero altrimenti catturati anche da A2 e A3.