Pular para o conteúdo

No ar · release v1.0.0

Central Antifraude

Sistemas distribuídos e decisão de risco

.NET 10 ASP.NET Core PostgreSQL 17 EF Core AWS Lambda SQS EventBridge React 19 TypeScript Neon Vercel
Demo de 24 s: painel, fila de alertas, transação explicável e caso de falso positivo.
Decisão
Permitir · Revisar · Bloquear, com score determinístico e versionado
Testes
Unidade, integração com PostgreSQL real, frontend e arquitetura
Segurança
Pentest gray-box em produção, com relatório no repositório
Infra
Lambda (arm64) + SQS/DLQ + EventBridge · Neon · Vercel

Visão geral

Plataforma B2B para avaliação de risco, monitoramento e investigação de transações suspeitas em pagamentos digitais. Recebe transações de sistemas externos autenticados por credencial própria, avalia o risco de forma determinística e explicável e devolve Permitir, Revisar ou Bloquear com os sinais que justificam a decisão.

A plataforma não processa dinheiro: recomenda uma ação e dá ao analista as ferramentas para investigar o que ficou em dúvida, com fila de alertas, casos com timeline, regras versionadas e backtest antes de publicar. O efeito assíncrono sai por Outbox, fila e Inbox, com efeito único mesmo com entrega repetida.

Arquitetura

API .NET 10 em AWS Lambda (Function URL) sobre PostgreSQL no Neon, com frontend na Vercel. O evento de cada avaliação sai por Outbox para uma fila SQS, e um Lambda consumidor aplica os efeitos. A infraestrutura é declarada em AWS SAM e os segredos ficam no SSM Parameter Store, nunca em variável de ambiente.

  • CentralAntifraude.Domain Invariantes e primitivos, com zero dependência.
  • CentralAntifraude.Application Contratos e casos de uso.
  • CentralAntifraude.Infrastructure PostgreSQL, EF Core e relógio.
  • CentralAntifraude.Api Composição HTTP com Minimal APIs. Testes de arquitetura seguram a direção das dependências.
  • Lambda despachante Publica a Outbox na fila; é acionado logo após o commit e por uma varredura a cada 15 minutos (EventBridge Scheduler).
  • Lambda consumidor Lê da fila, aplica os efeitos com Inbox na mesma transação e confirma só depois do commit.

Caminho de uma transação

  1. O sistema externo envia a tentativa de pagamento com API key própria e chave de idempotência.
  2. Numa única transação serializável, a API grava a tentativa, avalia as quatro regras versionadas e grava a avaliação e um evento na Outbox. Conflito refaz a operação inteira; estourado o orçamento de retentativas, responde 503 com Retry-After.
  3. A resposta traz Permitir, Revisar ou Bloquear com score e sinais. Repetir a requisição devolve a avaliação original, sem recalcular.
  4. O despachante publica a Outbox no SQS. A garantia é a tabela; a invocação imediata só reduz a latência.
  5. O consumidor aplica os efeitos (contador diário e alerta) e confirma a mensagem só depois do commit. Falhas repetidas vão para a DLQ após 5 tentativas.
  6. O analista abre um caso a partir do alerta, investiga e conclui. A conclusão humana não reescreve a decisão do motor: um Revisar concluído como Legítima é um falso positivo, não um defeito.

Capturas de tela

Pontos fortes

  • Score explicável e versionado: quatro regras tipadas; cada decisão guarda a versão do perfil e das regras acionadas, e o banco recusa apagar o que a sustenta.
  • Idempotência sob concorrência: seis requisições simultâneas do mesmo cliente exigem contagens 1 a 6, sem repetir nem pular; repetir a chamada devolve a avaliação original.
  • Outbox, SQS e Inbox: efeito único mesmo com entrega repetida, processo caindo no meio ou vários despachantes ao mesmo tempo.
  • Serverless na AWS: Lambda .NET 10 (arm64), SQS com DLQ, EventBridge Scheduler e segredos no SSM Parameter Store, sem recurso de custo fixo.
  • Investigação auditável: casos com timeline somente-inserção e concorrência otimista; duas resoluções simultâneas produzem exatamente um 200 e um 409.
  • Backtest antes de publicar: reaplica a regra candidata sobre o histórico, no mesmo motor da avaliação real, sem tocar em produção.
  • Segurança: API key própria para integrações, refresh token rotativo, proteção CSRF e rate limit, validados em pentest contra a produção.

Limites e decisões conscientes

O que este projeto não faz, e por quê. Descrever isso com precisão vale mais do que exagerar o escopo.

  • Não processa dinheiro nem guarda PAN, CVV ou credencial financeira: só referências tokenizadas fornecidas por um sistema externo.
  • Pesos e limiares das regras são configuração de demonstração. As práticas têm fonte (U.S. Payments Forum, ADR 0008); os números não são padrão de mercado.
  • IA não participa do score, dos sinais nem das explicações: tudo é código determinístico.
  • Não é banco, gateway, adquirente nem solução certificada de compliance.
  • A infraestrutura suspende quando ociosa: a primeira visita depois de um tempo parado é mais lenta.