Como funciona

O tenant é a unidade de isolamento. Campos, regras, conjuntos e faixas de risco pertencem a um tenant e não enxergam os de nenhum outro. Trocar o tenant na barra do topo troca tudo o que você vê no Studio.

Na prática um tenant costuma ser um cliente ou uma linha de negócio. Você cria um em Tenants e integrações informando só o nome; ele nasce como raiz e ativo.

Não existe herança nem compartilhamento entre tenants. Se duas operações precisam da mesma regra, a regra é criada duas vezes, uma em cada tenant.

A integração é o canal que chama o motor, e é ela que carrega a credencial usada nessa chamada. Um mesmo tenant pode ter várias, por exemplo uma por produto ou por ambiente.

O motor procura o conjunto publicado pelo par tenant + integração. Esse par é o endereço das regras: sem a ligação entre um conjunto publicado e uma integração, nada é avaliado, por mais regra que exista no tenant.

Campo do perfil é um dado que o motor mantém salvo por cliente e que a regra consulta na hora da transação. “Quantas saídas este cliente fez na última hora” é um campo: o valor é calculado e guardado para cada cliente, e já está pronto quando a transação chega. A regra não sai buscando esse número, ela apenas lê.

Cada campo é definido por:

• chave e tipo — o nome pelo qual a regra o referencia e o que ele devolve (inteiro, decimal, booleano, texto, data ou data e hora).
• origem — de onde o valor sai. Pode ser um campo direto da transação, uma agregação de transações ou de dispositivo (uma função como contagem ou soma sobre uma janela de tempo, por exemplo 24h), ou um campo derivado, calculado a partir de outros campos.
• entidade — sobre quem o valor é guardado, como o cliente ou o dispositivo.

Um campo nasce em rascunho e só pode ser usado por uma regra depois de publicado e ativo. Publicar dispara o backfill, que é o cálculo do valor para os clientes que já existem. Enquanto o backfill não termina, o campo ainda não responde — esse é o motivo mais comum de um campo recém-criado não aparecer para a regra.

Publicar também congela a versão. Alterar um campo já publicado cria uma versão nova em vez de reescrever a que está no ar.

O catálogo é a lista do que uma regra pode ler naquele tenant: os campos fixos da transação, como valor, tipo e horário, mais os campos de perfil que você ativou. Se um nome não está no catálogo, a condição não compila.

É a página para consultar antes de escrever uma regra, quando a dúvida é “esse dado existe?”.

A faixa de risco é a tabela que traduz pontuação em ação. Ela define a partir de qual score composto a transação é considerada baixa, média, alta ou crítica, e o peso que o score do cliente aplica sobre cada regra.

Ela é por tenant e existe uma vez só: as regras não carregam faixa própria, todas caem na mesma tabela.

A regra tem três partes:

• condição — o que precisa ser verdade, escrita sobre os nomes do catálogo.
• score — quanto ela soma quando bate.
• escopo — em quais transações ela vale.

Sozinha, a regra não roda em lugar nenhum. Ela só é avaliada quando entra em um conjunto, e o conjunto é publicado e ligado a uma integração. Criar a regra é o meio do caminho, não o fim.

O conjunto é o pacote que o motor carrega. Ele define quais regras rodam, em que ordem e com que peso cada uma entra. É no conjunto, e não na regra, que essa composição vive.

Em rascunho, nada é afetado: você monta e remonta à vontade. Publicar congela a versão e a torna imutável, e a partir daí qualquer mudança exige um rascunho novo — o que está no ar nunca muda por baixo.

Publicar ainda não coloca no ar. O passo que coloca é ligar o conjunto publicado a uma integração.

Quando a transação chega, o motor carrega o conjunto publicado do par tenant + integração, lê os campos do perfil daquele cliente e avalia as regras.

O score do cliente, o SC, não entra como uma parcela solta: ele vira peso. A faixa do SC define o multiplicador aplicado a cada regra que bateu.

O score base de cada regra que bateu é multiplicado por esse fator e arredondado. A soma desses valores é o ST final. O score composto é ST final + SC, e é ele que cai na faixa de risco:

Uma regra marcada como bloqueio bloqueia sozinha, independente do score somado.

O Laboratório roda uma regra ou um conjunto contra uma transação de teste e mostra o score e a decisão sem tocar em nada que esteja no ar. É onde se confere o efeito de uma mudança antes de publicar.

Para sair do zero até uma regra valendo, em um tenant novo:

1. criar o tenant e selecioná-lo na barra do topo;
2. criar uma integração nesse tenant e selecioná-la também;
3. criar os campos do perfil e publicá-los, esperando o backfill terminar;
4. conferir a faixa de risco do tenant;
5. criar as regras sobre os nomes do catálogo;
6. montar um conjunto em rascunho com essas regras;
7. testar no Laboratório;
8. publicar o conjunto e ligá-lo à integração.

Os seis passos cobrados na tela de regras são um recorte destes: eles verificam o que falta no tenant que está selecionado agora.