Aktuariusz

Formalizujesz klauzulę.
Budujesz graf.

Jako Aktuariusz tłumaczysz zwalidowane klauzule reasekuracyjne na skierowane grafy acykliczne (DAG). Każdy węzeł to element obliczeniowy; każde połączenie to zależność. Manager następnie instancjonuje Twoje grafy na rzeczywistych kontraktach i wprowadza wartości.

⬡ Edytor DAG

🔗 Połączenia między grafami

🧩 Dołączenia wymiarów

🔭 Eksplorator grafów

Twoja rola w łańcuchu

Cztery role — jeden kierunek. Każdy krok odblokowuje następny.

Krok	Profil	Co robi	Co otrzymujesz
1	Junior	Dekonstruuje tekst klauzul — tworzy ustrukturyzowane klauzule z treścią, rodziną, typami umów, zależnościami	Klauzule w szkicu
2	Senior	Waliduje klauzule i projektuje katalog wymiarów — osie, które będziesz dołączać do węzłów grafu	Zwalidowane klauzule + paleta wymiarów
3	Actuary ← Ty	Buduje grafy DAG dla każdej zwalidowanej klauzuli. Dołącza wymiary węzeł po węźle. Łączy grafy między klauzulami.	Grafy gotowe dla Managera
4	Manager	Tworzy kontrakty, instancjonuje graf, wypełnia wartości wymiarów dla każdego węzła	—

💡

Widzisz tylko zwalidowane klauzule. Jeśli klauzula brakuje, Senior musi ją najpierw zwalidować. Nie możesz modyfikować treści klauzul.

Pasek boczny klauzul

Lewy pasek boczny to Twoja główna nawigacja — przewijalna lista wszystkich zwalidowanych klauzul z zagnieżdżonymi grafami.

Każda karta klauzuli pokazuje jej identyfikator (CL_NNNN), tytuł, pastylki typów umów (kodowane kolorami: FAC, XL, TREATY_XL, QUOTA, SURPLUS) i tagi terminów RI 🏷 z definicjami po najechaniu. Kliknij kartę, aby ją rozwinąć i odsłonić grafy.

Tworzenie grafu

Kliknij + New graph bezpośrednio na klauzuli bez istniejącego grafu, lub przycisk + Graph u góry rozwiniętej klauzuli. Nadaj mu opisową etykietę — Manager używa jej do wyboru, którą formalizację instancjonować.

💡

Jedna klauzula, wiele grafów. Możesz tworzyć wiele grafów dla tej samej klauzuli — alternatywne formalizacje lub wersje dla różnych typów umów. Manager wybiera, który instancjonować na kontrakt.

Wskaźniki statusu grafu

Każdy wiersz grafu na pasku bocznym pokazuje dwie odznaki: ostrzeżenie ♻ cycle jeśli ostatni zapis wykrył cykl, oraz bieżący stan zapisu ✓ saved / ● unsaved.

Budowanie DAG

Skierowany graf acykliczny koduje logikę obliczeniową klauzuli jako przechodliwą strukturę węzłów i skierowanych połączeń.

Klauzula reasekuracyjna zawiera zagnieżdżone formuły — netto strata własna, po odliczeniu odzysków, powyżej retencji, z pułapem limitu. Każdy element staje się węzłem. Każda zależność staje się skierowanym połączeniem. Węzeł korzenny zawiera końcową wartość klauzuli.

Graf nie jest kalkulatorem. Jest strukturą dokumentacyjną. Manager go czyta, rozumie dokładnie co wypełnić, a wynikiem jest jednoznaczny zapis parametryzacji klauzuli na kontrakcie.

Przepływ pracy

Wybierz graf na pasku bocznym

Kliknij wiersz grafu, aby załadować go na canvas. Canvas to edytor SVG z panoramowaniem i powiększaniem. Użyj paska narzędzi, aby dopasować widok, dodać węzły, zapisać lub wyeksportować CSV.

Dodaj węzły

Kliknij + Node na pasku narzędzi. Tymczasowy węzeł pojawia się na canvasie, a prawy inspektor otwiera się na zakładce Properties. Ustaw etykietę, operand i typ wartości, następnie kliknij Apply.

Rysuj połączenia

Najedź na węzeł, aż pojawi się uchwyt krawędziowy, następnie przeciągnij do węzła docelowego. Tworzone jest połączenie i pojawia się selektor operandu — wybierz PLUS, MINUS, FACTOR itp.

Dołącz wymiary

Wybierz węzeł, otwórz zakładkę Dimensions w inspektorze i kliknij ＋ Add dimension, aby przypiąć osie dokumentacyjne do węzła.

