Mail-Extractor
Em desenvolvimentoExtração de informações de e-mails corporativos, com a origem de cada valor rastreável até o trecho exato da mensagem.
- 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
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