GestãoHVU

Sistema de gestão de consultas e atendimentos clínicos veterinários do HVU — UFAPE

---

Descrição

O GestãoHVU é um sistema web desenvolvido pelo LMTS (Laboratório Multidisciplinar de Tecnologias Sociais) da UFAPE (Universidade Federal do Agreste de Pernambuco), no âmbito de um projeto de extensão em parceria com o HVU (Hospital Veterinário Universitário).

A plataforma tem como objetivo digitalizar e organizar os processos de gestão de consultas e atendimentos clínicos de animais do HVU, integrando diferentes perfis de usuário em um único sistema: tutores, médicos veterinários, secretários, patologistas e o administrador do LAPA.

Com o sistema, é possível realizar o cadastro e acompanhamento de animais e seus responsáveis, o agendamento e registro de consultas clínicas, o gerenciamento de laudos e análises laboratoriais pelo LAPA, além do controle administrativo de todo o fluxo hospitalar veterinário.

Perfis de acesso

Perfil	Descrição
Tutor	Responsável pelo animal; pode cadastrar seus animais e acompanhar atendimentos
Médico	Realiza e registra consultas e atendimentos clínicos
Secretário	Gerencia agendamentos e fluxo de atendimento
Patologista	Responsável pelas análises do LAPA; cadastra animais e laudos laboratoriais
Administrador LAPA	Administra o sistema e os usuários do laboratório

---

Tecnologias Utilizadas

Backend

• Java
• Spring Boot
• Spring Web
• Spring Data JPA
• PostgreSQL
• Flyway (migrações de banco de dados)
• Keycloak

Frontend

• JavaScript
• React
• HTML5
• CSS3

Ferramentas e práticas

• Git
• GitHub
• Conventional Commits
• Pull Requests com revisão obrigatória
• GitFlow
• Docker
• Docker Compose

---

Instalação e Execução

Pré-requisitos

• Docker
• Docker Compose
• Git

Verifique:

docker --version
docker compose version

---

Ambiente de Desenvolvimento

No ambiente de desenvolvimento utilizamos Docker Compose.

Subindo a aplicação

Na raiz do projeto:

docker compose up -d --build

Isso irá:

• Construir as imagens
• Subir o backend (Spring Boot)
• Subir o frontend (React)
• Subir o PostgreSQL
• Executar as migrações Flyway automaticamente

URLs locais

Frontend:

http://localhost:3000

Backend:

http://localhost:8081

Keycloak:

http://localhost:8080

---

Guia de Contribuição

O projeto segue um fluxo de contribuição organizado, utilizando boas práticas de versionamento e colaboração em equipe.

Organização da equipe e tarefas

A equipe utiliza o GitHub Projects (Quadro Scrum) para organização e acompanhamento do desenvolvimento:

• Funcionalidades, correções e melhorias são registradas como Issues no repositório
• Cada issue é adicionada ao quadro e atribuída a um integrante da equipe
• O progresso é acompanhado pelas colunas: To Do, In Progress e Done
• Commits e Pull Requests referenciam ou encerram as issues relacionadas (Closes #id ou Related to #id)

Fluxo de versionamento

• Cada integrante trabalha em um branch dedicado ou fork do repositório

• Todas as alterações são realizadas por meio de Pull Requests
• Cada Pull Request exige:
  • uso do padrão Conventional Commits
  • no mínimo 1 revisor
  • resolução de todos os comentários antes do merge

Padrão de commit

tipo(escopo): descrição curta

Exemplos:

feat(animal): adicionar cadastro de animal por patologista

- Implementado endpoint POST /animais/patologista
- Adicionada validação de origem LAPA
- Criado AnimalByPatologistaRequest DTO

Related to #42

fix(tutor): corrigir payload de tutor anônimo no frontend

- Campo anonimo movido para raiz do request
- Removido useState dentro de handleSubmit

Closes #57