IPTU Manager
Sistema desktop local-first para gestão financeira imobiliária. Importa carnês de IPTU em PDF automaticamente, valida boletos e gera arquivos de remessa CNAB240 prontos para envio ao Banco do Brasil — tudo rodando na sua máquina, sem nuvem.
Problemas:
Gestão manual e dispersa: Proprietários com múltiplos imóveis lidam com dezenas de carnês físicos ou PDFs espalhados em pastas, sem visibilidade central de quais parcelas estão em aberto, vencidas ou pagas.
Risco de pagamento duplicado: Sem controle de deduplicação, o mesmo carnê pode ser contabilizado mais de uma vez, gerando erros financeiros difíceis de identificar depois.
Pagamento em lote é inviável manualmente: Quitar dezenas de boletos um por um no internet banking consome horas e é fonte constante de erros de digitação. O formato CNAB240 resolve isso, mas exige uma ferramenta que o gere corretamente.
Soluções:
Parser inteligente de PDF: O sistema lê automaticamente uma pasta de carnês, extrai valor, datas de vencimento, competência e linha digitável de cada documento. Uma lógica de deduplicação por hash garante que o mesmo carnê jamais seja importado duas vezes.
Geração de CNAB240 validada: O IPTU Manager monta lotes de pagamento com múltiplos boletos, valida rigorosamente os dígitos verificadores e os segmentos O/J do padrão Banco do Brasil, e gera o arquivo de remessa pronto para upload no portal bancário.
Dashboard central: Uma visão unificada de todos os imóveis e parcelas — com status Aberto, Vencido e Pago — elimina a necessidade de planilhas paralelas e reduz o tempo de auditoria.
Principais Funcionalidades:
- Importação de PDFs em lote: Selecione uma pasta inteira com carnês e o sistema processa tudo automaticamente, extraindo os dados relevantes e ignorando duplicatas via hash.
- Gestão de Proprietários e Imóveis: Cadastro estruturado com relação proprietário → imóveis → parcelas. Histórico completo, filtros e cópia de código de barras para pagamento manual.
- Lotes Bancários CNAB240: Selecione as parcelas desejadas, crie um lote de pagamento e exporte o arquivo de remessa no padrão Banco do Brasil. Suporte parcial à leitura do arquivo de retorno para baixa automática.
- Gestão de Comprovantes: Anexe comprovantes de pagamento (PDF, PNG, JPG, WEBP) diretamente às parcelas para facilitar auditoria futura.
- Dashboard Financeiro: Cards de resumo com totalizadores e status automático das parcelas para visão rápida da situação imobiliária.
- Empacotamento Desktop: Scripts com PyInstaller e Inno Setup geram um instalador Windows nativo. O aplicativo abre como janela dedicada no Edge em modo app, sem interface pesada de navegador.
Tecnologias Utilizadas:
- Python 3.14 + FastAPI: Backend enxuto e de alta performance, responsável pelo parser de PDF, validação CNAB240 e toda a lógica de negócio. Roda localmente como um processo em segundo plano invisível ao usuário.
- SQLite + SQLAlchemy: Banco de dados local e sem servidor — zero configuração. Os dados ficam em
%LOCALAPPDATA%\IPTU Manager\storage, totalmente privados e controlados pelo usuário. - React + TypeScript + Vite: Interface web moderna servida localmente pelo backend. Vite garante builds rápidas durante o desenvolvimento.
- Tailwind CSS: Estilização utilitária com suporte a tema claro e escuro, configurável pelo usuário nas preferências do sistema.
- Zustand + React Query: Gerenciamento de estado global (Zustand) e cache inteligente de requisições (React Query), tornando a interface responsiva mesmo com grandes volumes de parcelas.
- PyInstaller + Inno Setup: Empacotamento do backend Python em executável Windows e geração de instalador nativo — sem necessidade de Python instalado na máquina do usuário final.
Benefícios e Impacto:
- Privacidade total: Nenhum dado sai da máquina do usuário. Sem cadastro, sem nuvem, sem mensalidade — o sistema roda inteiramente local.
- Redução de erros financeiros: Validação automática de dígitos verificadores e deduplicação por hash eliminam as categorias mais comuns de erro em pagamentos de IPTU.
- Economia de tempo significativa: O que anteriormente demandava horas de trabalho manual no internet banking é resolvido em minutos com a geração do arquivo CNAB240.
- Auditoria facilitada: Comprovantes vinculados diretamente às parcelas, com histórico completo e rastreável por imóvel e proprietário.
Conclusão
O IPTU Manager nasceu de uma necessidade real: gestão eficiente de patrimônio imobiliário sem abrir mão da privacidade. A arquitetura local-first garante que os dados permaneçam sempre sob controle do usuário, enquanto a automação do fluxo PDF → CNAB240 transforma horas de trabalho manual em um processo de minutos.
O projeto está disponível para uso privado. Para rodar localmente, consulte as instruções no README do repositório — o instalador Windows gerado pelo script de build não requer nenhuma dependência prévia na máquina do usuário.