Skip to content

A15: pedidos e reembolso no painel - #148

Merged
tecrodrigocastro merged 3 commits into
mainfrom
feat/a15-pedidos
Nov 19, 2026
Merged

tecrodrigocastro merged 3 commits into
mainfrom
feat/a15-pedidos

Conversation

@tecrodrigocastro

Copy link
Copy Markdown
Member

Closes #63

Tela de pedidos do painel (/pedidos) e o que faltava no backend para ela.

Backend

  • POST /ticketing/orders/{id}/mark-paid: marca como pago um pedido criado ou aguardando pagamento, para dinheiro que entrou fora do gateway.
    • A justificativa é obrigatória (pelo menos 10 caracteres).
    • Fica na auditoria em ticketing.order_status_changed, com reason = "manual: ..." e o nome de quem marcou.
    • Os ingressos são emitidos como num pagamento normal, e a cobrança aberta no gateway é cancelada.
    • Só quem tem edition.manage pode usar.
  • POST /ticketing/orders/{id}/payment-reminder: reenvia a cobrança.
    • Manda o e-mail pix_reminder com o link do checkout do pedido.
    • Só funciona enquanto a reserva vale.
    • Auditado como ticketing.payment_reminder_sent, com throttle:6,1, e só para quem tem edition.manage.
  • GET /ticketing/orders/{id}/history: a linha do tempo do pedido.
    • Mostra a criação e tudo que a auditoria registrou: pagamento iniciado (com o método), pago, pago à mão (com a justificativa), reembolsos, cobrança reenviada, expirado e cancelado.
    • Cada linha vem com o nome de quem fez.
  • GET /ticketing/orders/export: CSV com os mesmos filtros da lista.
    • Separado por ponto e vírgula, com BOM, valores em reais e datas no fuso da edição.
    • Texto que começa com =, +, - ou @ ganha apóstrofo, para não virar fórmula na planilha.
    • O corpo é gravado dentro do contexto da edição, porque o stream roda depois que a requisição já saiu dele.
  • GET /ticketing/orders/{id} passa a trazer meta.payment: a cobrança em andamento, com método, situação, parcelas e motivo de falha.
  • Contrato novo no Audit: AuditTrail::forSubject(edition, type, id). O Ticketing lê o histórico por ele, sem tocar na tabela do Audit.
  • O e-mail pix_reminder deixa de dizer "expira em 30 minutos", porque agora quem envia é a organização na hora que quiser.
    • Novo nome: "Lembrete de pagamento".
    • Novo texto: "ainda não foi pago… antes de a reserva expirar".
    • O texto que a edição já editou continua valendo.

Tela

  • Lista com busca (nome, e-mail ou número), filtro por situação, paginação de 25 e estado vazio próprio para quando o filtro não acha nada.
  • Botão Exportar CSV com os filtros atuais.
  • O detalhe abre na gaveta lateral e mostra:
    • comprador e ingressos, com os cancelados marcados;
    • pagamento e totais: desconto, taxa repassada, reembolsado e taxa do gateway;
    • reembolsos, com "Registrar resultado" quando o gateway não respondeu;
    • o histórico.
  • Ações conforme a situação e o papel:
    • Reenviar cobrança, Marcar como pago e Cancelar pedido: só para a organização.
    • Reembolsar: organização e financeiro.
    • Pedido importado ou sem valor não tem reembolso, e edição encerrada fica só para consulta.
  • Reembolso:
    • valor total ou parcial, motivo, observação interna e opção de cancelar todos os ingressos ou só alguns;
    • aviso de que a taxa do gateway normalmente não volta e do prazo no Pix e no cartão;
    • antes de estornar, uma tela de confirmação com o valor e quem recebe, e o botão só libera depois de marcar "Conferi o valor e quero estornar";
    • no fim, o resultado do estorno: confirmado, em processamento, sem resposta do gateway (com o que fazer) ou recusado (com o motivo).

Documento de arquitetura

  • O print painel-pedidos.png entrou na página 18.
  • Contratos: 26. Eventos auditáveis: 23. A auditoria ganhou a linha sobre o AuditTrail.
  • A página de reembolso agora fala do "marcar como pago", e o roadmap mostra a A15 pronta.

Verificação

  • Backend:
    • composer check verde: pint, phpstan nível 8, rector e 1069 testes (1067 passaram, 2 pulados).
    • OrderManagementTest tem 7 cenários: pagamento no detalhe; marcar como pago com auditoria e histórico; permissões (o financeiro não marca nem cobra; o check-in não vê); lembrete e reserva vencida; pedido cancelado; CSV com filtro e escape de fórmula; isolamento entre edições.
  • Front:
    • lint e typecheck verdes; 355 testes Vitest, sendo 10 novos.
    • 88 cenários e2e no navegador, sendo 5 novos em e2e/orders.spec.ts: filtro e estado vazio, reembolso parcial com confirmação, reenviar cobrança e marcar como pago, permissões do financeiro, exportar CSV.
  • Não verificado aqui:
    • api-types.d.ts não foi regenerado. Ele está bem atrasado em relação à API, e regenerar daria um diff de 12 mil linhas que não tem a ver com este PR. Os módulos usam os próprios tipos.
    • A comparação com o protótipo do claude.ai não foi feita, porque não consigo abrir o link daqui.

…idos

Marcar como pago exige justificativa, vai para a auditoria, emite os
ingressos e cancela a cobrança aberta. O histórico do pedido vem do novo
contrato AuditTrail do Audit. O e-mail de lembrete deixa de prometer
30 minutos, porque agora é enviado pela organização.
@tecrodrigocastro
tecrodrigocastro merged commit f0aa0db 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.

A15 · Pedidos e reembolso

1 participant