> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # O que é o Tracer? > Valide transações em tempo real com o Tracer — aplique limites de gastos, detecte atividade não autorizada e decida permitir/negar em menos de 100ms. export const GCEL = ({children}) => {children} ; Toda instituição financeira precisa controlar como o dinheiro se move — quem pode gastar, quanto e sob quais condições. Sem governança de gastos em tempo real, transações não autorizadas passam, limites são ultrapassados e auditorias se tornam pesadelos. O **Tracer** resolve isso. É a plataforma da Lerian para validação de transações em tempo real e controle de gastos. Ele toma decisões instantâneas (ALLOW/DENY/REVIEW) para qualquer tipo de transação em menos de 100ms, mantendo a conformidade regulatória. O Tracer está disponível para clientes licenciados; seu repositório é mantido internamente. ## O Tracer em um core banking completo *** O Tracer é uma das peças de um core banking Lerian — a sua **camada de controle em tempo real**. Um ledger registra o que aconteceu; o Tracer decide o que *pode acontecer* antes. Nesse fluxo, antes de a sua aplicação registrar uma transação no **Midaz**, ela chama o Tracer para checar o movimento contra as suas regras e limites de gasto, e só submete ao ledger se a decisão for `ALLOW` — assim, movimentos não autorizados ou acima do limite nunca chegam ao ledger. O Tracer fica **separado do ledger**: nunca conecta no Midaz e não lê saldos — ele avalia o contexto que o seu sistema envia, e a sua aplicação orquestra os dois. Para ver onde isso se encaixa no quadro geral, veja [Montando um core banking completo](/pt/building-a-complete-core-banking). ## Por que usar o Tracer? *** Sem o Tracer, equipes dependem de verificações manuais, regras espalhadas em múltiplos sistemas ou processos pós-fato para identificar transações problemáticas. Isso significa que erros são descobertos tarde demais — depois que o dinheiro já saiu. O Tracer centraliza a governança de gastos e a validação de transações em uma única camada. Com tempos de resposta inferiores a 80ms (p99) e configuração flexível, você aplica políticas, estabelece limites de gastos e mantém a conformidade — tudo sem comprometer a experiência do usuário ou escrever código complexo. Em seu núcleo, o Tracer fornece duas capacidades fundamentais: * **Regras de validação**: Regras baseadas em expressões usando CEL (Common Expression Language) que avaliam o contexto da transação e retornam decisões instantâneas — sem necessidade de deploys de código. * **Limites de gastos dinâmicos**: Limites configuráveis por transação, por conta, por portfólio ou por segmento — com rastreamento de uso em tempo real e resets automáticos de período. ### Resolvendo desafios de controle e compliance O Tracer ajuda instituições a avaliar políticas de gastos, identificar transações não autorizadas e atender requisitos de auditoria. Seja para detectar transações que excedem limites de gastos, avaliar regras de negócio personalizadas ou manter um registro de auditoria completo para conformidade SOX/GLBA, o Tracer fornece a velocidade, flexibilidade e governança necessárias para operações financeiras modernas. ## Principais capacidades *** * Validação em tempo real com tempos de resposta inferiores a 80ms (p99) * Motor de regras baseado em expressões usando CEL (Common Expression Language) para regras type-safe e amigáveis para analistas * Design agnóstico de produto que suporta múltiplos tipos de transações: * Transações com cartão (débito, crédito, pré-pago) * Transferências bancárias (domésticas, internacionais, ACH) * PIX (instantâneo, agendado) * Criptomoedas (bitcoin, ethereum, stablecoin) * Limites de gastos dinâmicos: * Por transação, conta, portfólio ou segmento * Períodos diários, mensais ou por transação * Rastreamento de uso de limites em tempo real com resets automáticos de período * Registro de auditoria completo com retenção de 7+ anos para conformidade SOX/GLBA * Decisão padrão configurável para casos sem correspondência (`DEFAULT_DECISION_WHEN_NO_MATCH`) — quando nenhuma regra casa com a transação, o Tracer retorna o padrão configurado (ALLOW para fail-open, DENY para fail-closed). Falhas de infraestrutura aparecem como erros HTTP; o sistema chamador decide o comportamento de fallback. ## Como funciona *** O Tracer é construído em torno de três contextos principais: 1. **Contexto de Validação** - Orquestra as requisições de validação, coordena a avaliação de regras e limites, e registra a trilha de auditoria. 2. **Contexto de Regras** - Gerencia as definições de regras, compila expressões e avalia regras contra o contexto da transação. 3. **Contexto de Limites** - Gerencia as configurações de limites de gastos, rastreia contadores de uso e aplica thresholds. Quando uma transação é enviada para validação: Como o Tracer processa uma requisição de validação nos seus contextos de Validação, Regras e Limites e retorna uma decisão ALLOW, DENY ou REVIEW Todas as regras ativas são avaliadas, e se alguma regla DENY corresponder, o Tracer retorna uma decisão DENY. Os limites são verificados contra o uso atual, e a decisão é retornada com um registro de auditoria completo. **Seu sistema é responsável por agir com base nessa decisão** (ex.: bloquear a transação, mostrar um erro ao usuário ou enfileirar para revisão). ### Quem faz o quê O Tracer fica entre vários times. Cada time é dono de uma parte do ciclo: | Ator | O que faz | Toca em | | ------------------------------ | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | **Analista de risco / fraude** | Escreve e ajusta regras ("negar PIX acima de R\$ 50k de contas novas") | `POST /v1/rules`, `/v1/rules/{id}/activate`, revisão da trilha de auditoria | | **Gestor de produto / risco** | Configura limites de gastos por segmento, portfólio, conta | `POST /v1/limits`, endpoints de ciclo de vida, monitoramento de uso | | **Engenheiro de integração** | Constrói a chamada do sistema de autorização para o Tracer | `POST /v1/validations`, tratamento de retry / timeout / fallback | | **Sistema de autorização** | Envia toda transação para validação, age sobre ALLOW / DENY / REVIEW | Chama `POST /v1/validations` no caminho crítico | | **Tracer** | Avalia regras e limites, registra o resultado, retorna a decisão | Roda internamente — nunca chama de volta | | **Compliance / auditoria** | Consulta a trilha, verifica integridade da cadeia hash, roda relatórios SOX/GLBA | `GET /v1/validations`, `/v1/audit-events`, `/v1/audit-events/{id}/verify` | | **SRE / plataforma** | Monitora latência, capacidade, readiness | Acompanha `/readyz`, métricas OTel, taxas de erro | Uma requisição típica flui: **sistema de autorização → Tracer (avalia regras + checa limites → decisão) → log de auditoria → resposta de volta para o sistema de autorização**. Definições de regras e limites são configuradas antes pelos times de risco/produto; compliance lê o log depois. O Tracer nunca volta a chamar sua stack — não há webhooks ou callbacks. Valores monetários (`amount` da transação, `maxAmount` do limite de gastos e contadores de uso) são expressos como strings decimais, por exemplo `"1500.00"` ou `"50000.00"`. ## Quando usar o Tracer *** O Tracer se encaixa naturalmente em qualquer fluxo de trabalho onde você precisa controlar como o dinheiro se move através da sua instituição. * **Governança de gastos**: Avalie transações contra políticas de gastos internas ou em nível de cliente * **Validação de transações**: Avalie regras de negócio personalizadas e retorne decisões antes da execução de transações * **Conformidade regulatória**: Produza registros prontos para auditoria e garanta rastreabilidade * **Proteção ao cliente**: Detecte gastos excessivos e retorne decisões para que seu sistema possa agir ## Escopo e princípios de design *** O Tracer é um **motor de validação de transações**, não um sistema completo de gestão de fraudes. É um componente especializado otimizado para decisões de baixa latência (\< 100ms) que valida payloads pré-enriquecidos contra regras e limites configuráveis. Este escopo focado permite que o Tracer entregue desempenho previsível enquanto se integra perfeitamente a ecossistemas mais amplos de prevenção a fraudes. ### O que o Tracer foca * **Validação baseada em regras**: Lógica determinística baseada em expressões usando CEL * **Limites de gastos**: Aplicação em tempo real com resets automáticos de período * **Trilha de auditoria**: Registros imutáveis para compliance (SOX/GLBA) * **Decisões de baixa latência**: Respostas síncronas da API em menos de 80ms (p99) ### O que o Tracer não inclui | Capacidade | Razão | Alternativa | | -------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | **Scoring por machine learning** | Inferência de ML adiciona latência incompatível com meta de sub-100ms | Integre serviços de ML externos upstream e passe scores via metadata | | **Enriquecimento de dados** | Chamadas externas durante validação quebram garantias de latência | Enriqueça payloads na sua integração antes de chamar o Tracer | | **Fluxos de revisão manual** | Gestão de casos está fora do escopo principal de validação | Construa filas de revisão no seu sistema e use a decisão `REVIEW` como gatilho | | **Interface de usuário** | Design API-first permite integração flexível | Construa UIs customizadas ou use ferramentas de terceiros | | **Execução de pagamentos** | Tracer retorna decisões de validação; ele não movimenta fundos | Execute ou bloqueie pagamentos no sistema upstream com base na decisão | Esses limites mantêm o Tracer rápido, previsível e focado no seu valor principal: decisões instantâneas de transação com trilhas de auditoria completas. ## Integração *** Integrar com o Tracer é simples. Seu sistema de autorização envia requisições de validação com o contexto completo da transação, e o Tracer responde com uma decisão—tipicamente em menos de 35ms. Este **Padrão Payload-Complete** mantém as coisas simples: todo o contexto que o Tracer precisa chega em uma única requisição, então não há chamadas externas durante a validação e a latência permanece previsível. Por padrão, o Tracer opera em modo single-tenant e suporta operação multi-tenant quando implantado em modo SaaS ou BYOC Multi-Tenant. Em modo multi-tenant, a resolução e o isolamento de tenants funcionam da mesma forma que no resto da plataforma — consulte [Multi-tenancy](/pt/multi-tenancy) para o modelo e [Access Manager](/pt/platform/access-manager/access-manager) para o fluxo de autenticação. Assim como todos os produtos da Lerian, o Tracer é desenvolvido com integração nativa ao [Access Manager](/pt/platform/access-manager/access-manager). Quando habilitado, o Access Manager gerencia autenticação e autorização para as APIs do Tracer. Esta é uma funcionalidade opcional disponível no **modelo Enterprise**. ## Próximos passos *** Consulte endpoints para regras de validação, limites de gastos e trilhas de auditoria. Configure o Tracer e crie sua primeira regra de autorização.