🏥 Sistema de Agendamento Médico - Backend

API RESTful para gerenciamento de consultas médicas, desenvolvida com Node.js, Express, TypeScript e Prisma ORM.

📋 Índice

Sobre o Projeto
Tecnologias
Funcionalidades
Arquitetura
Pré-requisitos
Instalação
Configuração
Execução
Estrutura do Projeto
API Endpoints
Banco de Dados
Segurança
Scripts Disponíveis
Contribuindo

🎯 Sobre o Projeto

Sistema completo para gerenciamento de consultas médicas que permite:

Cadastro e autenticação de usuários (Médicos, Pacientes e Administradores)
Gerenciamento de especialidades médicas
Controle de agenda de médicos com slots de horários
Agendamento e gestão de consultas
Sistema de permissões baseado em perfis

🚀 Tecnologias

Core

Node.js - Ambiente de execução JavaScript
TypeScript - Superset JavaScript com tipagem estática
Express 5 - Framework web minimalista

Database & ORM

Prisma - ORM moderno para Node.js e TypeScript
MySQL - Sistema de gerenciamento de banco de dados

Segurança

Helmet - Headers de segurança HTTP
CORS - Controle de acesso entre origens
bcryptjs - Hash de senhas
jsonwebtoken - Autenticação JWT
express-rate-limit - Limitação de requisições

Validação & Logging

Zod - Validação de schemas TypeScript-first
Pino - Logger de alta performance

DevOps

tsx - Executor TypeScript para desenvolvimento
ts-node - Executor TypeScript
dotenv - Gerenciamento de variáveis de ambiente

✨ Funcionalidades

Autenticação e Autorização

✅ Login com email e senha
✅ Geração de tokens JWT
✅ Middleware de autenticação
✅ Sistema de permissões por perfil (ADMIN, MEDICO, PACIENTE)

Gestão de Usuários

✅ Cadastro de médicos e pacientes
✅ Atualização de perfis
✅ Ativação/desativação de contas

Especialidades

✅ CRUD completo de especialidades médicas
✅ Associação de múltiplas especialidades a médicos

Agenda Médica

✅ Criação de slots de horários disponíveis
✅ Visualização de agenda por médico
✅ Filtros por data e especialidade
✅ Controle de status dos slots (DISPONIVEL, OCUPADO, BLOQUEADO)

Consultas

✅ Agendamento de consultas
✅ Visualização de consultas por paciente/médico
✅ Cancelamento de consultas
✅ Atualização de status (AGENDADA, REALIZADA, CANCELADA)

🏗️ Arquitetura

O projeto segue uma arquitetura em camadas:

┌─────────────────────────────────────┐
│         Routes (Rotas)              │
├─────────────────────────────────────┤
│      Middlewares (Validação)        │
├─────────────────────────────────────┤
│     Controllers (Lógica)            │
├─────────────────────────────────────┤
│    Prisma ORM (Acesso a Dados)     │
├─────────────────────────────────────┤
│         MySQL Database              │
└─────────────────────────────────────┘

Padrões Utilizados

MVC Pattern - Separação de responsabilidades
Middleware Pattern - Processamento em cadeia
Repository Pattern - Abstração de acesso a dados via Prisma
Dependency Injection - Injeção de dependências

📦 Pré-requisitos

Antes de começar, certifique-se de ter instalado:

Node.js (versão 18 ou superior)
npm ou yarn
MySQL (versão 8 ou superior)
Git

🔧 Instalação

Clone o repositório

git clone https://github.com/enriconovellino/ProjDevWebBack.git
cd ProjDevWebBack

Instale as dependências

npm install

⚙️ Configuração

Crie o arquivo .env na raiz do projeto:

# Database
DATABASE_URL="mysql://usuario:senha@localhost:3306/nome_do_banco"

# Server
PORT=3000
NODE_ENV=development

# JWT
JWT_SECRET=seu_segredo_super_secreto_aqui_min_32_caracteres
JWT_EXPIRES_IN=7d

# CORS (opcional)
CORS_ORIGIN=http://localhost:3000

Configure o banco de dados

Crie o banco de dados MySQL:

CREATE DATABASE nome_do_banco CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Execute as migrations

npm run prisma:migrate

