Você valida as cláusulas.
Você desenha o framework de referência.
Como Senior Underwriter, é simultaneamente guardião da qualidade e arquiteto do framework de referência. Valida as cláusulas redigidas pelo Junior, desenha o catálogo de dimensões e mantém todos os dados de referência de que a plataforma depende.
O seu papel na cadeia
Quatro papéis, uma direção. O Senior é simultaneamente um filtro de qualidade e um designer criativo.
| Passo | Perfil | O que faz |
|---|---|---|
| 1 | Junior | Redige rascunhos de cláusulas: texto, família, tipos de tratado, dependências |
| 2 | Senior ← você | Valida cláusulas. Desenha o catálogo de dimensões (eixos + instruções). Mantém o framework de referência (famílias, tipos de tratado, glossário…). Supervisiona os contratos. |
| 3 | Actuary | Constrói grafos DAG para cláusulas validadas. Associa dimensões a nós. |
| 4 | Manager | Instancia grafos em contratos. Preenche valores de dimensão por nó. |
Cláusulas e ciclo de vida
Gere o ciclo de vida completo das cláusulas no tenant. O Junior cria-as; você valida-as ou rejeita-as.
A lista de cláusulas mostra todas as cláusulas do tenant filtráveis por estado. Clique numa cláusula para abrir o painel de detalhes com três separadores: General (texto, família), Treaty types (categorias de contratos a que se aplica) e Dependencies (relações com outras cláusulas).
Cada cartão de cláusula mostra o identificador CL_NNNN, título, família · estado, pastilhas coloridas dos tipos de tratado e etiquetas de termos RI (🏷) com definições em tooltip. Permite avaliar a cobertura de cláusulas e a etiquetagem do glossário de relance sem abrir o painel de detalhes.
Pode também criar cláusulas diretamente: use + New clause se preferir partir de um formulário em branco em vez de aguardar um rascunho do Junior.
Validação
A validação é uma ação deliberada de um clique que desbloqueia a cláusula para o Atuário. Apenas os Senior Underwriters podem validar.
Antes de validar, verifique: o texto está completo e sem ambiguidades, a família está correta, os tipos de tratado estão associados, as dependências-chave estão declaradas. Uma cláusula mal validada produzirá um grafo mal construído e o Manager introduzirá dados incorretos.
Tipos de tratado
Os tipos de tratado declaram a que categorias de contratos uma cláusula se aplica. O Manager só pode instanciar um grafo num contrato que partilhe pelo menos um tipo de tratado com a cláusula.
No painel de detalhes da cláusula, abra o separador Treaty types. Selecione um tipo na lista pendente e clique em + Add. Remova tipos com o ícone de eliminação. Uma cláusula sem tipos de tratado associados não estará disponível para nenhuma instanciação do Manager.
Dependências
Uma dependência declara que esta cláusula depende de outra: como entrada, como condição ou como acionador.
No separador Dependencies, selecione uma cláusula pai, opcionalmente um tipo de ligação (a natureza da dependência) e adicione uma nota que descreve a relação. Esta informação ajuda o Atuário a entender como ligar grafos através de ligações inter-grafo: é documental, não tecnicamente imposta.
| Tipo de ligação | Significado |
|---|---|
| CONDITION | Esta cláusula só se aplica se a cláusula pai for acionada |
| INPUT | Esta cláusula usa um valor calculado pela cláusula pai |
| TRIGGER | Esta cláusula ativa a cláusula pai |
Dimensões — o seu contributo criativo
As dimensões são os eixos documentais que o Atuário associa aos nós do grafo e que o Manager preenche nos contratos. É você quem as desenha.
Navegue até Dimensions & Instructions na barra lateral. O painel esquerdo lista todas as dimensões organizadas por categoria. O painel direito mostra os detalhes e instruções da dimensão selecionada.
A cadeia completa: o seu lugar nela
Criar uma dimensão
Instruções — o formulário do Manager
As instruções são a decisão de design mais granular que toma. Definem exatamente que dados o Manager introduz, campo a campo.
Pense nas instruções de uma dimensão como a etiqueta e o texto de substituição de uma linha de formulário. O Manager vê: um crachá numerado, a sua etiqueta e um campo de entrada. A qualidade das suas etiquetas determina se o Manager preenche a coisa certa sem pedir ajuda.
| Tipo de instrução | O que faz | Exemplo |
|---|---|---|
| Geral (primeira) | Descrição mostrada acima de todas as linhas de preenchimento: contexto e convenções | Introduza os valores monetários na moeda do contrato. Deixe em branco se não aplicável. |
| Linhas numeradas (seguintes) | Cada uma torna-se um campo de preenchimento com etiqueta para o Manager por nó | 1. Limite por ocorrência — 2. Limite anual agregado — 3. Teto de reintegração |
Référentiel — visão geral
O Référentiel é o framework de referência de que todos os perfis dependem. Você é o seu único guardião. As alterações têm efeito imediato em todo o tenant.
| Tabela | Quem depende | Impacto de uma alteração errada |
|---|---|---|
| Famílias de cláusulas | Junior, Senior | Um código de família renomeado ou eliminado rompe as cláusulas que o referenciam |
| Estados de cláusulas | Senior, todos | Transições de estado erradas podem contornar o fluxo de validação |
| Tipos de tratado | Senior, Manager | Um tipo de tratado eliminado remove retroativamente a compatibilidade cláusula-contrato |
| Tipos de ligação | Junior, Senior, Actuary | Um tipo de ligação eliminado rompe as dependências declaradas das cláusulas |
| Estados de contratos | Senior, Manager | Um estado CLOSED bloqueia todas as novas instanciações nos contratos correspondentes |
| Tipos de valor | Actuary, Manager | Um tipo de valor eliminado torna os nós não editáveis |
| Categorias de dimensões | Senior, Actuary, Manager | Uma categoria eliminada torna as suas dimensões não categorizadas ou inacessíveis |
| Glossário RI | Todos os perfis | Um termo eliminado remove-o de todas as listas pendentes de etiquetas de cláusulas |
As seis tabelas de referência seguem a mesma interface: uma lista à esquerda, um formulário à direita. Clique em qualquer elemento para o editar. Use + New para criar. O campo código é o identificador estável usado em toda a plataforma. A etiqueta é o nome de apresentação que os utilizadores veem.
Famílias
As famílias de cláusulas agrupam as cláusulas por tipo: Excess of Loss, Quota Share, Stop Loss, etc. O código é usado como identificador estável em toda a plataforma.
Navegue até Référentiel → Families. O painel esquerdo lista as famílias existentes; o direito mostra o código e a etiqueta do elemento selecionado. Use + New para adicionar uma família. O código deve ser único e em maiúsculas (ex. EXL, QS, SL). A etiqueta é o nome legível.
Estados de cláusulas
Os estados de cláusulas definem os estados do ciclo de vida de uma cláusula. Os dois estados predefinidos são DRAFT e VALIDATED: não os remova.
Se o seu tenant necessitar de estados intermédios (ex. UNDER_REVIEW, ARCHIVED), pode adicioná-los aqui. Cada estado tem um código e uma etiqueta. Apenas o Senior pode mover cláusulas entre estados.
Tipos de tratado
Os tipos de tratado categorizam contratos e cláusulas. Um Manager só pode instanciar um grafo de cláusula num contrato se partilharem pelo menos um tipo de tratado.
Navegue até Référentiel → Treaty types. Exemplos comuns: FAC (Facultativo), XL (Excess of Loss), TREATY_XL, QUOTA (Quota Share). O código aparece como crachá colorido em toda a interface do Manager: mantenha os códigos curtos e significativos.
Tipos de ligação
Os tipos de ligação descrevem a natureza de uma dependência entre duas cláusulas. São documentais, não tecnicamente impostos, mas orientam o Atuário na construção de ligações inter-grafo.
| Código | Significado |
|---|---|
| CONDITION | Esta cláusula só se aplica se a cláusula pai for acionada |
| INPUT | Esta cláusula usa um valor calculado pela cláusula pai |
| TRIGGER | Esta cláusula ativa a cláusula pai |
Adicione novos tipos de ligação aqui se a lógica de negócio do seu tenant necessitar de categorias de dependência mais granulares. Mantenha os códigos em maiúsculas e sem ambiguidades.
Estados de contratos
Os estados de contratos definem os estados do ciclo de vida dos contratos de resseguro. Um contrato CLOSED bloqueia todas as novas instanciações: as instâncias existentes são preservadas.
Estados predefinidos: ACTIVE, CLOSED. Adicione estados intermédios (ex. PENDING, SUSPENDED) se o seu fluxo de trabalho o exigir. O Manager vê a etiqueta do estado do contrato ao navegar pelos contratos.
Categorias de dimensões
As categorias de dimensões são os grupos de nível superior que organizam os eixos de dimensão que cria. Controlam como o Atuário navega no seletor de dimensões dentro dos modais de nó.
Por defeito, cada tenant tem duas categorias: Context (eixos geográficos, temporais, de risco) e Value (montantes monetários, taxas, tabelas). Pode criar categorias adicionais se uma família de dimensões genuinamente distinta não couber em nenhuma delas.
Glossário de termos RI
Um glossário de conceitos de resseguro, mantido ao nível do tenant e visível a todos os perfis.
O glossário centraliza as definições dos termos de resseguro usados em toda a plataforma. Cada entrada cobre o termo e a sua definição. Os termos são usados como etiquetas nas cláusulas, visíveis como crachás nas listas de cláusulas do Junior, Senior e Manager.
Navegue até Référentiel → RI Glossary. Use + New term para criar uma entrada. Preencha o termo e a definição. As entradas existentes podem ser editadas ou eliminadas: eliminar um termo remove-o imediatamente de todas as listas pendentes de etiquetas de cláusulas.
Contratos
A secção Contratos dá-lhe visibilidade completa sobre os contratos de resseguro do tenant e o seu estado de instanciação.
Pode criar contratos, associar tipos de tratado e monitorizar quais grafos o Manager instanciou por contrato. É de leitura/escrita: você é um dos perfis que pode gerir contratos diretamente.
Pesquisa documental
Pesquisa de texto completo em todos os documentos anexados aos contratos do tenant.
Use esta secção para encontrar linguagem contratual específica em todo o corpus documental: útil para verificar como uma cláusula foi redigida num contrato anterior, ou para validar uma nova cláusula face a precedentes.
Manutenção
Operações de limpeza para entidades órfãs criadas por exclusões fora do fluxo normal. Execute sempre o dry-run primeiro.
| Operação | O que limpa |
|---|---|
| S1 | Linhas de instrução órfãs cuja dimensão pai foi excluída |
| S2 | Grafos sem cláusula associada válida (cláusula excluída ou revertida para rascunho após a criação do grafo) |
| S4 | Vínculos de tipo de tratado a nível de cláusula apontando para códigos excluídos |
| S5 | Vínculos de tipo de tratado a nível de contrato apontando para códigos excluídos |