SOA Senior — Editor de patrones

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.

📐 Editor DAG de patrones
🏷 Tipos de enlace SOA
🔗 Cableado FORMULA
🧩 Dimensiones documentales

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.

Junior
Creación de cláusulas
Estructura el texto en cláusulas tipadas
Senior
Validación
Valida cláusulas, dimensiones, tipos de tratado
Actuary
Formalización DAG
Codifica cláusulas como grafos de cálculo
Manager
Instanciación
Instancia grafos en contratos, introduce valores
SOA Senior — usted
Diseño de patrones
Diseña el DAG de la cuenta técnica, cablea nodos FORMULA con salidas del Manager
SOA Junior
Producción de cuentas
Instancia sus patrones en contratos
💡
No introduce valores financieros. Construye la estructura de presentación. El SOA Junior rellena las referencias a los datos del Manager. Las cifras reales provienen de las instancias de grafo del Manager.

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. ) muestra cuántas instancias SOA activas referencian ese patrón.

🔒
Los patrones instanciados están congelados. Una vez que el Junior crea una instancia a partir de su patrón, no puede cambiar la estructura de nodos/enlaces. Cree una nueva versión (nueva etiqueta) para modificar la estructura en instancias futuras.

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).

1
Seleccionar un patrón
Haga clic en un patrón en la barra lateral para cargarlo en el canvas. Si el canvas está vacío, el patrón no tiene nodos aún.
2
Añadir nodos
Haga clic en + Node en la barra de herramientas (o doble clic en el canvas). Rellene la etiqueta, el tipo de enlace contable y el tipo de valor. Haga clic en Add node.
3
Conectar nodos
Pase el cursor sobre un nodo hasta que aparezca el puerto de salida en su borde inferior y arrastre a un nodo destino. Aparece un selector de tipo de enlace (DETAIL, SUBTOTAL, etc.).
4
Adjuntar dimensiones (opcional)
Seleccione un nodo → abra la pestaña Dimensions en el inspector → añada las dimensiones que el SOA Junior debe documentar para esta línea.
5
Guardar
Haga clic en 💾 Save. El patrón completo se escribe de forma atómica. La detección de ciclos se ejecuta en cada guardado.
⚠️
Los cambios no guardados solo existen en el navegador. Navegar o actualizar sin guardar pierde su trabajo. La cabecera muestra siempre ● sin guardar / ✓ guardado.

Atajos de teclado

TeclaAcción
Ctrl/Cmd + SGuardar patrón actual
Supr / RetrocesoEliminar nodo o enlace seleccionado
Rueda del ratónAcercar / alejar
Arrastrar en canvasDesplazar la vista
Doble clic canvasAñ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.

HEADER
Título de sección o encabezado principal: sin valor, puramente estructural.
DETAIL
Línea individual. Alimenta un SUBTOTAL o TOTAL.
SUBTOTAL
Suma intermedia de líneas DETAIL dentro de una sección.
TOTAL
Saldo final: la última línea de la cuenta o de una sección principal.
OFFSET
Contrapartida: reduce o ajusta una línea adyacente (ej. depósito en offset).
NOTE
Anotación informativa: visible en la cuenta pero no forma parte del cálculo.

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.

💡
Color del nodo = tipo de enlace. El canvas renderiza cada nodo con el color de su tipo de enlace: HEADER en azul marino, DETAIL en azul, SUBTOTAL en verde, TOTAL en verde oscuro, OFFSET en naranja, NOTE en gris. La estructura de la cuenta es legible de un vistazo.

Panel inspector

Al hacer clic en un nodo se abre el inspector a la derecha: dos pestañas para el nodo seleccionado.

PestañaQué hace aquí
PropertiesEdite 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.
DimensionsAñ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.

