medical-appointment-system

KO | EN

gitlite — search

#react #golang #android #deep-learning #linux #macos #nodejs #java #windows #awesome #cli #kubernetes #ios #openai

medical-appointment-system

(★ 6)

Sistema de agendamento de consultas médicas com geração automática de comprovante em PDF via AWS S3

medical-appointment-system Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🏥 Sistema de Agendamento de Consultas Médicas

## 📄 Descrição

Este projeto é composto por duas APIs integradas:

**API de Consultas Médicas**: responsável pelo cadastro e gerenciamento de usuários (pacientes, assistentes e médicos), além do agendamento de consultas médicas.

**API de Documentos**: responsável por gerar um comprovante em PDF com os dados da consulta, utilizando o Thymeleaf na criação do template, e armazenar o arquivo em um bucket S3 da AWS.

---

## ⚙️ Funcionalidades

- **Autenticação e autorização**: controle de acesso via JWT para pacientes, assistentes, médicos e administradores.
- **Agendamento de consultas**: respeitando a disponibilidade dos horários dos médicos.
- **Geração automática de documentos**: criação de comprovantes para os agendamentos realizados.
- **Armazenamento e acesso aos comprovantes**: arquivos PDF armazenados e acessados via AWS S3.

---

## 🛠️ Tecnologias

- **Linguagem**: Java
- **Framework**: Spring Boot
- **Gerenciador de Dependências**: Maven
- **Banco de Dados**: PostgreSQL, H2 Database
- **Migração de Banco**: Flyway DB
- **Segurança**: Spring Security, JWT Token
- **Mensageria**: RabbitMQ
- **Broker na Nuvem**: Cloud AMQP
- **Template Engine**: Thymeleaf
- **Geração de PDF**: ITextPDF
- **Armazenamento de Arquivos**: AWS S3
- **Testes**: JUnit, Mockito
- **Utilitários**: Lombok, MapStruct
- **Documentação da API**: SpringDoc OpenAPI

---

➡️ Fluxo da Aplicação:

1. Um usuário genérico é cadastrado no sistema com a role USER e credenciais básicas.
2. O tipo específico de usuário é criado, vinculado ao usuário genérico e incluindo suas informações específicas e role correspondente (paciente, médico, assistente ou administrador).
3. O assistente cadastra o cronograma de disponibilidade do médico, informando os dias da semana e horários de início e fim.
4. Com base nesse cronograma, o assistente cria uma consulta vinculando-a ao horário disponível.
5. O paciente visualiza e agenda uma das consultas disponíveis.
6. Após o agendamento, um comprovante em PDF é gerado utilizando o Thymeleaf, armazenado na AWS S3.

---

## 📝 Endpoints

- **Documentação online:**
  https://sistema-consultas-medicas.onrender.com/swagger-ui/index.html#/
- **Documentação local:**
  http://localhost:8080/swagger-ui/index.html

---

## 📈 Diagrama

<details>
 <summary>Diagrama de Classes</summary>
 <img src="./assets/class-diagram.png" alt="Diagrama de Classes" height="600">
</details>

---

## 🗂️ Imagens do Projeto

<details>
 <summary>Criação de Usuários</summary>
 <img src="./assets/doctor.png" alt="Imagem da criação do médico" width="500">
 <img src="./assets/assistant.png" alt="Imagem da criação do assistente" width="500">
 <img src="./assets/patient.png" alt="Imagem da criação do paciente" width="500">
</details>

<details>
 <summary>Criação de Cronograma do Médico</summary>
 <img src="./assets/create-doctor-schedule.png" alt="Imagem de criação do Cronograma do Médico" width="500">
</details>

<details>
 <summary>Criação de Consulta</summary>
 <img src="./assets/create-appointment.png" alt="Imagem de criação de Consulta" width="500">
</details>

<details>
 <summary>Agendamento de Consulta</summary>
 <img src="./assets/book-appointment.png" alt="Imagem do Agendamento da Consulta" width="500">
</details>

<details>
 <summary>Comprovante da Consulta Marcada</summary>
 <img src="./assets/booked-appointment.png" alt="Imagem do Comprovante" width="800">
</details>

<details>
 <summary>Listagem de Consultas Disponíveis por Especialidade Médica</summary>
 <img src="./assets/get-appointments-by-specialty.png" alt="Imagem da Listagem" width="500">
</details>

---

## ⚙️ Configuração e Execução

**Pré-requisitos**:

- Java 17
- Maven
- PostgreSQL
- RabbitMQ (CloudAMQP)
- Conta na AWS (Bucket S3)

**Passos para Configuração**:

1. Clone o repositório
2. Acesse o diretório do projeto
3. Configure o banco de dados no arquivo `application.yml` (URL, usuário, senha) das **duas APIs**
4. Configure o RabbitMQ (CloudAMQP) no arquivo `application.yml` das **duas APIs**
5. Configure a AWS S3 com suas credenciais no arquivo `application.yml` da **api-comprovantes**
6. Configure a secret key para JWT no arquivo `application.yml` da **api-consultas-medicas**

```bash
# Execute a aplicação
mvn spring-boot:run

# Pressione (CTRL + C) para encerrar a aplicação
```

---

## 🙋‍♀️ Autor

👩‍💻 Projeto desenvolvido por [Isabel Henrique](https://www.linkedin.com/in/isabel-henrique/)

🤝 Fique à vontade para contribuir!

medical-appointment-system

medical-appointment-system Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

medical-appointment-system

medical-appointment-system Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README