SOA Junior — Produção de contas técnicas

A conta toma forma
uma citação de cada vez.

Como SOA Junior, produz as contas técnicas de resseguro. Seleciona o padrão certo para cada contrato e preenche cada linha: com valores documentais livres ou citando o nó exato do grafo Manager que gerou o valor.

📄 Fluxo por contrato
📊 Visualizador de padrões SOA
✏️ Drawer de preenchimento
🔗 Citações FORMULA

O seu papel na cadeia

É o último passo antes de a conta ser definitiva. Tudo o que vem antes — estruturação de cláusulas, formalização atuarial, instanciação pelo Manager — converge no seu trabalho.

Junior
Cláusulas
Cria cláusulas estruturadas
Senior
Validação
Valida & configura
Actuary
Grafos DAG
Formaliza a lógica
Manager
Instâncias
Introduz valores de contrato
SOA Senior
Padrões
Desenha templates de conta
SOA Junior — você
Contas
Instancia padrões, cita dados do Manager
💡
Não calcula: documenta e cita. O seu trabalho é ligar cada linha da conta à sua fonte: um valor documental livre (periodicidade, quota, contraparte) ou uma referência precisa a um nó do grafo Manager.
Novo na plataforma? O seu espaço de trabalho já está pronto.
Cada nova conta inclui uma estrutura de referência completa, um exemplo de Profit Commission com 5 grafos atuariais e 2 modelos SOA — incluídos no registo.

Contratos e instâncias

A barra lateral lista todos os contratos do seu tenant. Cada contrato pode ter uma ou mais instâncias SOA, uma por padrão utilizado.

Selecionar um contrato

Clique em qualquer contrato na barra lateral (ou use a caixa de pesquisa) para abrir o painel de detalhes. Verá os tipos de tratado do contrato e as instâncias SOA existentes.

Criar uma instância

1
Abrir um contrato
Clique no contrato na barra lateral. O painel de detalhes aparece à esquerda.
2
Clique em + SOA Instance
O diálogo de criação abre-se. Selecione o padrão SOA desenhado pelo SOA Senior para este tipo de contrato.
3
Verificar compatibilidade
Um crachá de compatibilidade indica se as restrições de tipo de tratado do padrão correspondem ao contrato. Uma discrepância é um aviso, não um bloqueio.
4
Criar
Clique em Create instance. A instância aparece na lista e o DAG do padrão carrega no painel direito.
💡
Múltiplas instâncias por contrato. Um contrato pode ter várias instâncias SOA, por exemplo uma por período (anual, ajustamento) ou uma por tipo de padrão. Um aviso aparece se instanciar o mesmo padrão duas vezes no mesmo contrato, mas não é bloqueado.

Eliminar uma instância

Clique no botão 🗑 junto a uma instância na lista. Todos os seus valores de dimensão serão eliminados de forma permanente. Esta ação é irreversível.

Compatibilidade dos padrões

Ao criar uma instância, o diálogo mostra um crachá de compatibilidade baseado na sobreposição entre os tipos de tratado do contrato e as restrições do padrão.

CracháSignificadoPode prosseguir?
✓ CompatibleO contrato partilha pelo menos um tipo de tratado com as restrições do padrãoSim, recomendado
🌐 UniversalO padrão não tem restrição de tipo de tratado: aplica-se a todos os contratosSim, sempre válido
⚠ MismatchSem sobreposição de tipos de tratado: o padrão pode não ter sido desenhado para este tipo de contratoSim, com precaução
⚠ cycleO padrão tem um ciclo detetado: não pode produzir uma conta válidaNão, bloqueado

Se o padrão necessário mostrar um aviso de ciclo, contacte o SOA Senior para o corrigir antes de prosseguir.

SOA Patterns

A secção SOA Patterns (apenas leitura) oferece-lhe uma vista de referência de todos os padrões desenhados pelo SOA Senior — acessível diretamente a partir da secção Contratos na barra lateral.

Cada padrão mostra a sua estrutura: nós, tipos de ligação, restrições de tipo de tratado e as dimensões que o SOA Senior anexou a cada nó. Utilize esta secção para compreender um padrão antes de o instanciar, ou para verificar quais as dimensões que precisará de preencher.

💡
Esta vista é apenas de leitura. Não pode editar padrões — essa é a responsabilidade do SOA Senior. Se um padrão estiver em falta ou incorreto, contacte o SOA Senior.

Preencher dimensões

Após criar uma instância, clique em qualquer nó no DAG do padrão para abrir o drawer de preenchimento no lado direito do ecrã.

💡
Apenas os nós com dimensões associadas são clicáveis. Se clicar num nó não tiver efeito, o SOA Senior não lhe associou dimensões.

O drawer de preenchimento

O drawer mostra a etiqueta do nó, o seu tipo de ligação (codificado por cor) e uma secção de preenchimento por dimensão associada. Cada secção tem uma indicação geral (a amarelo) e campos de instrução numerados a completar.

DETAIL Perda líquida retida — camada XL 1
Descreva a periodicidade desta linha de conta: trimestral, anual ou período de ajustamento.
1
Tipo (Grânulo / Período)
2
Valor (ex. "2024")
3
Exceções (se existirem)

Os campos com borda verde já estão preenchidos. Clique em 💾 Save no fundo do drawer para guardar os seus valores. Pode regressar a qualquer nó e atualizar os seus valores a qualquer momento.

⚠️
A gravação é por nó. Fechar o drawer sem guardar descarta as suas alterações para esse nó. O indicador de progresso na barra de ferramentas atualiza-se automaticamente após cada gravação.

Linhas FORMULA — citar dados do Manager

Algumas linhas de conta, marcadas com o ícone 🔗 e borda tracejada, são nós FORMULA. Em vez de introduzir um valor livre, cita o nó exato do grafo Manager que gerou o valor para essa linha.

🔗
Os nós FORMULA ligam a conta ao modelo atuarial. Ao citar um nó de instância do Manager, está a dizer: esta linha de conta toma o seu valor desse output calculado específico. A referência é armazenada como ponteiro, não como valor copiado.

Como preencher um nó FORMULA

1
Clique no nó FORMULA
O drawer abre-se. Aparece um seletor 🔗 Citação de nó Manager com três grupos de grafos candidatos.
2
Leia os três grupos
Mesmo contrato: grafos Manager instanciados no mesmo contrato. Mesmo tipo de tratado: grafos cujo contrato partilha tipos de tratado. Mesma cláusula: grafos ligados às mesmas cláusulas que o padrão. Um grafo pode aparecer em vários grupos.
3
Clique num grafo
Aparece um seletor de nós com etiqueta, operando e tipo de valor de cada nó.
4
Selecione o nó
Escolha o nó específico cujo output alimenta esta linha de conta. A citação selecionada aparece no topo do drawer.
5
Guardar
Clique em 💾 Save. O nó fica verde (🔗 ligado ✓) no canvas.
💡
Pode alterar ou limpar uma citação a qualquer momento. Reabra o nó, selecione um grafo e nó diferentes, ou clique em ✕ para remover a citação.

E se não aparecer nenhum grafo?

Se os três grupos estiverem vazios, o Manager ainda não instanciou nenhum grafo relevante num contrato compatível. Contacte o Manager: o nó FORMULA permanecerá a âmbar (não ligado) até existir uma fonte. Um nó FORMULA não ligado sinaliza uma lacuna entre o modelo atuarial e a estrutura da conta.

Monitorização do progresso

O progresso de preenchimento é monitorizado simultaneamente em dois níveis.

OndeO que mostra
Barra de ferramentas (visualizador DAG)Fração em tempo real, ex. "25% preenchido (2 / 8 nós)", atualizada após cada gravação
Canvas DAG (nós FORMULA)🔗 verde = ligado ✓, âmbar = não ligado, atualizado após cada gravação
⚠️
O canvas atualiza-se após F5. Após guardar, prima F5 e volte a selecionar o contrato e a instância para ver o estado atualizado em todos os nós.

Explorador de instâncias SOA

Vista transversal de todas as suas instâncias SOA, acessível a partir de 🔭 SOA Instances Explorer na barra lateral.

Cada cartão mostra o identificador da instância, o nome do contrato, o nome do padrão e o estado do contrato. Clique num cartão para navegar diretamente para esse contrato e instância.

Filtros

FiltroO que restringe
All contractsMostra apenas instâncias de um contrato específico
All patternsMostra apenas instâncias de um padrão SOA específico
All statusesMostra apenas instâncias cujo contrato tem um estado específico (ACTIVE, CLOSED…)

A contagem de instâncias atualiza-se em tempo real quando os filtros são aplicados. Os filtros são independentes: combine-os livremente.

Data Checks

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

VistaO que mostra
SOA Instances — overviewTodas as instâncias com contrato, padrão, estado e tipos de tratado
FORMULA citationsQual nó SOA cita qual nó do grafo Manager, com etiqueta, operando e tipo de valor
Dimension values — detailTodos os valores de dimensão introduzidos, com contexto de nó e dimensão
Production — technical account exportConta completa: todas as instâncias × nós × valores + citações FORMULA. Uma linha por nó por instância, exportável para reporting.

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

Manutenção

Oito verificações de limpeza acessíveis a partir de 🔧 Database purge na barra lateral. Diagnosticar sempre primeiro — as execuções são irreversíveis.

CódigoO que limpaRisco
J1Instâncias SOA num contrato que já não existeAlto
J2Instâncias SOA num padrão que já não existeAlto
J3Valores de dimensão cuja instância foi excluídaMédio
J4Valores de dimensão cuja dimensão de nó foi desconectada pelo SOA SeniorMédio
J5Valores de dimensão cuja instrução foi excluída pelo Senior UnderwriterBaixo
J6Citações FORMULA cuja instância SOA foi excluída (verificação de segurança — normalmente tratada por cascata)Baixo
J7Citações FORMULA cujo nó de padrão foi excluído pelo SOA SeniorMédio
J8Citações FORMULA apontando para uma instância Manager que já não existe — a ligação está quebradaMédio

Ordem recomendada: J1 → J2 → J3 → J4 → J5 → J6 → J7 → J8. Executar J1 e J2 primeiro remove instâncias obsoletas e as suas citações FORMULA. J8 sinaliza ligação quebrada — o SOA Junior deve recitar os nós FORMULA afetados.

⚠️
J1 e J2 são de alto risco. Eliminam instâncias, todos os valores de dimensão associados e todas as citações FORMULA. Reveja cuidadosamente a lista de diagnóstico antes de confirmar a execução.