DeWallet 💰

Sobre o Projeto

DeWallet é uma solução completa e moderna para gerenciamento financeiro pessoal, desenvolvida pela Decoy Studios. O sistema oferece controle total sobre suas finanças, desde transações simples até o gerenciamento complexo de cartões de crédito com parcelamentos automáticos.

Com uma arquitetura robusta e interface intuitiva, o DeWallet transforma a forma como você gerencia seu dinheiro, oferecendo insights valiosos sobre seus gastos e ajudando no planejamento financeiro através de múltiplas carteiras organizadas.

✨ Funcionalidades Principais

💳 Gestão Completa de Bancos e Cartões:

• Cadastro ilimitado de bancos e cartões de crédito
• Configuração detalhada de limites, fechamento e vencimento
• Visualização em tempo real de saldo disponível e usado
• Controle de dias de fechamento e vencimento de faturas

📊 Sistema de Transações Inteligente:

• Registro de receitas e despesas com categorização
• Parcelamento automático de até 24x com cálculo de juros
• Transações recorrentes e fixas
• Cálculo automático de vencimentos por parcela
• Histórico completo e rastreável de todas as movimentações

👛 Organização por Múltiplas Wallets:

• Crie carteiras separadas (pessoal, empresarial, investimentos)
• Visualize balanços individuais por wallet
• Transfira valores entre carteiras
• Relatórios segmentados por tipo de carteira

📈 Dashboard com Análises Avançadas:

• Gráficos interativos de receitas vs despesas
• Projeções financeiras futuras baseadas em gastos recorrentes
• Controle detalhado de parcelas pendentes e pagas
• Alertas de vencimentos próximos
• Resumo mensal com insights automáticos

🛠️ Stack Tecnológica

Backend Robusto:

• Go (Golang): API REST de alta performance e concorrente
• PostgreSQL: Banco de dados relacional com integridade ACID
• JWT: Sistema de autenticação seguro com tokens
• Migrations: Versionamento automático do banco de dados

Frontend Moderno:

• Next.js 14: Framework React com SSR e otimizações automáticas
• TypeScript: Tipagem estática para código mais seguro
• Tailwind CSS: Design system responsivo e customizável
• Shadcn/ui: Componentes acessíveis e prontos para produção

DevOps e Infraestrutura:

• Docker: Containerização completa da aplicação
• Docker Compose: Orquestração de múltiplos containers
• Scripts Automatizados: Deploy simplificado com um único comando

🏗️ Arquitetura do Sistema

O DeWallet utiliza uma arquitetura em três camadas bem definida, garantindo escalabilidade, manutenibilidade e performance:

• Camada de Apresentação: Frontend Next.js com TypeScript (porta 3000)
• Camada de Aplicação: API REST em Go com endpoints RESTful (porta 8080)
• Camada de Dados: PostgreSQL com migrations versionadas (porta 5432)

💡 Exemplo de Uso: Compra Parcelada

Cenário: Você realizou uma compra de R$ 900,00 parcelada em 3x no Nubank, no dia 10/10/2025.

O DeWallet calcula automaticamente:

• Parcela 1: R$ 300,00 - Vence em 22/10/2025 (fatura atual)
• Parcela 2: R$ 300,00 - Vence em 22/11/2025 (próxima fatura)
• Parcela 3: R$ 300,00 - Vence em 22/12/2025 (última parcela)

Atualização do cartão:

• Limite total: R$ 5.000,00
• Valor usado: R$ 900,00
• Crédito disponível: R$ 4.100,00

🗄️ Modelagem de Dados

O banco de dados foi cuidadosamente estruturado para garantir integridade referencial e performance nas consultas:

• users: Gerenciamento de usuários e autenticação
• wallets: Múltiplas carteiras por usuário
• banks: Bancos e cartões com configurações de crédito
• transactions: Registro completo de todas as transações
• credit_transactions: Detalhamento de parcelas e vencimentos

🚀 Quick Start

Graças ao Docker, o DeWallet pode ser iniciado com apenas três comandos:

• ./run.sh dev - Modo desenvolvimento com logs no terminal
• ./run.sh prod - Modo produção em background
• ./run.sh clean - Limpeza completa de containers e volumes

O sistema automaticamente cria o banco de dados, executa todas as migrations e provisiona um usuário admin (admin@dewallet.com / admin123) pronto para uso.

🎯 Desafios Técnicos Superados

Sistema de Parcelamento Complexo: Implementar a lógica de cálculo automático de parcelas considerando diferentes datas de fechamento e vencimento foi um desafio fascinante. Desenvolvemos algoritmos que lidam com meses de diferentes durações e anos bissextos.

Performance em Consultas Agregadas: Otimizamos queries complexas que agregam dados de múltiplas tabelas, utilizando índices estratégicos e queries preparadas no PostgreSQL.

State Management no Frontend: Implementamos um sistema robusto de gerenciamento de estado com Context API do React, garantindo sincronização em tempo real entre componentes.

📈 Roadmap Futuro

• Sistema de notificações push para vencimentos próximos
• Integração com Open Banking para importação automática de extratos
• Aplicativo mobile nativo (React Native)
• Machine Learning para sugestões de economia
• Exportação de relatórios em PDF e Excel
• Dashboard compartilhado para casais e famílias
• Integração com APIs de criptomoedas
• Sistema de metas e objetivos financeiros

📚 Documentação Completa

O projeto conta com documentação extensiva e bem organizada:

• SETUP.md: Guia completo de instalação e configuração
• API-EXAMPLES.md: Exemplos práticos de todas as rotas
• BANCO-CREDITO.md: Detalhamento do sistema de crédito
• TROUBLESHOOTING.md: Soluções para problemas comuns
• GUIA-VISUAL.md: Wireframes e design system

🎨 Sobre a Decoy Studios

O DeWallet é desenvolvido pela Decoy Studios, nosso estúdio focado em criar soluções tecnológicas inovadoras. Este projeto representa nosso compromisso com código limpo, arquitetura escalável e experiência do usuário excepcional.