🩺 DocFy - Plataforma de Agendamento Médico Online

Projeto Final — Bootcamp Java Fullstack com Spring Boot (SoulCode + PagBank)

O DocFy é uma aplicação completa de agendamento de consultas médicas online, desenvolvida como projeto de conclusão do Bootcamp Java Fullstack da SoulCode em parceria com o PagBank.
Além do código, o grupo decidiu transformar essa experiência em uma simulação real de ambiente corporativo, com práticas ágeis, colaboração via GitHub e revisões de código entre colegas.

🚀 Sumário

1. Visão Geral
2. Tecnologias Utilizadas
3. Modelagem UML
4. Benchmark e Brainstorm
5. Prototipação no Figma — Telas de Login e Dashboards
6. Endpoints da API
7. Execução do Projeto
   • Pré-requisitos
   • Configuração do Banco de Dados
   • Executando o Backend
   • Executando o Frontend
   • Conexão Frontend ↔ Backend
8. Desafios e Aprendizados
9. Equipe

---

🩵 Visão Geral

O DocFy foi desenvolvido para conectar médicos e pacientes de forma simples, intuitiva e segura, permitindo que profissionais cadastrem seus horários e pacientes agendem, remarquem ou cancelem consultas online.

Principais funcionalidades:

• CRUD completo de Médico, Paciente e Consulta.
• Validação automática para impedir conflitos de horários (sem duplo agendamento).
• Login e autenticação básica.
• Agendamento, cancelamento e remarcação de consultas.
• Visualização de agendas e histórico.

🖼️ Principais Telas da Aplicação

🗂 Arquitetura em Camadas

Camada	Tecnologia Principal
🎨 Frontend	HTML, CSS, JavaScript
⚙️ API REST	Spring Boot
🗄️ Banco de Dados	MySQL

---

💻 Tecnologias Utilizadas

🧩 Backend

• Java 17
• Spring Boot
• Spring Data JPA / Hibernate
• Bean Validation (Jakarta)
• MySQL + XAMPP
• Eclipse IDE

🎨 Frontend

• HTML5
• CSS3
• JavaScript (ES6)
• Visual Studio Code

🛠️ Ferramentas de Apoio

• Git + GitHub — Versionamento e revisões de código
• Trello — Organização das tasks (Kanban)
• Milanote / Figma — Prototipagem e UI
• Postman — Testes dos endpoints REST

---

🧠 Modelagem UML

O diagrama atualizado considera relacionamentos bidirecionais entre Médico, Paciente e Consulta, refletindo o modelo de banco implementado.

---

🧠 Benchmark e Brainstorm

Durante a fase inicial do projeto, a equipe realizou um benchmarking para analisar referências de design e funcionalidades de plataformas de agendamento médico e telemedicina, observando boas práticas de UX/UI, layout responsivo e fluxos de agendamento.

Essas análises ajudaram a definir a estética limpa, o uso de cores suaves e a estrutura de navegação simples.

Paralelamente, foi conduzido um brainstorm criativo no Milanote, centralizando ideias de layout, telas de login, fluxos de usuário, logos e até mascotes. O objetivo foi construir uma identidade visual coesa, mantendo coerência entre paleta de cores, tipografia e tom comunicativo.

🔗 O board completo com o benchmark e brainstorm visual está disponível em: https://app.milanote.com/1V7xOv1arBiu1i?p=fP6ksYkBAoY

---

🎨 Prototipação no Figma — Telas de Login e Dashboards

Após o benchmark e brainstorm, a equipe utilizou o Figma para projetar as principais telas da aplicação DocFy, criando um protótipo interativo que reflete o fluxo real de uso do sistema.

As telas desenvolvidas incluem:

• 🔐 Tela de Login: foco na simplicidade e acessibilidade, com campos validados e feedback visual claro.
• 👩‍⚕️ Dashboard do Médico: exibe consultas agendadas, histórico e acesso rápido à agenda, facilitando a organização do profissional.
• 🧍‍♂️ Dashboard do Paciente: mostra consultas futuras, histórico médico e opções de cancelamento ou reagendamento com poucos cliques.

Esses protótipos ajudaram a equipe a visualizar o fluxo completo da aplicação, testar navegação, legibilidade e usabilidade antes da implementação, garantindo uma base sólida para o desenvolvimento das telas no front-end.

---

🌐 Endpoints da API

👩‍⚕️ MédicoController

Método	Endpoint	Descrição
GET	/medico/listar	Lista todos os médicos cadastrados
GET	/medico/{id}	Busca um médico pelo ID
POST	/medico/adicionar	Cadastra um novo médico
PUT	/medico/atualizar/{id}	Atualiza dados de um médico existente
DELETE	/medico/deletar/{id}	Remove um médico do sistema

---

🧍 PacienteController

Método	Endpoint	Descrição
GET	/docfy/paciente/listar	Lista todos os pacientes
GET	/docfy/paciente/{id}	Busca paciente por ID
POST	/docfy/paciente/adicionar	Cadastra um novo paciente
POST	/docfy/paciente/login	Realiza login de paciente
PUT	/docfy/paciente/atualizar/{id}	Atualiza os dados do paciente
DELETE	/docfy/paciente/deletar/{id}	Remove paciente do sistema

---

📅 ConsultaController

Método	Endpoint	Descrição
GET	/consulta/listar	Lista todas as consultas cadastradas
GET	/consulta/buscar/{cpf}	Busca todas as consultas de um paciente pelo CPF
POST	/consulta/adicionar	Agenda uma nova consulta
PUT	/consulta/remarcar/{id}	Permite remarcar uma consulta existente
DELETE	/consulta/cancelar/{id}	Cancela uma consulta específica

---

🕓 AgendaController

Método	Endpoint	Descrição
GET	/agenda/listar	Lista todas as agendas cadastradas
GET	/agenda/listar/id/{idMedico}	Lista horários dispon