EventFlow

Reescrita Estratégica · v2.0

Plataforma de gestão e operação de cerimônias de premiação empresarial — agora com arquitetura robusta, tempo real e modo offline.

Stack: Laravel 13 + PostgreSQL 16
Stack OSS: Valkey · MinIO · React
Foco: Reuso · Escala · Offline

REALE TECH · APRESENTAÇÃO À DIRETORIA

CONTEXTO

O que é o EventFlow

Sistema completo para gerenciar cerimônias de premiação empresarial — do cadastro pré-evento à projeção no telão, do check-in dos convidados à pesquisa de satisfação.

Pré-evento

Cadastro de empresas, categorias, mesas, vouchers, logos e vídeos. Importação em lote por JSON ou CSV.

Operação ao vivo

Recepção, apresentadores, controle do telão e projeção sincronizados em tempo real durante a cerimônia.

Pós-evento

Pesquisa de satisfação por mesa, relatórios de chegada e ganhadores, backup completo, métricas.

        Caso de uso piloto:
        Melhores do Ano Valença — 222 categorias, ~200 empresas, ~1.500 convidados.
      

SITUAÇÃO ATUAL

Onde estamos hoje — v1

FUNCIONA, MAS…

Persistência em arquivos JSON — sem ACID, sem índices, sem concorrência segura.
Polling agressivo a cada 2–5 segundos para "tempo real" — gera carga linear nas telas.
Singletenant — um único evento ativo por instalação.
Sem perfis — admin é "tudo ou nada", sem segregação de funções.
Sem auditoria de quem fez o quê.
Não funciona offline — depende totalmente de conexão estável.
Senhas e chaves hardcoded em código.
Não suporta subdiretório — URLs absolutas acopladas ao domínio raiz.

NÚMEROS DA V1

8.4k

Linhas PHP

222

Categorias

7

Telas

5

Endpoints API

A v1 cumpriu o propósito de validar o produto. Agora precisamos de uma base que suporte crescer com clientes, integrar com mais canais e operar de forma confiável em qualquer rede.

MOTIVAÇÃO

Por que reescrever agora

01

Confiabilidade em produção

Banco de dados real, transações ACID, replicação. Backup contínuo. Tolerância a falhas. Cerimônia ao vivo não admite "o sistema travou".

02

Escala comercial

Multi-tenant para vender o EventFlow como SaaS para cerimônias de outras associações comerciais e prêmios empresariais.

03

Operação offline

Logos e vídeos precisam funcionar mesmo sem internet — preocupação concreta de quem opera em interior, hotéis ou salões com Wi-Fi instável.

04

Tempo real de verdade

WebSocket no lugar de polling — latência abaixo de 100 ms, menos carga, mais responsivo, multi-telão sincronizado.

TECNOLOGIA

Stack v2

Tudo escolhido para ser maduro, abundante em mercado, compatível com Aurora e produtivo para nosso time.

Backend

PHP 8.3 + Laravel 13 (LTS). Eloquent, FormRequests, Policies, Queues.

Laravel 13 PHP 8.3

Banco de dados

PostgreSQL 16, compatível com Amazon Aurora. JSONB, gen_random_uuid, índices parciais.

PostgreSQL 16 Aurora-ready

Tempo real

Laravel Reverb (WebSocket nativo). Broadcast de eventos para todas as telas.

Reverb WebSocket

Frontend

Inertia + React 19 com TypeScript. Tailwind + shadcn/ui. Lucide. PWA com Service Worker.

React 19 TypeScript Tailwind PWA

Infraestrutura

Valkey (cache, sessões, filas), MinIO S3-compatible (mídia), workers para conversão de imagem e backup.

Valkey MinIO

Segurança

Sanctum/Fortify, CSRF, rate limiting, reauth para operações sensíveis, audit log.

Sanctum Activity Log

VISÃO TÉCNICA

Arquitetura em camadas

Separação clara entre apresentação, domínio e infraestrutura. Eventos de domínio fazem a cola via broadcast.

APRESENTAÇÃO

/admin (painel) /recepcao (PWA) /apresentadores /telao + /controle /convidado (voucher)

APLICAÇÃO

EventService CompanyService ScreenService WelcomeQueueService VoucherService SurveyService

INFRAESTRUTURA

