jmessias1984/sistemadeconvite

📋 Sistema de Confirmação de Convites

🎯 Sistema web completo para gestão de eventos e confirmação de presença

📥 Instalação • 🎥 Demo • 📖 Documentação • 🚀 Deploy

---

🎉 Sobre o Projeto

O Sistema de Confirmação de Convites é uma aplicação web moderna que permite a organizadores criar eventos, gerar links personalizados para convidados e acompanhar confirmações em tempo real.

✨ Características Principais

• 🔐 Multi-usuário - Sistema completo de autenticação
• 🎨 Interface Moderna - Design responsivo com Shadcn/UI
• 📱 Mobile-First - Funciona em todos os dispositivos
• 🔗 Links Únicos - Cada convidado recebe link personalizado
• 📊 Analytics - Dashboard com estatísticas em tempo real
• 📥 Export CSV - Relatórios completos

---

🚀 Funcionalidades

🔑 Autenticação Cadastro seguro com validação Login com JWT tokens Proteção de rotas Hash de senhas (bcrypt) 📅 Gestão de Eventos Criação completa de eventos Lista de convidados Links personalizados Dashboard por usuário

💌 Sistema de Convites Links únicos por convidado Interface responsiva Login simples com telefone Prevenção de duplicações 📊 Relatórios Estatísticas em tempo real Taxa de confirmação Lista detalhada Export CSV completo

---

🛠️ Tecnologias

Backend

Frontend

---

📸 Screenshots

🏠 Página Inicial

Sistema com opções de login e cadastro

📊 Dashboard do Usuário

Dashboard personalizado com estatísticas e gestão de eventos

✅ Confirmação de Presença

Interface responsiva para confirmação de convidados

---

🚀 Instalação

📋 Pré-requisitos

Python 3.11+    # Backend
Node.js 18+     # Frontend
MongoDB 6.0+    # Banco de dados
Yarn           # Gerenciador de pacotes

⚡ Instalação Rápida

# 1. Clone o repositório
git clone https://github.com/seu-usuario/sistema-confirmacao-convites.git
cd sistema-confirmacao-convites

# 2. Instalação automática
chmod +x install.sh
./install.sh

# 3. Configurar ambiente (opcional)
cp .env.example backend/.env
cp .env.example frontend/.env

# 4. Iniciar sistema
chmod +x start.sh
./start.sh

🌐 Acessar Sistema

• Frontend: http://localhost:3000
• Backend API: http://localhost:8001
• Docs API: http://localhost:8001/docs

---

🎮 Como Usar

👤 Para Organizadores

1. Criar conta e fazer login
2. Criar evento com dados completos
3. Copiar links personalizados
4. Enviar via WhatsApp para convidados
5. Acompanhar confirmações no dashboard
6. Baixar relatório em CSV

👥 Para Convidados

1. Receber link via WhatsApp
2. Clicar no link personalizado
3. Ver detalhes do evento
4. Confirmar presença com telefone
5. Receber confirmação visual

---

📚 API Documentation

🔐 Endpoints de Autenticação

Registrar Usuário

POST /api/register
{
  "name": "João Silva",
  "email": "joao@email.com",
  "password": "123456"
}

Login

POST /api/login
{
  "email": "joao@email.com",
  "password": "123456"
}

📅 Endpoints de Eventos

Criar Evento

POST /api/events
Authorization: Bearer {token}
{
  "name": "Meu Evento",
  "date": "2024-12-25",
  "time": "18:00",
  "location": "Local do Evento",
  "guest_names": ["Ana", "Pedro"]
}

Listar Eventos

GET /api/user/events
Authorization: Bearer {token}

💌 Endpoints de Confirmação

Confirmar Presença

POST /api/events/{event_id}/guest/{guest_id}/confirm
{
  "phone": "(11) 99999-9999"
}

Download CSV

GET /api/events/{event_id}/csv
Authorization: Bearer {token}

---

🚀 Deploy

☁️ Opções de Deploy

🐳 Docker (Recomendado)

# docker-compose.yml
version: '3.8'
services:
  backend:
    build: ./backend
    ports: ["8001:8001"]
    depends_on: [mongodb]
  
  frontend:
    build: ./frontend
    ports: ["3000:80"]
  
  mongodb:
    image: mongo:6
    ports: ["27017:27017"]

☁️ Cloud Deploy

1. Frontend (Vercel): vercel --prod
2. Backend (Heroku): git push heroku main
3. Database (MongoDB Atlas): Configure cluster

---

🧪 Testes

✅ Executar Testes

# Backend
cd backend && python -m pytest

# Frontend  
cd frontend && yarn test

📋 Cobertura de Testes

• Autenticação (registro/login)
• CRUD de eventos
• Confirmação de convidados
• Dashboard e estatísticas
• Export CSV
• Responsividade

---

🤝 Contribuição

🛠️ Como Contribuir

1. Fork o projeto
2. Crie uma branch (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -m 'Add: nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

📝 Padrões

• Commits: Conventional Commits
• Code Style: Prettier + ESLint (Frontend), Black + Flake8 (Backend)
• Branches: feature/, bugfix/, hotfix/

---

🎯 Roadmap

🚀 Próximas Funcionalidades

• 📧 Notificações automáticas por email
• 📱 API WhatsApp integration
• 🎨 Temas personalizáveis
• 📊 Analytics avançados
• 🌍 Internacionalização (i18n)
• 📅 Integração com calendários

🐛 Melhorias Planejadas

• 🚀 Otimizações de performance
• 🔒 Autenticação 2FA
• 🎨 Melhorias de UI/UX
• 📱 Progressive Web App (PWA)

---

📞 Suporte

🆘 Precisa de Ajuda?

• 📖 Documentação: Consulte este README
• 🐛 Bug Reports: Abra uma issue no GitHub
• 💡 Feature Requests: Use GitHub Discussions
• 📧 Contato Direto: contato@sistema-convites.com

---

📄 Licença

Este projeto está licenciado sob a MIT License. Veja o arquivo LICENSE para mais detalhes.

---

🏆 Reconhecimentos

🙏 Agradecimentos Especiais

• FastAPI - Framework web moderno
• React - Biblioteca de UI
• Shadcn/UI - Componentes elegantes
• MongoDB - Banco de dados flexível
• Tailwind CSS - Framework CSS utilitário

---

⭐ Se este projeto foi útil, considere dar uma estrela!

🚀 Sistema de Confirmação de Convites

Desenvolvido com ❤️ para facilitar a organização de eventos

---

Este projeto está em constante evolução. Contribuições são sempre bem-vindas!