Aura Reservas

Appearance

Requisitos de Interface ​

Esta seção descreve como o sistema interage com componentes e sistemas externos, incluindo APIs de pagamento, leitores de QR Code, dispositivos móveis e canais de comunicação. Esses requisitos garantem a interoperabilidade e a integração adequada do sistema com ferramentas externas essenciais para o funcionamento do parque.

🔄 1. Integração com Gateway de Pagamento ​

  • Objetivo: Permitir a finalização de reservas e compras de tickets por meio de transações eletrônicas seguras.
  • Interface: API RESTful segura (HTTPS).
  • Protocolos suportados: OAuth 2.0, Webhooks para notificações de pagamento.
  • Funções esperadas:
    • Criação de ordem de pagamento.
    • Redirecionamento para ambiente seguro do gateway.
    • Retorno com status da transação.
    • Geração de recibos e referência para liberação de ticket.
  • Exemplos de gateways compatíveis: Stripe, MercadoPago, Pagar.me, Gerencianet.

📩 2. Envio de Tickets e Confirmações ​

  • Objetivo: Informar ao cliente sobre sua reserva e fornecer os ingressos com QR Code.
  • Interface: API de e-mail e/ou mensageria.
  • Protocolos: SMTP, HTTP REST.
  • Canais Suportados:
    • E-mail (obrigatório).
    • WhatsApp ou SMS (opcional e configurável).
  • Conteúdo Enviado:
    • Dados da reserva.
    • Nome do serviço ou evento.
    • Data e hora.
    • QR Code individual por participante.

📷 3. Leitura de QR Code ​

  • Objetivo: Permitir a validação de ingressos na entrada do parque ou de eventos.
  • Interface: Navegador com permissão de acesso à câmera (PWA).
  • Tecnologia: Biblioteca JS para leitura de QR Codes (ex: html5-qrcode, zxing-js).
  • Funcionamento:
    • A câmera do dispositivo escaneia o QR Code.
    • O código é enviado para a API do sistema.
    • O sistema retorna o status: válido, já utilizado, inválido, ou fora da data/serviço.

🌐 Compatibilidade com Navegadores e Dispositivos ​

  • Objetivo: Garantir acessibilidade universal ao sistema.
  • Requisitos:
    • Suporte aos navegadores modernos: Chrome, Firefox, Safari, Edge.
    • Interface responsiva para funcionar em smartphones, tablets e desktops.
    • Funcionalidade offline limitada, conforme padrão PWA (armazenamento local, cache).

🧩 API Interna (RESTful) ​

  • Objetivo: Servir como ponte entre o front-end e o back-end.
  • Endpoints principais:
    • Autenticação e sessão.
    • Catálogo de serviços e eventos.
    • Processamento de reservas.
    • Geração e validação de QR Code.
    • Administração de usuários e relatórios.
  • Formato de dados: JSON
  • Segurança: Token JWT em cabeçalhos (Bearer)