PostgreSQL 16 Valkey (cache + queue) MinIO (mídia S3) Reverb (broadcast) Workers (jobs)

        Princípio:
        Domínio de eventos cerimoniais isolado da infra. Trocar Reverb por Pusher, ou Postgres por Aurora, não toca a camada de domínio.
      

PARIDADE COM A V1

Funcionalidades core preservadas

Tudo o que a v1 já faz hoje, replicado e melhorado.

Cadastro de empresasLogo, vídeo, mesa, cota, categorias, voucher

Cadastro de categoriasNumeradas, codificadas, ordenáveis

Voucher impresso com QR CodeAcesso à tela do convidado por scan ou código

Recepção / check-inConfirmação de presença com busca rápida

Tela dos apresentadoresLista ordenada por cota e chegada, com observações

Controle do telãoOperador escolhe o que projetar em cada momento

Telão (projeção)5 layouts: espera, empresa, vídeo, slide, boas-vindas

Slides especiaisImagem ou vídeo avulso, fixáveis na fila

Pesquisa de satisfação6 critérios em estrelas, limite por mesa

Backup e restauraçãoSnapshot completo + download em ZIP

NOVIDADE 1v2

Totalização individual de presenças

Hoje a empresa tem só um "presente / não presente". Mas cada empresa compra um pacote de cadeiras — 4, 6, 8 pessoas. Queremos saber, em tempo real, quantas chegaram.

Cada pessoa escaneia o QR e incrementa o contador da empresa.
O primeiro check-in marca a empresa como confirmada e define a posição na fila.
Os demais só somam ao contador — não mudam a ordem.
Cada tela mostra o contador X / Y com barra de progresso.
Recepção pode adicionar/remover manualmente quando o convidado não tem QR.
Auditoria por device_id, IP e horário — desfaz scan acidental.

Murilo Buffet

MESA 54

6/8

75% da mesa ocupada

✓ #1 — 19:42 ✓ #2 — 19:45 ✓ #3 — 19:51 ○ #4 #5

Card real da recepção mostrando contador ao vivo

NOVIDADE 2v2

Fila de boas-vindas configurável

Hoje as boas-vindas no telão aparecem na hora do check-in — a pessoa ainda está na recepção, não vê a tela. Quando duas chegam juntas, uma sobrescreve a outra.

Na v2, isso vira uma fila com dois parâmetros configuráveis:

CONFIGURAÇÃO

Tempo de deslocamento

Atraso entre check-in e exibição

5s

Duração no telão

Tempo de cada boas-vindas exibida

3s

FLUXO DA FILA

Check-in chega

Primeira pessoa da empresa escaneia o QR

Enfileira (status: pending)

Marca eligible_from = now + 5s, duration = 3s

Aguarda deslocamento

Pessoa caminha até a mesa

Telão exibe (playing)

Animação cinematográfica por 3 segundos

Done → próxima

Worker pega a próxima da fila FIFO

        Operador no controle:
        painel "Fila de boas-vindas" com botões pular, pausar, cancelar, repetir.
      

NOVIDADE 3v2

Reordenamento manual backstage

A ordem natural é cota → horário do primeiro check-in. Mas o cerimonial precisa flexibilidade para situações reais:

Empresa chegou cedo, mas o diretor está atrasado.
VIP pediu para ser chamado mais tarde por questão de timing.
Decisão de palco que muda a ordem in-flight.
Empresa não quer ser a primeira da subseção.

Solução: tela /admin/queue com drag-and-drop. Quem reordena? Cerimonial / operador da cerimônia.

FILA EM EDIÇÃO

1 Anderson Rocha Mesa 12 · Convidado

2 Murilo Buffet Mesa 54 · Ouro

3 Toni Informática Mesa 42 · Ganhador

4 Modeir Nery Mesa 62 · Ganhador

Operação sensível — requer reconfirmação de senha (reauth de 5 min)

NOVIDADE 4v2

Modo offline completo

No dia do evento a internet pode falhar. A operação não pode depender disso.

Pré-carga do "pacote do evento"

Botão "Baixar tudo para uso offline" no admin. Service Worker faz cache de todas as logos, vídeos, slides e fontes.

Operação local resiliente

Recepção, apresentadores e controle continuam respondendo. Comandos vão para fila local em IndexedDB.

Sincronização automática

