Skip to content

A14: ingressos — tipos, lotes, cupons e regras da venda - #146

Merged
tecrodrigocastro merged 5 commits into
mainfrom
feat/a14-ingressos
Nov 19, 2026
Merged

tecrodrigocastro merged 5 commits into
mainfrom
feat/a14-ingressos

Conversation

@tecrodrigocastro

@tecrodrigocastro tecrodrigocastro commented Nov 19, 2026 •

Copy link
Copy Markdown
Member

Closes #62

Depende do #147 (B47): a base já é main, mas faça o merge do #147 antes. Até lá, os dois commits da B47 aparecem também aqui.

Tela /ingressos do painel: o que vai ser vendido. Fica no módulo novo tickets do front-admin.

O que tem

  • Tipos e lotes
    • Cada tipo de ingresso aparece num cartão com a visibilidade e o total vendido.
    • A tabela de lotes mostra preço, quanto a edição recebe depois da taxa do gateway, vendidos sobre quantidade, período, situação e qual é o lote atual.
    • Dá para reordenar os tipos e, por lote, editar, encerrar (à venda ou agendado) e remover (sem vendas). Encerrar e remover pedem confirmação.
  • Formulário do tipo, numa gaveta lateral:
    • nome e descrição;
    • quem pode comprar (qualquer pessoa, quem tem o código, só por convite), com o código de acesso;
    • mínimo e máximo por pedido;
    • mostrar quantos restam;
    • repassar a taxa para quem compra;
    • perguntas do checkout: texto, lista com opções ou sim/não, obrigatória ou não, até 10.
  • Formulário do lote:
    • preço digitado em reais ("150", "1.234,56") e enviado em centavos;
    • quantidade, começo e fim (mandados em UTC);
    • o que fazer ao esgotar.
  • Cupons
    • A lista mostra código, desconto, usos sobre o limite, validade, desconto já dado e situação (ativo, pausado, agendado, vencido, esgotado).
    • O formulário tem percentual ou valor fixo, limite de usos, validade e para quais ingressos vale.
    • Cupom já usado não muda de código, como no backend, e só cupom sem uso pode ser removido.
  • Regras da venda: lugares na edição, minutos para pagar, ingressos por pessoa e a taxa estimada do gateway em %.
  • Valores sempre em reais com separador de milhar (Intl.NumberFormat('pt-BR')).
  • Papéis: o organizador edita; o financeiro, que também vê o menu Ingressos, só consulta. Edição encerrada fica só leitura.

Itens da issue

  • Cálculo ao vivo do valor líquido. No formulário do lote, o bloco mostra "Quem compra paga", "Taxa do gateway (x%)" e "A edição recebe", e muda a cada tecla. A conta é a mesma do backend (Split::fee, arredonda para cima). Com a taxa repassada, ela soma ao preço; sem, sai do que a edição recebe. Ingresso gratuito diz que não passa pelo gateway.
  • Aviso "vendas pausadas". Aparece quando há lote pago à venda ou agendado e a conta do gateway não está validada, com link para Pagamentos.
    • Para isso, o GET /ticketing/ticket-types ganhou meta.gateway_ready, pelo contrato PaymentAccounts::ready. A tela não pode ler /payments/accounts porque ela exige payments.gateway, e o financeiro não tem.
  • Alerta ao editar preço de lote com vendas (critério de aceite): "Este lote já tem N ingressos vendidos ou reservados. O preço novo só vale para as próximas compras; pedidos existentes não mudam."
  • Prévia do cartão de ingresso (critério de aceite): fica ao lado do formulário do tipo e mostra nome, lote, descrição, preço como quem compra paga (com a taxa repassada), quantos restam, esgotado e o selo "Só com código".

Estados e acessibilidade

  • Esqueleto ao carregar, PhLoadError com "Tentar de novo" e PhEmptyState com a próxima ação em tipos e cupons.
  • PhFormErrors no topo dos formulários, que leva ao campo.
  • Situações sempre com texto, além da cor. O cálculo do líquido fica numa região aria-live.
  • Botões de ação com aria-label que diz qual lote e qual tipo.

Documento de arquitetura

Ganhou a página 18, "Telas: vendas e organização", com o print desta tela. As próximas telas do Marco 2 entram nela. O roadmap foi atualizado.

Test plan

  • npm run lint, npm run typecheck e npm test passam: 345 testes, dos quais 13 são novos (dinheiro e taxa, serviço, composable, prévia e modal do lote).
  • npx playwright test e2e/tickets.spec.ts: 5 cenários no navegador.
    • lista com líquido e aviso de vendas pausadas;
    • editar preço com vendas, conferindo o alerta, o líquido e o envio em centavos;
    • criar tipo com código e pergunta, vendo a prévia;
    • criar cupom;
    • o financeiro só lê.
  • composer check no backend: 1062 testes, com a asserção nova de meta.gateway_ready.
  • Olhar a tela contra o protótipo de design do claude.ai, que não consigo abrir daqui.

…o endereço

Assinatura Svix verificada com janela de 5 minutos, um registro por
svix-id, edição descoberta pelo envio e bounce permanente ou reclamação
bloqueando o endereço na edição até a organização liberar.
Valor líquido calculado ao vivo depois da taxa do gateway, prévia do
cartão como no checkout, aviso de vendas pausadas sem gateway validado
e alerta ao mudar o preço de lote que já tem vendas.
@tecrodrigocastro tecrodrigocastro self-assigned this Nov 19, 2026
@tecrodrigocastro
tecrodrigocastro changed the base branch from feat/b47-webhooks-resend to main November 19, 2026 16:02
@tecrodrigocastro
tecrodrigocastro merged commit ca9d2a1 into main Nov 19, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

A14 · Ingressos: tipos, lotes e cupons

1 participant