Execute o seed (opcional) - Popula o banco com dados iniciais:

npm run prisma:seed

🚀 Execução

Modo Desenvolvimento

npm run dev

O servidor estará disponível em http://localhost:3000

Modo Produção

# Build
npm run build

# Start
npm start

Health Check

Verifique se o servidor está rodando:

curl http://localhost:3000/health

📁 Estrutura do Projeto

ProjDevWebBack/
├── controllers/          # Lógica de negócio
│   ├── agenda.controller.ts
│   ├── auth.controller.ts
│   ├── consulta.controller.ts
│   ├── especialidade.controller.ts
│   ├── medico.controller.ts
│   └── paciente.controller.ts
├── middlewares/          # Middlewares da aplicação
│   ├── auth.middleware.ts
│   ├── authorization.middleware.ts
│   ├── errorHandler.middleware.ts
│   └── validation.middleware.ts
├── routes/              # Definição de rotas
│   ├── index.ts
│   ├── agenda.route.ts
│   ├── auth.route.ts
│   ├── consulta.route.ts
│   ├── especialidade.route.ts
│   ├── medico.route.ts
│   └── paciente.route.ts
├── validations/         # Schemas de validação Zod
│   ├── agenda.validation.ts
│   ├── auth.validation.ts
│   ├── consulta.validation.ts
│   ├── especialidade.validation.ts
│   ├── medico.validation.ts
│   ├── paciente.validation.ts
│   └── pagination.validation.ts
├── utils/              # Utilitários
│   ├── jwt.util.ts
│   ├── logger.util.ts
│   └── prisma.util.ts
├── types/              # Definições TypeScript
│   └── express/
│       └── index.d.ts
├── prisma/             # Prisma ORM
│   ├── schema.prisma   # Schema do banco de dados
│   ├── seed.ts        # Dados iniciais
│   └── migrations/    # Histórico de migrations
├── server.ts          # Ponto de entrada da aplicação
├── package.json
└── tsconfig.json

🌐 API Endpoints

Base URL

http://localhost:3000/api

Autenticação

`POST /api/auth/login`

Realiza login e retorna token JWT

Request Body:

{
  "email": "[email protected]",
  "senha": "senha123"
}

Response:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "usuario": {
    "id": 1,
    "email": "[email protected]",
    "nome": "Nome do Usuário",
    "perfil": "PACIENTE"
  }
}

Médicos

`GET /api/medicos`

Lista todos os médicos (requer autenticação)

Query Parameters:

page (opcional): Número da página (padrão: 1)
limit (opcional): Itens por página (padrão: 10)
especialidade_id (opcional): Filtrar por especialidade

Headers:

Authorization: Bearer <token>

`POST /api/medicos`

Cria um novo médico (requer perfil ADMIN)

Request Body:

{
  "nome": "Dr. João Silva",
  "email": "[email protected]",
  "senha": "senha123",
  "cpf": "12345678900",
  "crm": "12345-SP",
  "telefone": "(11) 98765-4321",
  "duracao_minutos": 30,
  "especialidades": [1, 2]
}

`GET /api/medicos/:id`

Busca um médico por ID

`PUT /api/medicos/:id`

Atualiza um médico (requer perfil ADMIN ou ser o próprio médico)

`DELETE /api/medicos/:id`

Desativa um médico (requer perfil ADMIN)

Pacientes

`GET /api/pacientes`

Lista todos os pacientes (requer perfil ADMIN)

`POST /api/pacientes`

Cria um novo paciente

Request Body:

{
  "nome": "Maria Santos",
  "email": "[email protected]",
  "senha": "senha123",
  "cpf": "98765432100",
  "telefone": "(11) 91234-5678",
  "data_nascimento": "1990-05-15"
}

`GET /api/pacientes/:id`

Busca um paciente por ID

`PUT /api/pacientes/:id`

Atualiza um paciente

`DELETE /api/pacientes/:id`

Desativa um paciente

Especialidades

`GET /api/especialidades`

Lista todas as especialidades

`POST /api/especialidades`

Cria uma nova especialidade (requer perfil ADMIN)

Request Body:

{
  "nome": "Cardiologia",
  "codigo": "CARDIO"
}

`PUT /api/especialidades/:id`

