La cuenta es un grafo.
Usted es su arquitecto.
Como SOA Senior, diseña las plantillas de cuentas técnicas de reaseguro (patrones). Cada patrón define la estructura de una cuenta: líneas contables, tipos de enlace y nodos FORMULA que referencian las salidas cuantitativas producidas por el Manager.
Su rol en la cadena
Seis roles, una dirección. El módulo SOA se sitúa al final de la cadena, traduciendo el trabajo actuarial en cuentas financieras.
Barra lateral de patrones
La barra lateral izquierda lista todos sus patrones SOA. Cada patrón es una plantilla reutilizable para un estado de cuenta.
Use el buscador para filtrar patrones por nombre o identificador. Haga clic en + New pattern para crear uno: asígnele una etiqueta descriptiva (ej. XL Treaty Statement v1, Quota Share — Annual).
Un distintivo ♻ junto al nombre indica un ciclo detectado: ese patrón no puede ser instanciado por el Junior hasta que se corrija. Un contador de instancias (ej. 3×) muestra cuántas instancias SOA activas referencian ese patrón.
Construir un patrón SOA
Un patrón es un grafo acíclico dirigido de líneas contables. Cada nodo representa una línea del estado de cuenta. Los enlaces codifican la estructura jerárquica (detalle → subtotal → total).
Atajos de teclado
| Tecla | Acción |
|---|---|
| Ctrl/Cmd + S | Guardar patrón actual |
| Supr / Retroceso | Eliminar nodo o enlace seleccionado |
| Rueda del ratón | Acercar / alejar |
| Arrastrar en canvas | Desplazar la vista |
| Doble clic canvas | Añadir nodo en el cursor |
Tipos de enlace SOA
Cada nodo y cada enlace de un patrón SOA lleva un tipo de enlace: su rol contable en la cuenta. Sustituye a los operandos de cálculo del Actuario.
Puede ampliar la lista desde 🏷 SOA Link Types en la barra lateral. Los nuevos códigos están disponibles de inmediato en el editor de nodos. La eliminación de un código está bloqueada si algún nodo o enlace aún lo usa.
Panel inspector
Al hacer clic en un nodo se abre el inspector a la derecha: dos pestañas para el nodo seleccionado.
| Pestaña | Qué hace aquí |
|---|---|
| Properties | Edite la etiqueta, tipo de enlace y tipo de valor del nodo. Haga clic en Apply para actualizar el estado en memoria, luego Save (barra de herramientas) para persistir. |
| Dimensions | Añada o elimine adjuntos de dimensiones documentales. Cada dimensión que adjunte se convierte en un formulario de relleno que el SOA Junior debe completar para esta línea. |
Al hacer clic en un enlace se abre el inspector con un selector de tipo de enlace: cambie el tipo y haga clic en Apply.
Al hacer clic en el fondo del patrón (sin nodo seleccionado) se muestra el inspector del patrón: cláusulas vinculadas, restricciones de tipos de tratado, recuento de instancias y botones de acción rápida (renombrar, editar cláusulas, editar tipos de tratado, eliminar).
Nodos FORMULA — el puente hacia los datos del Manager
Un nodo FORMULA es una línea contable especial cuyo valor no introduce directamente el SOA Junior: en su lugar, el Junior cita un nodo específico de una instancia de grafo del Manager.
Cómo crear un nodo FORMULA
Qué hace el SOA Junior con los nodos FORMULA
Cuando el Junior abre un nodo FORMULA, aparece un selector de tres grupos: Mismo contrato, Mismo tipo de tratado, Misma cláusula. El Junior selecciona el grafo Manager relevante y el nodo específico cuya salida alimenta esa línea de cuenta. La referencia se almacena como cita JSON: no se copia ningún valor, solo el puntero.
Operandos de enlace IF / THEN / ELSE
Cuando un nodo de patrón SOA se conecta a un nodo de grafo Actuary de tipo CONDITION, tres operandos de enlace especializados estructuran explícitamente la relación condicional.
Antes del parche 035, los nodos CONDITION usaban el operando genérico ARGUMENT para todos los padres, haciendo ambigua la intención gráfica. Los tres operandos dedicados a continuación reemplazan ARGUMENT en los enlaces CONDITION y hacen la lógica de predicado inmediatamente legible en el canvas.
¿Cuándo son relevantes estos operandos para el SOA Senior?
Como SOA Senior, no construye grafos Actuary — pero conecta nodos FORMULA con sus homólogos Manager, que a su vez referencian salidas de grafos Actuary. Entender lo que produce un nodo CONDITION le ayuda a etiquetar con precisión la línea FORMULA correspondiente en el statement.
Ejemplo típico: un nodo FORMULA Profit Commission Payable after Loss Corridor debe citar la salida de un nodo CONDITION en el grafo Actuary. Ese CONDITION evalúa un umbral de loss corridor — el padre IF es la prueba, el padre THEN es la comisión si se supera el corridor, el padre ELSE es cero. Su línea FORMULA captura el resultado de esa ramificación.
Nodos THRESHOLD
Un nodo THRESHOLD (naranja, introducido en el parche 035) es un nodo hoja que representa un único límite — suelo, techo, punto de adjunción o disparador. Siempre es padre de un nodo CONDITION o LOOKUP. Los nodos THRESHOLD no aparecen directamente como objetivos FORMULA en los patrones SOA: son entradas intermedias en el grafo Actuary, no cantidades de salida. No cree líneas FORMULA que citen nodos THRESHOLD.
Dimensiones
Las dimensiones son ejes documentales: formularios de relleno opcionales adjuntos a los nodos del patrón. El SOA Senior puede adjuntar cualquier dimensión del catálogo del tenant a cualquier nodo.
El catálogo de dimensiones pertenece al Senior Underwriter y es compartido por todos los perfiles. Se proporciona una categoría de dimensiones dedicada SOA al crear el tenant, con tres ejes base: Periodicidad, Cuota y Contraparte: el contexto documental más habitual para una línea de cuenta.
| Dimensión base | Uso típico en un nodo SOA |
|---|---|
| PERIODICITY | Trimestral / anual / ajuste / complementario: el ciclo contable de esta línea |
| SHARE | 100% / cuota del reasegurador / cuota del cedente: la proporción aplicable |
| COUNTERPART | Reasegurador / corredor: la parte pagadora o receptora |
Restricciones de patrones
Dos restricciones opcionales ayudan al SOA Junior a encontrar el patrón correcto para cada contrato.
Cláusulas vinculadas
Un patrón puede anclarse a una o más cláusulas validadas (ej. cláusula de reinstalación XL). Es informativo: señala la familia de cláusulas para la que fue diseñado el patrón. La restricción no se aplica al instanciar.
Para gestionar: haga clic en 🔗 Clauses en la barra de herramientas, o use el botón Edit linked clauses del inspector del patrón.
Restricciones de tipos de tratado
Si restringe un patrón a uno o más tipos de tratado (ej. TREATY_XL), la pantalla de creación de instancia del Junior muestra un distintivo de compatibilidad: ✓ Compatible o ⚠ Mismatch. Un mismatch es una advertencia, no un bloqueo.
Deje todos los tipos de tratado sin marcar para hacer el patrón universal, aplicable a cualquier contrato.
Para gestionar: haga clic en 📋 Treaty types en la barra de herramientas, o use el inspector del patrón.
Detección de ciclos
Un DAG debe ser acíclico: ninguna línea puede ser su propio ancestro. RI-TOOL detecta ciclos automáticamente en cada guardado.
Si se detecta un ciclo, aparece un banner naranja en la parte superior del editor y la fila del patrón en la barra lateral muestra un distintivo ♻ cycle. El patrón se guarda igualmente pero queda marcado como no instanciable.
Explorador de patrones
Vista de producción de todos sus patrones, filtrable por estado de instancia e indicador de ciclo.
Haga clic en 🔭 Pattern Explorer en la barra lateral para abrir la vista a pantalla completa. Cada tarjeta muestra el identificador del patrón, su etiqueta, el recuento de nodos, el porcentaje de cobertura de dimensiones y el recuento de instancias. Haga clic en una tarjeta para ir directamente a ese patrón en el editor.
Cobertura de dimensiones
La cobertura es el porcentaje de nodos que tienen al menos una dimensión adjunta. 🧩 80% significa que el 80% de los nodos tienen requisitos de documentación. Un patrón con 0% de cobertura es válido pero no genera ningún formulario de relleno para el Junior.
Data Checks
Consultas SQL en tiempo real sobre los datos de su tenant, accesibles desde 📊 Data Checks en la barra lateral.
| Vista | Qué muestra |
|---|---|
| SOA Templates — overview | Todos los patrones con recuento de nodos, nodos FORMULA, recuento de instancias, tipos de tratado y cláusulas vinculadas |
| FORMULA nodes — missing dimension | Nodos FORMULA sin dimensión FORMULA adjunta: anomalías de configuración que corregir |
| Dimension coverage by node | Todos los nodos con sus dimensiones adjuntas y recuento de instrucciones: útil para auditoría de cobertura |
Cada vista tiene un botón ▶ Run. Los resultados se muestran en línea con un enlace ⬇ Download CSV para exportación completa.
Mantenimiento
Cuatro verificaciones de limpieza accesibles desde la barra lateral. Siempre diagnosticar antes de ejecutar — la ejecución es irreversible.
| Código | Qué limpia | Riesgo |
|---|---|---|
| S1 | Patrones sin nodos — cascaras vacías de una creación abortada | Bajo |
| S2 | Patrones con un ciclo detectado — solo diagnóstico, sin eliminación. Corregir manualmente en el editor. | Medio |
| S3 | Nodos huérfanos cuyo patrón padre fue eliminado fuera del flujo normal | Medio |
| S4 | Adjuntos de dimensiones huérfanos cuyo nodo o dimensión fue eliminado | Bajo |
Orden recomendado: S1 → S3 → S4. S2 es un diagnóstico de solo lectura — resalta ciclos a corregir manualmente, no elimina nada.