FinanceApp é uma aplicação de gerenciamento financeiro pessoal desenvolvida em Java, utilizando Spring Boot. A aplicação oferece uma API RESTful para gerenciar contas de usuários, transações (movimentações) e categorias. Utiliza PostgreSQL como banco de dados e JWT para autenticação e autorização.
- 📝 Registro e autenticação de usuários
- 💼 Gerenciamento de contas
- 💸 Gerenciamento de transações (movimentações)
- 🗂️ Gerenciamento de categorias
- 🔒 Controle de acesso baseado em roles
- 🔑 Autenticação JWT
- 📜 Documentação Swagger
- Java 21
- Spring Boot 3.3.1
- Maven
- PostgreSQL
- JWT
- Docker
- Swagger
Antes de começar, você precisará ter as seguintes ferramentas instaladas:
Siga os passos abaixo para configurar o projeto localmente:
-
Clone o repositório:
git clone https://github.com/Jaoow/finance-app.git
-
Navegue até o diretório do projeto:
cd finance-app
-
Construa o projeto usando Maven:
mvn clean install
-
Inicie o banco de dados PostgreSQL usando Docker:
docker-compose up -d
-
Execute a aplicação:
mvn spring-boot:run
-
A aplicação estará acessível em http://localhost:8080/
A documentação da API está disponível em:
- Swagger UI: http://localhost:8080/swagger-ui.html
Se você deseja contribuir para este projeto, siga as etapas abaixo:
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/sua-feature
) - Commit suas mudanças (
git commit -m 'Adiciona sua feature'
) - Push para a branch (
git push origin feature/sua-feature
) - Abra um Pull Request
Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
Se você tiver alguma dúvida ou problema, sinta-se à vontade para abrir uma issue.