Atualiza uma especialidade (requer perfil ADMIN)

`DELETE /api/especialidades/:id`

Desativa uma especialidade (requer perfil ADMIN)

Agenda

`GET /api/agenda/medico/:medicoId`

Lista slots de agenda de um médico

Query Parameters:

data_inicio: Data inicial (ISO 8601)
data_fim: Data final (ISO 8601)
status: Filtrar por status (DISPONIVEL, OCUPADO, BLOQUEADO)

`POST /api/agenda/slots`

Cria slots de horários para um médico (requer perfil MEDICO ou ADMIN)

Request Body:

{
  "medico_id": 1,
  "data_inicio": "2025-11-10T08:00:00Z",
  "data_fim": "2025-11-10T18:00:00Z",
  "duracao_minutos": 30
}

`PUT /api/agenda/slots/:id`

Atualiza um slot (requer perfil MEDICO ou ADMIN)

`DELETE /api/agenda/slots/:id`

Remove um slot (requer perfil MEDICO ou ADMIN)

Consultas

`GET /api/consultas`

Lista consultas (filtradas por perfil)

Query Parameters:

status: Filtrar por status (AGENDADA, REALIZADA, CANCELADA)
data_inicio: Data inicial
data_fim: Data final

`POST /api/consultas`

Agenda uma nova consulta

Request Body:

{
  "paciente_id": 1,
  "medico_id": 2,
  "agenda_slot_id": 5
}

`GET /api/consultas/:id`

Busca uma consulta por ID

`PUT /api/consultas/:id/status`

Atualiza o status de uma consulta

Request Body:

{
  "status": "REALIZADA"
}

`DELETE /api/consultas/:id`

Cancela uma consulta

🗄️ Banco de Dados

Modelos Principais

Usuario

Armazena dados de autenticação e perfil
Relacionamento 1:1 com Medico ou Paciente

Medico

Dados específicos de médicos (CRM, duração de consulta)
Relacionamento N:N com Especialidade

Paciente

Dados específicos de pacientes (data de nascimento)

Especialidade

Especialidades médicas disponíveis
Relacionamento N:N com Medico

AgendaSlot

Slots de horários na agenda dos médicos
Controle de disponibilidade

Consulta

Registro de consultas agendadas
Relaciona Paciente, Médico e AgendaSlot

Diagrama ER Simplificado

┌──────────┐     1:1     ┌─────────┐     N:N     ┌────────────────┐
│ Usuario  │────────────▶│ Medico  │◀───────────▶│ Especialidade  │
└──────────┘             └─────────┘             └────────────────┘
     │                        │                           
     │ 1:1                    │ 1:N                       
     │                        │                           
     ▼                        ▼                           
┌──────────┐             ┌─────────────┐                 
│ Paciente │             │ AgendaSlot  │                 
└──────────┘             └─────────────┘                 
     │                        │                           
     │         N:1            │ 1:1                       
     └───────────▶┌──────────┐◀───────                   
                  │ Consulta │                            
                  └──────────┘

🔐 Segurança

Medidas Implementadas

Autenticação JWT
- Tokens com expiração configurável
- Validação em todas as rotas protegidas
Autorização por Perfil
- ADMIN: Acesso total
- MEDICO: Gerencia própria agenda e consultas
- PACIENTE: Visualiza e agenda próprias consultas
Hash de Senhas
- Utilização de bcryptjs com salt rounds
Rate Limiting
- Limite de 100 requisições por IP a cada 15 minutos
Helmet
- Headers de segurança HTTP configurados
CORS
- Controle de origens permitidas
Validação de Dados
- Validação com Zod em todas as entradas

Boas Práticas

✅ Nunca commitar o arquivo .env
✅ Usar senhas fortes para JWT_SECRET
✅ Implementar HTTPS em produção
✅ Manter dependências atualizadas
✅ Realizar backups regulares do banco de dados

📜 Scripts Disponíveis

# Desenvolvimento
npm run dev                 # Inicia o servidor em modo watch

# Build
npm run build              # Compila TypeScript para JavaScript

# Produção
npm start                  # Inicia o servidor compilado

# Prisma
npm run prisma:migrate     # Executa migrations do Prisma
npm run prisma:seed        # Popula banco com dados iniciais
npx prisma studio          # Abre interface visual do banco
npx prisma generate        # Gera o Prisma Client

