Appearance
Componentes do Sistema
O Aura Reservas é composto por diversos módulos interligados que, juntos, suportam a operação completa de vendas, reservas, controle de acesso, administração e integração com serviços externos. Esses componentes são organizados em camadas funcionais para garantir escalabilidade, segurança e manutenibilidade.
🔧 1. Interface do Usuário (Front-End - PWA)
- Descrição: Camada de apresentação acessível via navegador, adaptada para uso em dispositivos móveis e desktops. Desenvolvida como Progressive Web App (PWA).
- Responsabilidades:
- Navegação pelos serviços e eventos disponíveis.
- Realização de compras e reservas.
- Acesso ao painel administrativo ou de leitura (conforme perfil).
- Visualização de tickets com QR Code.
🧠 2. Lógica de Negócio (Back-End / API)
- Descrição: Camada responsável por processar regras de negócio, orquestrar funcionalidades e conectar com o banco de dados.
- Responsabilidades:
- Gerenciar autenticação e controle de acesso (JWT, RBAC).
- Gerar, armazenar e validar QR Codes.
- Calcular regras de disponibilidade e preço.
- Processar pedidos e emitir confirmações.
🗄️ 3. Banco de Dados
- Descrição: Armazena todas as entidades do sistema, como usuários, reservas, eventos, serviços, preços, pagamentos e registros de entrada.
- Modelo: Relacional, estruturado com base no schema Prisma já definido.
🔐 4. Sistema de Autenticação e Sessões
- Descrição: Módulo responsável pela segurança de acesso à aplicação, garantindo que usuários acessem apenas as funcionalidades permitidas.
- Funcionalidades:
- Login com JWT.
- Controle de sessão.
- Diferenciação por papéis de usuário.
💳 5. Integração com Pagamento
- Descrição: Serviço externo que processa as transações financeiras.
- Responsabilidades:
- Processamento de pagamentos via cartão ou PIX.
- Confirmação automática de pagamento.
- Notificação do sistema para liberação dos tickets.
- Tecnologia sugerida: API de gateway como Stripe, MercadoPago ou Pagar.me.
📤 6. Módulo de Envio de Tickets
- Descrição: Responsável pelo envio automático de tickets com QR Codes após a compra.
- Canais Possíveis: E-mail (obrigatório), WhatsApp ou SMS (opcional).
- Funcionalidades:
- Template de ticket.
- Geração de PDF ou visualização web.
- QR Code embutido.
📷 7. Leitor de QR Code (Check-in)
- Descrição: Interface simplificada para porteiros, permitindo validação de ingressos com QR Code em tempo real.
- Funcionalidades:
- Acesso com perfil de "Porteiro".
- Leitura com câmera do dispositivo.
- Feedback visual: "Válido", "Já utilizado", "Inválido".
- Registro automático de entrada no banco de dados.