Grupo 11:
- Pedro Ono - RM 354950
- Elton Xavier Souza - RM 354254
- Welder Ressutti - RM 354557
Desenvolvido por: Welder Ressutti
O microsserviço de gerenciamento de diagnósticos no Glicare é responsável por executar operações CRUD e processar eventos recebidos do broker, originados pelo microsserviço de resultados de exames.
A análise diagnóstica utiliza IA para determinar se o paciente precisa de um novo exame para controle ou de uma consulta médica para avaliação. O diagnóstico é registrado no banco de dados e eventos são enviados ao broker para que o microsserviço de agendamento processe a próxima etapa.
Os dados são armazenados em um banco PostgreSQL, com gerenciamento de migração de schemas via Flyway.
Além disso, exceções personalizadas são tratadas globalmente por Rest Controller Advice e Exception Handler, garantindo respostas padronizadas com timestamp, status code, error, message e path.
Importante: A funcionalidade de IA ainda não foi implementada neste MVP, mas faz parte do escopo do sistema.
- Recebe a mensagem do broker com o resultado do exame.
- Aplica as regras de negócio com base nos valores de referência e, com auxílio da IA, classifica o resultado como normal, alterado ou crítico.
- Registra o diagnóstico no banco de dados, incluindo ID do exame, ID do paciente, status do diagnóstico e data/hora.
- Encaminha a mensagem ao broker, direcionando para:
- Canal de agendamento de consulta, se o status for crítico.
- Canal de agendamento de exame, caso contrário.
✅ Normal: Abaixo de 5,7%
❌ Diabetes: 6,5% ou mais
Endpoint: /api/diagnosis
É realizado validação dos dados, ID do exame, ID do paciente, resultado do exame, status do diagnóstico (enum), todos são obrigatórios.
Endpoint: /api/diagnosis/{diagnosisId}
É realizado validação dos dados, ID do exame, ID do paciente, resultado do exame, status do diagnóstico (enum), todos são obrigatórios.
Endpoint: /api/diagnosis/{diagnosisId} /api/diagnosis
Pode ser obtido o diagnóstico pelo seu id. Também é possível obter todos os diagnósticos de uma vez.
Endpoint: /api/diagnosis/{diagnosisId}
Para deletar um diagnóstico basta passar seu id no endpoint.
- Java 17 – Linguagem de programação utilizada no desenvolvimento do sistema.
- Spring Web – Base para a construção das APIs RESTful do sistema.
- Spring Data JPA – Gerenciamento da persistência de dados e integração com o banco de dados.
- PostgreSQL – Banco de dados relacional utilizado para armazenar as informações do sistema.
- Spring Cloud – Conjunto de ferramentas para facilitar a arquitetura baseada em microsserviços.
- Spring Cloud Stream – Implementação de mensageria para comunicação assíncrona entre microsserviços via RabbitMQ.
- RabbitMQ – Message broker utilizado para integração assíncrona entre os microsserviços.
- Flyway – Controle de versionamento do banco de dados, garantindo migrações seguras.
- Spring Validation – Validação de dados recebidos nas requisições das APIs.
- Lombok – Redução de boilerplate no código, simplificando a criação de classes Java.
- Docker – Containerização dos microsserviços para facilitar o deploy e a escalabilidade.
A arquitetura hexagonal consiste na ideia de utilizar portas e adaptadores para realizar a integração entre a camada externa e interna, isolando o core da aplicação para que alterações externas não interfiram nas regras de negócio e casos de uso.
Este microsserviço foi desenvolvido seguindo os padrões de API RESTful, arquitetura hexagonal, e também respeitando os princípios SOLID de isolamento de responsabilidades.
A arquitetura desta aplicação foi desenvolvida da seguinte forma:
- Git (caso queira clonar o repositório, mas você pode apenas baixá-lo):
- Docker Desktop (para executar a aplicação através de containers):
Para clonar o repositório, use o comando:
git clone https://github.com/welderessutti/api-diagnosisCaso não queira clonar o repositório, você pode baixá-lo em GitHub.
No terminal, dentro do diretório raíz do projeto (local onde se encontra o arquivo compose.yaml da aplicação), execute o comando abaixo para subir todos os containers da aplicação:
docker compose up -dO Docker tentará baixar a imagem no repositório do Docker Hub, caso ele não encontre a imagem, ele realizará a build da aplicação (.jar), criará a imagem e executará os containers automaticamente.
Antes do container da aplicação subir, ele aguardará os containers do banco de dados PostgreSQL e do broker RabbitMQ estarem prontos utilizando um healthcheck, quando pronto, o container da aplicação inicia, realiza a migração do banco de dados e suas tabelas automaticamente utilizando o Flyway, estará disponível para receber os eventos do broker e poderá ser acessado em:
http://localhost:8080/api/diagnosis
As coleções de requisições do Postman e Insomnia estão disponíveis no diretório api-requests/
Se você deseja testar os endpoints da API, basta importar os arquivos de coleção no Postman ou Insomnia e executar as requisições conforme necessário.