🧪 Testes

Para testar a API, você pode usar:

Postman - [Collection disponível]
Insomnia - Cliente REST
curl - Linha de comando
Thunder Client - Extensão do VS Code

Exemplo de Teste com curl

# Health Check
curl http://localhost:3000/health

# Login
curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","senha":"admin123"}'

# Listar Médicos (com autenticação)
curl http://localhost:3000/api/medicos \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

🤝 Contribuindo

Contribuições são bem-vindas! Para contribuir:

Faça um fork do projeto
Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
Push para a branch (git push origin feature/MinhaFeature)
Abra um Pull Request

Padrões de Código

Use TypeScript para todo código novo
Siga as convenções do ESLint/Prettier (se configurados)
Documente funções complexas
Escreva commits descritivos

📝 Licença

Este projeto está sob a licença ISC.

👥 Autores

Enrico Novellino e Gigio Moura Melo - GitHub

📞 Contato

Para dúvidas ou sugestões:

Abra uma issue
Entre em contato via e-mail

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
controllers		controllers
middlewares		middlewares
prisma		prisma
routes		routes
types/express		types/express
utils		utils
validations		validations
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
prisma.config.ts		prisma.config.ts
server.ts		server.ts
tsconfig.json		tsconfig.json
vercel.json		vercel.json

enriconovellino/ProjDevWebBack

Folders and files

Latest commit

History

Repository files navigation

🏥 Sistema de Agendamento Médico - Backend

📋 Índice

🎯 Sobre o Projeto

🚀 Tecnologias

Core

Database & ORM

Segurança

Validação & Logging

DevOps

✨ Funcionalidades

Autenticação e Autorização

Gestão de Usuários

Especialidades

Agenda Médica

Consultas

🏗️ Arquitetura

Padrões Utilizados

📦 Pré-requisitos

🔧 Instalação

⚙️ Configuração

🚀 Execução

Modo Desenvolvimento

Modo Produção

Health Check

📁 Estrutura do Projeto

🌐 API Endpoints

Base URL

Autenticação

POST /api/auth/login

Médicos

GET /api/medicos

POST /api/medicos

GET /api/medicos/:id

PUT /api/medicos/:id

DELETE /api/medicos/:id

Pacientes

GET /api/pacientes

POST /api/pacientes

GET /api/pacientes/:id

PUT /api/pacientes/:id

DELETE /api/pacientes/:id

Especialidades

GET /api/especialidades

POST /api/especialidades

PUT /api/especialidades/:id

DELETE /api/especialidades/:id

Agenda

GET /api/agenda/medico/:medicoId

POST /api/agenda/slots

PUT /api/agenda/slots/:id

DELETE /api/agenda/slots/:id

Consultas

GET /api/consultas

POST /api/consultas

GET /api/consultas/:id

PUT /api/consultas/:id/status

DELETE /api/consultas/:id

🗄️ Banco de Dados

Modelos Principais

Usuario

Medico

Paciente

Especialidade

AgendaSlot

Consulta

Diagrama ER Simplificado

🔐 Segurança

Medidas Implementadas

Boas Práticas

📜 Scripts Disponíveis

🧪 Testes

Exemplo de Teste com curl

🤝 Contribuindo

Padrões de Código

📝 Licença

`POST /api/auth/login`

`GET /api/medicos`

`POST /api/medicos`

`GET /api/medicos/:id`

`PUT /api/medicos/:id`

`DELETE /api/medicos/:id`

`GET /api/pacientes`

`POST /api/pacientes`

`GET /api/pacientes/:id`

`PUT /api/pacientes/:id`

`DELETE /api/pacientes/:id`

`GET /api/especialidades`

`POST /api/especialidades`

`PUT /api/especialidades/:id`

`DELETE /api/especialidades/:id`

`GET /api/agenda/medico/:medicoId`

`POST /api/agenda/slots`

`PUT /api/agenda/slots/:id`

`DELETE /api/agenda/slots/:id`

`GET /api/consultas`

`POST /api/consultas`

`GET /api/consultas/:id`

`PUT /api/consultas/:id/status`

`DELETE /api/consultas/:id`

Packages