Você formaliza a cláusula.
Você constrói o grafo.

O seu papel na cadeia

Quatro papéis, uma direção. Cada passo desbloqueia o seguinte.

Barra lateral de cláusulas

A barra lateral esquerda é a sua navegação principal: uma lista deslocável de todas as cláusulas validadas com os grafos aninhados.

Cada cartão de cláusula mostra o identificador (CL_NNNN), o título, as pastilhas dos tipos de tratado (codificadas por cor: FAC, XL, TREATY_XL, QUOTA, SURPLUS) e as etiquetas de termos RI 🏷 com definições ao passar o rato. Clique num cartão para expandi-lo e revelar os seus grafos.

Criar um grafo

Clique em + New graph diretamente numa cláusula sem grafo existente, ou no botão + Graph no topo da cláusula expandida. Atribua-lhe uma etiqueta descritiva: o Manager usa-a para escolher qual formalização instanciar.

Indicadores de estado do grafo

Cada linha de grafo na barra lateral mostra dois crachás: um aviso ♻ cycle se a última gravação detetou um ciclo, e o estado de gravação atual ✓ saved / ● unsaved.

Construir um DAG

Um grafo acíclico dirigido codifica a lógica de cálculo de uma cláusula como estrutura traversável de nós e ligações dirigidas.

Uma cláusula de resseguro contém fórmulas aninhadas: perda líquida retida, líquida de recuperações, em excesso da retenção, limitada ao limite. Cada elemento torna-se um nó. Cada dependência torna-se uma ligação dirigida. O nó raiz contém o valor final da cláusula.

O grafo não é uma calculadora. É uma estrutura de documentação. O Manager lê-o, entende exatamente o que preencher e o resultado é um registo inequívoco da parametrização da cláusula num contrato.

Fluxo de trabalho

Painel inspetor

Clicar em qualquer nó abre o inspetor à direita: três separadores, um nó de cada vez.

Operandos dos nós

O operando define o papel de cálculo de um nó e determina como é renderizado: cor e estilo de borda.

Cada nó deve ter um tipo de valor: o tipo de valor que o Manager introduzirá (montante, percentagem, duração, contagem, etc.). Os tipos de valor são configurados pelo Senior.

Operandos das ligações

Uma ligação conecta um nó pai a um nó filho. O seu operando descreve como o pai contribui para o cálculo do filho.

Dimensões — o motor criativo

As dimensões explicam por que o RI-TOOL se adapta a qualquer organização sem impor um template. Aqui vive a identidade do seu tenant.

Quatro camadas, três papéis

Associar uma dimensão a um nó

Selecione um nó → abra o separador Dimensions → clique em ＋ Add dimension → escolha do catálogo criado pelo Senior. A associação é local até guardar o grafo. Pode associar múltiplas dimensões ao mesmo nó.

Escolhas típicas de associação por tipo de nó

A cadeia de proteção

A plataforma previne a perda silenciosa de dados em ambas as direções. Não pode remover uma associação de dimensão se o Manager já preencheu valores para ela. O Senior não pode eliminar uma dimensão que associou a um nó. Cada camada protege a que está abaixo.

Pais externos

Um nó num grafo pode receber uma contribuição de um nó num grafo completamente diferente: o mecanismo de reutilização entre cláusulas.

Exemplo: Cláusula A — Perda líquida retida e Cláusula B — Prémio de reintegração. A fórmula de reintegração depende da perda líquida retida. Em vez de duplicar nós, declare a raiz do grafo A como pai externo do nó relevante no grafo B.

Como adicionar um pai externo

Para remover um pai externo existente, clique no botão ✕ junto a ele no separador Ext. links. Se o grafo filho estiver instanciado, é mostrado um aviso: o nó fantasma que referencia esta ligação torna-se inválido para as instâncias existentes.

Risk links

Um Risk link conecta um nó Actuary a um nó Risk Modeler, trazendo a descrição de exposição para o grafo de cláusulas.

O Risk Modeler constrói grafos de exposição — sites, perigos, condições de cobertura. O seu papel é ligar esse trabalho aos seus grafos de cláusulas declarando qual nó se relaciona com qual nó Risk e como. Esta conexão é armazenada em m_graph_risk_link e qualificada por um operando Risk link.

Adicionar um Risk link

Uma vez criado, o nó Risk aparece como um phantom colorido no canvas — estilo por tipo de nó (azul para site, vermelho para perigo, verde para cobertura), com borda tracejada vermelho tijolo. O phantom aparece imediatamente, sem recarregamento de página.

Efeito no Manager

Cada Risk link criado gera um bloco Risk Dimensions no drawer de preenchimento do Manager para esse nó. O Manager vê o label do nó Risk, o operando, o nome do grafo Risk e os campos definidos pelo Risk Modeler. As dimensões Risk são guardadas separadamente das dimensões Actuary mas numa única ação de gravação.

Deteção de ciclos

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

Após guardar, a plataforma verifica a estrutura completa do grafo. Se for encontrado um ciclo, aparece um banner laranja no topo do editor e a linha do grafo na barra lateral mostra um crachá ♻ cycle.

Bloqueio de instância

Assim que um Manager instancia um grafo num contrato, a estrutura desse grafo fica bloqueada.

A plataforma bloqueia qualquer modificação estrutural a um grafo instanciado: não pode guardar alterações nem eliminá-lo. Isto protege a introdução de dados existente do Manager de uma invalidação silenciosa.

Explorador de grafos

Vista de produção de todos os seus grafos num único lugar: filtrável, inspecionável e exportável.

Clique em 🔭 Graph Explorer na secção Analytics da barra lateral para abrir o explorador em ecrã completo. O painel de inspeção à direita permanece visível durante toda a navegação: clique em qualquer cartão para carregar o seu detalhe.

Barra de filtros

Seis filtros combináveis aplicam-se em tempo real:

Use ↺ Reset filters para limpar tudo de uma vez. O estado dos filtros é persistido no localStorage e restaurado na sua próxima visita.

Cartões e inspetor

Cada cartão mostra o id e a etiqueta do grafo, a sua cláusula e uma linha de crachás semânticos: contagem de nós, contagem de instâncias, flag de ciclo, ligações inter-grafo e percentagem de cobertura de dimensões com código de cor. Clique num cartão para carregar o detalhe completo no inspetor direito: identidade do grafo, texto da cláusula, pastilhas dos tipos de tratado e barra de cobertura visual.

A partir do inspetor, clique em ↗ Open in DAG editor para ir diretamente a esse grafo no canvas.

Exportar

O botão ⬇ Export CSV no cabeçalho do explorador exporta a vista filtrada atual como CSV: não todos os grafos, apenas os que os filtros ativos mostram. Colunas: id grafo, etiqueta, id cláusula, título cláusula, família cláusula, estado cláusula, tipos de tratado (separados por |), contagem de nós, nós com dimensões, % cobertura dimensões, contagem de instâncias, ligações inter-grafo, flag ciclo.

Data Checks

Consultas em tempo real sobre os dados do seu tenant, cada uma exportável como CSV, acessíveis a partir da secção Analytics da barra lateral.

Clique em 📊 Data Checks para abrir o painel em ecrã completo. Cada vista configurada mostra uma descrição e um botão ▶ Run. Os resultados aparecem como tabela paginada com um link ⬇ Download CSV. A barra de ferramentas DAG também oferece um export ⬇ CSV por grafo dos nós e ligações do grafo atual.

Manutenção

Quatro operações de limpeza acessíveis a partir do rodapé da barra lateral. Execute sempre primeiro o diagnóstico — mostra exatamente o que será removido sem tocar em nada.

Ordem recomendada: A1 → A2 → A3 → A4. Executar A1 primeiro elimina nós cujos links A2 e A3 também capturariam.