O evento inteiro
dentro do WhatsApp.
Playbook do negócio: venda de ingressos, pagamento, portaria, bar, estoque, promoters, artistas, fornecedores e financeiro, num único número de WhatsApp e numa base única de dados.
O que é o EventZap
Uma plataforma em que todo o evento acontece por um número de WhatsApp: o cliente compra e recebe o ingresso, o porteiro valida, o bar vende, o promoter acompanha a comissão, o artista confere rider e borderô, o fornecedor recebe o pedido, e o produtor vê números e alertas em tempo real, sem instalar aplicativo.
📒Base única: o livro do evento
Cada fato (venda, entrada, consumo, estoque, pagamento, comissão, repasse) é registrado uma vez, de forma imutável. Saldos e contadores são calculados a partir dele. Os agentes leem e escrevem nessa base e nunca guardam números de cabeça.
🧠IA raciocina, regra executa
A IA interpreta pedidos, redige respostas e extrai dados de contratos e notas. QR, estoque e dinheiro seguem regras determinísticas, testáveis e auditáveis.
📱Zero app, zero atrito
Pagamento por Pix ou cartão sem sair do WhatsApp. O porteiro valida com uma foto ou pelo leitor web. O produtor acompanha tudo por mensagens, alertas e aprovações com botões.
Princípios inegociáveis
- Dinheiro em centavos inteiros e partida dobrada; correção só por lançamento de ajuste.
- Idempotência em tudo que vem de fora: webhooks, reentrega de mensagens, leituras repetidas, sync offline.
- Permissão checada no comando, nunca só no texto do agente.
- Desenho agnóstico de infraestrutura: pode ser vertical do Kodz ou sistema separado.
- Privacidade por padrão: o QR leva hash do telefone, nunca o número.
- Nenhum concorrente ou produto de terceiros de eventos é citado em material do produto.
Público, proposta e receita
Para produtores que já vendem pelo WhatsApp com Pix manual e planilha, e para casas que querem controlar portaria e bar sem hardware caro.
Público-alvo
🎧 Produtores independentes
Festas, shows e baladas de 200 a 5.000 pessoas. ICP principal. Já vendem pelo WhatsApp, sofrem com Pix manual, fraude na porta e fechamento demorado.
🏠 Casas e bares com agenda
Eventos semanais, vários produtores no mesmo espaço, bar próprio e repasse para a casa.
🎪 Festivais pequenos e médios
Vários dias e palcos, muitos fornecedores, artistas com bilheteria em percentual.
🎓 Eventos fechados
Formaturas, eventos corporativos e comunitários, com lista de convidados, cortesias e credenciais.
Proposta de valor por persona
| Persona | Dor atual | O que o EventZap entrega |
|---|---|---|
| Produtor | Conferir Pix um a um, planilha de vendas, fraude de print, fechamento em dias, briga de números com sócios | Venda automática com lotes, números em tempo real no WhatsApp, alertas de fraude, fechamento com DRE e borderô em horas |
| Cliente | Cadastro em site, app para baixar, ingresso perdido no e-mail | Compra em 1 minuto na conversa, ingresso em imagem e PDF, transferência e reembolso pelo próprio chat |
| Portaria | Lista impressa, app que trava, internet ruim | Foto do QR pelo WhatsApp ou leitor web offline, com resposta ✅/❌ clara |
| Bar | Fila, ficha de papel, caixa que não bate | Fichas digitais e saldo cashless, retirada por QR, estoque baixando sozinho |
| Promoter | Não sabe quanto vendeu nem quando recebe | Link e cupom próprios, extrato de comissão a qualquer hora, repasse automático |
| Artista / casa | Desconfiança no borderô | Borderô calculado pela base única, com trilha de auditoria e aceite digital |
Receita da plataforma Proposta · a decidir
Plano Livre (por uso)
- Ingresso pago: 6% (mín. R$ 1,90) por ingresso
- Bar/cashless: 3% do valor transacionado
- Estacionamento: 5%
- Cortesias dentro da cota: grátis
Plano Pro (mensal)
- Mensalidade sugerida R$ 299/mês por organização
- Ingresso 4% · bar 2%
- Painel web completo, relatórios, vários números
- Franquia de mensagens utilitárias inclusa
Adicionais
- Campanhas de marketing: custo da mensagem + margem mínima 15%
- Antecipação de recebíveis (repasse do PSP + spread)
- Emissão fiscal e assinatura eletrônica: custo + margem
- Suporte presencial no dia do evento
Concorrência (por categoria, sem nomes)
| Categoria | Forças | Fraquezas que exploramos |
|---|---|---|
| Plataformas web/app de venda de ingressos | Vitrine, marca conhecida, checkout maduro | Compra fora do WhatsApp, taxas de conveniência altas, pouco ou nenhum controle de bar e estoque |
| Sistemas de bar/cashless com pulseira e hardware | Robustos em grandes eventos | Custo de implantação, logística de equipamento, não vendem ingresso |
| “Faça você mesmo” (grupo + Pix manual + planilha) | Custo zero, familiar | Fraude de print, erro humano, sem auditoria, fechamento manual |
| Apps de lista e check-in | Simples na porta | Resolvem só uma etapa; dados soltos do financeiro |
Diferenciais defensáveis
💬 Canal
Compra, ingresso, portaria e gestão no mesmo WhatsApp: conversão maior e nada para instalar.
📒 Livro único
Ingresso, bar, estoque e split na mesma base. O fechamento sai sozinho.
🛡️ Antifraude
QR assinado de uso único, QR dinâmico de 30 s e validação offline.
🤝 Split nativo
Produtor, sócios, artista, promoter e casa recebem automaticamente, com trilha de auditoria.
Um número, onze papéis
Quem fala é identificado pelo telefone e cruzado com o nome cadastrado. Telefone desconhecido é cliente. Privilégio só vem de uma atribuição confirmada pelo dono, nunca da conversa.
👑Produtor
Controle total da organização; aprova ações sensíveis.
🤝Sócio
Coprodutor; vê números e coaprova, conforme permissão.
🎟️Cliente
Compra ingresso, consumo e vaga. É o papel padrão.
📣Promoter
Link e cupom próprios, comissão, lista de nomes.
🎤Artista / empresário
Contrato, rider, convidados, borderô.
🧑🔧Equipe
Escala, credencial, check-in de staff.
🚪Portaria
Valida ingressos no seu portão ou setor.
🍺Bar
Valida retiradas e debita cashless no seu PDV.
🚗Estacionamento
Vende e valida vagas.
📦Fornecedor
Recebe pedidos, confirma entregas, envia notas.
🏟️Espaço (casa)
Capacidade, regras e a parte da casa no split.
➕ Financeiro (subpapel)
Contas a pagar e conciliação, sem poderes operacionais.
Cadastro em linguagem natural
Jornadas principais
🎟️ Cliente: da curiosidade à pista
- Clica no link do promoter ou do anúncio e cai no WhatsApp.
- Escolhe setor e lote (lista interativa); aplica cupom ou meia.
- Paga com Pix (botão de copiar) ou cartão (checkout no navegador interno).
- Recebe comprovante e ingresso QR em imagem e PDF.
- Recebe lembretes na véspera e no dia; pode transferir o ingresso.
- Na porta, mostra o QR (estático ou dinâmico): ✅ e entra.
- Compra fichas ou recarrega o saldo, retira no bar com QR.
- Depois do evento: pesquisa de satisfação, reembolso do saldo, convite para o próximo.
👑 Produtor: do anúncio ao fechamento
- Cria o evento (setores, lotes, meia, cortesias) por conversa ou no painel.
- Cadastra equipe, promoters, artistas e fornecedores por telefone.
- Acompanha “vendas agora” e recebe a virada de lote e as metas.
- No dia: entradas por portão, lotação, alertas de fraude, ruptura do bar.
- Aprova reembolsos fora da regra, overrides e pedidos de compra com 1 toque.
- Fechamento: checklist, DRE, borderô e repasses aprovados.
🚪 Porteiro: turno sem drama
- Recebe mensagem: “Você é Portaria – Portão B”.
- Abre o link pessoal do leitor web (baixa o pacote offline) ou usa a foto.
- Lê o QR e recebe ✅ nome e setor, ou ❌ motivo e horário do uso.
- Em caso de dúvida, chama o supervisor pelo próprio chat.
📣 Promoter e 🎤 artista
- Promoter recebe link e cupom, consulta vendas e comissão (“quanto já ganhei?”).
- Comissão é liberada depois do evento e do prazo de arrependimento, com repasse automático.
- Artista envia contrato e rider; o sistema vira checklist com responsáveis.
- Artista confere borderô e valor a receber; aceita digitalmente.
Maestro + 7 especialistas
O Maestro identifica quem fala e em qual evento, entende a intenção e roteia. Cada especialista só tem as ferramentas do seu domínio e as permissões do papel. Os especialistas conversam por eventos de domínio, nunca diretamente.
| Agente | Faz | Regra determinística | IA (raciocínio) | Modelo (padrão Kodz) |
|---|---|---|---|---|
| Maestro | Identidade, papel, contexto, roteamento, confirmações, transbordo humano | Telefone → pessoa → papéis; permissão; limites de uso | Intenção ambígua; planejar várias etapas | Modelo forte no plano; barato no dia a dia |
| Vendas | Lotes, cupons, meia, cortesias, lista de espera, transferência | Virada de lote, preço, cotas, reserva com TTL | Dúvidas, recomendação, sugestão de preço | Barato; forte se complexo |
| Acesso | QR, portaria, lotação, antifraude, offline | Assinatura, uso único, setor, lotação | Exceções (“perdi o ingresso”) | Quase só regra |
| Consumo | Cardápio, fichas, cashless, retirada | Saldo, débito, preço | “2 cervejas e 1 água” em texto ou áudio | Barato + ferramentas |
| Estoque | Baixa, contagem, ruptura, compras | Ficha técnica, ponto de pedido | Previsão; inventário por foto | Barato; extrator para notas |
| Financeiro | Pix/cartão, split, contas, conciliação, fechamento | Split, taxas, borderô, conciliação | Explicar divergências, relatórios | Barato; forte para conciliação |
| Pessoas | Equipe, artistas, fornecedores, contratos, rider, escalas | Escalas, prazos, checklists | Extrair cláusulas e rider | Barato + extrator |
| Marketing | Campanhas segmentadas, lembretes, recuperação de carrinho | Segmentação, opt-in, frequência | Texto e criativos | Forte para campanha |
Módulos funcionais
🎟️ Ingressos
Setores, tipos, lotes automáticos (por quantidade ou data), cupons, meia (cota 40%), cortesias com cota, lista de espera, transferência, reembolso.
💳 Pagamentos
Pix (botão da API oficial ou copia e cola), cartão (checkout no navegador interno ou Flows), webhook, comprovante, chargeback.
🚪 Portaria
Token assinado de uso único, QR dinâmico de 30 s, foto pelo WhatsApp, leitor web offline, lotação por setor.
🍺 Bar
Cardápio por PDV, fichas digitais, saldo cashless, pedido com retirada, combos e open bar, fechamento de caixa.
📦 Estoque
Ficha técnica, baixa automática, locais, contagens, ruptura, pedido a fornecedor, consignação.
🚗 Estacionamento
Vagas por tipo, QR próprio, venda no local por Pix, lotação, split com operador.
📣 Promoters
Links, cupons, regras de comissão e metas, listas de nome, extrato e repasse.
💰 Financeiro
Split, contas a pagar, conciliação, bilheteria em %, DRE, borderô, fiscal, exportação ao contador.
Como as coisas acontecem
1. Venda de ingresso
2. Pagamento e entrega
3. Portaria
Conteúdo do token
v · tid · eid · ph(hash tel.) · sec · kid · iat · w(30 s), assinado com Ed25519. A chave privada fica só no servidor; os leitores levam só a pública e validam offline sem conseguir emitir.
Por que foto ou leitor web?
O leitor de QR nativo do WhatsApp não é acessível por API. O QR dinâmico vive na página “Meus ingressos”, porque uma imagem enviada no chat não muda sozinha.
4. Bar (ficha digital e cashless)
5. Estoque
6. Split de um ingresso Exemplo ilustrativo
| Item | Regra (exemplo) | R$ |
|---|---|---|
| Pago pelo cliente | Inteira R$ 100 + taxa de serviço 6% | 106,00 |
| Plataforma | Taxa de serviço | 6,00 |
| PSP (Pix) | Tarifa por transação (premissa) | 1,99 |
| Base líquida | 100,00 − 1,99 | 98,01 |
| Promoter | 10% do valor de face | 10,00 |
| Artista | 30% da base líquida | 29,40 |
| Casa | 10% da base líquida | 9,80 |
| Produtor (resíduo) | Base − promoter − artista − casa | 48,81 |
7. Comissões de promoter
Atribuição
Por link (código no deep link do WhatsApp), cupom ou lista de nomes. Padrão: último toque com janela configurável. DECISÃO
Regras
% ou valor fixo, por lote ou tipo, metas com faixas de bônus, hierarquia com override. Cortesia não gera comissão.
Transparência
“Quanto já ganhei?” responde com prevista, liberada e paga, sempre lidos do livro, com horário.
8. Reembolso e chargeback
Chargeback: ingresso não usado é suspenso (a portaria vê ⚠️). Se já foi usado, sai um dossiê automático com check-in, conversa e aceite dos termos. Se a disputa for perdida, há estorno e reversão de splits e comissões.
Entidades e relações
Toda tabela tem tenant_id. Valores ficam em *_centavos e datas em UTC, com o fuso guardado no evento. CPF, documentos e dados bancários são criptografados.
Identidade
Organizacao, NumeroWhatsApp, Pessoa (global, por telefone), PessoaOrganizacao (dados por tenant), AtribuicaoPapel (papel, escopo, validade), Consentimento.
Evento e vendas
Espaco, Evento, Coproducao, Setor, Portao, TipoIngresso, Lote, Pedido, ItemPedido, Ingresso, Cupom, ListaEspera, Transferencia, Cortesia, DocumentoMeia.
Pagamentos
Pagamento, EventoWebhook, Reembolso, Contestacao, RegraSplit, Recebedor.
Acesso
ChaveAssinatura (kid), Dispositivo, LeituraQR, CheckIn, Revogacao, Credencial, AlertaFraude.
Bar e estoque
PontoVenda, Produto, ItemCardapio, FichaTecnica, Carteira, MovimentoCarteira, Retirada, LocalEstoque, MovimentoEstoque, Contagem, PedidoCompra.
Pessoas, financeiro, plataforma
Promoter, Comissao, Contrato, ItemRider, Escala, Fornecedor, Lancamento, ContaPagar, Repasse, Conciliacao, Fechamento, DocumentoFiscal, Conversa, Mensagem, ExecucaoAgente, AuditLog.
Máquinas de estado-chave
Ingresso
Evento
Leitura de QR
As 18 máquinas de estado completas estão no escopo (§9). Transição não listada é proibida.
Marca, cores, tipografia e componentes
Uma identidade noturna e elétrica: o violeta do evento e o verde da confirmação. Os tokens são travados (padrão Kodz: kit próprio, sem improviso por tela).
Marca
Uso
- Símbolo: raio (velocidade, “zap”) dentro de um quadrado arredondado em degradê violeta → verde.
- Área de respiro mínima: metade da altura do símbolo.
- Foto de perfil do WhatsApp: só o símbolo, sobre fundo Noite.
- Tom de voz: direto, festivo, sem jargão; emojis só funcionais (✅ ❌ ⚠️ 🎟️).
Paleta
Contraste: texto sobre Violeta e Zap sempre branco e em peso ≥ 600; as cores de status nunca são o único sinal (sempre há ícone e texto). A meta é contraste AA.
Tipografia
Títulos, números grandes e a marca. Pesos 600–800. Espaçamento entre letras de −1% a −2%.
Texto, tabelas e interface. Pesos 400–650. Números tabulares em valores financeiros.
| Token | Tamanho | Uso |
|---|---|---|
| display | 54/46 | capa |
| h2 | 30 | seção |
| h3 | 19 | bloco |
| corpo | 15 | texto |
| legenda | 12 | notas |
Componentes
Botões
Comprar ingresso✅ ConfirmarCorrigirRecusar
No WhatsApp: no máximo 3 botões de resposta; listas para mais de 3 opções.Etiquetas de status
PagoVálidoPendenteMeiaJá usadoFraudeCortesiaTransferidoExpirado
Card de KPI
Mockups: conversas no WhatsApp
Pista · Lote 2 · R$ 80,00 (inteira)
2 × R$ 80,00 + taxa R$ 9,60
Total: R$ 169,60
Reserva válida por 15 min
Comprovante e ingressos abaixo 👇20:16
Ingresso 1 de 2 · Lote 2
Ana Souza · Pista · Lote 222:41
Portão A · aparelho P-03
Titular: Bruno L.
⚠️ MEIA: conferir documento22:44
Vendidos: 1.412 / 1.800 (78%)
Entradas: 1.096 · Pista 86% · VIP 64%
Bilheteria: R$ 104.380
Bar: R$ 31.920 · top: cerveja lata23:02
Ingresso #8812 lido nos Portões A e C em 40 s.
💧 1 × Água · R$ 6,00
Total R$ 30,00 · saldo R$ 70,00
Retire no Bar 2 com este QR · senha B2-117
Vendas com seu código: 86
Comissão prevista: R$ 688,00
Liberada: R$ 0,00 · libera após o evento
Meta 100 vendas → bônus R$ 150 (faltam 14)15:10
Cupom: RAFA10
Tela web: painel do produtor
Em andamento · atualizado às 23:02
Tela web: leitor da portaria (PWA, funciona offline)
Estados do leitor: verde (válido), coral (rejeitado, com motivo), âmbar (atenção: meia, em disputa, QR expirado). Som e vibração diferentes para cada estado. Botão grande de “Busca manual” e “Chamar supervisor”.
Arquitetura no padrão Kodz
O EventZap replica a arquitetura-padrão do Kodz (fonte: arquitetura-padrao-kodz.md): um laço de agentes próprio, Postgres como estado durável, aprovações no código, segredos em arquivo e deploy com duas réplicas. Os contratos (comandos, eventos de domínio, adaptadores) são do EventZap, então o sistema pode nascer como vertical do Kodz ou como stack separada DECISÃO.
Motor de agentes (igual ao Kodz)
- Laço próprio em Python/asyncio, sem framework de terceiros (ADR-001): tarefa durável em Postgres, plano → ferramentas → conferência; só
finishencerra. - Retomada no boot sem repetir às cegas uma ferramenta que estava no meio.
- Aprovações no código (
policy.py): send / spend / delete pausam emwaiting_approval. No EventZap: repasse, reembolso fora da regra, campanha em massa, mudança de preço/split. - Limites: passos máximos, teto de custo por tarefa/agente, freio de repetição, “para tudo”.
- Subagentes sem netos; webhook de escalação operacional assinado (sem PII completa).
Canais WhatsApp
- API oficial = canal principal do EventZap: só ela oferece botões, listas, Flows, templates e o botão Pix.
- Webhook
/webhooks/metacom verify token e assinaturaX-Hub-Signature-256; tokens cifrados. - Gateway unificado por número com modos
meta/web/misto(padrão Kodz). - WhatsApp Web: só contingência ou uso interno (equipe), porque tem risco de bloqueio do número e não tem recursos de pagamento DECISÃO.
- No Kodz, todo envio passa por aprovação. No EventZap, as mensagens transacionais (ingresso, confirmação) são automáticas e as em massa precisam de aprovação.
Roteamento de modelos (eixo esforço + auxiliares)
| Uso | Modelo preferido (padrão Kodz) | Queda | No EventZap |
|---|---|---|---|
| Planejar / orquestrar (faixa plano/topo) | Sonnet | Haiku em triagem curta | Maestro em pedidos de várias etapas, campanhas, conciliação |
| Dia a dia (faixa base) | Haiku | Cadeia de fallback + modelos gratuitos | Conversa de venda, dúvidas, respostas |
| Extrair (JSON, campos) | Qwen3-30B-A3B | Gemma → Haiku | Contratos, rider, notas, boletos, cadastro por texto |
| Resumir | Phi-4 | Haiku | Resumos programados ao produtor, relatórios |
| Classificar / verificar (+ exemplos ouro) | Gemma 3 27B | Haiku | Intenção do Maestro, moderação, conferência |
| Nenhum | Regras determinísticas | QR, check-in, estoque, saldo, split, preço, permissões | |
Escalada para o modelo forte dura 3 passos e volta ao base. Teto de 32k tokens no laço e 2.048 nos auxiliares. Custo por chamada em llm_calls. Modelo novo só entra depois de aprovado.
💳 Pagamentos
Interface Provedor (cliente, cobrança, webhook). Implementação de referência do padrão Kodz: ProvedorAsaas (Pix QR/copia e cola + cartão), com segredos asaas_api_key e asaas_webhook_token em arquivo e idempotência por externo_id. Um segundo PSP pluga na mesma interface.
🗄️ Banco e migrações
SQL numerado migrations/NNN_*.sql, aplicado na subida, com número único. tenant_id em todas as consultas. O livro do evento é append-only, com projeções materializadas e reconstruíveis.
💾 Backups
restic para armazenamento off-site (pg_dump + arquivos + secrets) às ~03:17 BRT. Retenção de 7 diários, 4 semanais e 3 mensais, com check semanal. Backup antes de cada deploy. Senha do repositório num cofre fora da VPS.
🚀 Deploy
Caminho único publicar.sh <versão> com trava flock: backup → build de imagens versionadas → sobe api2 e depois api com healthcheck. No máximo 1 deploy por hora (hotfix fura). Proibido editar arquivos à mão no servidor.
🧪 Repositório
Branch → testes → PR, sem commit na main. CI com ruff, vulture, pytest e barreira de nomes proibidos (concorrentes). pt-BR em UI, commits e docs. Um teste por bug, e nunca apagar teste para ficar verde.
📈 Dimensionamento
Piloto: 1 VPS de 8 vCPU / 32 GB (igual ao Kodz). Crescimento: CPU/RAM acima de 70% sustentado → 16 vCPU ou 2º host para runner/computadores. Pico de portaria: mais réplicas de api, sem depender de LLM.
Checklist de implantação
Confiança é o produto
🔑Segredos
- Nunca no chat, em logs, eventos ou banco; arquivos em
/opt/eventzap/secrets(pasta 700, arquivos 640), montados só leitura. - Chaves privadas de assinatura de QR no cofre, uma por evento, com rotação por
kid. - Formulário seguro para credenciais, que expira em ~30 min.
🏢Isolamento
tenant_idem toda consulta + política no banco; testes automáticos de vazamento.- Rede Docker por agente; token por computador; egress filtrado.
- Socket Docker só via proxy;
cap_drop: ALL.
🧷Agentes
- Papel só por atribuição confirmada; “sou o dono” não eleva nada.
- Ferramentas tipadas; conteúdo de mensagens nunca altera permissões (defesa contra prompt injection).
- Ações sensíveis com PIN e/ou segundo aprovador 🔐.
🧾Auditoria
audit_logappend-only: quem pediu, qual agente, qual comando, qual resultado.- Rate limit por telefone; cabeçalhos de segurança; Cloudflare na origem.
- Produção: time só com leitura; escrita só pelo fluxo oficial.
💳Pagamentos
- Dados de cartão só no checkout do PSP, o que reduz o escopo PCI.
- Webhooks com assinatura e token; idempotência; reconciliação diária.
- Chaves Pix e dados bancários criptografados.
🕵️Trajetórias de IA
- Gravadas já anonimizadas; opt-out do produtor (
prefs.treino=false). - “Esquecer conta” apaga o histórico; retenção de 180 dias.
- Nada de CPF, documento ou telefone completo nos prompts sem necessidade.
LGPD (Lei 13.709/2018)
| Tema | Como o EventZap trata |
|---|---|
| Papéis | Produtor = controlador dos dados dos seus clientes; plataforma = operadora (contrato de tratamento). Identidade global por telefone exige avaliar controladoria própria DECISÃO |
| Bases legais | Execução de contrato (compra), obrigação legal (fiscal, meia), legítimo interesse (antifraude, com teste de balanceamento), consentimento para marketing |
| Minimização | QR com hash do telefone; documentos de meia com acesso restrito e retenção mínima; fotos de QR descartadas após prazo |
| Direitos do titular | “meus dados” e “apagar meus dados” no próprio WhatsApp (acesso, correção, portabilidade, eliminação), respeitando retenções legais |
| Retenção | Fiscal ≥ 5 anos; conversas X meses; documentos de meia até fim do evento + prazo de fiscalização DECISÃO |
| Incidentes | Plano de resposta; comunicação à ANPD e aos titulares quando cabível |
| Menores | Melhor interesse; sem marketing direcionado; itens +18 bloqueados |
Conformidade embutida no produto
🎓 Meia-entrada: Lei 12.933/2013 + Decreto 8.537/2015
- Estudantes (CIE válida), pessoas com deficiência (e acompanhante), jovens de 15 a 29 anos de baixa renda (ID Jovem); pessoas idosas pelo Estatuto da Pessoa Idosa (Lei 10.741/2003); categorias locais configuráveis.
- Cota de 40% do total de ingressos disponíveis, controlada em tempo real; esgotou, a meia para de ser vendida e o sistema avisa.
- Documento informado na compra (Flow) e conferido na portaria (“MEIA: conferir documento”).
- Relatório de meias por evento para fiscalização.
🛒 CDC: Lei 8.078/1990
- Arrependimento (art. 49): 7 dias a partir da compra online, com devolução integral. Regra de produto: automático se antes do início do evento. Compras a menos de 7 dias do evento: definir com o jurídico DECISÃO
- Preço total com taxas antes de pagar; informação clara (arts. 6º e 31).
- Cancelamento/adiamento: reembolso ou crédito, conforme a lei vigente e a escolha do consumidor.
- Sem venda casada: combos sempre opcionais. O saldo cashless pertence ao cliente.
🧾 Fiscal
- Ingressos: ISS municipal (LC 116/2003), com NFS-e emitida pelo produtor. A taxa da plataforma tem nota própria.
- Bar: ICMS, normalmente com NFC-e; o emitente é quem vende (produtor, casa ou bar terceirizado).
- Reforma tributária (IBS/CBS, LC 214/2025): transição desde 2026, então o adaptador precisa suportar os campos novos.
- Retenções em pagamentos a artistas e fornecedores conforme o contador.
🏟️ Outras
- Capacidade e alvarás/AVCB: o sistema não deixa a lotação passar da capacidade cadastrada e alerta vencimentos.
- ECA: proibição de venda de álcool a menores (itens +18 bloqueados).
- Direitos de execução pública musical como item do checklist de custos.
- Políticas comerciais do WhatsApp Business: opt-in e restrições para bebidas no catálogo.
O que medimos
⭐ Estrela-guia
GMV processado por evento (ingressos + bar + estacionamento) e % do evento operado 100% pelo WhatsApp.
🎯 Metas iniciais sugestão
- Conversa → pago ≥ 35%
- Validação p95 < 1 s (leitor) / < 4 s (foto)
- Reuso aceito = 0
💰 Financeiro
- Fechamento ≤ 24 h
- Chargeback < 0,5% do cartão
- Divergência de conciliação = 0 não explicada
📦 Bar
- Divergência de estoque ≤ 2%
- Ruptura avisada antes de zerar
- Tempo de retirada < 3 min
| Área | Indicadores |
|---|---|
| Vendas | Vendidos por lote/setor/canal/promoter/hora, receita bruta e líquida, ticket médio, funil conversa → pedido → pago, abandono de reserva, Pix × cartão, aprovação de cartão, uso de cupom, cota de meia, cortesias por emissor, conversão da lista de espera |
| Acesso | Entradas por hora/portão, tempo de validação, fila estimada, no-show, leituras inválidas por motivo, tentativas de reuso, conflitos offline, lotação por setor |
| Consumo e estoque | Receita por hora/PDV/item, consumo per capita, ticket do bar, rupturas (quantidade e duração), perdas (%), saldo cashless remanescente, margem por item |
| Financeiro | Margem do evento, custo por participante, taxas do PSP (% da receita), chargebacks, reembolsos por motivo, tempo de fechamento, prazo de repasse |
| Promoters e marketing | Vendas e comissão por promoter, entrega/leitura/clique/conversão por campanha, receita atribuída, opt-out, custo por mensagem |
| Plataforma | Custo de IA por pedido e por evento, % resolvido sem humano, latência p95, erros, NPS (cliente, produtor, equipe), qualidade do número |
Entrega por fases
Desde a Fase 1, cada venda já grava no livro o split previsto. O financeiro completo da Fase 5 não precisa migrar dados.
Fase 0 Fundações 4–6 semanas-pessoa
Livro do evento, multi-tenant, identidade por telefone e papéis, Maestro mínimo, gateway WhatsApp e templates, auditoria, adaptador de PSP, geração de imagem/PDF.
Aceite: “número X é Fulano, portaria” funciona de ponta a ponta; testes de isolamento passando.
Fase 1 Ingresso + pagamento + portaria 8–10 semanas-pessoa
Lotes automáticos, meia (40%), cortesias, cupons, Pix e cartão, webhook, ingresso em imagem e PDF, QR dinâmico, foto e leitor web offline, lotação, antifraude, painel do produtor no WhatsApp, transferência, lista de espera, lembretes, reembolso e chargeback básicos, LGPD básica.
Aceite: piloto real com ≥ 300 pessoas, zero overselling, zero reuso aceito, 100% conciliado.
Fase 2 Bar e estoque 5–6 semanas-pessoa
Cardápio por PDV, fichas e cashless, pedido com retirada, ficha técnica, baixa automática, contagens, ruptura, pedido simples a fornecedor, fechamento de caixa, NFC-e se aplicável.
Aceite: divergência ≤ 2%; ruptura avisada antes de zerar.
Fase 3 Promoters e comissões 3–4 semanas-pessoa
Links, cupons, regras e metas, extrato no WhatsApp, listas de nome, liberação, reversão e repasse.
Aceite: 100% das vendas com código atribuídas; comissões batem com a conferência manual.
Fase 4 Artistas, fornecedores e equipe 5–6 semanas-pessoa
Contratos com extração por IA + confirmação humana, rider como checklist, convidados, escalas e credenciais, fornecedores, estacionamento completo, visão da casa.
Aceite: rider 100% rastreado; check-in de equipe por credencial.
Fase 5 Financeiro completo e relatórios 6–8 semanas-pessoa
Split automático, bilheteria em %, contas a pagar com alçadas, conciliação PSP + banco, DRE e borderô, NFS-e e retenções, exportação contábil, marketing avançado, painel web.
Aceite: fechamento ≤ 24 h com DRE aprovada e borderô aceito.
O esforço em semanas-pessoa é uma estimativa para um time que já domina o padrão Kodz, reaproveitando o motor. Não inclui piloto, homologações fiscais nem aprovação de templates.
Economia de um evento-tipo Estimativa
Premissas do evento-tipo
- 1.000 ingressos pagos · ticket médio R$ 60 · 1,6 ingresso por pedido → 625 pedidos
- Meios: 70% Pix · 30% cartão à vista
- Bar cashless: R$ 24.000 em 400 recargas Pix (R$ 60 em média) e 800 pedidos de consumo
- ~12 mensagens de atendimento por comprador + 3 templates utilitários (véspera, dia, pós-evento)
- 8 eventos/mês na mesma organização (para ratear o custo fixo)
- Taxa da plataforma: Plano Livre (6% ingresso, 3% bar)
Tarifas de referência
| Item | Tarifa |
|---|---|
| WhatsApp: utilidade / serviço (após 1.000 grátis/mês por número) | R$ 0,035 |
| WhatsApp: marketing | R$ 0,3217 |
| Pix recebido (PSP) | R$ 1,99 |
| Cartão à vista (PSP) | 2,99% + R$ 0,49 |
| IA por conversa de compra (mix de modelos baratos) | ~R$ 0,10 |
| VPS 8 vCPU / 32 GB + backup + domínio | R$ 300–600/mês |
Custos variáveis por evento
| Item | Cálculo | R$ estimado |
|---|---|---|
| WhatsApp: atendimento de compra | 625 × 12 = 7.500 − 1.000 grátis = 6.500 × 0,035 | 227,50 |
| WhatsApp: templates utilitários | 625 × 3 = 1.875 × 0,035 | 65,63 |
| WhatsApp: bar, portaria por foto, produtor | (3.200 + 300 + 100) × 0,035 | 126,00 |
| IA (todos os agentes) | 625 × 0,10 + bar 800 × 0,03 + extrações/relatórios ~R$ 60 | ~146,50 |
| Infra fixa rateada | R$ 300–600 ÷ 8 eventos | 37,50–75,00 |
| Subtotal plataforma | sem PSP | ~603–641 |
| PSP: Pix de ingressos | 438 × 1,99 | 871,62 |
| PSP: cartão de ingressos | R$ 18.000 × 2,99% + 187 × 0,49 | 629,83 |
| PSP: recargas do bar (Pix) | 400 × 1,99 | 796,00 |
| Subtotal PSP | ~2.297 | |
| Opcional: marketing | 3 campanhas × 2.000 contatos × 0,3217 (repassado + 15%) | 1.930 (+290) |
Margem da plataforma por evento-tipo
Receita da plataforma
Ingressos: 1.000 × R$ 60 × 6% = R$ 3.600
Bar: R$ 24.000 × 3% = R$ 720
≈ R$ 4.320
Cenário A: PSP repassado ao produtor
Receita R$ 4.320 − custos da plataforma ~R$ 641
≈ R$ 3.680 (≈ 85%)
Cenário B: plataforma absorve o PSP
R$ 4.320 − R$ 641 − R$ 2.297
≈ R$ 1.380 (≈ 32%)
Leitura: quem absorve a tarifa do PSP é a variável que mais pesa na margem DECISÃO. Com o padrão Kodz de consumo real + margem mínima nos custos variáveis, a plataforma fica protegida contra alta de preço de IA e mensagens. O cartão tem liquidação em ~D+32 no provedor de referência, o que afeta o caixa do produtor e torna a antecipação um produto.
Riscos e mitigações
| Risco | Impacto | Mitigação |
|---|---|---|
| Bloqueio ou queda de qualidade do número de WhatsApp | Crítico | Opt-in rigoroso, frequência limitada, templates utilitários, número reserva, páginas web de contingência |
| Mudança de política/preço da API (ex.: cobrança de serviço desde 10/2026) | Alto | Adaptador de canal, custo por evento monitorado, repasse ao custo + margem |
| Internet ruim na portaria | Alto | Validação offline com chave pública, pré-carga, aparelhos dedicados, sync frequente |
| Print / compartilhamento de QR | Alto | Uso único, QR dinâmico em setores críticos, conferência de nome, alertas de reuso |
| IA inventa números ou age errado | Crítico | Números só via ferramenta, respostas por template, confirmação por botão, permissão no comando |
| Prompt injection / engenharia social | Alto | Papel só por atribuição, ferramentas tipadas, testes adversariais |
| Overselling em pico de vendas | Alto | Reserva atômica, filas, testes de carga |
| Webhook perdido ou duplicado | Alto | Idempotência, consulta ativa, reprocessamento, alerta de pendentes |
| Chargeback / fraude de cartão | Alto | Antifraude do PSP, 3DS, score de risco, dossiê automático, incentivo ao Pix |
| Não conformidade (meia, CDC, LGPD, fiscal) | Alto | Regras configuráveis por UF/município, revisão jurídica e contábil |
| Erro em split ou repasse | Alto | Cálculo determinístico, simulação, borderô aceito, dupla aprovação |
| Vazamento entre tenants | Crítico | Isolamento na camada de dados, testes automáticos, auditoria |
| Custo de IA fora de controle | Médio | Escada de modelos, regras primeiro, teto por tarefa e por evento |
| Baixa adoção pela equipe do evento | Médio | Fluxos de 1 toque, modo foto sem instalação, treino rápido, suporte no dia |
O que o Marcio precisa decidir
1 · Implantação
Vertical dentro do Kodz ou stack separada já no piloto?
2 · Receita
Percentuais do Plano Livre e do Pro; taxa paga pelo comprador ou absorvida pelo produtor?
3 · PSP
Quem absorve a tarifa? Split nativo ou por repasses? Segundo PSP de contingência desde o início?
4 · Cartão
Só checkout no navegador interno ou também Flows com tokenização? Parcelamento?
5 · Número de WhatsApp
Um por organização, marca ou evento? Número compartilhado para pequenos? Usar o WhatsApp Web para algo?
6 · QR dinâmico
Obrigatório em quais setores? Sync offline entre aparelhos na Fase 1?
7 · Reembolso
Política além do mínimo legal; arrependimento em compras a menos de 7 dias do evento.
8 · Consumo
Ficha, cashless ou ambos? Saldo remanescente: Pix automático ou crédito?
9 · Fiscal
Quem emite as notas do bar e dos ingressos em cada evento; nota por pedido ou consolidada?
10 · CPF
Obrigatório para todos ou só quando exigido (meia, nota, antifraude)?
11 · Segundo fator
PIN, segundo aprovador ou ambos? Valores de alçada?
12 · Piloto
Qual evento (porte, cidade/UF) e quais metas de KPI?
A lista completa (25 questões) está no escopo, §19.
/workspace/eventzap/escopo.md (escopo completo v0.1) e /workspace/eventzap/arquitetura-padrao-kodz.md (padrão de infraestrutura). Este playbook não cita concorrentes nem produtos de terceiros de eventos. Documento interno, gerado em 12/10/2026.