Allan Simões AdegasEnglish
Menu
Voltar para o início

Mail-Extractor

Em desenvolvimento

Extração de informações de e-mails corporativos, com a origem de cada valor rastreável até o trecho exato da mensagem.

Papel
Autor · produto Asigas
Início
2026
from: compras@cliente.com.br#4821R$ 1.240,0028/11/2026pedido-4821.pdfpedido#4821valorR$ 1.240,00vencimento28/11/2026Pub/Sub · fila do cliente
Ilustração do projeto
2
provedores: Gmail e Outlook (OAuth)
5
tipos de anexo lidos (PDF, DOCX, TXT, CSV, XLSX)
60+
arquivos de teste

Visão geral

Empresas recebem pedidos, confirmações e cobranças por e-mail e alguém copia os dados para outro sistema. O Mail-Extractor roteia mensagens por regras e extrai variáveis com evidência de origem. O conector pessoal do Gmail foi exercitado contra o provedor. Os fluxos de Outlook e Gmail corporativo têm testes com respostas simuladas.

É a evolução produto do que aprendi no BTG: extração confiável precisa de evidência, e cada valor entregue aponta para o trecho do e-mail de onde saiu.

O que ele faz

Roteamento por regras
Regras configuráveis decidem a que projeto cada e-mail pertence, com simulador para testar antes de ativar.
Extração por regex ou IA
Variáveis extraídas por expressão regular ou por modelo de linguagem (Claude ou Gemini), inclusive do texto dos anexos.
Evidência para cada valor
O corpo normalizado do e-mail é a âncora: cada valor guarda a posição do trecho de onde saiu.
Multiempresa
Papéis por cliente (admin, editor, leitor), tela de equipe e administração da plataforma.

Arquitetura

Arquitetura: Mail-ExtractorGmail · Outlook → fetch. fetch → route. route → extract. extract → deliver. deliver → Fila do cliente. route → PostgreSQL. extract → Corpos dos e-mailsGmail · OutlookOAuthfetchMIME e anexosrouteregrasextractregex ou IAdelivercontrato v1Fila do clientePub/SubPostgreSQLregras, resultados, evidênciaCorpos dos e-mailsCloud Storage ou disco
Pipeline de estágios independentes, cada um com seu worker.

Decisões e trade-offs

Duas formas de rodar
No Google Cloud usa Pub/Sub e Cloud Storage; numa VPS única, as mesmas etapas usam Redis e um diretório. O domínio não muda.
Arquitetura em camadas
Domínio puro, casos de uso e adaptadores (provedores de e-mail, IA, filas) separados por portas, o que permite testar contra emuladores locais.

Qualidade e operação

  • Testado contra emuladores locais de Pub/Sub e Cloud Storage; integração pula sozinha quando o Docker não está disponível.
  • Lint, checagem de tipos e testes num único comando (make check).
  • Deploy numa VPS com Docker Compose e Caddy já preparado.

Estado e próximos passos

  • Em desenvolvimento: o fluxo completo funciona localmente com dados de demonstração; falta o primeiro cliente em produção.

Stack

PythonFastAPIPostgreSQLRedisGoogle Pub/SubCloud StorageClaude / GeminiReactTanStack