Zapisz

Kliknij 💾 Save na pasku narzędzi. Cały graf — węzły, połączenia, dołączenia wymiarów — jest zapisywany atomowo. Odznaka statusu zmienia się na ✓ saved.

⚠️

Zapis jest wszystko albo nic. Niezapisane zmiany istnieją tylko w przeglądarce. Odświeżenie bez zapisania powoduje utratę pracy.

Panel inspektora

Kliknięcie dowolnego węzła otwiera inspektor po prawej — trzy zakładki, jeden węzeł na raz.

Properties

Dimensions

Ext. links

Zakładka	Co tu robisz
Properties	Ustaw etykietę, operand, typ wartości węzła i (dla węzłów SUB_GRAPH) odwoływany graf. Kliknij Apply, aby potwierdzić — zmiany są lokalne do zapisania grafu.
Dimensions	Dodawaj lub usuwaj dołączenia wymiarów dokumentacyjnych. Każdy dołączony wymiar staje się formularzem wypełniania, który Manager musi ukończyć dla tego węzła.
Ext. links	Zarządzaj przychodzącymi wkładami z węzłów w innych grafach. Zobacz sekcję Zewnętrzne rodzimy dla pełnego przepływu.

💡

Apply vs. Save. Apply zatwierdza zmiany w stanie grafu w pamięci. Save (pasek narzędzi) zapisuje cały graf do bazy danych. Zawsze zapisuj po Apply.

Operandy węzłów

Operand definiuje rolę obliczeniową węzła i określa sposób jego renderowania — kolor i styl ramki.

INPUT

Wartość wprowadzana przez Managera. Węzeł liść — bez rodziców. Przerywana ramka. Główny cel dokumentacji.

CONSTANT

Stała wartość ustawiona przy budowie grafu — nie wypełniana przez Managera.

SUM

Suma rodziców addytywnych minus subtraktywnych. Najczęstszy węzeł agregacyjny.

PRODUCT

Iloczyn wszystkich węzłów rodzicielskich. Modeluje klauzule multiplikatywne (kurs × baza).

MAX

Zwraca maksimum wszystkich rodziców. Przydatny dla obliczeń dolnego limitu.

MIN

Zwraca minimum wszystkich rodziców. Przydatny dla obliczeń górnego pułapu.

QUOTIENT

Dzielenie. Oczekuje jednego rodzica NUMERATOR i jednego DENOMINATOR.

DIFFERENCE

Jawne odejmowanie — baza pomniejszona o odliczenia.

CONDITION

Brama warunkowa — modeluje logikę jeśli/inaczej. Użyj połączeń ARGUMENT dla gałęzi.

SUB_GRAPH

Deleguje obliczenia do innego grafu. Wybierz odwoływany graf na zakładce Properties.

💡

INPUT zawsze jest liściem. Nigdy nie ma rodziców. Każdy inny operand powinien mieć co najmniej jednego rodzica — inaczej Manager nie ma nic do agregacji w tym węźle.

Każdy węzeł musi mieć typ wartości — rodzaj wartości, którą wprowadzi Manager: kwota, procent, czas trwania, liczba itp. Typy wartości są konfigurowane przez Seniora.

🔬

Wszystkie te operandy dostępne od pierwszego dnia

Przykład Profit Commission jest dołączany do każdego nowego konta — 5 grafów, 46 węzłów, z kaskadą bottom-up, skalą ruchomą, korytarzem szkód, podgrafem carry-forward i LOOKUP.

→

Operandy połączeń

Połączenie łączy węzeł rodzicielski z węzłem potomnym. Jego operand opisuje, jak rodzic przyczynia się do obliczenia potomnego.

PLUS

Rodzic jest dodawany. Standardowy wkład do węzła SUM.

MINUS

Rodzic jest odejmowany. Modeluje odliczenia w SUM.

FACTOR

Rodzic jest mnożnikiem. Używaj z węzłami PRODUCT.

NUMERATOR

Rodzic to licznik dzielenia. Używaj z QUOTIENT.

DENOMINATOR

Rodzic to mianownik dzielenia. Używaj z QUOTIENT.

ARGUMENT

Ogólna zależność — gałęzie CONDITION lub parametry SUB_GRAPH.