Quando a conexão volta, Background Sync envia tudo. Telão consome do cache local em qualquer momento.

        Cenário ideal:
        servidor local (notebook do operador) numa LAN — funciona sem nenhuma internet externa, com WebSocket apontando para localhost.
      

PROTEÇÃO DA OPERAÇÃO

Segurança & multi-perfil

A v2 separa quem pode fazer o quê. Cada perfil tem só o que precisa.

Perfis de usuário

Admin — todas as operações + configurações
Stage Manager — fila + reordenamento + telão
Apresentador — só sua tela
Recepcionista — só recepção + check-in
Convidado — voucher + dashboard + pesquisa

Camadas de proteção

Sanctum + cookies HttpOnly (sem chave AES no JS)
Reauth de 5 min para reordenar a cerimônia
Rate limiting em login, voucher e API
CSRF em todos os formulários
Audit log de quem fez o quê (Activitylog)
Voucher com cookie de uso por dispositivo

CONTINUIDADE

Migração v1 → v2 sem perda

Comando Artisan dedicado importa todos os dados existentes para o novo modelo, preservando históricos.

        $ php artisan eventflow:migrate-from-json /var/www/EventFlow/eventflow_versao_json
      

222 categorias migradas preservando códigos e numeração
Todas as empresas com seus campos, logos, vídeos, vouchers
Pivot empresa↔categoria com flag "ganhou"
Slides especiais com mídia copiada para S3
Usuários admin com hashes bcrypt (Laravel aceita direto)
Critérios da pesquisa preservados (e agora editáveis no admin)
Avaliações existentes mantidas com seus IDs
Para cada empresa já confirmada na v1, cria PresenceCheckin sintético de seq=1 com timestamp original

PLANEJAMENTO

Cronograma sugerido

Plano dividido em fases entregáveis. Cada fase resulta em algo demonstrável.

Fase	Duração	Entregas principais
1 · Fundação	2 semanas	Setup Laravel 13 + Postgres 16 · Migrations · Seeders · Factories · Auth + perfis · CI/CD
2 · Cadastros	2 semanas	CRUD empresas, categorias, slides · Upload de mídia (WebP via queue) · Importador v1→v2
3 · Operação	3 semanas	Recepção · Tela apresentadores · Controle do telão · Telão (5 layouts) · Reverb broadcast
4 · Convidado	1 semana	Login por voucher · Dashboard · Pesquisa de satisfação · Voucher imprimível com QR
5 · Novidades v2	3 semanas	Totalização de presenças · Fila de boas-vindas · Reordenamento + reauth
6 · Offline + PWA	2 semanas	Service Worker · Cache de mídia · Background Sync · IndexedDB · Indicadores de status
7 · Polimento	1 semana	Testes E2E · Documentação · Deploy de produção · Treinamento da equipe operacional
TOTAL	14 semanas	~3,5 meses até a v2 pronta para evento real

VALOR ENTREGUE

Diferenciais competitivos

Uma plataforma própria, robusta, escalável e exclusiva — pronta para crescer junto com a marca Reale.

Produto comercializável

Multi-tenant desde o desenho. Outras associações, ACs e prêmios podem ser clientes.

Confiabilidade

Banco transacional, backup contínuo, auditoria, modo offline. Cerimônia ao vivo sem sustos.

Identidade premium

Visual cerimonial dourado já consolidado, agora com animações cinematográficas e tempo real verdadeiro.

Experiência do convidado

QR escaneou, contador subiu, mensagem personalizada no telão. Detalhes que viram lembrança.

Operação flexível

Cerimonial controla timing, ordem, fila — tudo sem precisar tocar em código. Configuração in-flight.

Pronto para crescer

Stack mainstream, equipe ampla disponível no mercado, integração futura com WhatsApp, e-mail, BI.

Próximos passos

Validação e início do desenvolvimento

1. Aprovação

Validar o escopo apresentado. Ajustes de prioridade ou alcance, se houver.

2. Setup técnico

Repositório, ambiente de dev, padronização de código, definição de equipe.

3. Desenvolvimento

Início da Fase 1 (Fundação). Sprints de 2 semanas com demos ao final de cada uma.

"A v1 nos ensinou o que o produto precisa ser. A v2 é o produto pronto para o que vem depois."

OBRIGADO

REALE TECH SOLUÇÕES EM TI · 2026