조항을 형식화합니다.
그래프를 구축합니다.
계리사로서 승인된 재보험 조항을 방향성 비순환 그래프(DAG)로 변환합니다. 각 노드는 계산 요소이고, 각 연결은 의존성입니다. Manager는 실제 계약에 귀하의 그래프를 인스턴스화하고 값을 입력합니다.
체인에서의 역할
네 가지 역할 — 하나의 방향. 각 단계가 다음 단계의 잠금을 해제합니다.
| 단계 | 프로필 | 역할 | 귀하가 받는 것 |
|---|---|---|---|
| 1 | Junior | 조항 텍스트 분해 — 내용, 계열, 조약 유형, 의존성이 있는 구조화된 조항 생성 | 초안 조항 |
| 2 | Senior | 조항 승인 및 차원 카탈로그 설계 — 그래프 노드에 첨부할 축 | 승인된 조항 + 차원 팔레트 |
| 3 | Actuary ← 귀하 | 승인된 조항당 DAG 그래프 구축. 노드별 차원 첨부. 조항 간 그래프 연결. | Manager를 위한 준비된 그래프 |
| 4 | Manager | 계약 생성, 그래프 인스턴스화, 노드당 차원 값 입력 | — |
DAG 구축
방향성 비순환 그래프는 조항의 계산 논리를 노드와 방향성 연결의 순회 가능한 구조로 인코딩합니다.
재보험 조항에는 중첩된 공식이 포함됩니다 — 회수 순, 유보 초과, 한도 상한의 순 보유 손실. 각 요소가 노드가 됩니다. 각 의존성이 방향성 연결이 됩니다. 루트 노드는 조항의 최종 값을 포함합니다.
그래프는 계산기가 아닙니다. 문서화 구조입니다. Manager가 이를 읽고, 무엇을 채울지 정확히 이해하고, 결과는 계약에서 조항 매개변수화의 명확한 기록입니다.
워크플로우
인스펙터 패널
노드를 클릭하면 오른쪽에 인스펙터가 열립니다 — 한 번에 하나의 노드에 대한 세 개의 탭.
| 탭 | 여기서 하는 작업 |
|---|---|
| Properties | 노드 레이블, 피연산자, 값 유형, (SUB_GRAPH 노드의 경우) 참조된 그래프를 설정합니다. 확인하려면 Apply를 클릭합니다 — 변경 사항은 그래프를 저장할 때까지 로컬입니다. |
| Dimensions | 문서 차원 첨부를 추가하거나 제거합니다. 각 첨부된 차원은 Manager가 이 노드에 대해 완성해야 하는 입력 양식이 됩니다. |
| Ext. links | 다른 그래프의 노드에서 들어오는 기여를 관리합니다. 전체 흐름은 외부 부모 섹션을 참조하십시오. |
노드 피연산자
피연산자는 노드의 계산 역할을 정의하고 렌더링 방식을 결정합니다 — 색상과 테두리 스타일.
각 노드에는 값 유형이 있어야 합니다 — Manager가 입력할 값의 종류: 금액, 퍼센트, 기간, 수량 등. 값 유형은 Senior가 구성합니다.
연결 피연산자
연결은 부모 노드를 자식 노드에 연결합니다. 피연산자는 부모가 자식의 계산에 어떻게 기여하는지 설명합니다.
| 노드 유형 | 예상 연결 피연산자 | 예시 |
|---|---|---|
| SUM | PLUS + MINUS | 총 손실 + ALAE − 회수 |
| PRODUCT | FACTOR × n | 비율 × 기반 보험료 |
| QUOTIENT | NUMERATOR × 1 + DENOMINATOR × 1 | 순 손실 / 총 피보험 가치 |
| MAX / MIN | PLUS × n | MAX(순 보유, 공제 바닥) |
| CONDITION | ARGUMENT × n | 부착점 > 임계값이면 하위 한도 |
| SUB_GRAPH | ARGUMENT | 별도 그래프를 통한 갱신 보험료 |
| INPUT | 없음 — 잎 | 사건 손실, 공제, 한도… |
차원 — 창의적 엔진
차원은 RI-TOOL이 템플릿을 강요하지 않고 어떻게 모든 조직에 적응하는지를 설명합니다. 테넌트의 정체성이 여기에 있습니다.
네 개의 레이어, 세 가지 역할
노드에 차원 첨부
노드 선택 → Dimensions 탭 열기 → + Add dimension 클릭 → Senior가 구축한 카탈로그에서 선택. 첨부는 그래프를 저장할 때까지 로컬입니다. 같은 노드에 여러 차원을 첨부할 수 있습니다.
노드 유형별 일반적인 첨부 선택
| 노드 유형 | 일반적인 차원 선택 | 이유 |
|---|---|---|
| INPUT | 구역 + 위험 + 시간 + 금액 또는 비율 | 잎 값은 기본 문서화 대상입니다 — 항상 컨텍스트화하십시오. |
| SUM / PRODUCT | 금액(결과) — 이 수준에서 컨텍스트가 변경되면 선택적 범위 축 | 집계 노드에는 결과 주석이 필요할 수 있습니다. 컨텍스트는 일반적으로 자식에서 상속됩니다. |
| MIN / MAX | 보통 없음, 또는 천정/바닥 값을 문서화하기 위한 금액 | 구조적 천정/바닥 노드에는 컨텍스트 차원이 거의 필요하지 않습니다. |
| CONDITION | Senior가 정의한 경우 사용자 정의 차원(예: 트리거) | 조항 논리가 요구하는 경우 조건에는 전용 축이 필요할 수 있습니다. |
| SUB_GRAPH | 보통 없음 — 컨텍스트는 참조된 그래프에 있습니다 | 위임 노드는 문서화를 소스로 보냅니다. |
보호 체인
플랫폼은 양방향으로 데이터 손실을 방지합니다. Manager가 이미 차원에 대한 값을 채웠으면 차원 첨부를 제거할 수 없습니다. Senior는 귀하가 노드에 첨부한 차원을 삭제할 수 없습니다. 각 레이어가 그 아래를 보호합니다.
외부 부모
한 그래프의 노드는 완전히 다른 그래프의 노드에서 기여를 받을 수 있습니다 — 조항 간 재사용 메커니즘.
예시: 조항 A — 순 보유 손실과 조항 B — 갱신 보험료. 갱신 공식은 순 보유 손실에 의존합니다. 노드를 복사하는 대신 그래프 A의 루트를 그래프 B의 관련 노드의 외부 부모로 선언합니다.
외부 부모 추가 방법
기존 외부 부모를 제거하려면 Ext. links 탭에서 옆의 ✕ 버튼을 클릭합니다. 자식 그래프가 인스턴스화된 경우 경고가 표시됩니다 — 이 연결을 참조하는 유령 노드는 기존 인스턴스에 대해 유효하지 않게 됩니다.
Risk links
Risk link는 Actuary 노드와 Risk Modeler 노드를 연결하여 노출 설명을 조항 그래프에 가져옵니다.
Risk Modeler는 노출 그래프(사이트, 위험, 커버리지 조건)를 구축합니다. 여러분의 역할은 어느 노드가 어느 Risk 노드와 어떻게 관련되는지 선언하여 그 작업을 조항 그래프와 연결하는 것입니다. 이 연결은 m_graph_risk_link에 저장되며 Risk link 피연산자로 한정됩니다.
| 피연산자 | 의미 | 예시 |
|---|---|---|
EXPOSED_TO | Actuary 노드가 위험에 관련됨 | Cat XL 손실 노드 ← 폭풍 위험 |
LOCATED_AT | Actuary 노드가 사이트에 관련됨 | Property 노드 ← 리옹 산업 시설 |
COVERED_BY | Actuary 노드가 커버리지 조건에 관련됨 | 보유 노드 ← Property 올리스크 커버리지 |
AGGREGATES | Actuary 노드가 여러 리스크 객체를 집계함 | 누적 노드 ← 포트폴리오 사이트 |
Risk link 추가 방법
생성 후 Risk 노드가 캔버스에 컬러 팬텀으로 표시됩니다(노드 유형에 따라 파랑/빨강/초록), 빨간 벽돌색 점선 테두리와 Risk 그래프 이름 레이블이 표시됩니다. 팬텀은 페이지 새로고침 없이 즉시 나타납니다.
Manager에 대한 영향
생성된 각 Risk link는 해당 노드의 Manager 입력 드로어에 Risk Dimensions 블록을 생성합니다. Manager는 Risk 노드 레이블, 피연산자, Risk 그래프 이름, Risk Modeler가 정의한 필드를 확인합니다. Risk 차원은 Actuary 차원과 별도로 저장되지만 단일 저장 작업으로 처리됩니다.
사이클 감지
DAG는 비순환이어야 합니다 — 어떤 노드도 자신의 조상이 될 수 없습니다. RI-TOOL은 각 저장 시 자동으로 사이클을 감지합니다.
저장 후 플랫폼이 전체 그래프 구조를 확인합니다. 사이클이 발견되면 편집기 상단에 주황색 배너가 나타나고 사이드바의 그래프 행에 ♻ cycle 배지가 표시됩니다.
인스턴스 잠금
Manager가 계약에 그래프를 인스턴스화하면 해당 그래프의 구조가 동결됩니다.
플랫폼은 인스턴스화된 그래프에 대한 모든 구조적 수정을 차단합니다 — 변경 사항을 저장하거나 삭제할 수 없습니다. 이것은 Manager의 기존 데이터 입력을 자동 무효화로부터 보호합니다.
그래프 탐색기
한 곳에서 모든 그래프의 프로덕션 뷰 — 필터링 가능, 검사 가능, 내보내기 가능.
전체 화면 탐색기를 열려면 사이드바 분석 섹션에서 🔭 Graph Explorer를 클릭합니다. 오른쪽 검사 패널은 탐색 전체에서 항상 표시됩니다 — 세부 정보를 로드하려면 카드를 클릭합니다.
필터 바
여섯 개의 결합 가능한 필터가 실시간으로 적용됩니다:
| 필터 | 대상 |
|---|---|
| 조항 계열 | 그래프에 연결된 조항의 계열(테넌트 참조 목록에서) |
| 조항 상태 | 조항의 승인 상태 — 예: VALIDATED만 필터링 |
| 조약 유형 | 조항과 연결된 모든 조약 유형 코드 |
| 인스턴스 | 인스턴스화됨(활성 Manager 인스턴스 ≥ 1개) 또는 미인스턴스화 |
| 사이클 | 마지막 저장으로 참조 사이클이 표시된 그래프 |
| 차원 | 커버리지 수준: 완전(100%), 부분, 커버리지 없음, 빈 그래프(노드 없음) |
모두 한 번에 지우려면 ↺ Reset filters를 사용합니다. 필터 상태는 localStorage에 영속화되며 다음 방문 시 복원됩니다.
카드 및 인스펙터
각 카드는 그래프 ID와 레이블, 해당 조항, 의미 배지 행을 표시합니다: 노드 수, 인스턴스 수, 사이클 플래그, 그래프 간 연결, 색상 코딩된 차원 커버리지 비율. 오른쪽 인스펙터에서 전체 세부 정보를 로드하려면 카드를 클릭합니다: 그래프 ID, 조항 내용, 조약 유형 알약, 시각적 커버리지 바.
인스펙터에서 ↗ Open in DAG editor를 클릭하면 캔버스에서 해당 그래프로 직접 이동합니다.
내보내기
탐색기 헤더의 ⬇ Export CSV 버튼은 현재 필터링된 뷰를 CSV로 내보냅니다 — 모든 그래프가 아닌 활성 필터가 표시하는 것만. 열: 그래프 ID, 레이블, 조항 ID, 조항 제목, 조항 계열, 조항 상태, 조약 유형(| 구분), 노드 수, 차원이 있는 노드, % 차원 커버리지, 인스턴스 수, 그래프 간 연결, 사이클 플래그.
Data Checks
테넌트 데이터에 대한 실시간 쿼리 — 각각 CSV로 내보낼 수 있습니다. 사이드바 분석 섹션에서 접근합니다.
전체 화면 패널을 열려면 📊 Data Checks를 클릭합니다. 구성된 각 뷰는 설명과 ▶ Run 버튼을 표시합니다. 결과는 ⬇ Download CSV 링크와 함께 페이지가 매겨진 테이블로 표시됩니다. DAG 툴바는 현재 그래프의 노드와 연결에 대한 그래프당 ⬇ CSV 내보내기도 제공합니다.
유지 관리
사이드바 하단에서 접근할 수 있는 네 가지 정리 작업입니다. 항상 먼저 진단을 실행하세요 — 아무것도 변경하지 않고 제거될 내용을 정확히 표시합니다.
| 코드 | 정리 대상 | 발생 시점 |
|---|---|---|
| A1 | 부모 그래프가 삭제된 노드 — 링크 및 차원 첨부에 연쇄 적용 | 정상 흐름 외부에서 그래프가 삭제된 경우 |
| A2 | 부모 또는 자식 노드가 더 이상 존재하지 않는 고아 그래프 내부 링크 | 노드가 삭제되었지만 링크가 연쇄되지 않은 경우 |
| A3 | 삭제된 그래프를 가리키는 유령 그래프 간 링크(부모 또는 자식 측) | 크로스 링크에 관여된 그래프가 삭제된 경우 |
| A4 | 고아 차원 첨부(노드 또는 차원 삭제) — 관련 Manager 값도 제거할 수 있음 | 노드 또는 차원이 삭제되어 오래된 첨부가 남은 경우 |
권장 순서: A1 → A2 → A3 → A4. A1을 먼저 실행하면 A2와 A3가 별도로 처리할 노드의 링크를 미리 제거할 수 있습니다.