Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

Repository files navigation

🛡️ Sistema de Denúncias - GatoMia (Backend)

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.

🚀 Tecnologias Utilizadas

  • 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)

⚙️ Arquitetura e Segurança

  • 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 (ADMIN e USER).
  • 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.

🛠️ Como Rodar o Projeto

1. Pré-requisitos

  • Java 21 (JDK) instalado.
  • PostgreSQL rodando.

2. Configuração do Banco de Dados

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.

3. Configuração do Ambiente

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

🔌 Documentação da API (Endpoints)

🔐 Autenticação (Público)

1. Registrar Novo Usuário

  • 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")

2. Fazer Login

  • Método: POST
  • URL: /auth/login
  • Retorno: Token JWT para acesso.
{
  "email": "maria@teste.com",
  "password": "SenhaForte123"
}

Resposta (200 OK):

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

👤 Usuários (Rotas Protegidas)

⚠️ Atenção: Para acessar as rotas abaixo, é necessário enviar o Token JWT no Header da requisição: Authorization: Bearer <SEU_TOKEN_AQUI>

3. Listar Usuários

  • Método: GET
  • URL: /users
  • Descrição: Retorna lista de usuários ativos (soft deleted são ignorados).

4. Teste de Segurança

  • Método: GET
  • URL: /users/teste
  • Descrição: Endpoint simples para validar se o Token está funcionando corretamente.

📝 Próximos Passos (Roadmap)

  • Implementação da Entidade de Denúncias.
  • Relacionamento entre Usuários e Denúncias.
  • Upload de evidências (fotos/documentos).

Desenvolvido por Victor Portolani


About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages