diff --git a/backend/CLAUDE.md b/backend/CLAUDE.md index 2a6f4d6..ff236bb 100644 --- a/backend/CLAUDE.md +++ b/backend/CLAUDE.md @@ -13,9 +13,9 @@ Com implementação real até agora: - `identity`: `users` (UUID, ver ADR 0007), cadastro com verificação de e-mail, login/logout via Sanctum, `GET /me` (com os papéis da pessoa em cada edição, lidos pelo contrato `EditionMemberships` do Community). Outro módulo consulta e cria conta pelo contrato `UserAccounts`. Recuperação de senha pelo broker do Laravel (link de uso único para `{ADMIN_URL}/redefinir-senha`, expira em `AUTH_PASSWORD_RESET_EXPIRE` minutos, derruba todas as sessões), troca de senha autenticada (mantém só a sessão atual) e login com GitHub via Socialite, sem sessão: `GET /auth/github/redirect` devolve a URL com `state` cifrado, o painel recebe o `code` em `{ADMIN_URL}/login/github` e manda `code` e `state` para `POST /auth/github/callback`. O vínculo usa só o e-mail primário verificado do GitHub (`social_accounts`). Conta criada pelo GitHub não tem senha (`password` nulo) e só desconecta o GitHub depois de definir uma. Sessões ativas da pessoa (`GET /me/sessions`, um token Sanctum por dispositivo; `DELETE /me/sessions/{id}` revoga o token na hora) e preferências de notificação por e-mail (`NotificationTopic`, em `users.notification_preferences`; quem envia confere `User::wantsNotification()`). Perfil global (`PATCH /me`, foto em `POST /me/photo`: conteúdo validado e regravado em JPEG 800×800 no disco `MEDIA_DISK`) e perfil de palestrante global (`speaker_profiles`, público) com dados sensíveis separados e cifrados (`speaker_private_details`). Outro módulo lê o perfil público e a UF pelo contrato `SpeakerProfiles`. A organização vê o perfil completo de quem *participa* da edição (permissão `program.manage`); "participar" é decidido pelos módulos que implementam `EditionParticipation` e se registram com `$app->tag([...], EditionParticipation::TAG)` (hoje a equipe, via Community). - `community`: comunidades, edições com máquina de estados (`EditionStatus`, com o que cada etapa libera e bloqueia em `effects()`), modo do site (`SiteMode`: site da plataforma ou site próprio da comunidade, com `external_site_url`; a origem desse site ganha CORS só nas rotas `/api/v1/public/*` pelo `AllowEditionSiteOrigins`, ver `docs/site-proprio.md`), dados de privacidade da edição (encarregado, política, anonimizar após o evento; mudanças auditadas em `EditionSettingsChanged`), equipe (`edition_members`) com convites por e-mail (`edition_invitations`, token guardado só como hash, 7 dias) e a infraestrutura de tenancy usada pelos outros módulos (ver abaixo). - `cfp`: configuração da chamada por edição (`cfp_settings`, trilhas e critérios com peso). O status do CFP (`CfpStatus`) é derivado da janela e do estado da edição, nunca editado: `cfp:sync-status` (agendado a cada minuto) e o listener de `EditionStatusChanged` disparam `CfpOpened`/`CfpClosed` uma vez cada. Mudar critérios depois de avaliações exige `confirm=true`, e critério removido é soft delete para preservar as notas; quem conta as avaliações é o contrato `ReviewLedger`. Propostas (`proposals`) com autoria separada do conteúdo (`proposal_speakers`, dono e até 3 coautores): rascunho, envio só com o CFP aberto, perfil de palestrante e campos completos, limite por pessoa, retirada, e-mail `ProposalReceived`. O palestrante usa `/api/v1/speaker/editions/{id}/proposals`; a organização e os revisores usam `/editions/{id}/cfp/proposals`. Com avaliação anônima, quem não tem `program.manage` nunca recebe autoria (`ProposalPresenter`). Avaliação: atribuição manual e automática (`review_assignments`, menor carga primeiro, sem conflito de interesse: autoria ou mesma empresa no perfil de palestrante), notas de 1 a 5 por critério (`reviews`, `review_scores`), nota final ponderada calculada na hora sobre os critérios atuais (`ScoreCalculator`), quadro com pendente, avaliada e empate (`EvaluationBoard`) e exportação CSV. Decisão: ranking por trilha respeitando vagas (sem sugerir quando há empate no corte), simulação que não grava nada e devolve cobertura por UF, % do Nordeste (arredondado para baixo), estados do Nordeste sem representante e alertas (`DecisionBoard`, `CoverageCalculator`), e aplicação em transação que dispara `ProposalDecided` (auditado). Confirmação do palestrante (`speaker_confirmations`): nasce de `ProposalDecided` aprovada, com prazo (`confirmation_days`) e e-mail com link para o site da edição (`EditionSites`); `cfp:confirmation-deadlines` (de hora em hora) lembra 48 h antes e marca "sem resposta" depois do prazo, sem recusar sozinho; recusa e desistência liberam a vaga, e `WaitlistPromotions` sugere quem da lista de espera sobe, só com confirmação da organização. Logística por palestrante e edição em `speaker_logistics`. Quadro de palestrantes da organização (`SpeakerBoard`, `GET /cfp/speakers`): uma linha por pessoa e proposta aprovada ou na lista de espera, indicadores, cobertura dos nove estados do Nordeste entre os confirmados, lembrete manual (`POST /cfp/speakers/remind`, no máximo um a cada 12 h por proposta) e presença (`attended_at`). Acessibilidade e alimentação só saem com a permissão `speakers.private`. Convite direto de palestrante (`POST /cfp/speakers/invite`, `InviteSpeaker`): usa a conta do e-mail ou cria uma sem senha (`UserAccounts::findOrCreateInvited`), cria a proposta já aprovada com `origin = invited` e a confirmação com prazo, manda o e-mail `SpeakerInvited` e audita `cfp.speaker_invited`. Proposta convidada fica fora da avaliação, da atribuição, da decisão e do limite por pessoa (`Proposal::fromCfp()`), mas ocupa vaga da trilha: o ranking desconta essas vagas (`reserved`). -- `audit`: trilha append-only em `audit_logs` (quem, o quê, antes, depois, IP, `request_id`, edição). Todo evento que implementa `PHPeste\Audit\Contracts\Auditable` vira registro pelo listener genérico `RecordAuditableEvent`, com segredos removidos por inteiro e dados pessoais mascarados (`AuditRedactor`). Consulta em `GET /editions/{id}/audit` (filtros por pessoa, ação e período); o model recusa update e delete, e só o `audit:prune` diário apaga o que passou de `AUDIT_RETENTION_DAYS`. +- `audit`: trilha append-only em `audit_logs` (quem, o quê, antes, depois, IP, `request_id`, edição). Todo evento que implementa `PHPeste\Audit\Contracts\Auditable` vira registro pelo listener genérico `RecordAuditableEvent`, com segredos removidos por inteiro e dados pessoais mascarados (`AuditRedactor`). Consulta em `GET /editions/{id}/audit` (filtros por pessoa, ação e período); outro módulo lê o histórico de um registro pelo contrato `AuditTrail::forSubject` (ex.: o histórico do pedido); o model recusa update e delete, e só o `audit:prune` diário apaga o que passou de `AUDIT_RETENTION_DAYS`. - `branding`: tema por edição em `edition_settings` (rascunho, publicado e anterior, para reverter), presets Sertão/Maré/Brasa, checagem de contraste AA em `Theme/ContrastChecker`, upload de logos (SVG sanitizado com `enshrined/svg-sanitize`, disco `public`, exige `php artisan storage:link`) e `GET /api/v1/public/editions/{id}/theme` com cache e `ETag`. Os tokens de cor seguem os `--ph-*` do front-admin (`support` = `--ph-terra`, `on_accent` = texto sobre destaque). Domínios por edição em `edition_domains` (subdomínio da plataforma verificado na hora, domínio próprio por TXT ou CNAME), com resolução pública pelo host e `tls-check` para o on-demand TLS do Caddy (ver `docs/deploy/dominios-e-tls.md`). -- `ticketing`: tipos de ingresso (`ticket_types`: visibilidade pública, por código ou oculta, mínimo e máximo por pedido, perguntas do checkout em JSON) e lotes (`ticket_batches`: preço em centavos, quantidade, janela, o que fazer ao acabar), com a capacidade da edição em `ticketing_settings`. Estoque nunca é lido e depois gravado: `AllocateTickets` reserva com `UPDATE ... WHERE allocated + q <= quantity` no lote e na capacidade, na mesma transação, e devolve um `Allocation` com o preço do momento (o pedido guarda esse preço; mudar o lote não afeta quem já comprou). `ReleaseTickets` devolve o que expirou. `BatchRotation` encerra o lote esgotado ou vencido e abre o próximo (`ticketing:rotate-batches`, a cada minuto, e na hora em que o lote esgota). `TicketInventoryConcurrencyTest` prova com 12 processos PHP simultâneos que não há venda além do estoque. Página pública em `GET /public/editions/{id}/tickets?code=`. Cupons (`coupons`: código guardado e comparado em maiúsculas, percentual ou valor fixo por pedido, limite de usos, validade, ingressos aplicáveis): `CouponPricing::quote()` calcula desconto e total em centavos (percentual arredonda para baixo, valor fixo nunca deixa negativo) e diz se precisa de pagamento (cortesia de 100% não passa pelo gateway); `RedeemCoupon` gasta um uso com `UPDATE ... WHERE used < max_uses` e grava o uso em `coupon_redemptions`; `ReleaseCouponRedemption` devolve o uso uma vez só. Cupom usado não muda de código nem é removido (pausa). `CouponConcurrencyTest` prova com processos simultâneos que o último uso só é aprovado uma vez. Checagem pública em `POST /public/editions/{id}/coupons/check` (`throttle:checkout`). Pedidos (`orders`, `order_items` com um item por participante, preço, desconto e taxa guardados no item): `OrderStatus` define as transições (criado → aguardando pagamento → pago → reembolsado; criado ou aguardando → expirado ou cancelado) e `TransitionOrder` é o único caminho para mudar o status, com `UPDATE ... WHERE status = de` (transição concorrente não roda duas vezes), devolvendo estoque e cupom ao expirar ou cancelar e disparando `OrderStatusChanged` (auditado). `PlaceOrder` reserva estoque, gasta o cupom e cria o pedido numa transação só; total zero nasce pago, sem gateway. A taxa estimada do gateway (`gateway_fee_basis_points`) só entra no total dos tipos com `pass_fee_to_buyer`. Idempotência no banco, não no cache: `unique(edition_id, idempotency_key)` mais o hash do corpo (mesma chave com outro corpo é 409); o `EnsureIdempotencyKey` genérico guarda até resposta 422 e não serve para o checkout. Quem compra acompanha o pedido com o `access_token` (cifrado) no header `X-Order-Token`. CPF de quem paga é obrigatório quando há valor, guardado cifrado e com HMAC para o limite por pessoa (`max_tickets_per_buyer`, por e-mail ou CPF). Pagamento do pedido em `POST/GET /checkout/editions/{id}/orders/{order}/payment` (`StartOrderPayment`): campos de cartão são proibidos na requisição, o pedido vai para aguardando pagamento e o listener `SyncOrderWithCharge` confirma (ou marca reembolsado) quando a cobrança muda; valor diferente do pedido ou pedido já expirado não muda nada e fica no log. `CancelPendingCharges` cancela no gateway a cobrança de pedido expirado ou cancelado. Pedido pago guarda a conta que recebe (`payment_account_id`) e só é criado com a conta pronta ("Vendas pausadas até o teste do gateway"); `SalesReadinessGuard` impede abrir vendas com lote pago sem a conta pronta. `ticketing:expire-orders` (a cada minuto) expira reservas vencidas (`reservation_minutes`, padrão 30). Teste de processo simultâneo com SQLite usa `transaction_mode = IMMEDIATE` no script filho (transação que lê antes de escrever dá `database is locked` no SQLite). Reembolso pelo painel (`POST /ticketing/orders/{id}/refunds`, permissão `orders.refund`, do organizador e do financeiro): total ou parcial, com motivo (`RefundReason`) e observação interna, e opção de cancelar ingressos (`cancel_tickets`, todos ou `item_ids`), que ganham `cancelled_at` e devolvem a vaga ao lote. Quem estorna é o contrato `PaymentLedger` do Payments; quando o gateway aceita, o evento `RefundAccepted` faz o Ticketing somar `orders.refunded_cents`, cancelar os ingressos escolhidos, auditar `ticketing.order_refunded` e mandar o e-mail `order_refunded` para quem comprou. Ingresso válido é item sem `cancelled_at`. A taxa do gateway fica em `orders.gateway_fee_cents`. Conciliação diária (`ticketing:reconcile`, 04:00 de Brasília, ou `POST /ticketing/reconciliation/run`): reconsulta no gateway as cobranças pendentes, as pagas nos últimos 7 dias e as canceladas ou vencidas há pouco (Pix pago depois de expirar), compara com os pedidos e grava divergências em `reconciliation_issues` (`ReconciliationKind`: pago sem cobrança, cobrança sem pedido pago, valor diferente, pagamento em dobro, contestação, reembolso sem confirmação). Divergência nova vai para o log e para a visão geral; a que some sozinha é resolvida na próxima conferência; a que a organização resolve (`POST /ticketing/reconciliation/{id}/resolve`, com o que foi feito) não volta a abrir. Ingressos em `tickets` (um por item do pedido, emitidos por `IssueTicketsWhenPaid` quando o pedido fica pago, inclusive o gratuito, e enviados no e-mail `order_confirmed` para o e-mail de cada participante). O QR é `PHT1.{id}.{versão}.{HMAC}` (`Tickets\QrToken`, chave `TICKETING_QR_KEY` ou derivada da `APP_KEY`): sem dado pessoal e impossível de adivinhar. Transferir (`TransferTicket`, pela pessoa ou pela organização) troca o titular, limpa crachá, empresa, camiseta e acessibilidade, sobe a versão (o QR antigo vira `replaced`), grava `ticket_transfers`, audita `ticketing.ticket_transferred` e manda o e-mail `ticket_transferred`. O check-in confere o QR pelo contrato `TicketVerifier::check` (`valid`, `unknown`, `replaced`, `cancelled`). Reembolso que cancela o item cancela o ingresso. Área do participante em `/attendee/editions/{id}/tickets` (listar, ver com QR e histórico, editar dados do crachá, transferir, reenviar): a pessoa vê o ingresso cujo `holder_user_id` é ela ou, com o e-mail verificado, cujo e-mail é o dela (e o ingresso passa a ser dela). Organização em `/ticketing/tickets` (filtros `status`, `ticket_type_id`, `tshirt_size`, `q`, `accessibility`); acessibilidade (cifrada) só aparece para quem tem `edition.manage`, nunca para financeiro ou check-in. Importação de compradores de outra plataforma (Sympla, Even3, planilha), só para quem tem `edition.manage`, em `/ticketing/imports`: o CSV (UTF-8 ou Windows-1252, separador descoberto sozinho, até `TICKETING_IMPORT_MAX_ROWS` linhas) fica no disco privado (`TICKETING_IMPORT_DISK`) e o cabeçalho ganha um mapeamento sugerido (`ColumnGuesser`, campos em `ImportField`); `PUT .../mapping` grava as colunas e liga cada valor da coluna de tipo a um tipo da edição (ou `null` para deixar essas linhas de fora, ou um tipo padrão), com prévia das primeiras linhas sem gravar nada (`ImportPreview`). `POST .../start` põe na fila o `ProcessTicketImport`, que importa um lote de `TICKETING_IMPORT_CHUNK_SIZE` linhas por execução e se coloca de volta na fila; o lote inteiro e a posição em bytes no arquivo (`byte_offset`) são gravados numa transação só, então uma queda refaz só aquele lote. Importação parada volta pelo `POST .../resume` ou sozinha pelo `ticketing:resume-imports` (a cada 5 min, para as que não avançam há 10 min). Cada linha aceita vira pedido externo (`orders.source = import`, `external_platform`, `external_reference`): pago, total zero, sem cobrança, sem conta de gateway e sem taxa, por isso fica fora da conciliação e do reembolso; linhas com o mesmo número de pedido da mesma plataforma entram no mesmo pedido. O item não tem lote (`ticket_batch_id` nulo, a venda foi em outro lugar), mas ocupa a capacidade da edição. Repetida (`RowEvaluator`) é a linha cujo código do ingresso (`order_items.external_code`, único na edição) já foi importado ou, sem código, cujo e-mail já tem ingresso válido do mesmo tipo; reimportar o mesmo arquivo não cria ninguém de novo. Linhas repetidas e rejeitadas ficam em `ticket_import_rejections` (valores cifrados), em `GET .../rejections` e em CSV em `GET .../rejections.csv`. Os ingressos são emitidos sem e-mail (`IssueTickets::handle($order, notify: false)`); o envio só sai por `POST .../email` com `confirm=true` e `recipients` igual ao número de ingressos ainda não enviados (auditado como `ticketing.import_emails_sent`). Início e fim da importação são auditados (`ticketing.import_started`, `ticketing.import_finished`), e o arquivo é apagado ao terminar. +- `ticketing`: tipos de ingresso (`ticket_types`: visibilidade pública, por código ou oculta, mínimo e máximo por pedido, perguntas do checkout em JSON) e lotes (`ticket_batches`: preço em centavos, quantidade, janela, o que fazer ao acabar), com a capacidade da edição em `ticketing_settings`. Estoque nunca é lido e depois gravado: `AllocateTickets` reserva com `UPDATE ... WHERE allocated + q <= quantity` no lote e na capacidade, na mesma transação, e devolve um `Allocation` com o preço do momento (o pedido guarda esse preço; mudar o lote não afeta quem já comprou). `ReleaseTickets` devolve o que expirou. `BatchRotation` encerra o lote esgotado ou vencido e abre o próximo (`ticketing:rotate-batches`, a cada minuto, e na hora em que o lote esgota). `TicketInventoryConcurrencyTest` prova com 12 processos PHP simultâneos que não há venda além do estoque. Página pública em `GET /public/editions/{id}/tickets?code=`. Cupons (`coupons`: código guardado e comparado em maiúsculas, percentual ou valor fixo por pedido, limite de usos, validade, ingressos aplicáveis): `CouponPricing::quote()` calcula desconto e total em centavos (percentual arredonda para baixo, valor fixo nunca deixa negativo) e diz se precisa de pagamento (cortesia de 100% não passa pelo gateway); `RedeemCoupon` gasta um uso com `UPDATE ... WHERE used < max_uses` e grava o uso em `coupon_redemptions`; `ReleaseCouponRedemption` devolve o uso uma vez só. Cupom usado não muda de código nem é removido (pausa). `CouponConcurrencyTest` prova com processos simultâneos que o último uso só é aprovado uma vez. Checagem pública em `POST /public/editions/{id}/coupons/check` (`throttle:checkout`). Pedidos (`orders`, `order_items` com um item por participante, preço, desconto e taxa guardados no item): `OrderStatus` define as transições (criado → aguardando pagamento → pago → reembolsado; criado ou aguardando → expirado ou cancelado) e `TransitionOrder` é o único caminho para mudar o status, com `UPDATE ... WHERE status = de` (transição concorrente não roda duas vezes), devolvendo estoque e cupom ao expirar ou cancelar e disparando `OrderStatusChanged` (auditado). `PlaceOrder` reserva estoque, gasta o cupom e cria o pedido numa transação só; total zero nasce pago, sem gateway. A taxa estimada do gateway (`gateway_fee_basis_points`) só entra no total dos tipos com `pass_fee_to_buyer`. Idempotência no banco, não no cache: `unique(edition_id, idempotency_key)` mais o hash do corpo (mesma chave com outro corpo é 409); o `EnsureIdempotencyKey` genérico guarda até resposta 422 e não serve para o checkout. Quem compra acompanha o pedido com o `access_token` (cifrado) no header `X-Order-Token`. CPF de quem paga é obrigatório quando há valor, guardado cifrado e com HMAC para o limite por pessoa (`max_tickets_per_buyer`, por e-mail ou CPF). Pagamento do pedido em `POST/GET /checkout/editions/{id}/orders/{order}/payment` (`StartOrderPayment`): campos de cartão são proibidos na requisição, o pedido vai para aguardando pagamento e o listener `SyncOrderWithCharge` confirma (ou marca reembolsado) quando a cobrança muda; valor diferente do pedido ou pedido já expirado não muda nada e fica no log. `CancelPendingCharges` cancela no gateway a cobrança de pedido expirado ou cancelado. Pedido pago guarda a conta que recebe (`payment_account_id`) e só é criado com a conta pronta ("Vendas pausadas até o teste do gateway"); `SalesReadinessGuard` impede abrir vendas com lote pago sem a conta pronta. `ticketing:expire-orders` (a cada minuto) expira reservas vencidas (`reservation_minutes`, padrão 30). Teste de processo simultâneo com SQLite usa `transaction_mode = IMMEDIATE` no script filho (transação que lê antes de escrever dá `database is locked` no SQLite). Reembolso pelo painel (`POST /ticketing/orders/{id}/refunds`, permissão `orders.refund`, do organizador e do financeiro): total ou parcial, com motivo (`RefundReason`) e observação interna, e opção de cancelar ingressos (`cancel_tickets`, todos ou `item_ids`), que ganham `cancelled_at` e devolvem a vaga ao lote. Quem estorna é o contrato `PaymentLedger` do Payments; quando o gateway aceita, o evento `RefundAccepted` faz o Ticketing somar `orders.refunded_cents`, cancelar os ingressos escolhidos, auditar `ticketing.order_refunded` e mandar o e-mail `order_refunded` para quem comprou. Ingresso válido é item sem `cancelled_at`. A taxa do gateway fica em `orders.gateway_fee_cents`. Conciliação diária (`ticketing:reconcile`, 04:00 de Brasília, ou `POST /ticketing/reconciliation/run`): reconsulta no gateway as cobranças pendentes, as pagas nos últimos 7 dias e as canceladas ou vencidas há pouco (Pix pago depois de expirar), compara com os pedidos e grava divergências em `reconciliation_issues` (`ReconciliationKind`: pago sem cobrança, cobrança sem pedido pago, valor diferente, pagamento em dobro, contestação, reembolso sem confirmação). Divergência nova vai para o log e para a visão geral; a que some sozinha é resolvida na próxima conferência; a que a organização resolve (`POST /ticketing/reconciliation/{id}/resolve`, com o que foi feito) não volta a abrir. Painel de pedidos em `/ticketing/orders` (busca por nome, e-mail ou número, filtro `status`, 25 por página; `GET .../export` gera o CSV com os mesmos filtros, separado por ponto e vírgula, com BOM, datas no fuso da edição e escape de fórmula). O detalhe traz a cobrança em andamento (`meta.payment`, pelo `PaymentProcessor::current`) e `GET .../{id}/history` monta a linha do tempo (`Orders\OrderHistory`: criação mais o que a auditoria registrou, com o nome de quem fez). Só quem tem `edition.manage` marca como pago à mão (`POST .../mark-paid`, `MarkOrderPaid`: justificativa obrigatória gravada na auditoria como `reason` = `manual: ...`, emite os ingressos e cancela a cobrança aberta) e reenvia a cobrança (`POST .../payment-reminder`, `SendPaymentReminder`: e-mail `pix_reminder` com o link do checkout do pedido, só com a reserva valendo, auditado como `ticketing.payment_reminder_sent`). Ingressos em `tickets` (um por item do pedido, emitidos por `IssueTicketsWhenPaid` quando o pedido fica pago, inclusive o gratuito, e enviados no e-mail `order_confirmed` para o e-mail de cada participante). O QR é `PHT1.{id}.{versão}.{HMAC}` (`Tickets\QrToken`, chave `TICKETING_QR_KEY` ou derivada da `APP_KEY`): sem dado pessoal e impossível de adivinhar. Transferir (`TransferTicket`, pela pessoa ou pela organização) troca o titular, limpa crachá, empresa, camiseta e acessibilidade, sobe a versão (o QR antigo vira `replaced`), grava `ticket_transfers`, audita `ticketing.ticket_transferred` e manda o e-mail `ticket_transferred`. O check-in confere o QR pelo contrato `TicketVerifier::check` (`valid`, `unknown`, `replaced`, `cancelled`). Reembolso que cancela o item cancela o ingresso. Área do participante em `/attendee/editions/{id}/tickets` (listar, ver com QR e histórico, editar dados do crachá, transferir, reenviar): a pessoa vê o ingresso cujo `holder_user_id` é ela ou, com o e-mail verificado, cujo e-mail é o dela (e o ingresso passa a ser dela). Organização em `/ticketing/tickets` (filtros `status`, `ticket_type_id`, `tshirt_size`, `q`, `accessibility`); acessibilidade (cifrada) só aparece para quem tem `edition.manage`, nunca para financeiro ou check-in. Importação de compradores de outra plataforma (Sympla, Even3, planilha), só para quem tem `edition.manage`, em `/ticketing/imports`: o CSV (UTF-8 ou Windows-1252, separador descoberto sozinho, até `TICKETING_IMPORT_MAX_ROWS` linhas) fica no disco privado (`TICKETING_IMPORT_DISK`) e o cabeçalho ganha um mapeamento sugerido (`ColumnGuesser`, campos em `ImportField`); `PUT .../mapping` grava as colunas e liga cada valor da coluna de tipo a um tipo da edição (ou `null` para deixar essas linhas de fora, ou um tipo padrão), com prévia das primeiras linhas sem gravar nada (`ImportPreview`). `POST .../start` põe na fila o `ProcessTicketImport`, que importa um lote de `TICKETING_IMPORT_CHUNK_SIZE` linhas por execução e se coloca de volta na fila; o lote inteiro e a posição em bytes no arquivo (`byte_offset`) são gravados numa transação só, então uma queda refaz só aquele lote. Importação parada volta pelo `POST .../resume` ou sozinha pelo `ticketing:resume-imports` (a cada 5 min, para as que não avançam há 10 min). Cada linha aceita vira pedido externo (`orders.source = import`, `external_platform`, `external_reference`): pago, total zero, sem cobrança, sem conta de gateway e sem taxa, por isso fica fora da conciliação e do reembolso; linhas com o mesmo número de pedido da mesma plataforma entram no mesmo pedido. O item não tem lote (`ticket_batch_id` nulo, a venda foi em outro lugar), mas ocupa a capacidade da edição. Repetida (`RowEvaluator`) é a linha cujo código do ingresso (`order_items.external_code`, único na edição) já foi importado ou, sem código, cujo e-mail já tem ingresso válido do mesmo tipo; reimportar o mesmo arquivo não cria ninguém de novo. Linhas repetidas e rejeitadas ficam em `ticket_import_rejections` (valores cifrados), em `GET .../rejections` e em CSV em `GET .../rejections.csv`. Os ingressos são emitidos sem e-mail (`IssueTickets::handle($order, notify: false)`); o envio só sai por `POST .../email` com `confirm=true` e `recipients` igual ao número de ingressos ainda não enviados (auditado como `ticketing.import_emails_sent`). Início e fim da importação são auditados (`ticketing.import_started`, `ticketing.import_finished`), e o arquivo é apagado ao terminar. - `payments`: a plataforma não recebe nem repassa dinheiro (ADR 0009). Cada edição cadastra a conta do próprio gateway em `payment_accounts`: driver, ambiente, credenciais em `encrypted:array` (a API só mostra os 4 últimos caracteres), titular CPF ou CNPJ com nome exibido no checkout e documento só mascarado, métodos aceitos e parcelas. Trocar de conta cria uma nova e marca a anterior com `retired_at` (só consulta e reembolso, que usa sempre a conta do pedido: `RefundCharge`). Com pedidos pagos na conta atual, a troca exige `confirm=true`; quem conta os pedidos é o contrato `AccountUsage`, implementado pelo Ticketing. Toda troca dispara `PaymentAccountChanged` e a validação dispara `PaymentAccountVerified` (auditados, sem a chave). A conta fica pronta (`PaymentAccounts::ready`) com as chaves validadas no gateway (`POST /payments/accounts/{id}/verify`) e um webhook assinado recebido em `POST /api/v1/webhooks/payments/{token}`. Drivers implementam `Contracts\PaymentGateway` e entram em `config/payments.php` → `drivers` (registro em `GatewayRegistry`). O `FakeGateway` implementa o contrato inteiro para os testes (assinatura `X-Fake-Signature` = HMAC do corpo, token `tok_declined` recusa) e fica desligado em produção. Quem recebe aparece em `GET /public/editions/{id}/payments/receiver`. Cada driver declara o que sabe fazer (`GatewayCapability`: Pix, cartão com token do navegador, cartão ou boleto na página do gateway). Driver `asaas` (`Drivers/Asaas`): `AsaasClient` com timeout, retentativa só em leitura e exclusão (criar cobrança nunca é repetido, para não cobrar duas vezes) e erro tipado (`GatewayRequestFailed::reason`, com `publicMessage()` segura para quem compra e o detalhe só no log); cliente reaproveitado pelo CPF, Pix com QR e copia e cola, cartão sempre na fatura do Asaas (`invoiceUrl`, com parcelas e retorno para `{site}/checkout/pedido/{id}`), porque a tokenização do Asaas exige o número do cartão no servidor; webhook autenticado pelo header `asaas-access-token`; status mapeados em `AsaasStatus`. Driver `mercadopago` (`Drivers/MercadoPago`): `MercadoPagoClient` com token Bearer e `X-Idempotency-Key` em todo POST (por isso pode repetir a criação depois de queda de conexão sem cobrar duas vezes), Pix pela API de pagamentos e cartão com o token do formulário do Mercado Pago no navegador (`card_token`, `card_brand`, `card_issuer` no checkout; a conta guarda a `public_key`, que o checkout recebe em `/public/editions/{id}/payments/receiver`). Webhook validado pelo `x-signature` (HMAC-SHA256 de `id:{data.id};request-id:{x-request-id};ts:{ts};`); como o corpo não traz status, o job da caixa de entrada consulta o pagamento. Status em `MercadoPagoStatus` (Pix vencido é `cancelled/expired`). Os dois drivers passam pelo mesmo `GatewayContractTest`, com um harness por driver em `tests/Support`; driver novo entra no dataset. Teste contra a conta de teste: `MERCADOPAGO_SANDBOX_ACCESS_TOKEN=... ./vendor/bin/pest --filter=sandbox`. Taxas e prazos de cada gateway para a comunidade: `../docs/guia-gateways.md`. Cobranças em `payment_charges` (uma por tentativa, `reference` = id do pedido), criadas pelo contrato `PaymentProcessor` (`ChargeService`): trava por pedido contra clique duplo, reaproveita a cobrança pendente igual e cancela a anterior ao trocar de método; status muda com `UPDATE ... WHERE status = de` e dispara `ChargeStatusChanged` uma vez. `current(refresh: true)` consulta o gateway no máximo a cada 5 s. Webhooks entram na caixa `webhook_events` (`ReceiveWebhook`): assinatura validada pelo driver (falha devolve 401, soma em `payment_accounts.webhook_rejections` e vai para o log), corpo guardado cifrado, um registro por `(conta, id do evento)` com `createOrFirst` (entrega repetida responde `duplicate: true` e não volta para a fila) e resposta 2xx antes do processamento, que roda no job `ProcessWebhookEvent`. O job não confia no status do corpo: consulta a cobrança no gateway (`PaymentProcessor::sync`), então evento falso, repetido ou fora de ordem não muda o pedido. Cobrança desconhecida ou evento sem cobrança fica `ignored`; erro fica `failed` e volta para a fila em 1, 5, 15 e 60 min (`payments:retry-webhooks`, a cada minuto, também devolve os parados em `received` ou `processing`). Depois de 5 tentativas, o aviso aparece na visão geral (`webhooks_failed`) e a organização reprocessa em `POST /payments/webhook-events/{id}/reprocess` (auditado como `payments.webhook_reprocessed`); a lista fica em `GET /payments/webhook-events?status=`. Teste de contrato contra o sandbox: `ASAAS_SANDBOX_API_KEY=... ./vendor/bin/pest --filter=sandbox` (a conta sandbox precisa de chave Pix cadastrada). Reembolsos em `payment_refunds` (`PaymentLedger::refund`): o valor é reservado antes de chamar o gateway com `UPDATE ... SET refunded_cents = refunded_cents + x WHERE refunded_cents + x <= amount_cents`, então dois reembolsos ao mesmo tempo nunca passam do pago (`RefundConcurrencyTest`). Gateway recusou: o reembolso fica `failed`, a reserva volta e `RefundFailed` é auditado. Gateway fora do ar: fica `unconfirmed` com a reserva mantida, para ninguém estornar duas vezes, e a organização registra o resultado em `POST /ticketing/orders/{id}/refunds/{refund}/settle`. Reembolso total aceito marca a cobrança como `refunded`. Rotação da `APP_KEY`: `APP_PREVIOUS_KEYS` mais `payments:reencrypt-credentials` e `ticketing:reencrypt-orders`. - `sponsors`: patrocínio por edição, tudo sob a permissão `sponsors.manage` (só organizador), em `/editions/{id}/sponsors`. Cotas (`sponsor_tiers`: valor, vagas, nulo = sem limite, e contrapartidas em texto), empresas (`sponsors`, com contato e observações), acordos (`sponsorships`, o card do funil: empresa, cota, valor, que por padrão é o preço da cota, e responsável da equipe) e meta da edição (`sponsor_settings.goal_cents`). Funil `SponsorshipStage`: prospecção, negociando, fechado, pago e perdido (com motivo). Fechado e pago ocupam vaga da cota: `EnsureTierSlot` trava a cota e conta os acordos fechados; sem vaga, mover, criar já fechado ou trocar a cota de um acordo fechado só passa com `confirm=true`, e o evento `SponsorshipStageChanged` (auditado como `sponsors.stage_changed`) registra `over_slots`. A primeira vez que o acordo fecha cria uma entrega (`sponsor_deliverables`: responsável da equipe, prazo, status) para cada contrapartida da cota. Pagamentos são registrados à mão (`sponsorship_payments`, ADR 0009) e nunca passam do valor do acordo; quando cobrem o valor, o acordo vai sozinho para pago, e remover um pagamento que deixa faltar dinheiro volta para fechado (auditado como `sponsors.payment_recorded`/`payment_removed`). Histórico de contatos em `sponsor_contacts`. Anexos (`sponsor_attachments`: contrato, logo vetorial, outro) ficam no disco privado `SPONSORS_ATTACHMENTS_DISK` (SVG sanitizado) e nunca têm link direto: `GET .../attachments/{id}/url` devolve uma URL assinada que expira em `SPONSORS_ATTACHMENTS_URL_MINUTES`, e o download (`/api/v1/sponsors/attachments/{id}/download`, middleware `signed`, sem login) sai sempre como anexo, com `nosniff` e CSP `sandbox`. `SponsorTotals` dá meta, fechado, recebido, em negociação e contagem e valor por etapa para o funil (`GET .../board`) e para a Visão geral (`indicators.sponsors`, mais a pendência de entregas atrasadas). `SponsorTiersCloner` leva cotas e meta para a próxima edição; empresas, acordos e contatos não vão. Nome de responsável e autor vem do contrato `UserAccounts` (`Http/People`). - `suppliers`: fornecedores, sob a permissão `suppliers.manage` (só organizador), em `/editions/{id}/suppliers`. O cadastro (`suppliers`, com contatos em `supplier_contacts`) é global **da comunidade**, não da plataforma: toda consulta passa por `Access\SupplierAccess`, que filtra pelo `community_id` da edição (lido do contrato `EditionDirectory::communityId`), então outra comunidade recebe 404. Nome (comparado por `name_key`, sem acento e caixa) e CNPJ/CPF não se repetem na comunidade. O contato e o documento só aparecem para quem é da equipe de alguma edição em que o fornecedor está (`canSeeContacts`); para os outros, vem `contacts: null` e `contacts_visible: false`. Na edição, o vínculo (`edition_suppliers`) tem status `SupplierStatus` (a contatar, em orçamento, contratado, recusado), responsável da equipe e valor contratado. O primeiro orçamento (`supplier_quotes`) passa para "em orçamento"; contratar exige um orçamento (que vira aceito) ou um valor, recusar exige motivo, e a mudança é auditada como `suppliers.status_changed`. O "orçado" de cada fornecedor é o menor orçamento recebido ou aceito. A lista (`GET /suppliers`, sem paginação) devolve os totais de orçado (sem os recusados) e contratado calculados sobre a mesma lista filtrada (`SupplierTotals`), que também vão para a Visão geral (`indicators.suppliers`). Histórico em `supplier_activities`: anotações da equipe com canal e registros automáticos de status, orçamento e anexo. Anexos (`supplier_attachments`: orçamento, contrato, nota fiscal) seguem o mesmo esquema dos patrocinadores: disco privado `SUPPLIERS_ATTACHMENTS_DISK` e download só por URL assinada que expira (`/api/v1/suppliers/attachments/{id}/download`). Reaproveitar fornecedor: `GET /suppliers/directory?q=` busca no cadastro da comunidade e mostra em que edições ele esteve e com que status; `POST /suppliers/directory/{supplier}` traz para esta edição como "a contatar". `SuppliersCloner` leva os contratados para a próxima edição como "a contatar", sem valores nem orçamentos. diff --git a/backend/app-modules/audit/src/Contracts/AuditTrail.php b/backend/app-modules/audit/src/Contracts/AuditTrail.php new file mode 100644 index 0000000..1e02b4d --- /dev/null +++ b/backend/app-modules/audit/src/Contracts/AuditTrail.php @@ -0,0 +1,21 @@ + + */ + public function forSubject(string $editionId, string $subjectType, string $subjectId, int $limit = 200): array; +} diff --git a/backend/app-modules/audit/src/Data/AuditEntry.php b/backend/app-modules/audit/src/Data/AuditEntry.php new file mode 100644 index 0000000..fd01add --- /dev/null +++ b/backend/app-modules/audit/src/Data/AuditEntry.php @@ -0,0 +1,26 @@ +|null $before + * @param array|null $after + */ + public function __construct( + public string $id, + public string $action, + public ?string $actorId, + public ?array $before, + public ?array $after, + public CarbonImmutable $createdAt, + ) {} +} diff --git a/backend/app-modules/audit/src/Providers/AuditServiceProvider.php b/backend/app-modules/audit/src/Providers/AuditServiceProvider.php index 303eb0d..594b494 100644 --- a/backend/app-modules/audit/src/Providers/AuditServiceProvider.php +++ b/backend/app-modules/audit/src/Providers/AuditServiceProvider.php @@ -7,10 +7,15 @@ use Illuminate\Console\Scheduling\Schedule; use Illuminate\Support\ServiceProvider; use PHPeste\Audit\Console\PruneAuditLogsCommand; +use PHPeste\Audit\Contracts\AuditTrail; +use PHPeste\Audit\Support\DatabaseAuditTrail; class AuditServiceProvider extends ServiceProvider { - public function register(): void {} + public function register(): void + { + $this->app->singleton(AuditTrail::class, DatabaseAuditTrail::class); + } public function boot(): void { diff --git a/backend/app-modules/audit/src/Support/DatabaseAuditTrail.php b/backend/app-modules/audit/src/Support/DatabaseAuditTrail.php new file mode 100644 index 0000000..502bd9b --- /dev/null +++ b/backend/app-modules/audit/src/Support/DatabaseAuditTrail.php @@ -0,0 +1,26 @@ +where('edition_id', $editionId) + ->where('subject_type', $subjectType) + ->where('subject_id', $subjectId) + ->oldest('created_at') + ->oldest('id') + ->limit($limit) + ->get() + ->map(fn (AuditLog $log): AuditEntry => new AuditEntry($log->id, $log->action, $log->actor_id, $log->before, $log->after, $log->created_at->toImmutable())) + ->all()); + } +} diff --git a/backend/app-modules/notifications/src/Enums/EmailTemplate.php b/backend/app-modules/notifications/src/Enums/EmailTemplate.php index cff90df..f4995b1 100644 --- a/backend/app-modules/notifications/src/Enums/EmailTemplate.php +++ b/backend/app-modules/notifications/src/Enums/EmailTemplate.php @@ -24,7 +24,7 @@ public function label(): string { return match ($this) { self::OrderConfirmed => 'Confirmação de compra', - self::PixReminder => 'Lembrete de Pix', + self::PixReminder => 'Lembrete de pagamento', self::OrderRefunded => 'Reembolso do pedido', self::TicketTransferred => 'Ingresso transferido', self::CfpAccepted => 'Resultado do CFP: aprovada', @@ -43,7 +43,7 @@ public function trigger(): string { return match ($this) { self::OrderConfirmed => 'Ao pagar o pedido', - self::PixReminder => '30 min antes de expirar', + self::PixReminder => 'Quando a organização reenvia a cobrança', self::OrderRefunded => 'Ao reembolsar o pedido', self::TicketTransferred => 'Ao receber um ingresso transferido', self::CfpAccepted, self::CfpWaitlisted => 'Manual', @@ -84,7 +84,7 @@ public function defaultSubject(): string { return match ($this) { self::OrderConfirmed => 'Seu ingresso para o {edicao}', - self::PixReminder => 'Seu Pix para o {edicao} expira em breve', + self::PixReminder => 'Seu pedido no {edicao} está esperando pagamento', self::OrderRefunded => 'Reembolso do seu pedido no {edicao}', self::TicketTransferred => '{remetente} transferiu um ingresso do {edicao} para você', self::CfpAccepted => 'Sua proposta foi aprovada no {edicao}', @@ -103,7 +103,7 @@ public function defaultBody(): string { return match ($this) { self::OrderConfirmed => "Oi, {nome}!\n\nSeu ingresso para o {edicao} está garantido (pedido {pedido}). Entre com este e-mail para ver o QR code, completar os dados do crachá e, se precisar, transferir o ingresso para outra pessoa. É só mostrar o QR na entrada.", - self::PixReminder => "Oi, {nome}!\n\nO Pix do pedido {pedido} expira em 30 minutos. Se ainda quiser garantir seu lugar no {edicao}, é só pagar pelo link abaixo.", + self::PixReminder => "Oi, {nome}!\n\nO pedido {pedido} ainda não foi pago. Se ainda quiser garantir seu lugar no {edicao}, é só pagar pelo link abaixo antes de a reserva expirar.", self::OrderRefunded => "Oi, {nome}!\n\nFizemos o reembolso de {valor} do pedido {pedido} no {edicao}. {ingressos}\n\nO valor volta pelo mesmo meio de pagamento: no Pix, na conta de origem; no cartão, pode levar até duas faturas para aparecer.", self::TicketTransferred => "Oi, {nome}!\n\n{remetente} transferiu para você o ingresso {ingresso} do {edicao}, que acontece em {data}. Entre com este e-mail para ver o QR code e completar seus dados de crachá.", self::CfpAccepted => "Oi, {nome}!\n\nBoa notícia: a proposta \"{proposta}\" foi aprovada para o {edicao}, em {data}. Confirme sua participação pelo link abaixo até {prazo}.", @@ -122,7 +122,7 @@ public function actionLabel(): string { return match ($this) { self::OrderConfirmed => 'Ver meu ingresso', - self::PixReminder => 'Pagar com Pix', + self::PixReminder => 'Pagar o pedido', self::OrderRefunded => 'Ver meu pedido', self::TicketTransferred => 'Ver meu ingresso', self::CfpAccepted => 'Confirmar participação', diff --git a/backend/app-modules/ticketing/routes/ticketing-routes.php b/backend/app-modules/ticketing/routes/ticketing-routes.php index 4945926..afd1d4c 100644 --- a/backend/app-modules/ticketing/routes/ticketing-routes.php +++ b/backend/app-modules/ticketing/routes/ticketing-routes.php @@ -31,8 +31,12 @@ Route::delete('/coupons/{coupon}', [CouponController::class, 'destroy'])->whereUuid('coupon')->name('ticketing.coupons.destroy'); Route::get('/coupons/{coupon}/redemptions', [CouponController::class, 'redemptions'])->whereUuid('coupon')->name('ticketing.coupons.redemptions'); Route::get('/orders', [OrderController::class, 'index'])->name('ticketing.orders.index'); + Route::get('/orders/export', [OrderController::class, 'export'])->name('ticketing.orders.export'); Route::get('/orders/{order}', [OrderController::class, 'show'])->whereUuid('order')->name('ticketing.orders.show'); Route::post('/orders/{order}/cancel', [OrderController::class, 'cancel'])->whereUuid('order')->name('ticketing.orders.cancel'); + Route::post('/orders/{order}/mark-paid', [OrderController::class, 'markPaid'])->whereUuid('order')->name('ticketing.orders.mark-paid'); + Route::post('/orders/{order}/payment-reminder', [OrderController::class, 'remind'])->whereUuid('order')->middleware('throttle:6,1')->name('ticketing.orders.payment-reminder'); + Route::get('/orders/{order}/history', [OrderController::class, 'history'])->whereUuid('order')->name('ticketing.orders.history'); Route::get('/orders/{order}/refunds', [OrderRefundController::class, 'index'])->whereUuid('order')->name('ticketing.orders.refunds.index'); Route::post('/orders/{order}/refunds', [OrderRefundController::class, 'store'])->whereUuid('order')->name('ticketing.orders.refunds.store'); Route::post('/orders/{order}/refunds/{refund}/settle', [OrderRefundController::class, 'settle'])->whereUuid(['order', 'refund'])->name('ticketing.orders.refunds.settle'); diff --git a/backend/app-modules/ticketing/src/Actions/MarkOrderPaid.php b/backend/app-modules/ticketing/src/Actions/MarkOrderPaid.php new file mode 100644 index 0000000..00276cf --- /dev/null +++ b/backend/app-modules/ticketing/src/Actions/MarkOrderPaid.php @@ -0,0 +1,41 @@ +status, [OrderStatus::Created, OrderStatus::AwaitingPayment], true)) { + throw ValidationException::withMessages(['order' => sprintf('Só pedido esperando pagamento pode ser marcado como pago; este está %s.', mb_strtolower($order->status->label()))]); + } + + if ($order->total_cents === 0) { + throw ValidationException::withMessages(['order' => 'Pedido sem valor a pagar não precisa ser marcado como pago.']); + } + + $paid = $this->transition->handle($order, OrderStatus::Paid, $actorId, self::REASON_PREFIX.$justification); + $this->payments->cancelPending($order->edition_id, $order->id); + + return $paid; + } +} diff --git a/backend/app-modules/ticketing/src/Actions/SendPaymentReminder.php b/backend/app-modules/ticketing/src/Actions/SendPaymentReminder.php new file mode 100644 index 0000000..7666738 --- /dev/null +++ b/backend/app-modules/ticketing/src/Actions/SendPaymentReminder.php @@ -0,0 +1,45 @@ +status !== OrderStatus::AwaitingPayment) { + throw ValidationException::withMessages(['order' => 'Só dá para reenviar a cobrança de um pedido aguardando pagamento.']); + } + + if ($order->expires_at === null || $order->expires_at->lte(now())) { + throw ValidationException::withMessages(['order' => 'A reserva deste pedido expirou; a cobrança não vale mais.']); + } + + $deliveryId = $this->mailer->send($order->edition_id, EmailTemplate::PixReminder, $order->buyer_email, $order->buyer_name, [ + 'nome' => $order->buyer_name, + 'pedido' => sprintf('#%d', $order->number), + ], mb_rtrim($this->sites->url($order->edition_id), '/')."/checkout/pedido/{$order->id}"); + + event(new PaymentReminderSent($order->edition_id, $order->id, $deliveryId, $actorId)); + + return $deliveryId; + } +} diff --git a/backend/app-modules/ticketing/src/Events/PaymentReminderSent.php b/backend/app-modules/ticketing/src/Events/PaymentReminderSent.php new file mode 100644 index 0000000..9e4f468 --- /dev/null +++ b/backend/app-modules/ticketing/src/Events/PaymentReminderSent.php @@ -0,0 +1,27 @@ +editionId, 'ticketing.payment_reminder_sent', 'order', $this->orderId, $this->actorId, null, ['delivery_id' => $this->deliveryId]); + } +} diff --git a/backend/app-modules/ticketing/src/Http/Controllers/OrderController.php b/backend/app-modules/ticketing/src/Http/Controllers/OrderController.php index 1d25e9a..96bbdcd 100644 --- a/backend/app-modules/ticketing/src/Http/Controllers/OrderController.php +++ b/backend/app-modules/ticketing/src/Http/Controllers/OrderController.php @@ -5,50 +5,141 @@ namespace PHPeste\Ticketing\Http\Controllers; use Illuminate\Contracts\Database\Query\Builder; +use Illuminate\Database\Eloquent\Builder as EloquentBuilder; +use Illuminate\Http\JsonResponse; use Illuminate\Http\Request; use Illuminate\Http\Resources\Json\AnonymousResourceCollection; use Illuminate\Support\Facades\Gate; +use PHPeste\Community\Contracts\EditionDirectory; use PHPeste\Community\Enums\EditionPermission; +use PHPeste\Community\Tenancy\CurrentEdition; +use PHPeste\Payments\Contracts\PaymentProcessor; +use PHPeste\Payments\Data\PaymentAttempt; +use PHPeste\Ticketing\Actions\MarkOrderPaid; +use PHPeste\Ticketing\Actions\SendPaymentReminder; use PHPeste\Ticketing\Actions\TransitionOrder; use PHPeste\Ticketing\Enums\OrderStatus; +use PHPeste\Ticketing\Http\Requests\MarkOrderPaidRequest; use PHPeste\Ticketing\Http\Resources\OrderResource; use PHPeste\Ticketing\Models\Order; +use PHPeste\Ticketing\Orders\OrderExport; +use PHPeste\Ticketing\Orders\OrderHistory; +use Symfony\Component\HttpFoundation\StreamedResponse; class OrderController { + /** + * Pedidos da edição, do mais novo para o mais antigo. `status` filtra pela + * situação; `q` procura no nome, no e-mail ou no número (com ou sem #). + */ public function index(Request $request): AnonymousResourceCollection { Gate::authorize(EditionPermission::ViewOrders->value); - $status = OrderStatus::tryFrom((string) $request->query('status')); - $search = mb_trim((string) $request->query('q')); + return OrderResource::collection($this->filtered($request)->with('items')->paginate(25)); + } - $orders = Order::query()->with('items') - ->when($status !== null, fn ($query) => $query->where('status', $status?->value)) - ->when($search !== '', fn ($query) => $query->where(fn (Builder $inner) => $inner - ->where('buyer_name', 'like', "%{$search}%") - ->orWhere('buyer_email', 'like', '%'.mb_strtolower($search).'%') - ->when(ctype_digit(mb_ltrim($search, '#')), fn ($number) => $number->orWhere('number', (int) mb_ltrim($search, '#'))))) - ->orderByDesc('number') - ->paginate(25); + /** + * Os mesmos filtros da lista, em CSV separado por ponto e vírgula. + */ + public function export(Request $request, OrderExport $export, EditionDirectory $editions, CurrentEdition $currentEdition): StreamedResponse + { + Gate::authorize(EditionPermission::ViewOrders->value); + + $editionId = (string) $currentEdition->id(); + $orders = $this->filtered($request); + $timezone = $editions->summary($editionId)['timezone'] ?? 'America/Fortaleza'; - return OrderResource::collection($orders); + // O corpo é escrito depois que a requisição sai do contexto da edição, + // por isso o contexto é ligado de novo (pedidos e itens usam o escopo). + return response()->streamDownload(fn () => $currentEdition->run($editionId, function () use ($export, $orders, $timezone): void { + $out = fopen('php://output', 'w'); + + if ($out !== false) { + $export->write($orders, $timezone, $out); + fclose($out); + } + }), sprintf('pedidos-%s.csv', now()->format('Y-m-d')), ['Content-Type' => 'text/csv; charset=UTF-8']); + } + + /** + * O pedido com a cobrança em andamento no gateway, quando houver. + */ + public function show(Request $request, PaymentProcessor $payments): JsonResponse + { + Gate::authorize(EditionPermission::ViewOrders->value); + + $order = $this->order($request); + $attempt = $order->total_cents > 0 ? $payments->current($order->edition_id, $order->id) : null; + + return new OrderResource($order)->additional(['meta' => [ + 'payment' => $attempt instanceof PaymentAttempt ? [ + 'method' => $attempt->method->value, + 'method_label' => $attempt->method->label(), + 'status' => $attempt->status->value, + 'status_label' => $attempt->status->label(), + 'installments' => $attempt->installments, + 'expires_at' => $attempt->expiresAt?->clone()->utc()->toIso8601ZuluString(), + 'paid_at' => $attempt->paidAt?->clone()->utc()->toIso8601ZuluString(), + 'failure_reason' => $attempt->failureReason, + ] : null, + ]])->response(); } - public function show(Request $request): OrderResource + /** + * Linha do tempo: criação, pagamento, reembolsos, cobranças reenviadas e + * quem fez cada coisa. + */ + public function history(Request $request, OrderHistory $history): JsonResponse { Gate::authorize(EditionPermission::ViewOrders->value); - return new OrderResource($this->order($request)); + return response()->json(['data' => $history->for($this->order($request))]); } public function cancel(Request $request, TransitionOrder $transition): OrderResource { Gate::authorize(EditionPermission::ManageEdition->value); - $actor = $request->user()?->getAuthIdentifier(); + return new OrderResource($transition->handle($this->order($request), OrderStatus::Cancelled, $this->actor($request), 'organizer')->load('items')); + } + + /** + * Confirma um pagamento recebido fora do gateway. A justificativa é + * obrigatória e fica na auditoria; os ingressos são emitidos na hora. + */ + public function markPaid(MarkOrderPaidRequest $request, MarkOrderPaid $markPaid): OrderResource + { + Gate::authorize(EditionPermission::ManageEdition->value); + + return new OrderResource($markPaid->handle($this->order($request), $request->justification(), $this->actor($request))->load('items')); + } + + /** + * Manda de novo para quem comprou o link de pagamento do pedido. + */ + public function remind(Request $request, SendPaymentReminder $reminder): JsonResponse + { + Gate::authorize(EditionPermission::ManageEdition->value); - return new OrderResource($transition->handle($this->order($request), OrderStatus::Cancelled, is_string($actor) ? $actor : null, 'organizer')->load('items')); + return response()->json(['data' => ['delivery_id' => $reminder->handle($this->order($request), $this->actor($request))]], 202); + } + + /** + * @return EloquentBuilder + */ + private function filtered(Request $request): EloquentBuilder + { + $status = OrderStatus::tryFrom((string) $request->query('status')); + $search = mb_trim((string) $request->query('q')); + + return Order::query() + ->when($status !== null, fn ($query) => $query->where('status', $status?->value)) + ->when($search !== '', fn ($query) => $query->where(fn (Builder $inner) => $inner + ->where('buyer_name', 'like', "%{$search}%") + ->orWhere('buyer_email', 'like', '%'.mb_strtolower($search).'%') + ->when(ctype_digit(mb_ltrim($search, '#')), fn ($number) => $number->orWhere('number', (int) mb_ltrim($search, '#'))))) + ->orderByDesc('number'); } private function order(Request $request): Order @@ -58,4 +149,11 @@ private function order(Request $request): Order return Order::query()->with('items')->whereKey($id)->firstOrFail(); } + + private function actor(Request $request): ?string + { + $id = $request->user()?->getAuthIdentifier(); + + return is_string($id) ? $id : null; + } } diff --git a/backend/app-modules/ticketing/src/Http/Requests/MarkOrderPaidRequest.php b/backend/app-modules/ticketing/src/Http/Requests/MarkOrderPaidRequest.php new file mode 100644 index 0000000..b08d2ac --- /dev/null +++ b/backend/app-modules/ticketing/src/Http/Requests/MarkOrderPaidRequest.php @@ -0,0 +1,36 @@ +> + */ + public function rules(): array + { + return [ + 'justification' => ['required', 'string', 'min:10', 'max:1000'], + ]; + } + + /** + * @return array + */ + public function messages(): array + { + return [ + 'justification.required' => 'Explique como o pagamento foi recebido.', + 'justification.min' => 'Explique como o pagamento foi recebido, com pelo menos 10 caracteres.', + ]; + } + + public function justification(): string + { + return mb_trim((string) $this->string('justification')); + } +} diff --git a/backend/app-modules/ticketing/src/Orders/OrderExport.php b/backend/app-modules/ticketing/src/Orders/OrderExport.php new file mode 100644 index 0000000..8225efc --- /dev/null +++ b/backend/app-modules/ticketing/src/Orders/OrderExport.php @@ -0,0 +1,58 @@ + $orders + * @param resource $out + */ + public function write(Builder $orders, string $timezone, $out): void + { + fwrite($out, "\xEF\xBB\xBF"); + fputcsv($out, ['Pedido', 'Situação', 'Origem', 'Comprador', 'E-mail', 'Ingressos', 'Subtotal', 'Desconto', 'Taxa', 'Total', 'Reembolsado', 'Cupom', 'Criado em', 'Pago em'], ';', '"', ''); + + $orders->with('items')->chunk(500, function ($chunk) use ($out, $timezone): void { + foreach ($chunk as $order) { + fputcsv($out, array_map($this->cell(...), [ + sprintf('#%d', $order->number), + $order->status->label(), + $order->external() ? (string) $order->external_platform : 'Site', + $order->buyer_name, + $order->buyer_email, + (string) $order->items->filter(fn (OrderItem $item): bool => $item->cancelled_at === null)->count(), + $this->reais($order->subtotal_cents), + $this->reais($order->discount_cents), + $this->reais($order->fee_cents), + $this->reais($order->total_cents), + $this->reais($order->refunded_cents), + (string) $order->coupon_code, + $order->created_at->clone()->setTimezone($timezone)->format('d/m/Y H:i'), + $order->paid_at?->clone()->setTimezone($timezone)->format('d/m/Y H:i') ?? '', + ]), ';', '"', ''); + } + }); + } + + private function reais(int $cents): string + { + return number_format($cents / 100, 2, ',', ''); + } + + private function cell(string $value): string + { + return preg_match('/^[=+\-@\t\r]/', $value) === 1 ? "'".$value : $value; + } +} diff --git a/backend/app-modules/ticketing/src/Orders/OrderHistory.php b/backend/app-modules/ticketing/src/Orders/OrderHistory.php new file mode 100644 index 0000000..8fa718c --- /dev/null +++ b/backend/app-modules/ticketing/src/Orders/OrderHistory.php @@ -0,0 +1,119 @@ + + */ + public function for(Order $order): array + { + $entries = $this->trail->forSubject($order->edition_id, 'order', $order->id); + $actorIds = array_values(array_unique(array_filter(array_map(fn (AuditEntry $entry): ?string => $entry->actorId, $entries)))); + $profiles = $actorIds === [] ? [] : $this->accounts->profiles($actorIds); + + $created = [ + 'id' => 'created', + 'kind' => 'created', + 'title' => $order->external() ? sprintf('Pedido importado de %s', $order->external_platform) : 'Pedido criado', + 'detail' => null, + 'actor' => null, + 'at' => $order->created_at->clone()->utc()->toIso8601ZuluString(), + ]; + + return [$created, ...array_map(function (AuditEntry $entry) use ($profiles): array { + [$kind, $title, $detail] = $this->describe($entry); + + return [ + 'id' => $entry->id, + 'kind' => $kind, + 'title' => $title, + 'detail' => $detail, + 'actor' => $entry->actorId === null ? null : ['id' => $entry->actorId, 'name' => $profiles[$entry->actorId]['name'] ?? null], + 'at' => $entry->createdAt->utc()->toIso8601ZuluString(), + ]; + }, $entries)]; + } + + /** + * @return array{0: string, 1: string, 2: string|null} + */ + private function describe(AuditEntry $entry): array + { + $after = $entry->after ?? []; + + return match ($entry->action) { + 'ticketing.order_status_changed' => $this->statusChange($after), + 'ticketing.order_refunded' => [ + 'refunded', + sprintf('Reembolso de %s', $this->reais(is_int($after['amount_cents'] ?? null) ? $after['amount_cents'] : 0)), + $this->join([ + RefundReason::tryFrom(is_string($after['reason'] ?? null) ? $after['reason'] : '')?->label(), + is_string($after['note'] ?? null) ? $after['note'] : null, + is_int($after['cancelled_tickets'] ?? null) && $after['cancelled_tickets'] > 0 ? sprintf('%d ingresso(s) cancelado(s)', $after['cancelled_tickets']) : null, + ]), + ], + 'ticketing.payment_reminder_sent' => ['reminder', 'Cobrança reenviada por e-mail', null], + default => ['other', $entry->action, null], + }; + } + + /** + * @param array $after + * @return array{0: string, 1: string, 2: string|null} + */ + private function statusChange(array $after): array + { + $to = OrderStatus::tryFrom(is_string($after['status'] ?? null) ? $after['status'] : ''); + $reason = is_string($after['reason'] ?? null) ? $after['reason'] : null; + + if ($to === OrderStatus::Paid && $reason !== null && str_starts_with($reason, MarkOrderPaid::REASON_PREFIX)) { + return ['marked_paid', 'Marcado como pago manualmente', mb_substr($reason, mb_strlen(MarkOrderPaid::REASON_PREFIX))]; + } + + return match ($to) { + OrderStatus::AwaitingPayment => ['payment_started', 'Pagamento iniciado', PaymentMethod::tryFrom((string) $reason)?->label()], + OrderStatus::Paid => ['paid', 'Pagamento confirmado', null], + OrderStatus::Expired => ['expired', 'Reserva expirou sem pagamento', null], + OrderStatus::Cancelled => ['cancelled', 'Pedido cancelado', $reason === 'organizer' ? 'Pela organização' : ($reason === 'buyer' ? 'Por quem comprou' : null)], + OrderStatus::Refunded => ['refunded_full', 'Pedido reembolsado por inteiro', null], + OrderStatus::Created, null => ['other', 'Situação alterada', null], + }; + } + + private function reais(int $cents): string + { + return 'R$ '.number_format($cents / 100, 2, ',', '.'); + } + + /** + * @param list $parts + */ + private function join(array $parts): ?string + { + $parts = array_values(array_filter($parts, fn (?string $part): bool => $part !== null && $part !== '')); + + return $parts === [] ? null : implode(' · ', $parts); + } +} diff --git a/backend/app-modules/ticketing/tests/Feature/OrderManagementTest.php b/backend/app-modules/ticketing/tests/Feature/OrderManagementTest.php new file mode 100644 index 0000000..fa3fbc6 --- /dev/null +++ b/backend/app-modules/ticketing/tests/Feature/OrderManagementTest.php @@ -0,0 +1,176 @@ +travelTo('2027-06-10 12:00:00'); + $this->edition = Edition::factory()->status(EditionStatus::SalesOpen)->create(['name' => 'PHPeste 2027', 'timezone' => 'America/Fortaleza']); + $this->type = TicketType::create(['edition_id' => $this->edition->id, 'name' => 'Geral']); + $this->batch = TicketBatch::create(['edition_id' => $this->edition->id, 'ticket_type_id' => $this->type->id, 'name' => '1º lote', 'price_cents' => 15_000, 'quantity' => 10]); + PaymentAccount::create(['edition_id' => $this->edition->id, 'driver' => 'fake', 'environment' => 'sandbox', 'credentials' => ['api_key' => 'fake_key_1234', 'webhook_secret' => 'segredo-webhook'], 'credentials_hint' => '1234', 'holder_type' => 'individual', 'holder_name' => 'Fulana', 'holder_document_masked' => '***.***.247-**', 'methods' => ['pix', 'card'], 'max_installments' => 3, 'webhook_token' => str_repeat('a', 48), 'verified_at' => now(), 'webhook_verified_at' => now()]); + + $this->checkout = "/api/v1/checkout/editions/{$this->edition->id}/orders"; + $this->organizer = User::factory()->create(['name' => 'Rita Organizadora']); + EditionMember::factory()->for($this->edition)->create(['user_id' => $this->organizer->id, 'role' => EditionRole::Organizer]); + $this->api = "/api/v1/editions/{$this->edition->id}/ticketing/orders"; +}); + +function awaitingOrder(object $test, string $buyer = 'Ana Souza', string $key = 'pedido-1'): Order +{ + $order = $test->postJson($test->checkout, [ + 'buyer' => ['name' => $buyer, 'email' => 'ana@exemplo.com', 'document' => '529.982.247-25'], + 'items' => [['ticket_type_id' => $test->type->id, 'attendees' => [['name' => 'Ana Souza', 'email' => 'ana@exemplo.com'], ['name' => 'Bia Lima', 'email' => 'bia@exemplo.com']]]], + ], ['Idempotency-Key' => $key])->assertCreated()->json('data'); + + $test->postJson("{$test->checkout}/{$order['id']}/payment", ['method' => 'pix'], ['X-Order-Token' => $order['access_token']])->assertOk(); + + return Order::query()->forEdition($test->edition->id)->findOrFail($order['id']); +} + +function memberAs(object $test, EditionRole $role): User +{ + $user = User::factory()->create(); + EditionMember::factory()->for($test->edition)->create(['user_id' => $user->id, 'role' => $role]); + + return $user; +} + +it('o detalhe mostra a cobrança em andamento no gateway', function (): void { + $order = awaitingOrder($this); + Sanctum::actingAs($this->organizer); + + $this->getJson("{$this->api}/{$order->id}") + ->assertOk() + ->assertJsonPath('data.status', 'awaiting_payment') + ->assertJsonPath('meta.payment.method', 'pix') + ->assertJsonPath('meta.payment.status', 'pending'); +}); + +it('marcar como pago exige justificativa, emite os ingressos, cancela a cobrança e vai para a auditoria e o histórico', function (): void { + $order = awaitingOrder($this); + Sanctum::actingAs($this->organizer); + + $this->postJson("{$this->api}/{$order->id}/mark-paid", [])->assertUnprocessable()->assertJsonValidationErrors(['justification']); + $this->postJson("{$this->api}/{$order->id}/mark-paid", ['justification' => 'curto'])->assertUnprocessable()->assertJsonValidationErrors(['justification']); + + $this->postJson("{$this->api}/{$order->id}/mark-paid", ['justification' => 'Transferência para a conta da comunidade, comprovante no drive']) + ->assertOk() + ->assertJsonPath('data.status', 'paid') + ->assertJsonPath('data.paid_at', '2027-06-10T12:00:00Z'); + + expect(Ticket::query()->forEdition($this->edition->id)->count())->toBe(2) + ->and(PaymentCharge::query()->forEdition($this->edition->id)->sole()->status)->toBe(ChargeStatus::Cancelled); + + $audit = AuditLog::query()->where('action', 'ticketing.order_status_changed')->where('after->status', 'paid')->sole(); + expect($audit->actor_id)->toBe($this->organizer->id) + ->and($audit->after['reason'])->toBe('manual: Transferência para a conta da comunidade, comprovante no drive'); + + $history = $this->getJson("{$this->api}/{$order->id}/history")->assertOk()->json('data'); + expect(array_column($history, 'kind'))->toBe(['created', 'payment_started', 'marked_paid']) + ->and($history[1]['detail'])->toBe('Pix') + ->and($history[2])->toMatchArray([ + 'title' => 'Marcado como pago manualmente', + 'detail' => 'Transferência para a conta da comunidade, comprovante no drive', + 'actor' => ['id' => $this->organizer->id, 'name' => 'Rita Organizadora'], + ]); + + $this->postJson("{$this->api}/{$order->id}/mark-paid", ['justification' => 'De novo, por engano no clique']) + ->assertUnprocessable()->assertJsonValidationErrors(['order']); +}); + +it('só quem configura a edição marca como pago ou reenvia cobrança; o financeiro vê, exporta e o histórico', function (): void { + $order = awaitingOrder($this); + Sanctum::actingAs(memberAs($this, EditionRole::Finance)); + + $this->postJson("{$this->api}/{$order->id}/mark-paid", ['justification' => 'Recebido em dinheiro na secretaria'])->assertForbidden(); + $this->postJson("{$this->api}/{$order->id}/payment-reminder")->assertForbidden(); + $this->getJson("{$this->api}/{$order->id}/history")->assertOk(); + $this->get("{$this->api}/export")->assertOk(); + + Sanctum::actingAs(memberAs($this, EditionRole::CheckIn)); + $this->get("{$this->api}/export")->assertForbidden(); + $this->getJson("{$this->api}/{$order->id}/history")->assertForbidden(); + + expect($order->fresh()->status->value)->toBe('awaiting_payment'); +}); + +it('reenviar a cobrança manda o link do pedido para quem comprou, só enquanto a reserva vale', function (): void { + $order = awaitingOrder($this); + Sanctum::actingAs($this->organizer); + + $this->postJson("{$this->api}/{$order->id}/payment-reminder")->assertAccepted(); + + $email = EmailDelivery::query()->forEdition($this->edition->id)->where('template', EmailTemplate::PixReminder->value)->sole(); + expect($email->to_email)->toBe('ana@exemplo.com') + ->and($email->action_url)->toEndWith("/checkout/pedido/{$order->id}") + ->and(AuditLog::query()->where('action', 'ticketing.payment_reminder_sent')->sole()->actor_id)->toBe($this->organizer->id); + + $this->getJson("{$this->api}/{$order->id}/history")->assertJsonPath('data.2.kind', 'reminder'); + + $this->travel(31)->minutes(); + $this->postJson("{$this->api}/{$order->id}/payment-reminder")->assertUnprocessable()->assertJsonValidationErrors(['order']); +}); + +it('não reenvia cobrança de pedido pago nem marca como pago pedido cancelado', function (): void { + $order = awaitingOrder($this); + Sanctum::actingAs($this->organizer); + + $this->postJson("{$this->api}/{$order->id}/cancel")->assertOk(); + $this->postJson("{$this->api}/{$order->id}/mark-paid", ['justification' => 'Pagou depois do cancelamento'])->assertUnprocessable(); + $this->postJson("{$this->api}/{$order->id}/payment-reminder")->assertUnprocessable(); + + $history = $this->getJson("{$this->api}/{$order->id}/history")->json('data'); + expect(end($history))->toMatchArray(['kind' => 'cancelled', 'detail' => 'Pela organização']); +}); + +it('exporta os pedidos com os filtros da lista, valores em reais e sem deixar virar fórmula', function (): void { + $first = awaitingOrder($this, '=HYPERLINK("http://mal.example")', 'pedido-1'); + awaitingOrder($this, 'Caio Reis', 'pedido-2'); + Sanctum::actingAs($this->organizer); + $this->postJson("{$this->api}/{$first->id}/mark-paid", ['justification' => 'Recebido em dinheiro na secretaria'])->assertOk(); + + $response = $this->get("{$this->api}/export?status=paid"); + $response->assertOk()->assertHeader('content-type', 'text/csv; charset=UTF-8'); + $lines = explode("\n", mb_trim($response->streamedContent())); + + expect($lines)->toHaveCount(2) + ->and($lines[0])->toStartWith("\xEF\xBB\xBFPedido;Situação;Origem;Comprador;E-mail;Ingressos") + ->and($lines[1])->toContain('#1;Pago;Site;') + ->and($lines[1])->toContain('"\'=HYPERLINK(""http://mal.example"")"') + ->and($lines[1])->toContain(';2;300,00;0,00;0,00;300,00;0,00;;"10/06/2027 09:00";"10/06/2027 09:00"'); + + $all = explode("\n", mb_trim($this->get("{$this->api}/export?q=caio")->streamedContent())); + expect($all)->toHaveCount(2)->and($all[1])->toContain('Caio Reis'); +}); + +it('outra edição não enxerga pedido nem histórico', function (): void { + $order = awaitingOrder($this); + $other = Edition::factory()->status(EditionStatus::SalesOpen)->create(); + EditionMember::factory()->for($other)->create(['user_id' => $this->organizer->id, 'role' => EditionRole::Organizer]); + Sanctum::actingAs($this->organizer); + + $this->getJson("/api/v1/editions/{$other->id}/ticketing/orders/{$order->id}/history")->assertNotFound(); + $this->postJson("/api/v1/editions/{$other->id}/ticketing/orders/{$order->id}/mark-paid", ['justification' => 'Tentando pela outra edição'])->assertNotFound(); + + $csv = explode("\n", mb_trim($this->get("/api/v1/editions/{$other->id}/ticketing/orders/export")->streamedContent())); + expect($csv)->toHaveCount(1); +}); diff --git a/docs/arquitetura/PHPeste_Arquitetura.pdf b/docs/arquitetura/PHPeste_Arquitetura.pdf index d5e2798..eb94ee1 100644 Binary files a/docs/arquitetura/PHPeste_Arquitetura.pdf and b/docs/arquitetura/PHPeste_Arquitetura.pdf differ diff --git a/docs/arquitetura/fonte/arquitetura.html b/docs/arquitetura/fonte/arquitetura.html index a6b82ae..67f6397 100644 --- a/docs/arquitetura/fonte/arquitetura.html +++ b/docs/arquitetura/fonte/arquitetura.html @@ -108,7 +108,7 @@

Conteúdo

chamada ou dependência assíncrono (evento, fila, webhook) -
Fonte: código da main, backend/CLAUDE.md, docs/produto.md e ADRs 0001–0009.19/11/2026 · A14 (tela de ingressos) · página 1
+
Fonte: código da main, backend/CLAUDE.md, docs/produto.md e ADRs 0001–0009.19/11/2026 · A15 (tela de pedidos) · página 1
@@ -215,7 +215,7 @@

Visão geral do sistema

  • Painel e site são projetos separados (decisão: front-admin SPA, front-public SSR). O token é Bearer do Sanctum nos dois (ADR 0005).
  • Fila e agendador rodam a mesma imagem do backend (horizon e scheduler no infra/docker-compose.yml).
-
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 2
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 2
@@ -290,7 +290,7 @@

Tenancy: comunidade, edição e o que é global

community_id
  • Por que não um banco por comunidade: a mesma pessoa palestra no PHPeste de um ano e compra ingresso no outro, e o perfil dela é um só.
  • Dado de edição que vai para a próxima ("criar edição a partir da anterior") é copiado por um EditionCloner de cada módulo, nunca dado de pessoa.
-
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 3
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 3
@@ -358,7 +358,7 @@

Como uma requisição encontra a edição

O site chama /public/resolve com o host da requisição, recebe edition_id e o domínio principal e redireciona se for preciso (ADR 0008). O host é normalizado (minúsculas, sem porta, IDN em punycode) e nunca é usado para montar URL sem passar pela tabela edition_domains. -
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 4
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 4
@@ -424,7 +424,7 @@

Ciclo de vida da edição

palestrantes, patrocínio, fornecedores), pendências com caminho e filtro (propostas sem revisor, divergência na conciliação, entregas e despesas vencidas) e marcos. O Community filtra cada pendência pela permissão de quem vê: o voluntário não vê pendência de finanças. -
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 5
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 5
@@ -523,13 +523,13 @@

Os 15 módulos do backend

casca -
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 6
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 6
07 · Backend

Como os módulos conversam

-

Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 25 contratos hoje. O arch test barra dependência de App\.

+

Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 26 contratos hoje. O arch test barra dependência de App\.

Community @@ -561,7 +561,7 @@

Como os módulos conversam

Ticketing → PaymentProcessor, PaymentLedger -→ PaymentAccounts (Payments) +→ PaymentAccounts (Payments), AuditTrail AccountUsage, TicketVerifier, TicketRevenue ← Payments, CheckIn, Finance @@ -586,10 +586,11 @@

Como os módulos conversam

Audit · Notifications Auditable: qualquer evento vira registro pelo listener genérico RecordAuditableEvent -EditionMailer::send(...): todo e-mail -passa por aqui, com tema da edição
+AuditTrail: histórico de um registro +EditionMailer::send(...): todo e-mail, +com o tema da edição
  • Ponto de extensão é registrado com $app->tag([...], Contrato::TAG): o Community não conhece os módulos, só a tag. Módulo novo aparece na Visão geral e na clonagem sem mexer no Community. O mesmo vale para TaskLinkProvider (Tasks): Suppliers e Sponsors registram o que uma tarefa pode apontar, e o Program vai registrar a sessão.
-
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 7
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 7
@@ -691,7 +692,7 @@

Banco de dados por domínio

cache · cache_locks sessions
  • Dinheiro sempre em centavos (inteiro). Dado sensível cifrado no banco: CPF de quem compra, credenciais do gateway, acessibilidade, corpo de webhook, linhas de importação. APP_PREVIOUS_KEYS + comandos *:reencrypt-* para trocar a chave.
  • Estoque e cupom nunca são lidos e depois gravados: UPDATE … WHERE allocated + q <= quantity. Testes com 12 processos simultâneos provam que não vende além do lote.
-
PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 8
+
PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 8
@@ -712,7 +713,7 @@

Como funciona

  • Palestrante e participante não têm papel: entram pelas rotas de edição publicada.
  • -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 9
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 9
    @@ -785,8 +786,8 @@

    Ingresso: da compra ao QR

    Rotinas que fecham as pontas ticketing:expire-orders (1/min) devolve estoque de reserva vencida · ticketing:rotate-batches abre o próximo lote payments:retry-webhooks (1, 5, 15, 60 min) · ticketing:reconcile (diário) grava divergência com o gateway -
    • Reembolso: PaymentLedger::refund reserva o valor antes de chamar o gateway (dois reembolsos ao mesmo tempo nunca passam do pago). Pedido importado de outra plataforma entra pago, sem cobrança, e não passa por reembolso nem conciliação.
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 10
    +
    • Reembolso: PaymentLedger::refund reserva o valor antes de chamar o gateway (dois reembolsos ao mesmo tempo nunca passam do pago). Pedido importado de outra plataforma entra pago, sem cobrança, e não passa por reembolso nem conciliação. Pagamento recebido fora do gateway é marcado à mão pela organização (MarkOrderPaid), com justificativa na auditoria, emissão dos ingressos e cancelamento da cobrança aberta.
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 10
    @@ -862,7 +863,7 @@

    CFP: da proposta à grade

    Configurar CFP (A10) · Avaliar propostas com teclado (A11) · Palestrantes: lista, cobertura e detalhe (A12) · no site público: formulário de proposta e área do palestrante com entrar pelo GitHub (P03, P11). -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 11
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 11
    @@ -915,7 +916,7 @@

    Dinheiro: patrocínio, fornecedores e finanças

    ADR 0009: a plataforma não recebe nem repassa dinheiro Cada edição cadastra a conta do próprio gateway; a API valida as chaves e um webhook assinado antes de abrir vendas. Credenciais cifradas; a API só mostra os 4 últimos caracteres. -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 12
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 12
    @@ -940,11 +941,12 @@

    E-mail (Notifications)

    Auditoria

      -
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 22 eventos hoje.
    • +
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 23 eventos hoje.
    • +
    • Tela que mostra histórico (ex.: o pedido) lê pelo contrato AuditTrail::forSubject, sem consultar a tabela de outro módulo.
    • Segredo removido, dado pessoal mascarado; o model recusa update e delete.
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 13
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 13
    @@ -954,7 +956,7 @@

    Segurança

    TemaComo está
    AutenticaçãoSanctum Bearer, um token por dispositivo com expiração (SANCTUM_EXPIRATION_MINUTES); revogar é imediato. Senha mínima de 10 e checagem de vazamento.
    IsolamentoEscopo global por edição; outra comunidade recebe 404; arch test impede módulo de depender de App\ e controller de usar $request->all().
    Rate limitLimiters nomeados: login, password-reset, checkout, webhooks, configuráveis por .env.
    Headers e CORSCSP, HSTS, nosniff, Referrer-Policy, Permissions-Policy. CORS por ambiente e, em /public/*, só a origem do site próprio da edição.
    Dados sensíveisCifrados no banco (CPF, credenciais, acessibilidade, webhooks). Logs JSON com password, token, secret e cartão redigidos automaticamente.
    ArquivosDisco privado; download só por URL assinada que expira (10 min), sempre como anexo, com nosniff e CSP sandbox. SVG sanitizado.
    PagamentoSem dado de cartão na API; webhook com assinatura do driver e reconsulta ao gateway; idempotência no banco (unique(edition_id, idempotency_key)).
    SegredosADR 0006: nada de segredo no repositório; APP_PREVIOUS_KEYS para trocar a chave sem perder o que já foi cifrado.
    LGPDEncarregado e política por edição, anonimização após o evento (B43 em aberto). Decisão em aberto: comunidade controladora, PHPeste operador.
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 14
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 14
    @@ -991,7 +993,7 @@

    Desenvolvimento, CI e deploy

    backend-ci Pint (estilo) Larastan nível 8 -Pest (~1040 testes) +Pest (~1070 testes) composer audit front-admin-ci · front-public-ci @@ -1029,7 +1031,7 @@

    Desenvolvimento, CI e deploy

    Em aberto para o evento teste de carga, backups, runbook do dia do evento (B45) · dados de demonstração e documentação publicada (B46) -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 15
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 15
    @@ -1042,7 +1044,7 @@

    Telas: o design do painel

    Tokens do tema Sertão
    Design: tokens do tema Sertão
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 16
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 16
    @@ -1056,7 +1058,7 @@

    Telas: o painel em uso

    Login
    Entrar com e-mail e senha ou GitHub
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 17
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 17
    @@ -1064,9 +1066,9 @@

    Telas: o painel em uso

    Telas: vendas e organização

    As telas do Marco 2 conforme ficam prontas. Mesma fonte dos outros prints: o painel rodando com a API simulada.

    -
    Ingressos: tipos e lotes com o preço, o que a edição recebe depois da taxa do gateway, vendidos e situação. Cupons e regras da venda nas outras abas.
    +
    Ingressos: tipos e lotes com o preço, o que a edição recebe depois da taxa do gateway, vendidos e situação. Cupons e regras da venda nas outras abas.
    Pedidos: busca e filtro por situação, e o detalhe com itens, pagamento, reembolsos e histórico (auditoria). Reembolso com aviso de taxa e confirmação explícita; marcar como pago exige justificativa.
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 18
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 18
    @@ -1074,8 +1076,8 @@

    Telas: vendas e organização

    Onde estamos e o que falta

    Os milestones do GitHub e o board PHPeste Platform são a fonte da verdade do andamento; esta página é o retrato no dia da geração.

    -
    MarcoSituaçãoO que tem
    Marco 0 · FundaçãoConcluídoesqueleto Laravel 13, módulos, Docker, convenções de API, segurança base, painel e componentes
    Marco 1 · Núcleo e CFPBackend concluídoIdentity, Community, Branding, Notifications, CFP inteiro, Audit; telas A05–A12, A24, A25; site P01, P03
    Marco 2 · IngressosBackend concluído, telas em andamentobackend: ingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças, tarefas, webhooks do Resend; telas prontas: A14 (ingressos); faltam A15–A23 e P04–P06
    Marco 3 · Evento prontoA fazergrade e programação (B35–B37), check-in com modo offline (B38–B39), push (B40), API pública e checkout embutível (B41), site da edição (P02, P07–P09)
    Marco 4 · OperaçãoA fazerengajamento (B42), LGPD (B43), relatórios (B44), carga, backups e runbook (B45), dados de demonstração (B46), acessibilidade e e2e (A26, A27)
    +
    MarcoSituaçãoO que tem
    Marco 0 · FundaçãoConcluídoesqueleto Laravel 13, módulos, Docker, convenções de API, segurança base, painel e componentes
    Marco 1 · Núcleo e CFPBackend concluídoIdentity, Community, Branding, Notifications, CFP inteiro, Audit; telas A05–A12, A24, A25; site P01, P03
    Marco 2 · IngressosBackend concluído, telas em andamentobackend: ingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças, tarefas, webhooks do Resend; telas prontas: A14 (ingressos), A15 (pedidos e reembolso); faltam A16–A23 e P04–P06
    Marco 3 · Evento prontoA fazergrade e programação (B35–B37), check-in com modo offline (B38–B39), push (B40), API pública e checkout embutível (B41), site da edição (P02, P07–P09)
    Marco 4 · OperaçãoA fazerengajamento (B42), LGPD (B43), relatórios (B44), carga, backups e runbook (B45), dados de demonstração (B46), acessibilidade e e2e (A26, A27)
    -
    PHPeste Platform · Arquitetura19/11/2026 · A14 (tela de ingressos) · página 19
    +
    PHPeste Platform · Arquitetura19/11/2026 · A15 (tela de pedidos) · página 19
    diff --git a/docs/arquitetura/fonte/gerar.py b/docs/arquitetura/fonte/gerar.py index c74d969..cca66a6 100644 --- a/docs/arquitetura/fonte/gerar.py +++ b/docs/arquitetura/fonte/gerar.py @@ -13,7 +13,7 @@ from pathlib import Path OUT = Path(__file__).with_name("arquitetura.html") -RETRATO = "19/11/2026 · A14 (tela de ingressos)" +RETRATO = "19/11/2026 · A15 (tela de pedidos)" # ---------------------------------------------------------------- estilo --- # Cores do tema Sertão (front-admin) para o que é da plataforma, e neutras @@ -320,16 +320,16 @@ def legend(): b.append(arrow([(550, 116), (x + 127, 150)], "edition", dashed=True)) pairs = [ (20, 240, "Cfp", ["→ UserAccounts, SpeakerProfiles (Identity)", "→ EditionMailer (Notifications)", "→ EditionSites (Branding)", "ReviewLedger ← quem conta avaliações"]), - (390, 240, "Ticketing", ["→ PaymentProcessor, PaymentLedger", "→ PaymentAccounts (Payments)", "AccountUsage, TicketVerifier,", "TicketRevenue ← Payments, CheckIn, Finance"]), + (390, 240, "Ticketing", ["→ PaymentProcessor, PaymentLedger", "→ PaymentAccounts (Payments), AuditTrail", "AccountUsage, TicketVerifier,", "TicketRevenue ← Payments, CheckIn, Finance"]), (760, 240, "Payments", ["→ PaymentGateway (driver Asaas/MP)", "ChargeStatusChanged → Ticketing", "RefundAccepted → Ticketing", "sem acesso a pedidos: só referência"]), (20, 395, "Finance", ["→ TicketRevenue (Ticketing)", "→ SponsorRevenue (Sponsors)", "→ PaymentAccounts::all (Payments)", "→ EditionSuppliers (Suppliers)"]), (390, 395, "Sponsors · Suppliers", ["→ EditionMemberships (responsável)", "→ UserAccounts (nomes)", "Suppliers → EditionDirectory::communityId", "para não vazar entre comunidades"]), - (760, 395, "Audit · Notifications", ["Auditable: qualquer evento vira registro", "pelo listener genérico RecordAuditableEvent", "EditionMailer::send(...): todo e-mail", "passa por aqui, com tema da edição"]), + (760, 395, "Audit · Notifications", ["Auditable: qualquer evento vira registro", "pelo listener genérico RecordAuditableEvent", "AuditTrail: histórico de um registro", "EditionMailer::send(...): todo e-mail,", "com o tema da edição"]), ] for x, y, title, lines in pairs: b.append(box(x, y, 340, 130, title, lines, "backend", size=9.8)) pages.append(page(7, "Backend", "Como os módulos conversam", - "Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 25 contratos hoje. O arch test barra dependência de App\\.", + "Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 26 contratos hoje. O arch test barra dependência de App\\.", svg("\n".join(b), h=540), ["Ponto de extensão é registrado com $app->tag([...], Contrato::TAG): o Community não conhece os módulos, só a tag. Módulo novo aparece na Visão geral e na clonagem sem mexer no Community. O mesmo vale para TaskLinkProvider (Tasks): Suppliers e Sponsors registram o que uma tarefa pode apontar, e o Program vai registrar a sessão."])) @@ -428,7 +428,7 @@ def legend(): pages.append(page(10, "Fluxo", "Ingresso: da compra ao QR", "O pedido nasce reservando estoque; o pagamento só confirma quando a API consulta o gateway. Evento falso, repetido ou fora de ordem não muda pedido.", svg("\n".join(b), h=540), - ["Reembolso: PaymentLedger::refund reserva o valor antes de chamar o gateway (dois reembolsos ao mesmo tempo nunca passam do pago). Pedido importado de outra plataforma entra pago, sem cobrança, e não passa por reembolso nem conciliação."])) + ["Reembolso: PaymentLedger::refund reserva o valor antes de chamar o gateway (dois reembolsos ao mesmo tempo nunca passam do pago). Pedido importado de outra plataforma entra pago, sem cobrança, e não passa por reembolso nem conciliação. Pagamento recebido fora do gateway é marcado à mão pela organização (MarkOrderPaid), com justificativa na auditoria, emissão dos ingressos e cancelamento da cobrança aberta."])) # ================================================== 11 CFP b = [] @@ -497,7 +497,8 @@ def legend():

    Auditoria

      -
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 22 eventos hoje.
    • +
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 23 eventos hoje.
    • +
    • Tela que mostra histórico (ex.: o pedido) lê pelo contrato AuditTrail::forSubject, sem consultar a tabela de outro módulo.
    • Segredo removido, dado pessoal mascarado; o model recusa update e delete.
    """ pages.append(page(13, "Operação", "Fila, rotinas agendadas, e-mail e auditoria", "O que roda sem ninguém clicar. Todas as rotinas usam withoutOverlapping() e são idempotentes: rodar duas vezes não muda o resultado.", content)) @@ -527,7 +528,7 @@ def legend(): b.append(box(365, 128, 150, 64, "Mailpit", ["e-mail em :8025"], "external")) b.append(box(25, 204, 490, 74, "infra/dev.sh up | down | reset | shell | logs", ["sobe os seis serviços (cria infra/.env na primeira vez)", "front-admin e front-public rodam com npm run dev"], "infra")) b.append(group(560, 20, 530, 270, "CI (GitHub Actions)", "infra")) -b.append(box(575, 52, 245, 105, "backend-ci", ["Pint (estilo)", "Larastan nível 8", "Pest (~1040 testes)", "composer audit"], "infra")) +b.append(box(575, 52, 245, 105, "backend-ci", ["Pint (estilo)", "Larastan nível 8", "Pest (~1070 testes)", "composer audit"], "infra")) b.append(box(830, 52, 245, 105, "front-admin-ci · front-public-ci", ["lint, typecheck, testes", "unitários e build; e2e na CI", "do front-public; o do painel", "(82 testes) roda local"], "infra", title_size=11)) b.append(box(575, 170, 500, 108, "composer check (local, antes de abrir PR)", ["pint + phpstan + rector --dry-run + pest", "Teste de concorrência com processos PHP reais (estoque, cupom,", "reembolso, idempotência), SQLite com transaction_mode IMMEDIATE"], "infra", size=9.8)) b.append(group(10, 310, 1080, 220, "Produção (planejado, B45)", "todo")) @@ -561,6 +562,7 @@ def legend(): # Cada tela do Marco 2 que fica pronta entra aqui (prints de front-admin/e2e/capturas-arquitetura.spec.ts). SALES_SCREENS = [ ("painel-ingressos.png", "Ingressos: tipos e lotes com o preço, o que a edição recebe depois da taxa do gateway, vendidos e situação. Cupons e regras da venda nas outras abas."), + ("painel-pedidos.png", "Pedidos: busca e filtro por situação, e o detalhe com itens, pagamento, reembolsos e histórico (auditoria). Reembolso com aviso de taxa e confirmação explícita; marcar como pago exige justificativa."), ] pages.append(page(18, "Telas", "Telas: vendas e organização", "As telas do Marco 2 conforme ficam prontas. Mesma fonte dos outros prints: o painel rodando com a API simulada.", @@ -570,7 +572,7 @@ def legend(): status = [ ("Marco 0 · Fundação", "Concluído", "esqueleto Laravel 13, módulos, Docker, convenções de API, segurança base, painel e componentes"), ("Marco 1 · Núcleo e CFP", "Backend concluído", "Identity, Community, Branding, Notifications, CFP inteiro, Audit; telas A05–A12, A24, A25; site P01, P03"), - ("Marco 2 · Ingressos", "Backend concluído, telas em andamento", "backend: ingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças, tarefas, webhooks do Resend; telas prontas: A14 (ingressos); faltam A15–A23 e P04–P06"), + ("Marco 2 · Ingressos", "Backend concluído, telas em andamento", "backend: ingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças, tarefas, webhooks do Resend; telas prontas: A14 (ingressos), A15 (pedidos e reembolso); faltam A16–A23 e P04–P06"), ("Marco 3 · Evento pronto", "A fazer", "grade e programação (B35–B37), check-in com modo offline (B38–B39), push (B40), API pública e checkout embutível (B41), site da edição (P02, P07–P09)"), ("Marco 4 · Operação", "A fazer", "engajamento (B42), LGPD (B43), relatórios (B44), carga, backups e runbook (B45), dados de demonstração (B46), acessibilidade e e2e (A26, A27)"), ] diff --git a/docs/arquitetura/telas/painel-pedidos.png b/docs/arquitetura/telas/painel-pedidos.png new file mode 100644 index 0000000..34f9a3a Binary files /dev/null and b/docs/arquitetura/telas/painel-pedidos.png differ diff --git a/front-admin/CLAUDE.md b/front-admin/CLAUDE.md index 4ef71fc..687ac52 100644 --- a/front-admin/CLAUDE.md +++ b/front-admin/CLAUDE.md @@ -52,6 +52,7 @@ app/ palestrantes/index.vue # módulo speakers: confirmações, cobertura dos nove estados e lista de espera palestrantes/[id].vue # módulo speakers: perfil, palestras, viagem e hospedagem e confirmação ingressos/index.vue # módulo tickets: tipos e lotes com valor líquido e prévia do checkout, cupons e regras da venda + pedidos/index.vue # módulo orders: lista com busca e filtro, detalhe com pagamento e histórico, reembolso, marcar como pago, reenviar cobrança, CSV configuracoes.vue # módulo editionSettings: dados e etapa da edição, domínio e site próprio, privacidade e auditoria meu-perfil.vue # módulo myProfile: conta, senha, sessões ativas e notificações index.vue diff --git a/front-admin/app/application/locales/pt-br/index.ts b/front-admin/app/application/locales/pt-br/index.ts index ab59528..5abf12d 100644 --- a/front-admin/app/application/locales/pt-br/index.ts +++ b/front-admin/app/application/locales/pt-br/index.ts @@ -9,6 +9,7 @@ import identity from '../../../modules/identity/locales/pt-br' import team from '../../../modules/team/locales/pt-br' import cfpSettings from '../../../modules/cfpSettings/locales/pt-br' import tickets from '../../../modules/tickets/locales/pt-br' +import orders from '../../../modules/orders/locales/pt-br' import cfpReview from '../../../modules/cfpReview/locales/pt-br' import speakers from '../../../modules/speakers/locales/pt-br' import editionSettings from '../../../modules/editionSettings/locales/pt-br' @@ -30,6 +31,7 @@ export default { team, cfpSettings, tickets, + orders, cfpReview, speakers, editionSettings, diff --git a/front-admin/app/modules/orders/components/MarkPaidModal.vue b/front-admin/app/modules/orders/components/MarkPaidModal.vue new file mode 100644 index 0000000..3f67447 --- /dev/null +++ b/front-admin/app/modules/orders/components/MarkPaidModal.vue @@ -0,0 +1,52 @@ + + + diff --git a/front-admin/app/modules/orders/components/OrderDrawer.vue b/front-admin/app/modules/orders/components/OrderDrawer.vue new file mode 100644 index 0000000..94ad263 --- /dev/null +++ b/front-admin/app/modules/orders/components/OrderDrawer.vue @@ -0,0 +1,188 @@ + + + diff --git a/front-admin/app/modules/orders/components/OrdersComponents.test.ts b/front-admin/app/modules/orders/components/OrdersComponents.test.ts new file mode 100644 index 0000000..01c505d --- /dev/null +++ b/front-admin/app/modules/orders/components/OrdersComponents.test.ts @@ -0,0 +1,62 @@ +import { mountSuspended } from '@nuxt/test-utils/runtime' +import { describe, expect, it, vi } from 'vitest' +import MarkPaidModal from './MarkPaidModal.vue' +import RefundModal from './RefundModal.vue' +import type { Order } from '../types' + +const order: Order = { + id: 'o-1', number: 42, status: 'paid', statusLabel: 'Pago', externalPlatform: null, buyerName: 'Ana Souza', buyerEmail: 'ana@exemplo.com', buyerDocument: null, + subtotalCents: 30000, discountCents: 0, feeCents: 0, totalCents: 30000, refundedCents: 0, gatewayFeeCents: 1497, couponCode: null, expiresAt: null, paidAt: null, createdAt: '2027-06-10T12:00:00Z', + items: [ + { id: 'i-1', ticketTypeName: 'Inteira', batchName: '1º lote', totalCents: 15000, attendeeName: 'Ana Souza', attendeeEmail: 'ana@exemplo.com', cancelled: false, externalCode: null }, + { id: 'i-2', ticketTypeName: 'Inteira', batchName: '1º lote', totalCents: 15000, attendeeName: 'Bia Lima', attendeeEmail: 'bia@exemplo.com', cancelled: false, externalCode: null }, + ], + activeTickets: 2, +} +const flat = (text: string) => text.replace(/\s/g, ' ') + +describe('RefundModal', () => { + it('avisa sobre taxa e prazo, pede confirmação explícita e mostra o resultado do estorno', async () => { + const refund = vi.fn().mockResolvedValue({ ok: true, refund: { id: 'r-1', amountCents: 5000, status: 'pending', statusLabel: 'Em processamento no gateway', reasonLabel: '', note: null, cancelledItems: 0, failureReason: null, createdAt: '' } }) + const wrapper = await mountSuspended(RefundModal, { props: { modelValue: false, order, refund } }) + await wrapper.setProps({ modelValue: true }) + + expect(flat(wrapper.find('[data-testid="refund-fee-warning"]').text())).toContain('R$ 14,97') + + await wrapper.find('input[value="partial"]').setValue(true) + await wrapper.find('#refund-amount').setValue('400,00') + await wrapper.find('#refund-form').trigger('submit') + expect(flat(wrapper.text())).toContain('até R$ 300,00') + + await wrapper.find('#refund-amount').setValue('50,00') + await wrapper.find('#refund-form').trigger('submit') + const confirm = wrapper.find('[data-testid="refund-confirm"]') + expect(flat(confirm.text())).toContain('devolver R$ 50,00 para Ana Souza') + + const button = wrapper.findAll('button').find((b) => flat(b.text()).includes('Estornar R$ 50,00'))! + expect(button.attributes('disabled')).toBeDefined() + await confirm.find('input[type="checkbox"]').setValue(true) + await button.trigger('click') + await new Promise((resolve) => setTimeout(resolve, 0)) + + expect(refund).toHaveBeenCalledWith({ amountCents: 5000, reason: 'buyer_request', note: '', cancelTickets: false, itemIds: null }) + expect(flat(wrapper.find('[data-testid="refund-result"]').text())).toContain('aceitou o estorno de R$ 50,00') + }) +}) + +describe('MarkPaidModal', () => { + it('exige justificativa antes de chamar a API', async () => { + const markPaid = vi.fn().mockResolvedValue({ ok: true }) + const wrapper = await mountSuspended(MarkPaidModal, { props: { modelValue: false, order, markPaid } }) + await wrapper.setProps({ modelValue: true }) + + await wrapper.find('#mark-paid-form').trigger('submit') + expect(wrapper.text()).toContain('pelo menos 10 caracteres') + expect(markPaid).not.toHaveBeenCalled() + + await wrapper.find('#mark-paid-justification').setValue('Transferência para a conta da comunidade') + await wrapper.find('#mark-paid-form').trigger('submit') + expect(markPaid).toHaveBeenCalledWith('Transferência para a conta da comunidade') + expect(wrapper.emitted('saved')).toHaveLength(1) + }) +}) diff --git a/front-admin/app/modules/orders/components/OrdersPanel.vue b/front-admin/app/modules/orders/components/OrdersPanel.vue new file mode 100644 index 0000000..1ad63cc --- /dev/null +++ b/front-admin/app/modules/orders/components/OrdersPanel.vue @@ -0,0 +1,148 @@ + + + diff --git a/front-admin/app/modules/orders/components/RefundModal.vue b/front-admin/app/modules/orders/components/RefundModal.vue new file mode 100644 index 0000000..b084b34 --- /dev/null +++ b/front-admin/app/modules/orders/components/RefundModal.vue @@ -0,0 +1,149 @@ + + + diff --git a/front-admin/app/modules/orders/components/statusTone.ts b/front-admin/app/modules/orders/components/statusTone.ts new file mode 100644 index 0000000..83f33f6 --- /dev/null +++ b/front-admin/app/modules/orders/components/statusTone.ts @@ -0,0 +1,18 @@ +import type { BadgeStatus } from '@/application/shared/components/ui/Badge.vue' +import type { OrderStatus, RefundStatus } from '../types' + +export const ORDER_TONE: Record = { + created: 'neutral', + awaiting_payment: 'warn', + paid: 'ok', + expired: 'neutral', + cancelled: 'neutral', + refunded: 'info', +} + +export const REFUND_TONE: Record = { + unconfirmed: 'warn', + pending: 'info', + completed: 'ok', + failed: 'danger', +} diff --git a/front-admin/app/modules/orders/composables/format.test.ts b/front-admin/app/modules/orders/composables/format.test.ts new file mode 100644 index 0000000..ea60cd4 --- /dev/null +++ b/front-admin/app/modules/orders/composables/format.test.ts @@ -0,0 +1,14 @@ +import { describe, expect, it } from 'vitest' +import { centsToInput, formatCents, parseReais } from './format' + +describe('format', () => { + it('converte reais digitados em centavos e de volta', () => { + expect(parseReais('150')).toBe(15000) + expect(parseReais('1.234,5')).toBe(123450) + expect(parseReais('R$ 75,00')).toBe(7500) + expect(parseReais('abc')).toBeNull() + expect(parseReais('')).toBeNull() + expect(centsToInput(123450)).toBe('1.234,50') + expect(formatCents(30000).replace(/\s/g, ' ')).toBe('R$ 300,00') + }) +}) diff --git a/front-admin/app/modules/orders/composables/format.ts b/front-admin/app/modules/orders/composables/format.ts new file mode 100644 index 0000000..53d78c9 --- /dev/null +++ b/front-admin/app/modules/orders/composables/format.ts @@ -0,0 +1,21 @@ +const brl = new Intl.NumberFormat('pt-BR', { style: 'currency', currency: 'BRL' }) + +/** 15000 → "R$ 150,00". */ +export const formatCents = (cents: number) => brl.format(cents / 100) + +/** "1.234,56", "150" ou "R$ 150,00" → centavos. Texto inválido → null. */ +export function parseReais(text: string): number | null { + const clean = text.replace(/R\$|\s/g, '').trim() + if (clean === '') return null + if (!/^\d{1,3}(\.\d{3})*(,\d{1,2})?$|^\d+(,\d{1,2})?$/.test(clean)) return null + const [integer = '0', decimals = ''] = clean.replace(/\./g, '').split(',') + return Number(integer) * 100 + Number(decimals.padEnd(2, '0')) +} + +/** Centavos → "1.234,56" para o campo de edição. */ +export const centsToInput = (cents: number) => new Intl.NumberFormat('pt-BR', { minimumFractionDigits: 2, maximumFractionDigits: 2 }).format(cents / 100) + +const dateTime = new Intl.DateTimeFormat('pt-BR', { day: '2-digit', month: 'short', hour: '2-digit', minute: '2-digit' }) + +/** "10 de jun., 09:00". */ +export const formatDateTime = (iso: string | null) => (iso ? dateTime.format(new Date(iso)) : '') diff --git a/front-admin/app/modules/orders/composables/useOrders.test.ts b/front-admin/app/modules/orders/composables/useOrders.test.ts new file mode 100644 index 0000000..6978103 --- /dev/null +++ b/front-admin/app/modules/orders/composables/useOrders.test.ts @@ -0,0 +1,84 @@ +import { beforeEach, describe, expect, it, vi } from 'vitest' +import ordersService from '../services/ordersService' +import { OrdersError } from '../services/ordersError' +import { refundableCents, useOrders } from './useOrders' + +vi.mock('../services/ordersService', () => ({ + default: { list: vi.fn(), show: vi.fn(), history: vi.fn(), refunds: vi.fn(), cancel: vi.fn(), markPaid: vi.fn(), remind: vi.fn(), refund: vi.fn(), settleRefund: vi.fn(), exportCsv: vi.fn() }, +})) + +const money = (amount: number) => ({ amount, currency: 'BRL' }) +const orderPayload = (overrides: Record = {}) => ({ + id: 'o-1', number: 42, status: 'paid', status_label: 'Pago', source: 'checkout', external: null, + buyer: { name: 'Ana Souza', email: 'ana@exemplo.com', document: '***.982.247-**' }, + subtotal: money(30000), discount: money(0), fee: money(0), total: money(30000), refunded: money(10000), gateway_fee: money(1497), + requires_payment: true, coupon_code: null, expires_at: null, paid_at: '2027-06-10T12:00:00Z', created_at: '2027-06-10T11:50:00Z', + items: [ + { id: 'i-1', ticket_type_id: 'tt-1', ticket_type_name: 'Inteira', batch_name: '1º lote', unit_price: money(15000), discount: money(0), fee: money(0), total: money(15000), attendee: { name: 'Ana Souza', email: 'ana@exemplo.com' }, cancelled_at: null, external_code: null }, + { id: 'i-2', ticket_type_id: 'tt-1', ticket_type_name: 'Inteira', batch_name: '1º lote', unit_price: money(15000), discount: money(0), fee: money(0), total: money(15000), attendee: { name: 'Bia Lima', email: 'bia@exemplo.com' }, cancelled_at: '2027-06-11T10:00:00Z', external_code: null }, + ], + ...overrides, +}) +const refundPayload = { id: 'r-1', amount: money(10000), status: 'completed', status_label: 'Reembolsado', reason: 'buyer_request', reason_label: 'Pedido de quem comprou', note: null, cancelled_item_ids: ['i-2'], failure_reason: null, created_at: '2027-06-11T10:00:00Z', completed_at: '2027-06-11T10:00:00Z' } + +beforeEach(() => { + vi.clearAllMocks() + vi.mocked(ordersService.list).mockResolvedValue({ data: [orderPayload()], meta: { current_page: 1, last_page: 3, total: 61 } } as never) + vi.mocked(ordersService.show).mockResolvedValue({ data: orderPayload(), meta: { payment: { method: 'pix', method_label: 'Pix', status: 'paid', status_label: 'Pago', installments: 1, expires_at: null, paid_at: null, failure_reason: null } } } as never) + vi.mocked(ordersService.history).mockResolvedValue({ data: [{ id: 'created', kind: 'created', title: 'Pedido criado', detail: null, actor: null, at: '2027-06-10T11:50:00Z' }, { id: 'h-2', kind: 'refunded', title: 'Reembolso de R$ 100,00', detail: 'Pedido de quem comprou', actor: { id: 'u-1', name: 'Rita' }, at: '2027-06-11T10:00:00Z' }] } as never) + vi.mocked(ordersService.refunds).mockResolvedValue({ data: [refundPayload] } as never) +}) + +describe('useOrders', () => { + it('carrega a página com os totais e traduz o pedido para centavos e ingressos válidos', async () => { + const orders = useOrders('ed-1') + await orders.load() + + expect(orders.state.value).toBe('ready') + expect(orders.pageCount.value).toBe(3) + expect(orders.total.value).toBe(61) + expect(orders.orders.value[0]).toMatchObject({ number: 42, totalCents: 30000, refundedCents: 10000, activeTickets: 1, externalPlatform: null }) + expect(refundableCents(orders.orders.value[0]!)).toBe(20000) + }) + + it('filtrar volta para a primeira página', async () => { + const orders = useOrders('ed-1') + await orders.goTo(3) + await orders.search('paid', 'ana') + + expect(ordersService.list).toHaveBeenLastCalledWith('ed-1', { page: 1, status: 'paid', q: 'ana' }) + expect(orders.filtered.value).toBe(true) + }) + + it('abre o pedido com pagamento, reembolsos e histórico', async () => { + const orders = useOrders('ed-1') + await orders.open('o-1') + + expect(orders.detailState.value).toBe('ready') + expect(orders.detail.value?.payment).toMatchObject({ methodLabel: 'Pix', statusLabel: 'Pago' }) + expect(orders.detail.value?.refunds[0]).toMatchObject({ amountCents: 10000, cancelledItems: 1, reasonLabel: 'Pedido de quem comprou' }) + expect(orders.detail.value?.history.map((entry) => entry.actorName)).toEqual([null, 'Rita']) + }) + + it('reembolso total manda o valor nulo e devolve o resultado do estorno; erro 422 vira mensagem do campo', async () => { + vi.mocked(ordersService.refund).mockResolvedValueOnce({ data: { ...refundPayload, status: 'unconfirmed' } } as never) + const orders = useOrders('ed-1') + await orders.open('o-1') + + const result = await orders.refund({ amountCents: null, reason: 'buyer_request', note: ' ', cancelTickets: false, itemIds: ['i-1'] }) + expect(ordersService.refund).toHaveBeenCalledWith('ed-1', 'o-1', { amount_cents: null, reason: 'buyer_request', note: null, cancel_tickets: false, item_ids: null }) + expect(result).toMatchObject({ ok: true, refund: { status: 'unconfirmed' } }) + + vi.mocked(ordersService.markPaid).mockRejectedValueOnce(new OrdersError('Inválido', 422, { justification: ['Explique como o pagamento foi recebido.'] })) + expect(await orders.markPaid('curto')).toEqual({ ok: false, message: 'Explique como o pagamento foi recebido.', fieldErrors: { justification: 'Explique como o pagamento foi recebido.' } }) + }) + + it('depois de uma ação recarrega o pedido', async () => { + vi.mocked(ordersService.remind).mockResolvedValue({ data: { delivery_id: 'd-1' } } as never) + const orders = useOrders('ed-1') + await orders.open('o-1') + + expect(await orders.remind()).toEqual({ ok: true }) + expect(ordersService.show).toHaveBeenCalledTimes(2) + }) +}) diff --git a/front-admin/app/modules/orders/composables/useOrders.ts b/front-admin/app/modules/orders/composables/useOrders.ts new file mode 100644 index 0000000..e0e9bde --- /dev/null +++ b/front-admin/app/modules/orders/composables/useOrders.ts @@ -0,0 +1,192 @@ +import { computed, ref } from 'vue' +import ordersService, { type HistoryPayload, type OrderPayload, type PaymentPayload, type RefundPayload } from '../services/ordersService' +import { OrdersError } from '../services/ordersError' +import locale from '../locales/pt-br' +import type { HistoryEntry, MutationResult, Order, OrderDetail, Payment, Refund, RefundInput, RefundResult } from '../types' + +export const translateOrder = (payload: OrderPayload): Order => ({ + id: payload.id, + number: payload.number, + status: payload.status, + statusLabel: payload.status_label, + externalPlatform: payload.external?.platform ?? null, + buyerName: payload.buyer.name, + buyerEmail: payload.buyer.email, + buyerDocument: payload.buyer.document, + subtotalCents: payload.subtotal.amount, + discountCents: payload.discount.amount, + feeCents: payload.fee.amount, + totalCents: payload.total.amount, + refundedCents: payload.refunded.amount, + gatewayFeeCents: payload.gateway_fee.amount, + couponCode: payload.coupon_code, + expiresAt: payload.expires_at, + paidAt: payload.paid_at, + createdAt: payload.created_at, + items: payload.items.map((item) => ({ + id: item.id, + ticketTypeName: item.ticket_type_name, + batchName: item.batch_name, + totalCents: item.total.amount, + attendeeName: item.attendee.name, + attendeeEmail: item.attendee.email, + cancelled: item.cancelled_at !== null, + externalCode: item.external_code, + })), + activeTickets: payload.items.filter((item) => item.cancelled_at === null).length, +}) + +const translatePayment = (payload: PaymentPayload | null): Payment | null => (payload === null ? null : { + methodLabel: payload.method_label, + status: payload.status, + statusLabel: payload.status_label, + installments: payload.installments, + expiresAt: payload.expires_at, + failureReason: payload.failure_reason, +}) + +const translateRefund = (payload: RefundPayload): Refund => ({ + id: payload.id, + amountCents: payload.amount.amount, + status: payload.status, + statusLabel: payload.status_label, + reasonLabel: payload.reason_label, + note: payload.note, + cancelledItems: payload.cancelled_item_ids.length, + failureReason: payload.failure_reason, + createdAt: payload.created_at, +}) + +const translateHistory = (payload: HistoryPayload): HistoryEntry => ({ + id: payload.id, + kind: payload.kind, + title: payload.title, + detail: payload.detail, + actorName: payload.actor ? (payload.actor.name ?? '') : null, + at: payload.at, +}) + +const FIELDS: Record = { justification: 'justification', amount_cents: 'amount', reason: 'reason', note: 'note', item_ids: 'items', cancel_tickets: 'items', order: 'order', status: 'order' } + +function failure(error: unknown): { ok: false, message: string, fieldErrors: Record } { + if (error instanceof OrdersError && error.statusCode === 422 && error.fieldErrors) { + const fieldErrors = Object.fromEntries(Object.entries(error.fieldErrors).map(([key, messages]) => [FIELDS[key.split('.')[0] ?? key] ?? key, messages[0] ?? ''])) + return { ok: false, message: Object.values(fieldErrors)[0] ?? locale.genericError, fieldErrors } + } + return { ok: false, message: locale.genericError, fieldErrors: {} } +} + +export function useOrders(editionId: string) { + const orders = ref([]) + const page = ref(1) + const pageCount = ref(1) + const total = ref(0) + const status = ref('') + const query = ref('') + const state = ref<'loading' | 'ready' | 'error'>('loading') + const filtered = computed(() => status.value !== '' || query.value.trim() !== '') + + const detail = ref(null) + const detailState = ref<'idle' | 'loading' | 'ready' | 'error'>('idle') + + async function load() { + state.value = 'loading' + try { + const response = await ordersService.list(editionId, { page: page.value, status: status.value, q: query.value }) + orders.value = response.data.map(translateOrder) + pageCount.value = Math.max(1, response.meta.last_page) + total.value = response.meta.total + state.value = 'ready' + } catch { + state.value = 'error' + } + } + + async function search(nextStatus: string, nextQuery: string) { + status.value = nextStatus + query.value = nextQuery + page.value = 1 + await load() + } + + async function goTo(next: number) { + page.value = next + await load() + } + + async function open(orderId: string) { + detailState.value = 'loading' + try { + const [shown, history, refunds] = await Promise.all([ + ordersService.show(editionId, orderId), + ordersService.history(editionId, orderId), + ordersService.refunds(editionId, orderId), + ]) + detail.value = { + order: translateOrder(shown.data), + payment: translatePayment(shown.meta.payment), + history: history.data.map(translateHistory), + refunds: refunds.data.map(translateRefund), + } + orders.value = orders.value.map((order) => (order.id === orderId ? detail.value!.order : order)) + detailState.value = 'ready' + } catch { + detailState.value = 'error' + } + } + + function close() { + detail.value = null + detailState.value = 'idle' + } + + async function mutate(request: () => Promise): Promise { + const orderId = detail.value?.order.id + if (!orderId) return { ok: false, message: locale.genericError, fieldErrors: {} } + try { + await request() + await open(orderId) + return { ok: true } + } catch (error) { + return failure(error) + } + } + + const current = () => detail.value!.order.id + + const cancel = () => mutate(() => ordersService.cancel(editionId, current())) + const markPaid = (justification: string) => mutate(() => ordersService.markPaid(editionId, current(), justification.trim())) + const remind = () => mutate(() => ordersService.remind(editionId, current())) + const settle = (refund: Refund, completed: boolean) => mutate(() => ordersService.settleRefund(editionId, current(), refund.id, completed)) + + async function refund(input: RefundInput): Promise { + const orderId = detail.value?.order.id + if (!orderId) return { ok: false, message: locale.genericError, fieldErrors: {} } + try { + const response = await ordersService.refund(editionId, orderId, { + amount_cents: input.amountCents, + reason: input.reason, + note: input.note.trim() === '' ? null : input.note.trim(), + cancel_tickets: input.cancelTickets, + item_ids: input.cancelTickets ? input.itemIds : null, + }) + await open(orderId) + return { ok: true, refund: translateRefund(response.data) } + } catch (error) { + return failure(error) + } + } + + async function exportCsv(): Promise { + try { + return await ordersService.exportCsv(editionId, { status: status.value, q: query.value }) + } catch { + return null + } + } + + return { orders, page, pageCount, total, status, query, state, filtered, detail, detailState, load, search, goTo, open, close, cancel, markPaid, remind, refund, settle, exportCsv } +} + +/** Quanto ainda pode voltar: o pago menos o que já foi reembolsado (ou reservado). */ +export const refundableCents = (order: Order) => Math.max(0, order.totalCents - order.refundedCents) diff --git a/front-admin/app/modules/orders/locales/pt-br/index.ts b/front-admin/app/modules/orders/locales/pt-br/index.ts new file mode 100644 index 0000000..d0f1b8c --- /dev/null +++ b/front-admin/app/modules/orders/locales/pt-br/index.ts @@ -0,0 +1,129 @@ +export default { + title: 'Pedidos', + subtitle: 'Compras da edição: quem comprou, o que foi pago e o que voltou.', + loadError: 'Não foi possível carregar os pedidos.', + detailError: 'Não foi possível abrir este pedido.', + genericError: 'Não deu para concluir agora. Tente de novo.', + readOnly: 'Edição encerrada: os pedidos ficam só para consulta.', + total: '{n} pedido(s)', + + search: 'Buscar', + searchPlaceholder: 'Nome, e-mail ou nº do pedido', + statusFilter: 'Situação', + allStatuses: 'Todas', + statuses: { + created: 'Criado', + awaiting_payment: 'Aguardando pagamento', + paid: 'Pago', + expired: 'Expirado', + cancelled: 'Cancelado', + refunded: 'Reembolsado', + }, + exportCsv: 'Exportar CSV', + exported: 'Planilha baixada.', + noOrders: 'Nenhum pedido ainda', + noOrdersHint: 'Os pedidos aparecem aqui assim que alguém comprar pelo site ou quando você importar compradores de outra plataforma.', + noMatches: 'Nenhum pedido com esse filtro', + noMatchesHint: 'Tente outro nome, e-mail ou situação.', + clearFilters: 'Limpar filtros', + goTickets: 'Ir para Ingressos', + + tableCaption: 'Pedidos da edição', + colNumber: 'Pedido', + colBuyer: 'Comprador', + colTickets: 'Ingressos', + colTotal: 'Total', + colStatus: 'Situação', + colDate: 'Criado em', + open: 'Abrir pedido {n}', + refundedPart: '{valor} reembolsado', + imported: 'Importado de {plataforma}', + + orderTitle: 'Pedido #{n}', + buyer: 'Comprador', + document: 'CPF', + items: 'Ingressos', + cancelledItem: 'Cancelado', + payment: 'Pagamento', + noPayment: 'Sem cobrança no gateway.', + free: 'Pedido sem valor: não passa pelo gateway.', + importedPayment: 'Venda feita em {plataforma}: o pagamento não passa por aqui.', + installments: '{n}x', + expiresAt: 'Reserva vale até {data}', + subtotal: 'Subtotal', + discount: 'Desconto', + coupon: 'cupom {codigo}', + fee: 'Taxa repassada', + orderTotal: 'Total', + refunded: 'Reembolsado', + gatewayFee: 'Taxa do gateway', + refunds: 'Reembolsos', + settle: 'Registrar resultado', + settleDone: 'Foi estornado', + settleFailed: 'Não foi estornado', + settled: 'Resultado do reembolso registrado.', + unconfirmedHint: 'O gateway não respondeu. Confira no painel do gateway se o estorno saiu antes de registrar.', + history: 'Histórico', + system: 'Sistema', + by: 'por {nome}', + + actions: 'Ações do pedido', + remind: 'Reenviar cobrança', + reminded: 'Cobrança reenviada para {email}.', + markPaid: 'Marcar como pago', + cancel: 'Cancelar pedido', + refund: 'Reembolsar', + back: 'Voltar', + close: 'Fechar', + + cancelTitle: 'Cancelar o pedido #{n}?', + cancelText: 'A reserva é desfeita, os lugares voltam para o lote e a cobrança aberta no gateway é cancelada. Quem comprou não consegue mais pagar este pedido.', + cancelConfirm: 'Cancelar pedido', + cancelled: 'Pedido cancelado.', + + markPaidTitle: 'Marcar o pedido #{n} como pago', + markPaidText: 'Use só quando o dinheiro entrou fora do gateway (transferência, dinheiro na secretaria). Os ingressos são emitidos e enviados na hora, e a cobrança aberta é cancelada.', + justification: 'Justificativa', + justificationHint: 'Como o pagamento foi recebido e onde está o comprovante. Fica registrado na auditoria com o seu nome.', + justificationShort: 'Escreva pelo menos 10 caracteres.', + markPaidConfirm: 'Confirmar pagamento', + markedPaid: 'Pedido marcado como pago. Os ingressos foram enviados.', + + refundTitle: 'Reembolsar o pedido #{n}', + refundable: 'Pode reembolsar até {valor}.', + refundKind: 'Valor', + refundFull: 'Total ({valor})', + refundPartial: 'Parcial', + amount: 'Valor a devolver', + amountInvalid: 'Use um valor como 150,00, maior que zero e até {valor}.', + reason: 'Motivo', + reasons: { + buyer_request: 'Pedido de quem comprou', + event_changed: 'Evento cancelado ou alterado', + duplicate: 'Pagamento em duplicidade', + paid_after_expiry: 'Pago depois de a reserva expirar', + other: 'Outro motivo', + }, + note: 'Observação interna', + noteHint: 'Só a equipe vê. Ex.: "pediu pelo Instagram em 10/06".', + cancelTickets: 'Cancelar ingressos', + cancelTicketsHint: 'Os ingressos escolhidos deixam de valer e os lugares voltam para o lote.', + chooseTickets: 'Quais ingressos', + chooseTicketsError: 'Escolha pelo menos um ingresso.', + feeWarningTitle: 'Antes de reembolsar', + feeWarning: 'A taxa do gateway ({taxa}) normalmente não volta para a edição. No Pix o dinheiro cai na hora; no cartão pode levar até duas faturas para aparecer.', + review: 'Revisar reembolso', + confirmTitle: 'Confirme o reembolso', + confirmText: 'Vamos pedir ao gateway para devolver {valor} para {nome}. Isso não pode ser desfeito.', + confirmTickets: '{n} ingresso(s) vão ser cancelados.', + keepTickets: 'Os ingressos continuam valendo.', + confirmCheck: 'Conferi o valor e quero estornar', + confirmRefund: 'Estornar {valor}', + resultTitle: 'Resultado do estorno', + results: { + completed: 'O gateway confirmou o estorno de {valor}. Quem comprou recebe um e-mail.', + pending: 'O gateway aceitou o estorno de {valor} e está processando. Quem comprou recebe um e-mail.', + unconfirmed: 'O gateway não respondeu. O valor fica reservado para ninguém estornar duas vezes; confira no painel do gateway e registre o resultado aqui no pedido.', + failed: 'O gateway recusou o estorno: {motivo}. Nada foi devolvido.', + }, +} diff --git a/front-admin/app/modules/orders/router/index.ts b/front-admin/app/modules/orders/router/index.ts new file mode 100644 index 0000000..8b0360d --- /dev/null +++ b/front-admin/app/modules/orders/router/index.ts @@ -0,0 +1,9 @@ +import type { RouteRecordRaw } from 'vue-router' + +const OrdersView = () => import('../views/OrdersView.vue') + +export const ordersRoutes: RouteRecordRaw[] = [ + { path: '/pedidos', name: 'orders', component: OrdersView }, +] + +export default ordersRoutes diff --git a/front-admin/app/modules/orders/services/ordersError.ts b/front-admin/app/modules/orders/services/ordersError.ts new file mode 100644 index 0000000..ef56da9 --- /dev/null +++ b/front-admin/app/modules/orders/services/ordersError.ts @@ -0,0 +1,11 @@ +export class OrdersError extends Error { + statusCode: number | null + fieldErrors: Record | null + + constructor(message: string, statusCode: number | null = null, fieldErrors: Record | null = null) { + super(message) + this.name = 'OrdersError' + this.statusCode = statusCode + this.fieldErrors = fieldErrors + } +} diff --git a/front-admin/app/modules/orders/services/ordersService.test.ts b/front-admin/app/modules/orders/services/ordersService.test.ts new file mode 100644 index 0000000..619895c --- /dev/null +++ b/front-admin/app/modules/orders/services/ordersService.test.ts @@ -0,0 +1,48 @@ +import { describe, expect, it, vi } from 'vitest' +import { httpClient, HttpClientError } from '@/infrastructure/http/HttpClient' +import ordersService from './ordersService' +import { OrdersError } from './ordersError' + +vi.mock('@/infrastructure/http/HttpClient', () => ({ + httpClient: { get: vi.fn(), post: vi.fn() }, + HttpClientError: class extends Error { + statusCode: number | null + fieldErrors: Record | null + + constructor(message: string, statusCode: number | null = null, fieldErrors: Record | null = null) { + super(message) + this.statusCode = statusCode + this.fieldErrors = fieldErrors + } + }, +})) + +describe('ordersService', () => { + it('chama as rotas de pedidos da edição, mandando só os filtros preenchidos', async () => { + vi.mocked(httpClient.get).mockResolvedValue({ data: [] }) + vi.mocked(httpClient.post).mockResolvedValue({ data: {} }) + + await ordersService.list('ed-1', { page: 2, status: '', q: ' ana ' }) + await ordersService.history('ed-1', 'o-1') + await ordersService.markPaid('ed-1', 'o-1', 'Transferência recebida') + await ordersService.remind('ed-1', 'o-1') + await ordersService.refund('ed-1', 'o-1', { amount_cents: null, reason: 'buyer_request', note: null, cancel_tickets: true, item_ids: null }) + await ordersService.settleRefund('ed-1', 'o-1', 'r-1', true) + await ordersService.exportCsv('ed-1', { status: 'paid', q: '' }) + + expect(httpClient.get).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders', { query: { page: 2, q: 'ana' } }) + expect(httpClient.get).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders/o-1/history') + expect(httpClient.post).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders/o-1/mark-paid', { body: { justification: 'Transferência recebida' } }) + expect(httpClient.post).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders/o-1/payment-reminder') + expect(httpClient.post).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders/o-1/refunds', expect.objectContaining({ body: expect.objectContaining({ cancel_tickets: true }) })) + expect(httpClient.post).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders/o-1/refunds/r-1/settle', { body: { completed: true } }) + expect(httpClient.get).toHaveBeenCalledWith('/editions/ed-1/ticketing/orders/export', { query: { status: 'paid' }, as: 'blob' }) + }) + + it('troca o erro HTTP pelo erro do módulo, com os campos', async () => { + vi.mocked(httpClient.post).mockRejectedValue(new HttpClientError('Inválido', 422, { justification: ['Explique'] })) + + await expect(ordersService.markPaid('ed-1', 'o-1', '')).rejects.toMatchObject({ name: 'OrdersError', statusCode: 422, fieldErrors: { justification: ['Explique'] } }) + await expect(ordersService.markPaid('ed-1', 'o-1', '')).rejects.toBeInstanceOf(OrdersError) + }) +}) diff --git a/front-admin/app/modules/orders/services/ordersService.ts b/front-admin/app/modules/orders/services/ordersService.ts new file mode 100644 index 0000000..493ba99 --- /dev/null +++ b/front-admin/app/modules/orders/services/ordersService.ts @@ -0,0 +1,124 @@ +import { httpClient, HttpClientError } from '@/infrastructure/http/HttpClient' +import { OrdersError } from './ordersError' + +export interface Money { amount: number, currency: string } + +export type OrderStatusValue = 'created' | 'awaiting_payment' | 'paid' | 'expired' | 'cancelled' | 'refunded' + +export interface OrderItemPayload { + id: string + ticket_type_id: string + ticket_type_name: string + batch_name: string | null + unit_price: Money + discount: Money + fee: Money + total: Money + attendee: { name: string, email: string } + cancelled_at: string | null + external_code: string | null +} + +export interface OrderPayload { + id: string + number: number + status: OrderStatusValue + status_label: string + source: string + external: { platform: string | null, reference: string | null } | null + buyer: { name: string, email: string, document: string | null } + subtotal: Money + discount: Money + fee: Money + total: Money + refunded: Money + gateway_fee: Money + requires_payment: boolean + coupon_code: string | null + expires_at: string | null + paid_at: string | null + created_at: string + items: OrderItemPayload[] +} + +export interface PaymentPayload { + method: string + method_label: string + status: string + status_label: string + installments: number + expires_at: string | null + paid_at: string | null + failure_reason: string | null +} + +export interface RefundPayload { + id: string + amount: Money + status: 'unconfirmed' | 'pending' | 'completed' | 'failed' + status_label: string + reason: string + reason_label: string + note: string | null + cancelled_item_ids: string[] + failure_reason: string | null + created_at: string + completed_at: string | null +} + +export interface HistoryPayload { + id: string + kind: string + title: string + detail: string | null + actor: { id: string, name: string | null } | null + at: string +} + +export interface OrdersPage { + data: OrderPayload[] + meta: { current_page: number, last_page: number, total: number } +} + +export interface ListQuery { page: number, status: string, q: string } + +export interface RefundBody { + amount_cents: number | null + reason: string + note: string | null + cancel_tickets: boolean + item_ids: string[] | null +} + +const base = (editionId: string) => `/editions/${editionId}/ticketing/orders` + +const filters = (query: Omit) => ({ + ...(query.status ? { status: query.status } : {}), + ...(query.q.trim() ? { q: query.q.trim() } : {}), +}) + +async function call(request: () => Promise): Promise { + try { + return await request() + } catch (error) { + if (error instanceof HttpClientError) { + throw new OrdersError(error.message, error.statusCode, error.fieldErrors) + } + throw new OrdersError('Request failed') + } +} + +export default { + list: (editionId: string, query: ListQuery) => call(() => httpClient.get(base(editionId), { query: { page: query.page, ...filters(query) } })), + show: (editionId: string, orderId: string) => call(() => httpClient.get<{ data: OrderPayload, meta: { payment: PaymentPayload | null } }>(`${base(editionId)}/${orderId}`)), + history: (editionId: string, orderId: string) => call(() => httpClient.get<{ data: HistoryPayload[] }>(`${base(editionId)}/${orderId}/history`)), + refunds: (editionId: string, orderId: string) => call(() => httpClient.get<{ data: RefundPayload[] }>(`${base(editionId)}/${orderId}/refunds`)), + cancel: (editionId: string, orderId: string) => call(() => httpClient.post<{ data: OrderPayload }>(`${base(editionId)}/${orderId}/cancel`)), + markPaid: (editionId: string, orderId: string, justification: string) => + call(() => httpClient.post<{ data: OrderPayload }>(`${base(editionId)}/${orderId}/mark-paid`, { body: { justification } })), + remind: (editionId: string, orderId: string) => call(() => httpClient.post<{ data: { delivery_id: string } }>(`${base(editionId)}/${orderId}/payment-reminder`)), + refund: (editionId: string, orderId: string, body: RefundBody) => call(() => httpClient.post<{ data: RefundPayload }>(`${base(editionId)}/${orderId}/refunds`, { body })), + settleRefund: (editionId: string, orderId: string, refundId: string, completed: boolean) => + call(() => httpClient.post<{ data: RefundPayload }>(`${base(editionId)}/${orderId}/refunds/${refundId}/settle`, { body: { completed } })), + exportCsv: (editionId: string, query: Omit) => call(() => httpClient.get(`${base(editionId)}/export`, { query: filters(query), as: 'blob' })), +} diff --git a/front-admin/app/modules/orders/types/index.ts b/front-admin/app/modules/orders/types/index.ts new file mode 100644 index 0000000..98ffdc0 --- /dev/null +++ b/front-admin/app/modules/orders/types/index.ts @@ -0,0 +1,88 @@ +import type { OrderStatusValue } from '../services/ordersService' + +export type OrderStatus = OrderStatusValue + +export interface OrderItem { + id: string + ticketTypeName: string + batchName: string | null + totalCents: number + attendeeName: string + attendeeEmail: string + cancelled: boolean + externalCode: string | null +} + +export interface Order { + id: string + number: number + status: OrderStatus + statusLabel: string + externalPlatform: string | null + buyerName: string + buyerEmail: string + buyerDocument: string | null + subtotalCents: number + discountCents: number + feeCents: number + totalCents: number + refundedCents: number + gatewayFeeCents: number + couponCode: string | null + expiresAt: string | null + paidAt: string | null + createdAt: string + items: OrderItem[] + activeTickets: number +} + +export interface Payment { + methodLabel: string + status: string + statusLabel: string + installments: number + expiresAt: string | null + failureReason: string | null +} + +export type RefundStatus = 'unconfirmed' | 'pending' | 'completed' | 'failed' + +export interface Refund { + id: string + amountCents: number + status: RefundStatus + statusLabel: string + reasonLabel: string + note: string | null + cancelledItems: number + failureReason: string | null + createdAt: string +} + +export interface HistoryEntry { + id: string + kind: string + title: string + detail: string | null + actorName: string | null + at: string +} + +export interface OrderDetail { + order: Order + payment: Payment | null + refunds: Refund[] + history: HistoryEntry[] +} + +export interface RefundInput { + amountCents: number | null + reason: string + note: string + cancelTickets: boolean + itemIds: string[] | null +} + +export type MutationResult = { ok: true } | { ok: false, message: string, fieldErrors: Record } + +export type RefundResult = { ok: true, refund: Refund } | { ok: false, message: string, fieldErrors: Record } diff --git a/front-admin/app/modules/orders/views/OrdersView.vue b/front-admin/app/modules/orders/views/OrdersView.vue new file mode 100644 index 0000000..39d869a --- /dev/null +++ b/front-admin/app/modules/orders/views/OrdersView.vue @@ -0,0 +1,14 @@ + + + diff --git a/front-admin/app/pages/pedidos/index.vue b/front-admin/app/pages/pedidos/index.vue new file mode 100644 index 0000000..ba64cd3 --- /dev/null +++ b/front-admin/app/pages/pedidos/index.vue @@ -0,0 +1,7 @@ + + + diff --git a/front-admin/e2e/capturas-arquitetura.spec.ts b/front-admin/e2e/capturas-arquitetura.spec.ts index 30e03c8..8926ea1 100644 --- a/front-admin/e2e/capturas-arquitetura.spec.ts +++ b/front-admin/e2e/capturas-arquitetura.spec.ts @@ -103,3 +103,42 @@ test('ingressos', async ({ page, goto }) => { await expect(page.getByRole('heading', { name: 'Ingressos', level: 1 })).toBeVisible() await page.screenshot({ path: out('painel-ingressos') }) }) + +test('pedidos', async ({ page, goto }) => { + await page.setViewportSize({ width: 1440, height: 1000 }) + await signedIn(page) + const money = (amount: number) => ({ amount, currency: 'BRL' }) + const item = (id: string, name: string, cancelled: string | null = null) => ({ id, ticket_type_id: 'tt-1', ticket_type_name: 'Inteira', batch_name: '2º lote', unit_price: money(15000), discount: money(0), fee: money(0), total: money(15000), attendee: { name, email: 'x@exemplo.com' }, cancelled_at: cancelled, external_code: null }) + const order = (number: number, name: string, email: string, status: string, label: string, total: number, extra: Record = {}) => ({ + id: `0e1c6d1a-0000-4000-8000-0000000000${number}`, number, status, status_label: label, source: 'checkout', external: null, buyer: { name, email, document: '***.982.247-**' }, + subtotal: money(total), discount: money(0), fee: money(0), total: money(total), refunded: money(0), gateway_fee: money(Math.ceil(total * 0.0499)), requires_payment: true, coupon_code: null, + expires_at: null, paid_at: '2027-06-10T12:00:00Z', created_at: `2027-06-${String(10 - (number % 7)).padStart(2, '0')}T14:${String(number % 60).padStart(2, '0')}:00Z`, items: [item('i-1', name)], ...extra, + }) + const featured = order(58, 'Ana Souza', 'ana@exemplo.com', 'paid', 'Pago', 30000, { refunded: money(15000), items: [item('i-1', 'Ana Souza'), item('i-2', 'Bia Lima', '2027-06-11T10:00:00Z')] }) + const list = [ + order(61, 'Caio Reis', 'caio@exemplo.com', 'awaiting_payment', 'Aguardando pagamento', 15000), + order(60, 'Duda Martins', 'duda@exemplo.com', 'paid', 'Pago', 15000), + order(59, 'Edu Farias', 'edu@exemplo.com', 'expired', 'Expirado', 30000), + featured, + order(57, 'Fabi Nunes', 'fabi@exemplo.com', 'paid', 'Pago', 7500), + order(56, 'Gil Andrade', 'gil@exemplo.com', 'cancelled', 'Cancelado', 15000), + ] + const history = [ + { id: 'h0', kind: 'created', title: 'Pedido criado', detail: null, actor: null, at: '2027-06-10T11:50:00Z' }, + { id: 'h1', kind: 'payment_started', title: 'Pagamento iniciado', detail: 'Pix', actor: null, at: '2027-06-10T11:51:00Z' }, + { id: 'h2', kind: 'paid', title: 'Pagamento confirmado', detail: null, actor: null, at: '2027-06-10T12:00:00Z' }, + { id: 'h3', kind: 'refunded', title: 'Reembolso de R$ 150,00', detail: 'Pedido de quem comprou · 1 ingresso(s) cancelado(s)', actor: { id: 'u-me', name: 'Rita Organiza' }, at: '2027-06-11T10:00:00Z' }, + ] + const refund = { id: 'r-1', amount: money(15000), status: 'completed', status_label: 'Reembolsado', reason: 'buyer_request', reason_label: 'Pedido de quem comprou', note: 'Bia não vai poder ir', cancelled_item_ids: ['i-2'], failure_reason: null, created_at: '2027-06-11T10:00:00Z', completed_at: '2027-06-11T10:00:00Z' } + await page.route('**/api/v1/editions/ed-27/ticketing/orders**', (route) => { + const path = new URL(route.request().url()).pathname + if (path.endsWith('/orders')) return route.fulfill({ status: 200, json: { data: list, meta: { current_page: 1, last_page: 9, total: 214 } } }) + if (path.endsWith('/history')) return route.fulfill({ status: 200, json: { data: history } }) + if (path.endsWith('/refunds')) return route.fulfill({ status: 200, json: { data: [refund] } }) + return route.fulfill({ status: 200, json: { data: featured, meta: { payment: { method: 'pix', method_label: 'Pix', status: 'paid', status_label: 'Pago', installments: 1, expires_at: null, paid_at: '2027-06-10T12:00:00Z', failure_reason: null } } } }) + }) + await goto('/pedidos', { waitUntil: 'hydration' }) + await page.getByRole('button', { name: 'Abrir pedido 58' }).click() + await expect(page.getByTestId('order-history')).toContainText('Reembolso de R$ 150,00') + await page.screenshot({ path: out('painel-pedidos') }) +}) diff --git a/front-admin/e2e/orders.spec.ts b/front-admin/e2e/orders.spec.ts new file mode 100644 index 0000000..5658872 --- /dev/null +++ b/front-admin/e2e/orders.spec.ts @@ -0,0 +1,158 @@ +import { expect, test } from '@nuxt/test-utils/playwright' +import type { Page, Route } from '@playwright/test' + +const session = { user: { id: 'u-me', name: 'Rita Organiza', email: 'rita@php-pb.net', avatarUrl: null }, token: 'e2e-token' } +const edition = (role: string) => ({ + id: 'ed-27', slug: '2027', name: 'PHPeste 2027', community_id: 'c1', community: { id: 'c1', name: 'PHP-PB', slug: 'php-pb' }, + status: 'sales_open', status_label: 'Vendas abertas', starts_on: '2027-10-08', ends_on: '2027-10-09', city: 'João Pessoa', state: 'PB', year: 2027, site_url: null, role, +}) +const money = (amount: number) => ({ amount, currency: 'BRL' }) +const item = (id: string, name: string) => ({ + id, ticket_type_id: 'tt-1', ticket_type_name: 'Inteira', batch_name: '1º lote', unit_price: money(15000), discount: money(0), fee: money(0), total: money(15000), + attendee: { name, email: `${name.split(' ')[0]!.toLowerCase()}@exemplo.com` }, cancelled_at: null, external_code: null, +}) +const paidOrder = { + id: '0e1c6d1a-0000-4000-8000-000000000042', number: 42, status: 'paid', status_label: 'Pago', source: 'checkout', external: null, + buyer: { name: 'Ana Souza', email: 'ana@exemplo.com', document: '***.982.247-**' }, + subtotal: money(30000), discount: money(0), fee: money(0), total: money(30000), refunded: money(0), gateway_fee: money(1497), + requires_payment: true, coupon_code: null, expires_at: null, paid_at: '2027-06-10T12:00:00Z', created_at: '2027-06-10T11:50:00Z', + items: [item('i-1', 'Ana Souza'), item('i-2', 'Bia Lima')], +} +const awaitingOrder = { + ...paidOrder, id: '0e1c6d1a-0000-4000-8000-000000000043', number: 43, status: 'awaiting_payment', status_label: 'Aguardando pagamento', + buyer: { name: 'Caio Reis', email: 'caio@exemplo.com', document: null }, paid_at: null, expires_at: new Date(Date.now() + 20 * 60_000).toISOString(), items: [item('i-3', 'Caio Reis')], + total: money(15000), subtotal: money(15000), +} +const history = [{ id: 'created', kind: 'created', title: 'Pedido criado', detail: null, actor: null, at: '2027-06-10T11:50:00Z' }] + +interface Calls { method: string, path: string, query: string, body: unknown } + +async function open(page: Page, goto: (url: string, options: { waitUntil: 'hydration' }) => Promise, role = 'organizador', handle: (route: Route, call: Calls) => Promise | boolean = () => false) { + const calls: Calls[] = [] + await page.addInitScript((value) => localStorage.setItem('app.auth', JSON.stringify(value)), session) + await page.route('**/api/v1/editions', (route) => route.fulfill({ status: 200, json: { data: [edition(role)] } })) + await page.route('**/api/v1/editions/ed-27/ticketing/orders**', async (route) => { + const url = new URL(route.request().url()) + const call = { method: route.request().method(), path: url.pathname.replace('/api/v1/editions/ed-27/ticketing/orders', ''), query: url.search, body: route.request().postDataJSON() } + calls.push(call) + if (await handle(route, call)) return + const order = call.path.includes(awaitingOrder.id) ? awaitingOrder : paidOrder + if (call.path === '' && url.searchParams.get('status') === 'expired') return route.fulfill({ status: 200, json: { data: [], meta: { current_page: 1, last_page: 1, total: 0 } } }) + if (call.path === '') return route.fulfill({ status: 200, json: { data: [paidOrder, awaitingOrder], meta: { current_page: 1, last_page: 1, total: 2 } } }) + if (call.path === '/export') return route.fulfill({ status: 200, headers: { 'Content-Type': 'text/csv' }, body: 'Pedido;Situação\n#42;Pago\n' }) + if (call.path.endsWith('/history')) return route.fulfill({ status: 200, json: { data: history } }) + if (call.path.endsWith('/refunds') && call.method === 'GET') return route.fulfill({ status: 200, json: { data: [] } }) + if (call.method === 'GET') { + const payment = order === awaitingOrder ? { method: 'pix', method_label: 'Pix', status: 'pending', status_label: 'Aguardando pagamento', installments: 1, expires_at: null, paid_at: null, failure_reason: null } : null + return route.fulfill({ status: 200, json: { data: order, meta: { payment } } }) + } + return route.fulfill({ status: 200, json: { data: order } }) + }) + await goto('/pedidos', { waitUntil: 'hydration' }) + await expect(page.getByRole('heading', { name: 'Pedidos', level: 1 })).toBeVisible() + return calls +} + +test.describe('Pedidos', () => { + test('lista os pedidos e filtra pela situação, com estado vazio para o filtro', async ({ page, goto }) => { + const calls = await open(page, goto) + + await expect(page.getByRole('row', { name: /Ana Souza/ })).toContainText('R$ 300,00') + await expect(page.getByRole('row', { name: /Caio Reis/ })).toContainText('Aguardando pagamento') + await expect(page.getByText('2 pedido(s)')).toBeVisible() + + await page.getByLabel('Situação').selectOption('expired') + await expect(page.getByText('Nenhum pedido com esse filtro')).toBeVisible() + expect(calls.some((call) => call.path === '' && call.query.includes('status=expired'))).toBe(true) + + await page.getByRole('button', { name: 'Limpar filtros' }).click() + await expect(page.getByRole('row', { name: /Ana Souza/ })).toBeVisible() + }) + + test('reembolso parcial avisa da taxa, exige confirmação explícita e mostra o resultado do estorno', async ({ page, goto }) => { + const calls = await open(page, goto, 'organizador', (route, call) => { + if (call.method !== 'POST' || !call.path.endsWith('/refunds')) return false + route.fulfill({ status: 201, json: { data: { id: 'r-1', order_id: paidOrder.id, amount: money(5000), status: 'completed', status_label: 'Reembolsado', reason: 'event_changed', reason_label: 'Evento cancelado ou alterado', note: null, cancelled_item_ids: ['i-2'], failure_reason: null, requested_by: 'u-me', created_at: '2027-06-11T10:00:00Z', completed_at: '2027-06-11T10:00:00Z' } } }) + return true + }) + + await page.getByRole('button', { name: 'Abrir pedido 42' }).click() + const drawer = page.getByRole('dialog', { name: 'Pedido #42' }) + await expect(drawer.getByTestId('order-history')).toContainText('Pedido criado') + await expect(drawer.getByRole('button', { name: 'Marcar como pago' })).toHaveCount(0) + await drawer.getByRole('button', { name: 'Reembolsar' }).click() + + const modal = page.getByRole('dialog', { name: 'Reembolsar o pedido #42' }) + await expect(modal.getByTestId('refund-fee-warning')).toContainText('R$ 14,97') + await modal.getByLabel('Parcial').check() + await modal.getByLabel('Valor a devolver').fill('50,00') + await modal.getByLabel('Motivo').selectOption('event_changed') + await modal.getByLabel('Cancelar ingressos').check() + await modal.getByLabel('Ana Souza · Inteira').uncheck() + await modal.getByRole('button', { name: 'Revisar reembolso' }).click() + + const confirm = page.getByRole('dialog', { name: 'Confirme o reembolso' }) + await expect(confirm).toContainText('devolver R$ 50,00 para Ana Souza') + await expect(confirm).toContainText('1 ingresso(s) vão ser cancelados.') + const button = confirm.getByRole('button', { name: 'Estornar R$ 50,00' }) + await expect(button).toBeDisabled() + await confirm.getByLabel('Conferi o valor e quero estornar').check() + await button.click() + + await expect(page.getByRole('dialog', { name: 'Resultado do estorno' })).toContainText('O gateway confirmou o estorno de R$ 50,00') + expect(calls.find((call) => call.method === 'POST')?.body).toEqual({ amount_cents: 5000, reason: 'event_changed', note: null, cancel_tickets: true, item_ids: ['i-2'] }) + }) + + test('pedido aguardando: reenviar cobrança e marcar como pago com justificativa', async ({ page, goto }) => { + const calls = await open(page, goto, 'organizador', (route, call) => { + if (call.method === 'POST' && call.path.endsWith('/payment-reminder')) { + route.fulfill({ status: 202, json: { data: { delivery_id: 'd-1' } } }) + return true + } + return false + }) + + await page.getByRole('button', { name: 'Abrir pedido 43' }).click() + const drawer = page.getByRole('dialog', { name: 'Pedido #43' }) + await expect(drawer.getByTestId('order-payment')).toContainText('Pix') + await expect(drawer.getByRole('button', { name: 'Reembolsar' })).toHaveCount(0) + + await drawer.getByRole('button', { name: 'Reenviar cobrança' }).click() + await expect(page.getByText('Cobrança reenviada para caio@exemplo.com.')).toBeVisible() + + await drawer.getByRole('button', { name: 'Marcar como pago' }).click() + const modal = page.getByRole('dialog', { name: 'Marcar o pedido #43 como pago' }) + await modal.getByRole('button', { name: 'Confirmar pagamento' }).click() + await expect(modal).toContainText('pelo menos 10 caracteres') + + await modal.getByLabel('Justificativa').fill('Pix direto para a conta da comunidade, comprovante no drive') + await modal.getByRole('button', { name: 'Confirmar pagamento' }).click() + await expect(page.getByText('Pedido marcado como pago. Os ingressos foram enviados.')).toBeVisible() + expect(calls.find((call) => call.path.endsWith('/mark-paid'))?.body).toEqual({ justification: 'Pix direto para a conta da comunidade, comprovante no drive' }) + }) + + test('o financeiro reembolsa, mas não cobra, não marca como pago nem cancela', async ({ page, goto }) => { + await open(page, goto, 'financeiro') + + await page.getByRole('button', { name: 'Abrir pedido 43' }).click() + const drawer = page.getByRole('dialog', { name: 'Pedido #43' }) + await expect(drawer.getByTestId('order-detail')).toBeVisible() + await expect(drawer.getByRole('button', { name: 'Reenviar cobrança' })).toHaveCount(0) + await expect(drawer.getByRole('button', { name: 'Marcar como pago' })).toHaveCount(0) + await expect(drawer.getByRole('button', { name: 'Cancelar pedido' })).toHaveCount(0) + await drawer.getByRole('button', { name: 'Fechar' }).first().click() + + await page.getByRole('button', { name: 'Abrir pedido 42' }).click() + await expect(page.getByRole('dialog', { name: 'Pedido #42' }).getByRole('button', { name: 'Reembolsar' })).toBeVisible() + }) + + test('exporta o CSV com o filtro atual', async ({ page, goto }) => { + const calls = await open(page, goto) + + const download = page.waitForEvent('download') + await page.getByRole('button', { name: 'Exportar CSV' }).click() + expect((await download).suggestedFilename()).toMatch(/^pedidos-\d{4}-\d{2}-\d{2}\.csv$/) + await expect(page.getByText('Planilha baixada.')).toBeVisible() + expect(calls.some((call) => call.path === '/export')).toBe(true) + }) +})