Il conto è un grafo.
Lei ne è l'architetto.
Come SOA Senior, progetta i template dei conti tecnici di riassicurazione (pattern). Ogni pattern definisce la struttura di un conto: righe contabili, tipi di collegamento e nodi FORMULA che fanno riferimento agli output quantitativi prodotti dal Manager.
Il suo ruolo nella catena
Sei ruoli, una direzione. Il modulo SOA si trova alla fine della catena, traducendo il lavoro attuariale in conti finanziari.
Barra laterale dei pattern
La barra laterale sinistra elenca tutti i pattern SOA. Ogni pattern è un template riutilizzabile per un conto tecnico.
Usare la casella di ricerca per filtrare i pattern per nome o identificatore. Fare clic su ＋ New pattern per crearne uno: assegnargli un'etichetta descrittiva (es. XL Treaty Statement v1, Quota Share — Annual).
Un badge ♻ accanto al nome di un pattern indica un ciclo rilevato: quel pattern non può essere istanziato dal Junior finché il ciclo non viene corretto. Un piccolo contatore di istanze (es. 3×) mostra quante istanze SOA attive fanno riferimento a quel pattern.
Costruire un pattern SOA
Un pattern è un grafo aciclico diretto di righe contabili. Ogni nodo rappresenta una riga del conto. I collegamenti codificano la struttura gerarchica (dettaglio → subtotale → totale).
Scorciatoie da tastiera
| Tasto | Azione |
|---|---|
| Ctrl/Cmd + S | Salvare il pattern corrente |
| Canc / Backspace | Eliminare il nodo o collegamento selezionato |
| Rotella del mouse | Zoom avanti / indietro |
| Trascinamento sul canvas | Spostare la vista |
| Doppio clic canvas | Aggiungere un nodo al cursore |
Tipi di collegamento SOA
Ogni nodo e ogni collegamento in un pattern SOA porta un tipo di collegamento: il suo ruolo contabile nel conto. Questo sostituisce gli operandi di calcolo usati dall'Attuario.
È possibile estendere l'elenco da 🏷 SOA Link Types nella barra laterale. I nuovi codici sono immediatamente disponibili nell'editor dei nodi. L'eliminazione di un codice è bloccata se un nodo o collegamento lo usa ancora.
Pannello inspector
Fare clic su un nodo apre l'inspector a destra: due schede per il nodo selezionato.
| Scheda | Cosa si fa qui |
|---|---|
| Properties | Modificare l'etichetta, il tipo di collegamento e il tipo di valore del nodo. Fare clic su Apply per aggiornare lo stato in memoria, poi Save (barra degli strumenti) per persistere. |
| Dimensions | Aggiungere o rimuovere allegati di dimensioni documentali. Ogni dimensione allegata diventa un modulo di compilazione che il SOA Junior deve completare per questa riga. |
Fare clic su un collegamento apre l'inspector con un selettore di tipo di collegamento: modificare il tipo e fare clic su Apply.
Fare clic sullo sfondo del pattern (nessun nodo selezionato) mostra l'inspector del pattern: clausole collegate, restrizioni sui tipi di trattato, conteggio delle istanze e pulsanti di azione rapida (rinominare, modificare clausole, modificare tipi di trattato, eliminare).
Nodi FORMULA — il ponte verso i dati del Manager
Un nodo FORMULA è una riga contabile speciale il cui valore non viene inserito direttamente dal SOA Junior: il Junior cita invece un nodo specifico di un'istanza del grafo Manager.
Come creare un nodo FORMULA
Cosa fa il SOA Junior con i nodi FORMULA
Quando il Junior apre un nodo FORMULA, appare un selettore a tre gruppi: Stesso contratto, Stesso tipo di trattato, Stessa clausola. Il Junior seleziona il grafo Manager pertinente e il nodo specifico il cui output alimenta quella riga del conto. Il riferimento viene memorizzato come citazione JSON: nessun valore viene copiato, solo il puntatore.
Operandi link IF / THEN / ELSE
Quando un nodo pattern SOA è collegato a un nodo grafo Actuary di tipo CONDITION, tre operandi link specializzati strutturano esplicitamente la relazione condizionale.
Prima della patch 035, i nodi CONDITION usavano l'operando generico ARGUMENT per tutti i genitori, rendendo ambigua l'intenzione grafica. I tre operandi dedicati qui sotto sostituiscono ARGUMENT sui link CONDITION e rendono la logica del predicato immediatamente leggibile sul canvas.
Quando questi operandi sono rilevanti per il SOA Senior?
Come SOA Senior, non costruite grafi Actuary — ma collegate i nodi FORMULA ai loro omologhi Manager, che a loro volta referenziano output di grafi Actuary. Capire cosa produce un nodo CONDITION vi aiuta a etichettare con precisione la riga FORMULA corrispondente nel statement.
Esempio tipico: un nodo FORMULA Profit Commission Payable after Loss Corridor dovrebbe citare l'output di un nodo CONDITION nel grafo Actuary. Quel CONDITION valuta una soglia di loss corridor — il genitore IF è il test, il genitore THEN è la commissione se il corridor viene superato, il genitore ELSE è zero. La vostra riga FORMULA cattura il risultato di quella diramazione.
Nodi THRESHOLD
Un nodo THRESHOLD (arancione, introdotto nella patch 035) è un nodo foglia che rappresenta un singolo limite — pavimento, soffitto, punto di attacco o trigger. È sempre genitore di un nodo CONDITION o LOOKUP. I nodi THRESHOLD non appaiono direttamente come target FORMULA nei pattern SOA: sono input intermedi nel grafo Actuary, non quantità di output. Non create righe FORMULA che citano nodi THRESHOLD.
Dimensioni
Le dimensioni sono assi documentali: moduli di compilazione opzionali allegati ai nodi del pattern. Il SOA Senior può allegare qualsiasi dimensione del catalogo del tenant a qualsiasi nodo.
Il catalogo delle dimensioni appartiene al Senior Underwriter ed è condiviso tra tutti i profili. Una categoria di dimensioni dedicata SOA viene fornita alla creazione del tenant con tre assi base: Periodicità, Quota e Controparte: il contesto documentale più comune per una riga del conto.
| Dimensione base | Utilizzo tipico su un nodo SOA |
|---|---|
| PERIODICITY | Trimestrale / annuale / adeguamento / supplementare: il ciclo contabile per questa riga |
| SHARE | 100% / quota del riassicuratore / quota del cedente: la proporzione applicabile |
| COUNTERPART | Riassicuratore / broker: la parte pagante o ricevente |
Restrizioni dei pattern
Due restrizioni facoltative aiutano il SOA Junior a trovare il pattern corretto per ogni contratto.
Clausole collegate
Un pattern può essere ancorato a una o più clausole validate (es. clausola di reintegrazione XL). È informativo: segnala la famiglia di clausole per cui è stato progettato il pattern. La restrizione non viene applicata all'istanziazione.
Per gestire: fare clic su 🔗 Clauses nella barra degli strumenti, o usare il pulsante Edit linked clauses nell'inspector del pattern.
Restrizioni sui tipi di trattato
Restringendo un pattern a uno o più tipi di trattato (es. TREATY_XL), la schermata di creazione istanza del Junior mostra un badge di compatibilità: ✓ Compatible o ⚠ Mismatch. Un mismatch è un avviso, non un blocco.
Lasciare tutti i tipi di trattato deselezionati per rendere il pattern universale, applicabile a qualsiasi contratto.
Per gestire: fare clic su 📋 Treaty types nella barra degli strumenti, o usare l'inspector del pattern.
Rilevamento dei cicli
Un DAG deve essere aciclico: nessuna riga può essere il proprio antenato. RI-TOOL rileva i cicli automaticamente ad ogni salvataggio.
Se viene trovato un ciclo, appare un banner arancione in cima all'editor e la riga del pattern nella barra laterale mostra un badge ♻ cycle. Il pattern viene comunque salvato ma è contrassegnato come non istanziabile.
Esploratore di pattern
Vista di produzione di tutti i pattern, filtrabile per stato delle istanze e flag di ciclo.
Fare clic su 🔭 Pattern Explorer nella barra laterale per aprire la vista a schermo intero. Ogni scheda mostra l'identificatore del pattern, l'etichetta, il conteggio dei nodi, la percentuale di copertura delle dimensioni e il conteggio delle istanze. Fare clic su una scheda per andare direttamente a quel pattern nell'editor.
Copertura delle dimensioni
La copertura è la percentuale di nodi con almeno una dimensione allegata. 🧩 80% significa che l'80% dei nodi ha requisiti di documentazione. Un pattern con copertura 0% è valido ma non produce alcun modulo di compilazione per il Junior.
Data Checks
Query SQL in tempo reale sui dati del tenant, accessibili da 📊 Data Checks nella barra laterale.
| Vista | Cosa mostra |
|---|---|
| SOA Templates — overview | Tutti i pattern con conteggio nodi, nodi FORMULA, conteggio istanze, tipi di trattato e clausole collegate |
| FORMULA nodes — missing dimension | Nodi FORMULA senza dimensione FORMULA allegata: anomalie di configurazione da correggere |
| Dimension coverage by node | Tutti i nodi con le dimensioni allegate e il conteggio delle istruzioni: utile per l'audit di copertura |
Ogni vista ha un pulsante ▶ Run. I risultati vengono visualizzati in linea con un link ⬇ Download CSV per l'esportazione completa.
Manutenzione
Quattro controlli di pulizia accessibili dalla barra laterale. Diagnosticare sempre prima di eseguire — l'esecuzione è irreversibile.
| Codice | Cosa pulisce | Rischio |
|---|---|---|
| S1 | Pattern senza nodi — gusci vuoti lasciati da una creazione interrotta | Basso |
| S2 | Pattern con un ciclo rilevato — solo diagnostica, nessuna eliminazione. Correggere manualmente nell'editor. | Medio |
| S3 | Nodi orfani il cui pattern padre è stato eliminato fuori dal flusso normale | Medio |
| S4 | Allegati dimensioni orfani il cui nodo o dimensione è stato eliminato | Basso |
Ordine consigliato: S1 → S3 → S4. S2 è una diagnostica in sola lettura — evidenzia i cicli da correggere manualmente, non elimina nulla.