🔐 API Usuários

---

📌 Sobre o projeto

A API Usuários é uma aplicação backend desenvolvida com Java e Spring Boot para cadastro e autenticação de usuários.

O projeto implementa cadastro de usuários, autenticação utilizando JWT, criptografia de senhas com SHA-256, validações de negócio e documentação automática com Swagger/OpenAPI, seguindo uma arquitetura organizada em camadas.

Além da aplicação, o ambiente de desenvolvimento conta com Docker Compose, disponibilizando automaticamente o banco de dados MySQL e o phpMyAdmin.

---

🚀 Funcionalidades

• Cadastro de usuários
• Autenticação de usuários
• Geração de Token JWT
• Criptografia de senha com SHA-256
• Validação de senha forte
• Controle de perfis de usuário
• Documentação da API com Swagger/OpenAPI
• Configuração de CORS para integração com aplicações frontend
• Ambiente de banco de dados com Docker Compose

---

🔒 Recursos de Segurança

• Geração de Token JWT durante a autenticação
• Criptografia de senhas utilizando SHA-256
• Validação de senha forte através de Expressão Regular (Regex)
• Perfis de usuário (Usuário Comum e Administrador)
• Configuração de CORS

Observação: Nesta versão do projeto o token JWT é gerado durante o login, porém ainda não há filtro de autenticação para proteger os endpoints da aplicação.

---

🧱 Tecnologias Utilizadas

• Java 21
• Spring Boot
• Spring Web MVC
• Spring Data JPA
• MySQL 8
• Docker Compose
• phpMyAdmin
• JWT (JJWT)
• Swagger / OpenAPI
• Lombok
• Maven

---

🏗️ Estrutura do Projeto

src/main/java/br/com/cotiinformatica/api_usuarios/

├── configurations
├── controllers
├── dtos
├── entities
├── enums
├── repositories
└── services

---

🔗 Endpoints

Método	Endpoint	Descrição
POST	/api/v1/usuario/criar	Cadastro de usuário
POST	/api/v1/usuario/autenticar	Autenticação e geração do JWT

---

⚙️ Como Executar

1. Clone o repositório

git clone https://github.com/beatrizlima-tech/api-usuarios.git

2. Suba o banco de dados

Na raiz do projeto execute:

docker compose up -d

Serão iniciados:

• MySQL 8

  • Porta: 3307
  • Banco: bd_usuarios

• phpMyAdmin

  • URL: http://localhost:5052

---

3. Configure a aplicação

No arquivo application.properties, configure a conexão com o banco e a chave JWT.

Exemplo:

spring.datasource.url=jdbc:mysql://localhost:3307/bd_usuarios
spring.datasource.username=coti
spring.datasource.password=coti

jwt.secret=sua_chave_secreta

---

4. Execute a aplicação

mvn spring-boot:run

---

5. Acesse a documentação

http://localhost:8080/swagger-ui.html

---

📊 Arquitetura

Cliente (Frontend)
        │
        ▼
Controller
        │
        ▼
Service
        │
        ▼
Repository
        │
        ▼
MySQL

---

📚 Conceitos Aplicados

• Programação Orientada a Objetos
• Arquitetura em Camadas
• API REST
• DTO Pattern
• Spring Data JPA
• Injeção de Dependência
• JWT
• SHA-256
• Regex para validação
• Docker Compose
• MySQL
• Swagger/OpenAPI

---

📌 Melhorias Futuras

• Implementar filtro JWT para proteger rotas
• Controle de acesso por perfil
• Refresh Token
• Bean Validation
• Tratamento global de exceções
• Testes automatizados
• Dockerizar a aplicação Spring Boot

---

👩‍💻 Autora

Beatriz Lima

• GitHub: https://github.com/beatrizlima-tech
• LinkedIn: https://www.linkedin.com/in/beatrizlima-tech