Typ węzła	Oczekiwane operandy połączeń	Przykład
SUM	PLUS + MINUS	Strata brutto + ALAE − odzysk
PRODUCT	FACTOR × n	Kurs × Składka bazowa
QUOTIENT	NUMERATOR × 1 + DENOMINATOR × 1	Strata netto / Łączna wartość ubezpieczona
MAX / MIN	PLUS × n	MAX(netto własne, dolny limit franczyzy)
CONDITION	ARGUMENT × n	Jeśli punkt wejścia > próg TO sub-limit
SUB_GRAPH	ARGUMENT	Składka reinstatement przez oddzielny graf
INPUT	Brak — liść	Strata zdarzenia, franczyza, limit…

Wymiary — silnik twórczy

Wymiary wyjaśniają, dlaczego RI-TOOL dostosowuje się do każdej organizacji bez narzucania szablonu. Tutaj żyje tożsamość Twojego tenanta.

🎯

System wymiarów to centralne wyróżnienie RI-TOOL. Dwie organizacje formalizujące tę samą klauzulę mogą używać zupełnie różnych osi, różnej granularności, różnych instrukcji — i obie będą idealnie odpowiadać swojej własnej organizacji.

Cztery warstwy, trzy role

Senior

Kategorie + Wymiary

Tworzy nazwane kategorie wymiarów i same wymiary, każdy z instrukcjami wypełniania, które Manager będzie następował linia po linii.

→

Actuary — Ty

Dołączenia do węzłów

Przypina konkretne wymiary do konkretnych węzłów przez zakładkę Dimensions inspektora. Jedna decyzja na węzeł: co Manager musi tutaj dokumentować?

→

Manager

Wypełnione wartości

Wypełnia jedną wartość na węzeł × wymiar × linia instrukcji. Wynik: w pełni udokumentowana instancja klauzuli na kontrakcie.

Dołączanie wymiaru do węzła

Wybierz węzeł → otwórz zakładkę Dimensions → kliknij ＋ Add dimension → wybierz z katalogu zbudowanego przez Seniora. Dołączenie jest lokalne do zapisania grafu. Możesz dołączyć wiele wymiarów do tego samego węzła.

💡

Instrukcje to formularz Managera. Wymiar Amount z trzema instrukcjami tworzy trzy pola wypełniania na dołączony węzeł. Senior kontroluje granularność; Ty decydujesz, gdzie ją stosować.

Typowe wybory dołączeń według typu węzła

Typ węzła	Typowe wybory wymiarów	Uzasadnienie
INPUT	Strefa + Ryzyko + Czas + Kwota lub Kurs	Wartości liści to główny cel dokumentacji — zawsze je kontekstualizuj.
SUM / PRODUCT	Kwota (wynik) — opcjonalnie osie zakresu jeśli kontekst zmienia się na tym poziomie	Węzły agregacyjne mogą potrzebować adnotacji wyniku; kontekst jest zazwyczaj dziedziczony od dzieci.
MIN / MAX	Zazwyczaj żaden, lub Kwota do dokumentacji wartości pułapu/dolnego limitu	Strukturalne węzły pułapu/dolnego limitu rzadko potrzebują wymiarów kontekstowych.
CONDITION	Niestandardowy wymiar jeśli Senior go zdefiniował (np. Wyzwalacz)	Warunki mogą potrzebować dedykowanej osi jeśli logika klauzuli tego wymaga.
SUB_GRAPH	Zazwyczaj żaden — kontekst żyje w odwoływanym grafie	Węzły delegujące przekazują dokumentację do źródła.

Łańcuch ochrony

Platforma zapobiega cichej utracie danych w obu kierunkach. Nie możesz usunąć dołączenia wymiaru, jeśli Manager już wypełnił dla niego wartości. Senior nie może usunąć wymiaru dołączonego przez Ciebie do węzła. Każda warstwa chroni tę poniżej.

Zewnętrzne rodzimy

Węzeł w jednym grafie może otrzymywać wkład od węzła w zupełnie innym grafie — mechanizm ponownego użycia między klauzulami.

Przykład: Klauzula A — Netto strata własna i Klauzula B — Składka reinstatement. Formuła reinstatement zależy od netto straty własnej. Zamiast duplikować węzły, zadeklaruj korzeń grafu A jako zewnętrzny rodzic odpowiedniego węzła w grafie B.

Jak dodać zewnętrznego rodzica

Wybierz węzeł potomny

Kliknij węzeł w grafie potomnym, który będzie odbierał przychodzącą wartość. Węzeł musi już być zapisany (nie węzeł TMP_).

Otwórz zakładkę Ext. links

W inspektorze kliknij zakładkę Ext. links. Istniejące zewnętrzne rodzimy są wymienione. Poniżej nich jest formularz Add parent.

Wypełnij formularz

Wybierz graf źródłowy, węzeł źródłowy i operand (PLUS, MINUS, FACTOR…). Kliknij ＋ Add external parent.

⚠️

Graf potomny musi być otwarty gdy dodajesz rodzica. Połączenie jest tworzone natychmiast — nie jest wymagany oddzielny zapis dla samego połączenia. Canvas automatycznie odświeża się, aby pokazać nowego ducha.

Aby usunąć istniejącego zewnętrznego rodzica, kliknij przycisk ✕ obok niego na zakładce Ext. links. Jeśli graf potomny jest instancjonowany, pojawi się ostrzeżenie — węzeł-duch odnoszący się do tego połączenia staje się nieprawidłowy dla istniejących instancji.

Risk links

Risk link łączy węzeł Actuary z węzłem Risk Modeler, wprowadzając opis ekspozycji do grafu klauzul.

Risk Modeler buduje grafy ekspozycji — lokalizacje, zagrożenia, warunki pokrycia. Twoją rolą jest powiązanie tej pracy z grafami klauzul przez zadeklarowanie, który węzeł odnosi się do którego węzła Risk i w jaki sposób. Połączenie to jest przechowywane w m_graph_risk_link i kwalifikowane przez operand Risk link.

Operand	Znaczenie	Przykład
`EXPOSED_TO`	Węzeł Actuary powiązany z zagrożeniem	Węzeł straty Cat XL ← Zagrożenie burzą
`LOCATED_AT`	Węzeł Actuary powiązany z lokalizacją	Węzeł property ← Zakład przemysłowy Lyon
`COVERED_BY`	Węzeł Actuary powiązany z warunkiem pokrycia	Węzeł retencji ← Pokrycie all risks property
`AGGREGATES`	Węzeł Actuary agreguje wiele obiektów ryzyka	Węzeł akumulacji ← Lokalizacja portfela

Dodawanie Risk link

Wybrać węzeł

Kliknij dowolny zapisany węzeł w grafie. Musi już istnieć w bazie danych (nie węzeł TMP_).

Otworzyć zakładkę Ext. links

W inspektorze kliknij zakładkę Ext. links. Przewiń do sekcji 🗺️ Risk links na dole.

Wybrać graf Risk, węzeł, operand

Wybierz graf Risk z pierwszego menu, następnie węzeł Risk i operand. Kliknij ＋ Add Risk link.

Po utworzeniu węzeł Risk pojawia się jako kolorowy phantom na canvasie — styl zależy od typu węzła (niebieski dla lokalizacji, czerwony dla zagrożenia, zielony dla pokrycia), z przerywaną rdzawą obwódką. Phantom pojawia się natychmiast, bez przeładowania strony.

💡

Preładowany przykład. Risk Modeler dodał graf o nazwie European Industrial Portfolio. Użyj go do ćwiczenia tworzenia Risk links przed połączeniem rzeczywistych danych ekspozycji.

⚠️

Operandy Risk link są zarządzane przez tenant. Twój Admin może dodawać niestandardowe operandy w zakładce Risk link operands sekcji Referencje.

Wpływ na Managera

Każdy utworzony Risk link generuje blok Risk Dimensions w szufladzie wypełniania Managera dla tego węzła. Manager widzi label węzła Risk, operand, nazwę grafu Risk i pola zdefiniowane przez Risk Modelera. Wymiary Risk są zapisywane oddzielnie od wymiarów Actuary, ale w jednej akcji zapisu.

Wykrywanie cykli

DAG musi być acykliczny — żaden węzeł nie może być własnym przodkiem. RI-TOOL wykrywa cykle automatycznie przy każdym zapisie.

Po zapisaniu platforma sprawdza pełną strukturę grafu. Jeśli wykryto cykl, pojawia się pomarańczowy baner na górze edytora, a wiersz grafu na pasku bocznym pokazuje odznakę ♻ cycle.

⚠️

Wykrywanie nie blokuje. Cykliczny graf jest mimo to zapisywany — ale jest semantycznie nieprawidłowy i Manager nie może go instancjonować. Napraw przed użyciem: znajdź węzeł powracający do jednego ze swoich przodków, usuń błędne połączenie, zapisz ponownie.

Blokada instancji

Po instancjonowaniu grafu przez Managera na kontrakcie, struktura tego grafu jest zamrożona.

Platforma blokuje wszelkie modyfikacje strukturalne instancjonowanego grafu — nie możesz zapisywać zmian ani go usuwać. Chroni to istniejące wprowadzanie danych przez Managera przed cichym unieważnieniem.

🔒

Musisz zmodyfikować instancjonowany graf? Utwórz nową wersję. Użyj + Graph na tej samej klauzuli z nową etykietą (np. Netto strata własna v2). Manager instancjonuje nową wersję na przyszłych kontraktach; istniejące kontrakty zachowują oryginał.

Eksplorator grafów

Produkcyjny widok wszystkich grafów w jednym miejscu — filtrowalny, inspektowalny i eksportowalny.

Kliknij 🔭 Graph Explorer w sekcji Analytics paska bocznego, aby otworzyć eksplorator pełnoekranowy. Panel inspekcji po prawej pozostaje widoczny przez cały czas — kliknij kartę, aby załadować jej szczegóły.

Pasek filtrów

Sześć kombinowalnych filtrów stosuje się w czasie rzeczywistym:

Filtr	Co celuje
Rodzina klauzuli	Rodzina klauzuli powiązanej z grafem (z listy referencyjnej tenanta)
Status klauzuli	Status walidacji klauzuli — np. filtruj tylko VALIDATED
Typ umowy	Dowolny kod typu umowy powiązany z klauzulą
Instancje	Instancjonowany (≥ 1 aktywna instancja Managera) lub Nieinstancjonowany
Cykl	Grafy oznaczone cyklem referencyjnym przez ostatni zapis
Wymiary	Poziom pokrycia — Pełny (100%), Częściowy, Brak pokrycia lub Pusty graf (bez węzłów)

Użyj ↺ Reset filters, aby wyczyścić wszystko naraz. Stan filtrów jest utrwalany w localStorage i przywracany przy następnej wizycie.

Karty i inspektor

Każda karta pokazuje identyfikator i etykietę grafu, jego klauzulę i wiersz semantycznych odznak — liczba węzłów, liczba instancji, flaga cyklu, połączenia między grafami i procent pokrycia wymiarów z kodowaniem kolorystycznym. Kliknij kartę, aby załadować pełne szczegóły w prawym inspektorze: tożsamość grafu, treść klauzuli, pastylki typów umów i wizualny pasek pokrycia.

Z inspektora kliknij ↗ Open in DAG editor, aby przejść bezpośrednio do tego grafu na canvasie.

Eksport

Przycisk ⬇ Export CSV w nagłówku eksploratora eksportuje bieżący filtrowany widok jako CSV — nie wszystkie grafy, tylko te pokazywane przez aktywne filtry. Kolumny: id grafu, etykieta, id klauzuli, tytuł klauzuli, rodzina klauzuli, status klauzuli, typy umów (oddzielone |), liczba węzłów, węzły z wymiarami, % pokrycia wymiarów, liczba instancji, połączenia między grafami, flaga cyklu.

💡

Dane eksploratora są ładowane raz na sesję i buforowane. Jeśli wprowadzisz zmiany strukturalne w edytorze DAG i wrócisz do eksploratora, odśwież stronę, aby ponownie załadować.

Data Checks

Zapytania na żywo na danych tenanta, każde eksportowalne jako CSV — dostępne z sekcji Analytics paska bocznego.

Kliknij 📊 Data Checks, aby otworzyć panel pełnoekranowy. Każdy skonfigurowany widok pokazuje opis i przycisk ▶ Run. Wyniki są wyświetlane jako paginowana tabela z linkiem ⬇ Download CSV. Pasek narzędzi DAG oferuje również eksport ⬇ CSV na poziomie grafu węzłów i połączeń bieżącego grafu.

Konserwacja

Cztery operacje czyszczenia dostępne z stopki paska bocznego. Zawsze uruchamiaj najpierw diagnostykę — pokazuje dokładnie co zostanie usunięte bez dotykania czegokolwiek.

⚠️

Wszystkie operacje purge są nieodwracalne. Dokładnie przejrzyj listę diagnostyczną przed potwierdzeniem.

Kod	Co czyści	Kiedy występuje
A1	Węzły, których graf nadrzędny został usunięty — kaskaduje na ich linki i powiązania wymiarów	Graf usunięty poza normalnym przepływem
A2	Osierocone linki intra-graf, których węzeł nadrzędny lub podrzędny już nie istnieje	Węzeł usunięty bez kaskady na linki
A3	Linki inter-graf-duchy wskazujące na usunięty graf (strona nadrzędna lub podrzędna)	Graf zaangażowany w cross-link został usunięty
A4	Osierocone powiązania wymiarów (węzeł lub wymiar usunięty) — może też usuwać powiązane wartości Managera	Węzeł lub wymiar usunięty pozostawiając przestarzałe powiązania

Zalecana kolejność: A1 → A2 → A3 → A4. Uruchomienie A1 jako pierwsze eliminuje węzły, których linki byłyby w przeciwnym razie również przechwytywane przez A2 i A3.