# OmniTicketz

> Plataforma SaaS multi-tenant brasileira de venda de ingressos. Combina venda online, PDV (balcão), check-in por QR code, pagamentos integrados (Pagar.me, Stone, PIX), emissão de NFS-e, programa de afiliados e portal B2B para agências de turismo. Cada cliente (tenant) opera com subdomínio ou domínio personalizado, whitelabel completo, e dados totalmente isolados via Row Level Security.

## Tipos de produto vendidos

- **Day Use** — ingresso atrelado a uma data específica, com múltiplos lotes (preços/variações) que compartilham o mesmo estoque diário.
- **Day Use Flexível** (`dayuse_sem_data`) — cliente compra o ingresso, escolhe a data de uso depois. Uso principal: PDV.
- **Dia Único** (`dia-unico`) — evento pontual com formulário customizável por ingresso (builder de perguntas).
- **Evento** — evento de data fixa.
- **Evento com Mesa** (`evento-mesa`) — eventos com planta baixa, áreas e seleção de mesas/lugares.
- **Combos** — pacotes que agrupam múltiplos ingressos e adicionais com preço único.
- **Adicionais / Order Bumps** — produtos complementares (almoço, transporte, brinde) vinculados a ingressos.
- **Hospedagem** — acomodações com calendário de tarifas, temporadas, ocupação por pessoa, check-in/check-out, mapa visual e reservas.
- **Passaportes** — planos recorrentes com cortesias e dependentes.
- **Excursões** — pacotes de múltiplos dias gerenciados por agências parceiras.

## Vendas e checkout

- **Carrinho** com expiração automática (padrão 15min, configurável por ingresso) e devolução de estoque via cron.
- **Pagamentos online**: PIX dinâmico (QR code), cartão de crédito com parcelamento, via Pagar.me.
- **PDV (balcão)**: dinheiro, débito, crédito, PIX com código de autorização. Integração TEF Stone Connect. Sem coleta de dados individuais (ingresso anônimo).
- **Pagamento Rápido** — fluxo simplificado para vendas de balcão.
- **Promoções e cupons** com duas janelas de data (venda e uso), segmentáveis por ingresso/combo/lote.
- **Códigos promocionais** (`/p/{slug}` e `/promo/{slug}`) — links rastreáveis para campanhas.
- **Links da Central de Vendas** — geração de URLs com parâmetros pré-preenchidos.
- **Remarcação** — cliente pode alterar a data do ingresso respeitando regras do tenant.

## Check-in

- **App de câmera** para leitura de QR code em tempo real.
- **Upload de imagem** como fallback quando a câmera não lê.
- Registro de timestamp, usuário responsável e prevenção de duplo check-in.
- API pública (`/api/v1/api-qrcode-checkin`) para integração com catracas físicas.

## Painel administrativo (tenant)

- **Dashboard customizável** — widgets arrastáveis por tenant.
- **Gestão de ingressos** — criação, edição, lotes, configuração, disponibilidade por data, formulário de compra dinâmico, flutuação tarifária.
- **Gestão de clientes** — cadastro, histórico de compras, dependentes.
- **Pedidos** — listagem, detalhes, alteração de status, reenvio de vouchers.
- **Notas fiscais** — emissão, listagem, reemissão via Omie.
- **Mapa de calor** — análise visual de ocupação por data/horário.
- **Auditoria** — log completo de ações dos usuários (90 dias para info, 1 ano para warning/error).
- **Usuários e grupos** — sistema de permissões granulares por grupo.
- **Configurações** — whitelabel (logo, tema, metadados), integrações, gateway de pagamento, domínio personalizado.
- **Wiki interna** — documentação para operadores.

## Relatórios

Relatórios avançados, de caixa, cancelamentos, Central de Vendas, check-in, cidades, clientes, comparativo, entrada, horários, lotes, no-shows, ocupação, PDV por usuário, remarcações, saída.

## Programa de afiliados

- Cadastro de afiliados, geração de links únicos, rastreamento de vendas, cálculo automático de comissão, fluxo de saques e repasses, PDV próprio do afiliado.

## Portal B2B / Empresas parceiras (turismo)

- Cadastro de agências e operadoras, descoberta de parques/atrações, gestão de comissões, financeiro, faturamento, excursões, calendário de reservas, parceiros.

## Painel Master (operador da plataforma)

- Gestão de tenants (clientes SaaS), contratos, planos, faturamento, storage, integrações, MailGrid, manutenção, auditoria global.

## API pública

Documentada em `/docs`. Endpoints disponíveis:

- **Autenticação** — JWT multi-tenant (register, login, refresh, logout, reset password, change password).
- **Clientes** — listagem e consulta.
- **Combos** — listagem de combos ativos.
- **QR Code / Check-in** — validação de ingressos.
- **Vouchers** — emissão de comprovantes com dados de integração.
- **Orders (integração)** — criação e consulta de pedidos, emissão de voucher.
- **Webhooks Pagar.me** — recebimento de notificações de pagamento.

## Widgets embutíveis

Calendário e fluxo de compra embutíveis em sites de terceiros (`/embed/*`).

## Arquitetura

- **Stack**: Next.js 15 (App Router), TypeScript, Supabase (PostgreSQL + Auth + Edge Functions + Storage), Vercel, TailwindCSS, shadcn/ui.
- **Multi-tenant**: resolução por domínio (Vercel subdomain, domínio personalizado) + JWT customizado.
- **Pagamentos**: multi-gateway (Pagar.me principal, Stone para TEF).
- **Monitoramento**: Sentry via tunnel route.
- **Analytics**: Google Analytics, Meta Pixel integrados por tenant.

## Páginas de referência

- [Início](https://omniticketz.com/)
- [Política de Privacidade](https://omniticketz.com/politica-de-privacidade)
- [Termos de Uso](https://omniticketz.com/termos-de-uso)
- [Documentação da API](https://docs.omniticketz.com)

## Contato

- WhatsApp: +55 38 99882-6267
- Site: https://omniticketz.com