🔗 La señal de conciliación
El cableado FORMULA es un acto de conciliación entre el dominio actuarial y la realidad contable. Si una línea del estado de cuenta no encuentra su nodo de destino en los grafos del Manager, la herramienta revela el desalineamiento: lo que el actuario modeló y lo que requiere la cuenta están desincronizados. RI-TOOL hace visible esa brecha.

Cómo crear un nodo FORMULA

1
Añadir un nodo
Haga clic en + Node. Establezca la etiqueta (ej. Pérdida neta retenida), elija un tipo de enlace adecuado (normalmente DETAIL) y establezca el tipo de valor en FORMULA.
2
Guardar
Guarde el patrón. La dimensión FORMULA se adjunta automáticamente: no se requiere paso manual. El nodo aparece con borde discontinuo y el icono 🔗 en el canvas.
💡
Un nodo FORMULA por cantidad del Manager. Si la cuenta tiene dos primas de reinstalación separadas, cree dos nodos FORMULA: cada uno será citado de forma independiente por el Junior.

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.

📊
Dos plantillas listas para usar se entregan con cada nueva cuenta
PC Standard y PC Sliding Scale — 21 nodos, 14 enlaces FORMULA conectados a los gráficos actuariales de Profit Commission. Listos para instanciar desde el primer día.

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.

IF
El predicado que se evalúa. Exactamente un padre IF por nodo CONDITION. Representado en violeta.
THEN
Valor devuelto cuando el predicado es verdadero. Representado en verde.
ELSE
Valor devuelto cuando el predicado es falso. Puede ser un CONSTANT(0) para un suelo en cero. Representado en rojo.

¿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.

💡
Un CONDITION = un resultado binario. Si la cuenta requiere dos líneas separadas para los escenarios "por encima del corridor" y "por debajo del corridor", modélelas como dos nodos FORMULA distintos — cada uno citando una rama diferente del grafo Actuary, no el nodo CONDITION en sí.

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.

💡
Los nodos FORMULA tienen un mensaje dedicado en la pestaña Dimensions. Cuando un nodo está configurado como FORMULA, la pestaña Dimensions del inspector muestra un aviso explicativo en lugar de la lista de dimensiones: la dimensión FORMULA se gestiona automáticamente y no puede añadirse ni eliminarse manualmente.
Dimensión baseUso típico en un nodo SOA
PERIODICITYTrimestral / anual / ajuste / complementario: el ciclo contable de esta línea
SHARE100% / cuota del reasegurador / cuota del cedente: la proporción aplicable
COUNTERPARTReasegurador / corredor: la parte pagadora o receptora
💡
Las dimensiones son opcionales pero poderosas. Un nodo TOTAL rara vez necesita documentación; un nodo DETAIL que alimenta una línea de prima casi siempre se beneficia de PERIODICITY y SHARE. Use el criterio: menos dimensiones bien elegidas son mejor que una sobrecarga de formularios.

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.

⚠️
La detección no es bloqueante. Localice el nodo que vuelve a uno de sus propios ancestros, elimine el enlace erróneo y guarde de nuevo. El indicador de ciclo se limpia automáticamente.

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.

VistaQué muestra
SOA Templates — overviewTodos los patrones con recuento de nodos, nodos FORMULA, recuento de instancias, tipos de tratado y cláusulas vinculadas
FORMULA nodes — missing dimensionNodos FORMULA sin dimensión FORMULA adjunta: anomalías de configuración que corregir
Dimension coverage by nodeTodos 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ódigoQué limpiaRiesgo
S1Patrones sin nodos — cascaras vacías de una creación abortadaBajo
S2Patrones con un ciclo detectado — solo diagnóstico, sin eliminación. Corregir manualmente en el editor.Medio
S3Nodos huérfanos cuyo patrón padre fue eliminado fuera del flujo normalMedio
S4Adjuntos de dimensiones huérfanos cuyo nodo o dimensión fue eliminadoBajo

Orden recomendado: S1 → S3 → S4. S2 es un diagnóstico de solo lectura — resalta ciclos a corregir manualmente, no elimina nada.