Usted formaliza la cláusula.
Usted construye el grafo.
Como Actuario, traduce las cláusulas de reaseguro validadas en grafos acíclicos dirigidos (DAG). Cada nodo es un elemento de cálculo; cada enlace es una dependencia. El Manager instancia después sus grafos en contratos reales e introduce los valores.
Su rol en la cadena
Cuatro roles, una dirección. Cada paso desbloquea el siguiente.
| Paso | Perfil | Qué hace | Qué recibe usted |
|---|---|---|---|
| 1 | Junior | Deconstruye el texto de cláusulas: crea cláusulas estructuradas con redacción, familia, tipos de tratado, dependencias | Cláusulas en borrador |
| 2 | Senior | Valida cláusulas y diseña el catálogo de dimensiones: ejes que adjuntará a los nodos del grafo | Cláusulas validadas + paleta de dimensiones |
| 3 | Actuary ← usted | Construye grafos DAG por cláusula validada. Adjunta dimensiones nodo a nodo. Enlaza grafos entre cláusulas. | Grafos listos para el Manager |
| 4 | Manager | Crea contratos, instancia un grafo, rellena valores de dimensión por nodo | — |
Construir un DAG
Un grafo acíclico dirigido codifica la lógica de cálculo de una cláusula como estructura traversable de nodos y enlaces dirigidos.
Una cláusula de reaseguro contiene fórmulas anidadas: pérdida neta retenida, neta de recuperaciones, en exceso de la retención, limitada al límite. Cada elemento se convierte en un nodo. Cada dependencia se convierte en un enlace dirigido. El nodo raíz contiene el valor final de la cláusula.
El grafo no es una calculadora. Es una estructura de documentación. El Manager lo lee, entiende exactamente qué rellenar y el resultado es un registro inequívoco de la parametrización de la cláusula en un contrato.
Flujo de trabajo
Panel inspector
Al hacer clic en cualquier nodo se abre el inspector a la derecha: tres pestañas, un nodo a la vez.
| Pestaña | Qué hace aquí |
|---|---|
| Properties | Establezca la etiqueta, operando, tipo de valor del nodo y (para nodos SUB_GRAPH) el grafo referenciado. Haga clic en Apply para confirmar: los cambios son locales hasta que guarde el grafo. |
| Dimensions | Añada o elimine adjuntos de dimensiones documentales. Cada dimensión que adjunte aquí se convierte en un formulario de relleno que el Manager debe completar para este nodo. |
| Ext. links | Gestione las contribuciones entrantes de nodos en otros grafos. Vea la sección Padres externos para el flujo completo. |
Operandos de nodos
El operando define el rol de cálculo de un nodo y determina cómo se renderiza: color y estilo de borde.
Cada nodo debe tener un tipo de valor: el tipo de valor que introducirá el Manager (importe, porcentaje, duración, recuento, etc.). Los tipos de valor son configurados por el Senior.
Operandos de enlaces
Un enlace conecta un nodo padre con un nodo hijo. Su operando describe cómo contribuye el padre al cálculo del hijo.
| Tipo de nodo | Operandos de enlace esperados | Ejemplo |
|---|---|---|
| SUM | PLUS + MINUS | Pérdida bruta + ALAE − salvamento |
| PRODUCT | FACTOR × n | Tasa × Prima base |
| QUOTIENT | NUMERATOR × 1 + DENOMINATOR × 1 | Pérdida neta / Valor total asegurado |
| MAX / MIN | PLUS × n | MAX(neto retenido, suelo de franquicia) |
| CONDITION | ARGUMENT × n | Si punto de adherencia > umbral ENTONCES sublímite |
| SUB_GRAPH | ARGUMENT | Prima de reinstalación mediante grafo separado |
| INPUT | Ninguno — hoja | Pérdida por ocurrencia, franquicia, límite… |
Dimensiones — el motor creativo
Las dimensiones explican por qué RI-TOOL se adapta a cualquier organización sin imponer una plantilla. Aquí vive la identidad de su tenant.
Cuatro capas, tres roles
Adjuntar una dimensión a un nodo
Seleccione un nodo → abra la pestaña Dimensions → haga clic en ＋ Add dimension → elija del catálogo creado por el Senior. El adjunto es local hasta que guarde el grafo. Puede adjuntar varias dimensiones al mismo nodo.
Opciones típicas de adjunto por tipo de nodo
| Tipo de nodo | Opciones típicas de dimensión | Razonamiento |
|---|---|---|
| INPUT | Zona + Riesgo + Tiempo + Importe o Tasa | Los valores hoja son el objetivo principal de documentación: contextualícelos siempre. |
| SUM / PRODUCT | Importe (resultado) — opcionalmente ejes de ámbito si el contexto cambia en este nivel | Los nodos de agregación pueden necesitar anotación de resultado; el contexto generalmente se hereda de los hijos. |
| MIN / MAX | Normalmente ninguna, o Importe para documentar el valor de techo/suelo | Los nodos estructurales de techo/suelo rara vez necesitan dimensiones contextuales. |
| CONDITION | Dimensión personalizada si el Senior definió una (ej. Disparador) | Las condiciones pueden necesitar un eje dedicado si la lógica de la cláusula lo requiere. |
| SUB_GRAPH | Normalmente ninguna: el contexto vive en el grafo referenciado | Los nodos de delegación difieren la documentación a la fuente. |
La cadena de protección
La plataforma previene la pérdida silenciosa de datos en ambas direcciones. No puede eliminar un adjunto de dimensión si el Manager ya ha rellenado valores contra él. El Senior no puede eliminar una dimensión que usted haya adjuntado a un nodo. Cada capa protege a la que está debajo.
Padres externos
Un nodo en un grafo puede recibir una contribución de un nodo en un grafo completamente diferente: el mecanismo de reutilización entre cláusulas.
Ejemplo: Cláusula A — Pérdida neta retenida y Cláusula B — Prima de reinstalación. La fórmula de reinstalación depende de la pérdida neta retenida. En lugar de duplicar nodos, declare la raíz del grafo A como padre externo del nodo relevante en el grafo B.
Cómo añadir un padre externo
Para eliminar un padre externo existente, haga clic en el botón ✕ junto a él en la pestaña Ext. links. Si el grafo hijo está instanciado, se muestra una advertencia: el nodo fantasma que referencia este enlace se vuelve inválido para las instancias existentes.
Risk links
Un Risk link conecta un nodo Actuary con un nodo Risk Modeler, incorporando la descripción de exposición al grafo de cláusulas.
El Risk Modeler construye grafos de exposición — sitios, peligros, condiciones de cobertura. Su función es vincular ese trabajo con sus grafos de cláusulas declarando qué nodo se relaciona con qué nodo Risk y cómo. Esta conexión se almacena en m_graph_risk_link y se califica mediante un operando Risk link.
| Operando | Significado | Ejemplo |
|---|---|---|
EXPOSED_TO | Nodo Actuary relacionado con un peligro | Nodo pérdida Cat XL ← Peligro tormenta |
LOCATED_AT | Nodo Actuary relacionado con un sitio | Nodo property ← Planta industrial Lyon |
COVERED_BY | Nodo Actuary relacionado con una condición de cobertura | Nodo retención ← Cobertura todo riesgo property |
AGGREGATES | Nodo Actuary agrega múltiples objetos de riesgo | Nodo acumulación ← Sitio cartera |
Añadir un Risk link
Una vez creado, el nodo Risk aparece como un phantom de color en el canvas — estilo según tipo de nodo (azul para sitio, rojo para peligro, verde para cobertura), con borde discontinuo rojo ladrillo. El phantom aparece de inmediato, sin recarga de página.
Efecto en el Manager
Cada Risk link creado genera un bloque Risk Dimensions en el cajón de relleno del Manager para ese nodo. El Manager ve el label del nodo Risk, el operando, el nombre del grafo Risk y los campos definidos por el Risk Modeler. Las dimensiones Risk se guardan por separado de las dimensiones Actuary pero en una única acción de guardado.
Detección de ciclos
Un DAG debe ser acíclico: ningún nodo puede ser su propio ancestro. RI-TOOL detecta ciclos automáticamente en cada guardado.
Tras guardar, la plataforma comprueba la estructura completa del grafo. Si se detecta un ciclo, aparece un banner naranja en la parte superior del editor y la fila del grafo en la barra lateral muestra un distintivo ♻ cycle.
Bloqueo por instancia
Una vez que un Manager instancia un grafo en un contrato, la estructura de ese grafo queda congelada.
La plataforma bloquea cualquier modificación estructural de un grafo instanciado: no puede guardar cambios ni eliminarlo. Esto protege la introducción de datos existente del Manager frente a una invalidación silenciosa.
Explorador de grafos
Vista de producción de todos sus grafos en un solo lugar: filtrable, inspeccionable y exportable.
Haga clic en 🔭 Graph Explorer en la sección Analytics de la barra lateral para abrir el explorador a pantalla completa. El panel de inspección a la derecha permanece visible en todo momento: haga clic en cualquier tarjeta para cargar su detalle.
Barra de filtros
Seis filtros combinables se aplican en tiempo real:
| Filtro | A qué apunta |
|---|---|
| Familia de cláusula | Familia de la cláusula vinculada al grafo (de la lista de referencia del tenant) |
| Estado de cláusula | Estado de validación de la cláusula: ej. filtrar solo VALIDATED |
| Tipo de tratado | Cualquier código de tipo de tratado asociado a la cláusula |
| Instancias | Instanciado (≥ 1 instancia activa del Manager) o No instanciado |
| Ciclo | Grafos marcados con ciclo de referencia por el último guardado |
| Dimensiones | Nivel de cobertura: Completa (100%), Parcial, Sin cobertura o Grafo vacío (sin nodos) |
Use ↺ Reset filters para limpiar todos a la vez. El estado de los filtros se persiste en localStorage y se restaura en su próxima visita.
Tarjetas e inspector
Cada tarjeta muestra el id y la etiqueta del grafo, su cláusula y una fila de distintivos semánticos: recuento de nodos, recuento de instancias, flag de ciclo, enlaces inter-grafo y porcentaje de cobertura de dimensiones con código de color. Haga clic en una tarjeta para cargar el detalle completo en el inspector derecho: identidad del grafo, redacción de la cláusula, pastillas de tipos de tratado y barra de cobertura visual.
Desde el inspector, haga clic en ↗ Open in DAG editor para ir directamente a ese grafo en el canvas.
Exportar
El botón ⬇ Export CSV en la cabecera del Explorador exporta la vista filtrada actual como CSV: no todos los grafos, solo los que muestran los filtros activos. Columnas: id grafo, etiqueta, id cláusula, título cláusula, familia cláusula, estado cláusula, tipos de tratado (separados por |), recuento de nodos, nodos con dimensiones, % cobertura dimensiones, recuento de instancias, enlaces inter-grafo, flag ciclo.
Data Checks
Consultas en tiempo real sobre los datos de su tenant, cada una exportable como CSV, accesibles desde la sección Analytics de la barra lateral.
Haga clic en 📊 Data Checks para abrir el panel a pantalla completa. Cada vista configurada muestra una descripción y un botón ▶ Run. Los resultados se muestran como tabla paginada con un enlace ⬇ Download CSV. La barra de herramientas DAG también ofrece un export ⬇ CSV por grafo de los nodos y enlaces del grafo actual.
Mantenimiento
Cuatro operaciones de limpieza accesibles desde el pie de la barra lateral. Siempre ejecute el diagnóstico primero — muestra exactamente qué se eliminará sin tocar nada.
| Código | Qué limpia | Cuándo ocurre |
|---|---|---|
| A1 | Nodos cuyo grafo padre fue eliminado — en cascada sobre sus enlaces y adjuntos de dimensiones | Grafo eliminado fuera del flujo normal |
| A2 | Enlaces intra-grafo huérfanos cuyo nodo padre o hijo ya no existe | Nodo eliminado sin cascada sobre los enlaces |
| A3 | Enlaces inter-grafo fantasma que apuntan a un grafo eliminado (lado padre o hijo) | Un grafo involucrado en un cross-link fue eliminado |
| A4 | Adjuntos de dimensiones huérfanos (nodo o dimensión eliminados) — puede también eliminar valores Manager asociados | Nodo o dimensión eliminados dejando adjuntos obsoletos |
Orden recomendado: A1 → A2 → A3 → A4. Ejecutar A1 primero elimina nodos cuyos enlaces A2 y A3 también capturarían.