Visão geral
Finance App é um projeto de aprendizado de 2024: API backend para gestão financeira pessoal com cadastro de usuários, registro de receitas e despesas, categorização de transações e dashboard consolidado, com persistência em PostgreSQL e ambiente containerizado com Docker.
- Autenticação de usuários
- CRUD de transações
- Dashboard financeiro
- Organização de receitas e despesas
- Migrações automatizadas
Problema resolvido
Usuários precisam de uma forma simples e confiável de registrar movimentações financeiras, categorizar gastos e acompanhar saldo sem depender de planilhas manuais.
Regras de negócio
- Cada transação pertence a um único usuário autenticado.
- Tipos de transação: ganho, despesa ou investimento.
- Valores e datas são obrigatórios e validados na API.
- Dashboard consolida totais por período e categoria.
- Senhas armazenadas com hash seguro.
Arquitetura
API Express com camadas de use cases
Separação entre controllers, use cases e acesso a dados via helper PostgreSQL. Docker Compose padroniza o ambiente de desenvolvimento e deploy.
- Cliente HTTP
- Express Controllers
- Use Cases
- PostgreSQL
- Migrações SQL
- Documentação API
Desafios técnicos
- Modelagem de dados
- Validação de regras
- Qualidade de código
- Deploy em cloud
Decisões técnicas
Use cases explícitos
Isola regras de negócio dos controllers, facilitando testes e manutenção do domínio financeiro.
Migrações versionadas
Scripts SQL automatizados garantem reprodutibilidade do schema entre ambientes.
Docker para o banco
Elimina diferenças entre máquinas locais e facilita onboarding de novos desenvolvedores.
Qualidade de Software
Ferramentas, testes automatizados, CI/CD e padrões de engenharia aplicados neste portfólio.