Clinic Appointment Scheduling System

Sistema de agendamento de consultas para clínicas médicas desenvolvido com React, FastAPI e MongoDB.

🏥 Sobre o Projeto

Este sistema foi desenvolvido para otimizar o processo de agendamento de consultas em clínicas médicas, oferecendo:

• 📅 Gestão completa de agendamentos
• 📊 Importação de dados via Excel
• 📄 Geração de relatórios em PDF
• 👥 Controle de acesso baseado em funções (RBAC)
• 🔍 Filtros avançados e busca inteligente

🚀 Tecnologias

Backend

• Python 3.11 com FastAPI
• MongoDB 6.0 para persistência de dados
• JWT para autenticação
• Clean Architecture para organização do código

Frontend

• React 18 com TypeScript
• Vite para build rápido
• Tailwind CSS para estilização
• TanStack Query para gerenciamento de estado

DevOps

• Docker e Docker Compose
• GitHub Actions para CI/CD
• Prometheus e Grafana para monitoramento

📋 Pré-requisitos

• Docker e Docker Compose
• Node.js 18+ (para desenvolvimento local)
• Python 3.11+ (para desenvolvimento local)
• Git

🛠️ Instalação e Configuração

1. Clone o repositório

git clone https://github.com/seu-usuario/clinic-appointment.git
cd clinic-appointment

2. Configure as variáveis de ambiente

# Copie os arquivos de exemplo
cp .env.example .env
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

3. Inicie com Docker

# Construa e inicie todos os serviços
docker-compose up --build

# Ou em modo detached
docker-compose up -d

4. Acesse a aplicação

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs
• MongoDB Express: http://localhost:8081

🔧 Desenvolvimento Local

Backend

cd backend

# Crie um ambiente virtual
python -m venv venv
source venv/bin/activate  # No Windows: venv\Scripts\activate

# Instale as dependências
pip install -r requirements.txt

# Execute o servidor
uvicorn src.main:app --reload

Frontend

cd frontend

# Instale as dependências
npm install

# Execute o servidor de desenvolvimento
npm run dev

📚 Documentação

• Guia de Desenvolvimento
• Arquitetura do Sistema
• Plano de Implementação
• API Documentation

🧪 Testes

Backend

cd backend
pytest

Frontend

cd frontend
npm test

End-to-End

cd tests
npm run e2e

📦 Build para Produção

# Build das imagens Docker
docker-compose -f docker-compose.prod.yml build

# Deploy
docker-compose -f docker-compose.prod.yml up -d

🤝 Contribuindo

Leia nosso Guia de Contribuição para detalhes sobre nosso código de conduta e processo de submissão de pull requests.

📄 Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.

👥 Equipe

• Bruno - Desenvolvedor Principal

📞 Suporte

Para suporte, envie um email para suporte@clinicapp.com.br ou abra uma issue no GitHub.

---

Desenvolvido com ❤️ para melhorar o atendimento em clínicas médicas brasileiras.