Skip to content

About

API REST para gerenciamento financeiro pessoal com Java, Spring Boot, JWT e PostgreSQL

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

FinanceHub API

API REST profissional para gerenciamento financeiro pessoal, com Java 21, Spring Boot 3, PostgreSQL, JWT, Swagger, Docker e testes.

Funcionalidades

  • Cadastro, login, JWT e refresh token.
  • Perfil de usuario, edicao, alteracao de senha e desativacao.
  • CRUD de contas, cartoes, categorias, transacoes, metas e orcamentos.
  • Despesas parceladas.
  • Transferencias entre contas.
  • Filtros dinamicos, paginacao e ordenacao em transacoes.
  • Dashboard mensal com receitas, despesas, saldo e despesas por categoria.
  • Relatorios em CSV e PDF.
  • Tratamento global de excecoes e validacao Bean Validation.
  • Migracoes SQL com Flyway.
  • Documentacao Swagger/OpenAPI.
  • CI com GitHub Actions.

Stack

  • Java 21
  • Spring Boot 3
  • Spring Security
  • Spring Data JPA / Hibernate
  • PostgreSQL
  • Flyway
  • Maven
  • Docker / Docker Compose
  • JUnit 5 / Mockito

Como executar

Com Docker:

docker compose up --build

Sem Docker, configure um PostgreSQL local e rode:

mvn spring-boot:run

Variaveis de ambiente principais:

DB_URL=jdbc:postgresql://localhost:5432/financehub
DB_USERNAME=financehub
DB_PASSWORD=financehub
JWT_SECRET=ChangeThisSecretBeforeProductionWithAtLeastThirtyTwoChars

Documentacao

Depois de subir a aplicacao:

  • Swagger UI: http://localhost:8080/api/swagger-ui.html
  • OpenAPI JSON: http://localhost:8080/api/v3/api-docs

Fluxo rapido

  1. POST /api/auth/register
  2. Copie o accessToken
  3. Envie Authorization: Bearer <token> nos endpoints protegidos
  4. Cadastre contas, categorias e transacoes
  5. Consulte /api/dashboard?month=2026-07

Testes

mvn test

Estrutura

src/main/java/com/financehub/api
├── config
├── controller
├── dto
├── entity
├── enums
├── exception
├── mapper
├── repository
├── security
├── service
└── util

About

API REST para gerenciamento financeiro pessoal com Java, Spring Boot, JWT e PostgreSQL

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages