API RESTful desenvolvida com Java 21 e Spring Boot 3, focada na proteção infantil. O objetivo do sistema é gerenciar denúncias de abuso, garantindo a integridade, segurança e a persistência dos dados para fins legais e assistenciais.
ℹ️ Contexto do Projeto: Este sistema foi originalmente concebido em C# (.NET) como um projeto acadêmico. Esta versão representa uma refatoração e migração completa para o ecossistema Java, demonstrando domínio sobre arquitetura de software, Spring Security e boas práticas de Backend Moderno.
- Java 21 (LTS)
- Spring Boot 3
- Spring Security (Autenticação e Autorização)
- JWT (JSON Web Token) - via Auth0 (Gerenciamento de Tokens)
- Spring Data JPA (Persistência de dados)
- PostgreSQL (Banco de Dados Relacional)
- Maven (Gerenciamento de dependências)
- Bean Validation (Validação de dados e DTOs)
- Autenticação Stateless: Utilização de tokens JWT. O servidor não guarda sessão, tornando a API escalável.
- Criptografia de Senhas: Utilização do algoritmo BCrypt para hash de senhas antes da persistência.
- RBAC (Role-Based Access Control): Controle de acesso baseado em cargos (
ADMINeUSER). - Soft Delete: Exclusão lógica para manter histórico de dados (campo
deleted_at). - Padrão DTO: Separação estrita entre Entidades de Domínio e Camada de Apresentação.
- Java 21 (JDK) instalado.
- PostgreSQL rodando.
Crie um banco de dados no PostgreSQL chamado gatomia_db.
Não é necessário rodar scripts manuais: O projeto está configurado com ddl-auto=update, então o Hibernate criará as tabelas tb_users automaticamente na primeira execução.
No arquivo src/main/resources/application.properties, configure suas credenciais e a chave de segurança do Token:
# Banco de Dados
spring.datasource.url=jdbc:postgresql://localhost:5432/gatomia_db
spring.datasource.username=postgres
spring.datasource.password=SUA_SENHA_DO_BANCO
# JPA / Hibernate
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
# Segurança (JWT)
# Defina uma senha forte e única para assinar seus tokens
api.security.token.secret=minha-senha-super-secreta-gatomia
- Método:
POST - URL:
/auth/register - Body:
{
"name": "Maria Developer",
"email": "maria@teste.com",
"cpf": "123.456.789-00",
"phone": "11999999999",
"password": "SenhaForte123",
"role": "ADMIN"
}
(Nota: O campo role aceita "ADMIN" ou "USER")
- Método:
POST - URL:
/auth/login - Retorno: Token JWT para acesso.
{
"email": "maria@teste.com",
"password": "SenhaForte123"
}
Resposta (200 OK):
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
⚠️ Atenção: Para acessar as rotas abaixo, é necessário enviar o Token JWT no Header da requisição:Authorization: Bearer <SEU_TOKEN_AQUI>
- Método:
GET - URL:
/users - Descrição: Retorna lista de usuários ativos (soft deleted são ignorados).
- Método:
GET - URL:
/users/teste - Descrição: Endpoint simples para validar se o Token está funcionando corretamente.
- Implementação da Entidade de Denúncias.
- Relacionamento entre Usuários e Denúncias.
- Upload de evidências (fotos/documentos).
Desenvolvido por Victor Portolani