Exposure description
for reinsurance

Your role

The Risk Modeler describes the insured exposure brought as input to a treaty or facultative reinsurance contract.

You work at layer 3b in the RI-TOOL value chain. Your output — a Risk Graph — is the aggregate of direct insurance that forms the basis of the reinsurance programme. It is not an individual policy, but the structured description of a portfolio: its geographic locations, the perils it is exposed to, and the coverage conditions that apply.

Once you have built and published a Risk Graph, the Actuary connects it to one or more Actuary Graphs. The Manager then uses both layers when instructing a contract instance — filling in the Actuary dimensions first, then the Risk dimensions you have described.

Value chain

RI-TOOL structures reinsurance documentation across six sequential layers.

Your layer feeds directly into the Manager workflow. The Actuary is the bridge: they connect your Risk Graph to their clause graph, creating a transitive path from contract instance to risk exposure.

Risk graphs

A Risk Graph is a DAG of exposure nodes — sites, perils, and coverage conditions — that describes what is insured.

Create a graph

In the sidebar under Risk Graphs, click + New graph. Give it a label (e.g. "French Industrial Portfolio — 2026") and an optional description. The graph appears in the sidebar list immediately.

Edit a graph

Click a graph in the sidebar to open the canvas editor. Use the toolbar buttons to add nodes, draw links, and attach dimensions. Click Save or use the header button to persist changes. The dirty indicator in the header turns yellow when unsaved changes are present.

Node types

Three semantic node types structure the exposure description.

Nodes can be connected in any DAG topology. A typical pattern: Site → Coverage ← Peril, expressing that a given location is exposed to a given peril under specific financial conditions.

Dimensions

Dimensions are structured fields attached to nodes. They provide the semantic content that the Manager will fill in at instantiation time.

The RISK category (id 50) contains ten pre-seeded dimensions aligned with the three node types:

To attach a dimension to a node, select the node on the canvas and use the Dimensions tab in the inspector panel. You can attach any dimension from the full tenant catalogue — not only RISK dimensions. Dimensions from other categories (CONTEXTE, VALEUR…) can complement the exposure description.

Links

Links between nodes express semantic relationships within the exposure graph.

To create a link, hover a source node on the canvas until the connector handle appears, then drag to a target node. A link direction dialog appears — confirm to create the link.

Actuary connections

The Actuary connects Risk Graphs to Actuary Graphs — this is read-only in your profile.

The Actuary connections section in the sidebar shows which of your Risk Graphs have been connected to an Actuary Graph. A graph listed here is active in at least one reinsurance programme.

How the connection works

Your Risk Graph feeds into the reinsurance programme through a three-layer chain — Risk Modeler → Actuary → Manager.

Once your Risk Graph is built and its nodes have dimensions attached, the Actuary takes over. In their profile, they open an Actuary Graph node, go to the Ext. links tab in the inspector, and connect it to one of your Risk nodes via a Risk link operand. The operand qualifies the semantic nature of the relationship:

Once the Actuary has created the link, your Risk node appears as a phantom on their canvas — a coloured, dashed-border node projected from your graph. The connection is stored in m_graph_risk_link and is visible on the Actuary canvas immediately.

The Manager then sees both layers when instructing a contract instance. For every Actuary node connected to one of your Risk nodes, a Risk Dimensions block appears at the bottom of the fill drawer — with the exact fields you defined (address, peril type, insured value, etc.).

What you need to do

Monitoring views

The sidebar Analytics section provides views to track the state of your Risk Graphs.

Data Checks shows live counts and coverage metrics: graphs without Actuary connections, nodes without dimensions, and graphs with a detected cycle. Use these views to ensure your exposure descriptions are complete before the Actuary connects them.

Maintenance

Three cleanup operations for orphaned data, accessible from the Maintenance section of the sidebar.

Recommended order: R1 → R2 → R3.