https://github.com/jhonsantt4na/healthcheck_api
A HealthCheck API é uma API REST construída com Java e Spring Boot, focada no agendamento de consultas médicas. O objetivo é proporcionar uma experiência real de desenvolvimento profissional, aplicando as melhores práticas de backend modernas.
https://github.com/jhonsantt4na/healthcheck_api
healthcheck java santt4na spring spring-data-jpa
Last synced: 10 months ago
JSON representation
A HealthCheck API é uma API REST construída com Java e Spring Boot, focada no agendamento de consultas médicas. O objetivo é proporcionar uma experiência real de desenvolvimento profissional, aplicando as melhores práticas de backend modernas.
- Host: GitHub
- URL: https://github.com/jhonsantt4na/healthcheck_api
- Owner: JhonSantt4na
- License: mit
- Created: 2025-06-07T17:24:48.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-24T21:49:02.000Z (12 months ago)
- Last Synced: 2025-07-04T13:06:49.938Z (12 months ago)
- Topics: healthcheck, java, santt4na, spring, spring-data-jpa
- Language: Java
- Homepage:
- Size: 682 KB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🏥 Health Check - API de Agendamento Médico
[](https://www.oracle.com/java/)
[](https://spring.io/projects/spring-boot)
[](LICENSE)
[](README.md)
---
## 📖 Descrição
A **HealthCheck API** é uma API REST construída com **Java 21** com **Spring Boot**, para gerenciamento de agendamento de consultas médicas. O objetivo é proporcionar uma experiência real de desenvolvimento profissional, aplicando as melhores práticas de backend modernas. A API oferece recursos de autenticação, cadastro de médicos, pacientes e controle de consultas.
| 🚀 Tecnologias | 🚀 + Padrões Utilizados |
|-----------------------------------------------------|-----------------------------------------------|
| ✅ **Linguagem: Java 21+** | ✅ **Lombok** |
| ✅ **Framework: Spring Boot 3.5.x** | ✅ **Bean Validation** |
| ✅ **Camadas: `Controller → Service → Repository`** | ✅ **Actuador** |
| ✅ **Spring Security (JWT)** | ✅ **Cors Configuration** |
| ✅ **Spring Data JPA** | ✅ **Postman para testes** |
| ✅ **MySQL (com Docker)** | ✅ **Padronização de logs com SLF4J** |
| ✅ **Docker + Docker Compose** | ✅ **Tratamento de exceções customizadas** |
| ✅ **DTO com `record`** | ✅ **Thymeleaf** |
| ✅ **MapStruct para conversões** | ✅ **Swagger SpringDoc OpenAPI + Swagger UI** |
---
---
## 🔐 Autenticação e Autorização
O projeto utiliza autenticação via JWT Token, Criptografia com PBKDF2WithHmacSHA256 e Role-Based Access Control (RBAC)
com as seguintes roles:
ROLE_DOCTOR - Médicos
ROLE_PATIENT - Pacientes
ROLE_ADMIN - Administrador do Sistema
Exemplo de fluxo:
```mermaid
sequenceDiagram
participant Usuário
participant API
Usuário->>API: POST /auth/login\n(enviar credenciais: username e password)
API-->>Usuário: Retorna JWT Token (access_token)
Usuário->>API: Chamada autenticada\n(Authorization: Bearer )
API-->>Usuário: Retorna dados protegidos
```
---
---
## 📂 Estrutura do Projeto
```bash
src/
├── main/
│ ├── java/
│ │ └── com.santt4na.healthcheck/
│ │ ├── controller/ (Endpoints da aplicação)
│ │ │ ├── docs/ (Documentação das rotas)
│ │ │ └── views/ (Controllers de páginas Thymeleaf)
│ │ ├── entity/ (Entidades JPA no sistema)
│ │ │ └── security/ (Entidades de autenticação e permissões)
│ │ ├── dto/ (Objetos de transferência de dados - DTOs)
│ │ │ ├── appointmentsDTO/ (DTOs de agendamento de consultas)
│ │ │ ├── doctorDTO/ (DTOs de médicos)
│ │ │ ├── patientDTO/ (DTOs de pacientes)
│ │ │ ├── scheduleDTO/ (DTOs de horários disponíveis)
│ │ │ └── securityDTO/ (DTOs de autenticação e segurança)
│ │ ├── enum/ (Enums e tipos fixos no sistema)
│ │ ├── health/ (Actuador com o monitoramento)
│ │ ├── mapper/ (Conversão entre Entidades e DTOs via MapStruct)
│ │ ├── exceptions/ (Exceções customizadas da aplicação)
│ │ │ └── handler/ (Tratamento global de exceções)
│ │ ├── repository/ (Repositórios de acesso a dados - JPA)
│ │ ├── service/ (Camada de regras de negócio - Services)
│ │ │ ├── impl/ (Implementações concretas dos serviços)
│ │ │ └── security/ (Serviços relacionados à segurança/autenticação)
│ │ ├── config/ (Configurações gerais no projeto)
│ │ └── security/ (Configurações específicas de segurança)
│ │ └── jwt/ (Geração e validação de tokens JWT)
│ └── resources/
│ ├── application.yml (Configurações externas da aplicação)
│ ├── logback-spring.xml (Configuração de logs SLF4J)
│ └── db/migration/ (Scripts de versionamento Flyway)
└── test/ (Testes unitários e de integração)
```
## 📚 Documentação da API
A documentação completa da API está disponível no Swagger UI:
➡️ [http://localhost:8080/swagger-ui/index.html](http://localhost:8080/swagger-ui/index.html)
- Configurado via SpringDoc (`springdoc-openapi-ui`)
- Versão da API: v1.0.0
- Todos os endpoints documentados
---
## 🏗️ Melhorias Futuras
- Validação dos CRM dos Medicos
- Validação dos Planos de Saude dos Pacientes
- Notificações por e-mail
- Interface administrativa com Thymeleaf
- Implementar OAuth 2.0 Authentication
---
## 🪪 Licença
**Criado Por Jorge Santana (Santt4na) By Intellij IDEA -**
**Este projeto está licenciado sob a [MIT License](LICENSE).**