Conceitos

A entidade que está sendo avaliada. Pode ser uma pessoa física (CPF), pessoa jurídica (CNPJ), veículo (placa), imóvel (matrícula), contrato (número) ou qualquer outra entidade identificável. O avaliado mantém histórico próprio: último score, limite atual, tier e nível de risco — atualizados a cada análise aprovada.

Uma avaliação específica de um avaliado em um momento do tempo. Cada análise é executada sob uma política e produz um resultado (score, tier, limite calculado, recomendação). É a unidade de decisão da plataforma — toda aprovação, rejeição ou revisão manual é registrada como uma análise com audit trail completo.

O modelo de avaliação. Define quais parâmetros coletar, como calcular o score, quais faixas de classificação (tiers) usar, quais bloqueios aplicar (hard stops) e quando acionar a IA. Uma mesma organização pode ter múltiplas políticas ativas simultaneamente — por exemplo: uma para crédito PJ básico, outra para crédito PJ avançado, outra para análise de fornecedor.

Uma informação coletada durante a análise. Pode vir de um bureau externo (Serasa, Receita), de cálculo interno, de upload de documento, de entrada manual ou ser informada pelo próprio avaliado via portal. Cada parâmetro tem um tipo (texto, número, data, booleano, arquivo, JSON, lista) e pode ser obrigatório ou opcional.

Um bloco de cálculo que produz uma parcela do score final. Um componente combina um ou mais parâmetros através de uma fórmula configurável e contribui com um peso específico para o score total. Exemplo: componente 'Análise Financeira' usa faturamento, lucro líquido e dívida total para produzir uma nota de 0 a 1000, que entra com peso 40% no score geral.

Uma faixa de score que determina como o resultado é interpretado. Cada tier tem um range (ex: 800-1000 = Tier A), uma recomendação associada (aprovar automaticamente, revisar, rejeitar) e pode exigir nível específico de alçada. Tiers permitem traduzir um número cru em uma decisão de negócio operacional.

Uma regra determinística que bloqueia uma análise independentemente do score. Avaliada em duas fases — PRE (antes do cálculo) ou POST (depois) — e pode ser vinculada a parâmetros ou componentes específicos. Exemplo: 'se CNPJ tiver restrição na Receita, rejeitar automaticamente'. Hard stops têm severidade (Crítico bloqueia, Warning alerta, Info apenas registra).

O número entre 0 e 1000 que representa o resultado final da análise. Calculado pelo motor a partir dos componentes da política, ponderados pelos seus pesos. É o indicador objetivo usado pela plataforma para determinar tier, limite sugerido e necessidade de aprovação manual.

O valor monetário associado à análise. A plataforma distingue entre três limites: calculado (imutável, definido pelo motor), sugerido pela IA (opcional, derivado do parecer do modelo) e aprovado (ajustável pelo aprovador humano).

O serviço que executa a política sobre os dados coletados: avalia hard stops (PRE), calcula cada componente, aplica pesos, determina o tier, avalia hard stops (POST), dispara a IA (se configurada) e devolve o resultado. Executa em modo automático (imediatamente após coleta) ou por workflow (quando o analista avança manualmente).

Interface externa para coleta de dados adicionais diretamente do avaliado. Quando a política exige documentos ou informações que só o avaliado pode fornecer, a plataforma gera um link seguro com autenticação OTP. O avaliado acessa, preenche dados, anexa documentos e envia — tudo sem precisar acessar o sistema principal.

O registro imutável de todas as decisões tomadas sobre uma análise. Cada aprovação, rejeição, override de limite ou edição de parâmetro é gravada com usuário, timestamp, valor anterior e valor novo, em uma cadeia encadeada por hash SHA-256. Essencial para conformidade e auditoria externa.