A conta é um grafo.
Você é o seu arquiteto.

O seu papel na cadeia

Seis papéis, uma direção. O módulo SOA situa-se no fim da cadeia, traduzindo o trabalho atuarial em contas financeiras.

Barra lateral de padrões

A barra lateral esquerda lista todos os seus padrões SOA. Cada padrão é um template reutilizável para uma conta técnica.

Use a caixa de pesquisa para filtrar padrões por nome ou identificador. Clique em ＋ New pattern para criar um: atribua-lhe uma etiqueta descritiva (ex. XL Treaty Statement v1, Quota Share — Annual).

Um crachá ♻ junto ao nome de um padrão indica um ciclo detetado: esse padrão não pode ser instanciado pelo Junior até o ciclo ser corrigido. Um pequeno contador de instâncias (ex. 3×) mostra quantas instâncias SOA ativas referenciam esse padrão.

Construir um padrão SOA

Um padrão é um grafo acíclico dirigido de linhas contabilísticas. Cada nó representa uma linha da conta. As ligações codificam a estrutura hierárquica (detalhe → subtotal → total).

Atalhos de teclado

Tipos de ligação SOA

Cada nó e cada ligação num padrão SOA tem um tipo de ligação: o seu papel contabilístico na conta. Isto substitui os operandos de cálculo usados pelo Atuário.

Pode expandir a lista a partir de 🏷 SOA Link Types na barra lateral. Os novos códigos ficam disponíveis imediatamente no editor de nós. A eliminação de um código é bloqueada se algum nó ou ligação ainda o usar.

Painel inspetor

Clicar num nó abre o inspetor à direita: dois separadores para o nó selecionado.

Clicar numa ligação abre o inspetor com um seletor de tipo de ligação: altere o tipo e clique em Apply.

Clicar no fundo do padrão (nenhum nó selecionado) mostra o inspetor do padrão: cláusulas ligadas, restrições de tipos de tratado, contagem de instâncias e botões de ação rápida (renomear, editar cláusulas, editar tipos de tratado, eliminar).

Nós FORMULA — a ponte para os dados do Manager

Um nó FORMULA é uma linha contabilística especial cujo valor não é introduzido diretamente pelo SOA Junior: em vez disso, o Junior cita um nó específico de uma instância de grafo do Manager.

Como criar um nó FORMULA

O que o SOA Junior faz com os nós FORMULA

Quando o Junior abre um nó FORMULA, aparece um seletor de três grupos: Mesmo contrato, Mesmo tipo de tratado, Mesma cláusula. O Junior seleciona o grafo Manager relevante e o nó específico cujo output alimenta essa linha de conta. A referência é armazenada como citação JSON: nenhum valor é copiado, apenas o ponteiro.

Operandos de ligação IF / THEN / ELSE

Quando um nó de padrão SOA é ligado a um nó de grafo Actuary do tipo CONDITION, três operandos de ligação especializados estruturam explicitamente a relação condicional.

Antes do patch 035, os nós CONDITION usavam o operando genérico ARGUMENT para todos os pais, tornando a intenção gráfica ambígua. Os três operandos dedicados abaixo substituem ARGUMENT nas ligações CONDITION e tornam a lógica de predicado imediatamente legível no canvas.

Quando são relevantes estes operandos para o SOA Senior?

Como SOA Senior, não constrói grafos Actuary — mas liga nós FORMULA aos seus homólogos Manager, que por sua vez referenciam saídas de grafos Actuary. Compreender o que um nó CONDITION produz ajuda-o a etiquetar com precisão a linha FORMULA correspondente no statement.

Exemplo típico: um nó FORMULA Profit Commission Payable after Loss Corridor deve citar a saída de um nó CONDITION no grafo Actuary. Esse CONDITION avalia um limiar de loss corridor — o pai IF é o teste, o pai THEN é a comissão se o corridor for ultrapassado, o pai ELSE é zero. A sua linha FORMULA captura o resultado dessa ramificação.

Nós THRESHOLD

Um nó THRESHOLD (laranja, introduzido no patch 035) é um nó folha que representa um único limite — piso, teto, ponto de attachment ou trigger. É sempre pai de um nó CONDITION ou LOOKUP. Os nós THRESHOLD não aparecem diretamente como alvos FORMULA nos padrões SOA: são entradas intermédias no grafo Actuary, não quantidades de saída. Não crie linhas FORMULA que citem nós THRESHOLD.

Dimensões

As dimensões são eixos documentais: formulários de preenchimento opcionais associados aos nós do padrão. O SOA Senior pode associar qualquer dimensão do catálogo do tenant a qualquer nó.

O catálogo de dimensões pertence ao Senior Underwriter e é partilhado entre todos os perfis. Uma categoria de dimensões dedicada SOA é disponibilizada na criação do tenant com três eixos base: Periodicidade, Quota e Contraparte: o contexto documental mais comum para uma linha de conta.

Restrições de padrões

Duas restrições opcionais ajudam o SOA Junior a encontrar o padrão certo para cada contrato.

Cláusulas ligadas

Um padrão pode ser ancorado a uma ou mais cláusulas validadas (ex. cláusula de reintegração XL). É informativo: sinaliza a família de cláusulas para a qual o padrão foi desenhado. A restrição não é aplicada na instanciação.

Para gerir: clique em 🔗 Clauses na barra de ferramentas, ou use o botão Edit linked clauses no inspetor do padrão.

Restrições de tipos de tratado

Se restringir um padrão a um ou mais tipos de tratado (ex. TREATY_XL), o ecrã de criação de instância do Junior mostra um crachá de compatibilidade: ✓ Compatible ou ⚠ Mismatch. Um mismatch é um aviso, não um bloqueio.

Deixe todos os tipos de tratado desmarcados para tornar o padrão universal, aplicável a qualquer contrato.

Para gerir: clique em 📋 Treaty types na barra de ferramentas, ou use o inspetor do padrão.

Deteção de ciclos

Um DAG deve ser acíclico: nenhuma linha pode ser o seu próprio ancestral. O RI-TOOL deteta ciclos automaticamente a cada gravação.

Se for encontrado um ciclo, aparece um banner laranja no topo do editor e a linha do padrão na barra lateral mostra um crachá ♻ cycle. O padrão é mesmo assim guardado mas fica marcado como não instanciável.

Explorador de padrões

Vista de produção de todos os seus padrões, filtrável por estado de instâncias e indicador de ciclo.

Clique em 🔭 Pattern Explorer na barra lateral para abrir a vista em ecrã completo. Cada cartão mostra o identificador do padrão, a etiqueta, a contagem de nós, a percentagem de cobertura de dimensões e a contagem de instâncias. Clique num cartão para ir diretamente a esse padrão no editor.

Cobertura de dimensões

A cobertura é a percentagem de nós com pelo menos uma dimensão associada. 🧩 80% significa que 80% dos nós têm requisitos de documentação. Um padrão com 0% de cobertura é válido mas não produz nenhum formulário de preenchimento para o Junior.

Data Checks

Consultas SQL em tempo real sobre os dados do seu tenant, acessíveis a partir de 📊 Data Checks na barra lateral.

Cada vista tem um botão ▶ Run. Os resultados aparecem em linha com um link ⬇ Download CSV para exportação completa.

Manutenção

Quatro verificações de limpeza acessíveis a partir da barra lateral. Diagnosticar sempre antes de executar — a execução é irreversível.

Ordem recomendada: S1 → S3 → S4. S2 é um diagnóstico apenas de leitura — destaca ciclos a corrigir manualmente, não elimina nada.