.png)
Extensão para Chrome / Faturas de energia
BODEE
Extensão para Chrome que ajuda usuários autenticados a consultar e baixar faturas da Equatorial direto no navegador.
Sobre o projeto
O projeto nasceu como FaturaSync: uma plataforma para automatizar a consulta, o download e a organização de faturas da Equatorial. A visão inicial incluía API, processamento de PDFs, filas, tentativas automáticas, agendamento mensal e armazenamento externo.
Uma prova de conceito com Node.js e Playwright validou o fluxo de autenticação, a consulta de faturas e o download de segundas vias. Em seguida, a arquitetura evoluiu para processamento em lote de múltiplas contas e competências, API documentada, chaves de acesso, limites de requisição, logs seguros e estratégias de retry.
A versão atual, BODEE, é uma extensão instalada no Chrome. Ela aproveita exclusivamente a sessão que o usuário já iniciou no portal oficial: o usuário escolhe unidades consumidoras e competências, e a extensão consulta e baixa as faturas selecionadas em PDF, inclusive em lote.
Destaques
- Extensão Chrome Manifest V3 publicada na Chrome Web Store (versão 1.0.1).
- Downloads em lote com nomes estruturados por titular, unidade consumidora e conta-contrato.
- Sessão legítima do navegador, permissões mínimas e funcionamento mesmo após fechar o popup.
- Sem banco de dados, analytics, servidor intermediário ou armazenamento de credenciais.
Desenvolvimento e aprendizados
O principal redesenho veio de uma limitação concreta: mudanças nos mecanismos de segurança e antifraude da Equatorial passaram a bloquear ou dificultar a automação remota. Em vez de manter uma infraestrutura própria para um fluxo que já dependia de uma sessão real, o produto foi deslocado para uma extensão Manifest V3 instalada pelo usuário. Isso exigiu trabalhar com o ciclo de vida do service worker, permissões mínimas, persistência da sessão legítima e downloads confiáveis mesmo com o popup fechado. Tokens, cookies e PDFs existem apenas temporariamente em memória; não há login automatizado, armazenamento de credenciais ou tentativa de contornar CAPTCHA.
Uma nota pessoal
Da automação à extensão
“O objetivo era tirar uma tarefa repetitiva da operação, sem alterar o que um usuário autorizado já podia fazer manualmente.”
- em uma solicitação comum
- 5 unidades × 12 meses = 60 faturas
- por fatura no fluxo automatizado
- ~5–12 s
- com todos os documentos ao final
- 1 ZIP
O problema apareceu no trabalho real com clientes de energia solar. Baixar faturas manualmente no portal da Equatorial era uma tarefa repetitiva e demorada: em um caso comum, buscar 12 meses de faturas para 5 unidades consumidoras significava localizar e baixar 60 documentos, um de cada vez.
O FaturaSync nasceu para transformar esse fluxo manual em automação. A validação técnica confirmou a viabilidade do produto, mas também mostrou que manter servidores, banco de dados e credenciais para esse caso de uso adicionaria complexidade e responsabilidade desnecessárias.
Quando os mecanismos de segurança e antifraude da Equatorial passaram a bloquear ou dificultar significativamente a automação, especialmente em ambientes cloud, o projeto mudou de direção. O BODEE surgiu como extensão para Chrome: o usuário faz login normalmente no portal e a extensão trabalha somente com a sessão já autorizada no navegador.
A extensão não realiza login, não contorna CAPTCHA e não solicita senha. Ela reduz o escopo de dados ao mínimo: tokens, cookies e PDFs são usados temporariamente em memória, sem banco de dados, analytics ou servidor próprio. A manutenção acompanha mudanças no portal e na API da Equatorial, variações de sessão e interface, além da compatibilidade com Chrome e Edge.
O projeto tornou visível uma lição importante de engenharia: quando uma integração externa muda, às vezes a melhor resposta é redesenhar o produto — não insistir na arquitetura anterior.