Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt

Use this file to discover all available pages before exploring further.

Resumo: editar uma política é o trabalho contínuo de calibração: ajustar thresholds à medida que os resultados reais aparecem, adicionar regras novas quando o risco muda, corrigir fórmulas de precificação. Toda edição gera uma nova versão automaticamente, com diff e autor. Esta página cobre o fluxo de edição e as mecânicas de versionamento e reversão.

​
Quando editar

  • Calibrar thresholds a partir de casos reais (taxa de aprovação baixa demais, falsos negativos, default inesperado).
  • Adicionar regra para cobrir um cenário novo (ex: novo tipo de restritivo, nova fonte disponível).
  • Ajustar precificação (taxa, prazo, valor aprovado) em resposta a mudança de funding ou apetite.
  • Desabilitar regra que está gerando ruído sem valor discriminante.

​
Pré-requisitos

  • Papel de administrador ou gestor de crédito.
  • Política já existe (criada do zero ou clonada de template).

​
Fluxo

1

Abrir a política

Em Política de Crédito, Políticas, clicar na política que você quer editar. O editor abre com o estado atual.
2

Entrar em modo edição

Toggle Editar no cabeçalho. Enquanto em edição, as alterações ficam em um rascunho não publicado, a política em produção continua rodando a versão anterior para quem disparar análise.
3

Fazer as alterações

Tudo que pode ser editado:
  • Cabeçalho: nome, nível de relatório, produto vinculado. (O tipo de documento PF/PJ é imutável.)
  • Grupos: adicionar, remover, renomear, mudar score agregado (scoreApproved, scoreAlert, scoreDenied).
  • Regras: adicionar, remover, desabilitar, ajustar campo/operador/threshold/status.
  • Fórmulas: periodFormula, interestFormula, amountFormula. Ver Precificação.
  • Dados consultados: ativar ou desativar SCR, janela de processos, níveis de vínculos societários.
  • Mensagens: textos mostrados para APPROVED, ALERT, DENIED.
4

Ver o diff

Botão Ver alterações mostra, lado a lado, o que mudou em relação à versão publicada: regras adicionadas, removidas, alteradas, fórmulas antes/depois.
5

Publicar

Clicar em Publicar. A nova versão passa a ser a vigente imediatamente. Qualquer análise disparada a partir desse momento usa a nova versão.
Análises disparadas antes da publicação continuam rastreáveis à versão antiga da política. A tela de resultado sempre mostra qual versão rodou.

​
Versionamento

Toda publicação gera uma nova versão da política. Cada relatório gerado registra a versão da política que rodou na análise, o que permite rastrear qualquer decisão ao conjunto exato de regras vigentes no momento. Na tela da política, a aba Histórico lista todas as versões publicadas com autor, data e o que mudou. A consulta do histórico é feita apenas pelo toolbox (não exposta via API).

​
Boas práticas

Uma mudança por publicação

Facilita entender o impacto. Evite empilhar 10 ajustes numa única publicação.

Descrição sempre preenchida

O campo descrição na publicação é o commit message da política. Futuro você agradece.

Testar antes de publicar

Ao menos 1 caso APPROVED, 1 DENIED e 1 limítrofe.

Janela de observação

Depois de alterar threshold crítico, observe as próximas 20 a 50 análises antes de consolidar.

​
Limitações e considerações

  • Edição concorrente: se dois usuários editam a mesma política ao mesmo tempo, o último a publicar sobrescreve. A tela alerta se outra edição está em curso.
  • Tipo de documento imutável. PF não vira PJ. Para mudar, duplique e edite a cópia.
  • Nível de relatório impacta campos disponíveis. Reduzir o nível (ex: de COMPLETO para ESSENCIAL) invalida regras que usam campos SCR; o editor bloqueia a publicação até você remover ou desabilitar.
  • Fórmulas com variáveis inexistentes bloqueiam o salvar. Se uma variável referenciada sumiu, corrija antes de publicar.

​
Perguntas frequentes

Pode. O lote em curso continua usando a versão vigente no momento em que foi disparado. Só novas análises pegam a versão nova.
Não. Todas as versões ficam salvas indefinidamente, com diff completo.
Na aba Histórico, selecionar duas versões (checkbox) e clicar em Comparar. Mostra o diff acumulado entre as duas.
Correto. Análises antigas são rastreáveis à versão da política que rodou no momento. A regra não é apagada, só deixa de avaliar em análises futuras.
Administradores e gestores de crédito veem. Analistas veem apenas a versão vigente.

​
Próximos passos

Criar Política

Do zero, quando nenhum template serve.

Usar Templates

Partir de um template pronto.

Precificação

Fórmulas de prazo, taxa e valor.

Interpretar Resultado

Calibrar thresholds a partir do breakdown.