diff --git a/backend/CLAUDE.md b/backend/CLAUDE.md index 5415f40..336df52 100644 --- a/backend/CLAUDE.md +++ b/backend/CLAUDE.md @@ -15,13 +15,13 @@ Com implementação real até agora: - `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); 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. Painel de pedidos em `/ticketing/orders` (busca por nome, e-mail ou número, filtro `status`, 25 por página; `meta.summary` traz os números da edição inteira, sem seguir o filtro: pagos, aguardando e quantos vencem até o fim do dia, reembolsos e a taxa do gateway sobre o bruto; `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. +- `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; `meta.summary` traz os números da edição inteira, sem seguir o filtro: pagos, aguardando e quantos vencem até o fim do dia, reembolsos e a taxa do gateway sobre o bruto; `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`, `missing` e `transferred`; cada linha traz `missing`, os campos que faltam, e `transferred_from`; `meta.summary` traz participantes, crachás completos, com dados faltando, pedidos de acessibilidade e transferidos da edição inteira); acessibilidade (cifrada) só aparece para quem tem `edition.manage`, nunca para financeiro ou check-in. "Dados faltando" é ingresso válido sem nome no crachá ou sem camiseta (`Tickets\AttendeeData`). Toda edição dos dados do participante, pela organização ou pela própria pessoa, dispara `TicketAttendeeUpdated` (auditado como `ticketing.ticket_attendee_updated`, com antes e depois; a acessibilidade entra só como "preenchido"), e o detalhe mostra essas edições em `edits` (`Tickets\AttendeeHistory`). Cobrança de dados faltando: `GET .../tickets/data-reminder` devolve quantas pessoas recebem e o e-mail renderizado (`EditionMailer::preview`), e `POST` com `confirm=true` e `recipients` igual a esse número manda o e-mail `attendee_data_reminder`, um por pessoa (auditado como `ticketing.attendee_data_reminder_sent`). `GET .../tickets/badges` gera o CSV dos crachás (só ingressos válidos, sem e-mail nem acessibilidade). 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}`. A conta ativa traz `webhook_url` e `last_event_at` (último evento assinado dessa conta, para o painel mostrar se o webhook continua chegando). Só a organização (`payments.gateway`) vê e mexe no gateway; o financeiro não. 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. - `finance`: finanças da edição, sem nota fiscal, sob a permissão `finance.manage` (organizador e financeiro), em `/editions/{id}/finance`. A receita não é guardada: `Reports\FinanceReport` calcula na hora a partir dos contratos `Ticketing\Contracts\TicketRevenue` (pedidos pagos ou reembolsados com valor, por conta de recebimento: vendido, reembolsos, taxa do gateway real em `orders.gateway_fee_cents` ou estimada pelo percentual da edição, e líquido) e `Sponsors\Contracts\SponsorRevenue` (patrocínio recebido e a receber), com o titular de cada conta (CPF ou CNPJ, documento mascarado, inclusive contas trocadas) vindo de `PaymentAccounts::all`. Pedido gratuito e importado ficam de fora. Saldo = receita líquida recebida − despesas pagas; previsão = saldo + patrocínio a receber − despesas a pagar. Despesas (`expenses`) com categoria, fornecedor opcional da edição (contrato `Suppliers\Contracts\EditionSuppliers`), valor, vencimento, status (a pagar, paga, que exige data, ou cancelada) e comprovante no disco privado `FINANCE_RECEIPTS_DISK`, baixado só por URL assinada que expira; criar, mudar e remover são auditados (`finance.expense_*`). Categorias (`finance_categories`) com orçamento: a edição ganha as padrão (`FinanceCategory::DEFAULTS`) na primeira leitura, e o resumo compara orçado, comprometido (a pagar e paga) e pago por categoria. `GET .../export` gera XLSX com as abas Resumo, Receita por conta, Orçamento e Despesas (`Export\XlsxWriter`, sem biblioteca, com `ZipArchive`; valores como número), e `?format=csv` gera só as despesas, com ponto e vírgula e BOM. Texto que começa com `=`, `+`, `-` ou `@` ganha apóstrofo para não virar fórmula. A Visão geral recebe a pendência de despesas vencidas (só para quem tem `finance.manage`), e `FinanceCloner` leva categorias e orçamento para a próxima edição. - `tasks`: quadro kanban da organização, em `/editions/{id}/tasks`. Toda a equipe da edição vê o quadro (`GET /board?filter=mine|overdue`); `tasks.manage` (só organizador) cria, edita, remove e mexe nas colunas, e o responsável move a própria tarefa. Colunas (`task_columns`, as quatro de `TaskColumn::DEFAULTS` nascem na primeira leitura) com `is_done`: tarefa que entra nela ganha `completed_at` e deixa de ficar atrasada; o quadro nunca fica sem coluna de concluídas e só remove coluna vazia. Mover (`MoveTask`): trava as colunas de origem e destino pelo id, em ordem, e renumera as duas de 0 a n−1 na mesma transação; se a tarefa mudou de coluna enquanto isso, tenta de novo. `TaskReorderConcurrencyTest` prova com 12 processos PHP simultâneos que não duplica nem perde posição. Atrasada = prazo antes de hoje e não concluída (pendência na Visão geral). E-mail só para o responsável, se ainda é da equipe e se não desligou `assigned_tasks` (`UserAccounts::wantsNotification`): `task_assigned` ao virar responsável (menos quando a pessoa se atribui) e `task_due_soon` pelo `tasks:due-reminders` (08:00 de Brasília), uma vez por prazo; mudar o prazo libera outro lembrete. Vínculo da tarefa (`link_type`, `link_id`) por ponto de extensão: o módulo dono implementa `Tasks\Contracts\TaskLinkProvider` e registra com `$app->tag([...], TaskLinkProvider::TAG)` (hoje `supplier`, do Suppliers, e `sponsorship`, do Sponsors; a sessão entra com o Program). `TasksCloner` leva colunas e tarefas para a próxima edição como checklist, sem responsável, prazo nem vínculo. -- `notifications`: e-mail transacional por edição. Outro módulo envia pelo contrato `EditionMailer::send(editionId, EmailTemplate, email, nome, variáveis, url)`, que registra o envio em `email_deliveries` e enfileira `SendEmailDelivery` (5 tentativas, backoff 30s → 30min). Os tipos de e-mail ficam em `EmailTemplate` (assunto/corpo padrão, variáveis permitidas, transacional ou não), e a edição só sobrescreve assunto e corpo (`email_templates`). O corpo é texto com `{variavel}`, substituído sem Blade e com todo HTML escapado. O layout usa o tema publicado (Branding). Não transacional leva link assinado e `List-Unsubscribe` (one-click), e quem se descadastra fica em `email_unsubscribes`. Produção usa Resend (`MAIL_MAILER=resend`, `RESEND_API_KEY`) e dev usa o Mailpit. O transport do Resend grava o id do Resend como Message-ID, e o envio guarda esse id em `provider_message_id`. Webhooks do Resend em `POST /api/v1/webhooks/resend` (`throttle:webhooks`): assinatura Svix verificada com `RESEND_WEBHOOK_SECRET` e janela de 5 minutos (`Webhooks\SvixSignature`, 401 e nada muda se falhar), um registro por `svix-id` em `email_webhook_events` (entrega repetida responde `duplicate: true`) e a edição descoberta pelo envio (`provider_message_id`), nunca pelo que o webhook manda. `email.delivered` marca entregue; bounce permanente e `email.complained` marcam o envio e bloqueiam o endereço na edição (`email_suppressions`, auditado como `notifications.address_suppressed`), inclusive para e-mail transacional e para o que já estava na fila; bounce temporário e `email.delivery_delayed` só registram o motivo em `provider_detail`. A organização vê os bloqueados em `GET /emails/suppressions` e libera em `DELETE /emails/suppressions/{id}` (`notifications.suppression_lifted`); reenviar para endereço bloqueado é recusado. +- `notifications`: e-mail transacional por edição. Outro módulo envia pelo contrato `EditionMailer::send(editionId, EmailTemplate, email, nome, variáveis, url)` (e vê o e-mail pronto, sem enviar, em `EditionMailer::preview`), que registra o envio em `email_deliveries` e enfileira `SendEmailDelivery` (5 tentativas, backoff 30s → 30min). Os tipos de e-mail ficam em `EmailTemplate` (assunto/corpo padrão, variáveis permitidas, transacional ou não), e a edição só sobrescreve assunto e corpo (`email_templates`). O corpo é texto com `{variavel}`, substituído sem Blade e com todo HTML escapado. O layout usa o tema publicado (Branding). Não transacional leva link assinado e `List-Unsubscribe` (one-click), e quem se descadastra fica em `email_unsubscribes`. Produção usa Resend (`MAIL_MAILER=resend`, `RESEND_API_KEY`) e dev usa o Mailpit. O transport do Resend grava o id do Resend como Message-ID, e o envio guarda esse id em `provider_message_id`. Webhooks do Resend em `POST /api/v1/webhooks/resend` (`throttle:webhooks`): assinatura Svix verificada com `RESEND_WEBHOOK_SECRET` e janela de 5 minutos (`Webhooks\SvixSignature`, 401 e nada muda se falhar), um registro por `svix-id` em `email_webhook_events` (entrega repetida responde `duplicate: true`) e a edição descoberta pelo envio (`provider_message_id`), nunca pelo que o webhook manda. `email.delivered` marca entregue; bounce permanente e `email.complained` marcam o envio e bloqueiam o endereço na edição (`email_suppressions`, auditado como `notifications.address_suppressed`), inclusive para e-mail transacional e para o que já estava na fila; bounce temporário e `email.delivery_delayed` só registram o motivo em `provider_detail`. A organização vê os bloqueados em `GET /emails/suppressions` e libera em `DELETE /emails/suppressions/{id}` (`notifications.suppression_lifted`); reenviar para endereço bloqueado é recusado. ## Estrutura de cada módulo (`app-modules//src/`) diff --git a/backend/app-modules/notifications/src/Actions/QueueEmail.php b/backend/app-modules/notifications/src/Actions/QueueEmail.php index 6e90c22..d01025d 100644 --- a/backend/app-modules/notifications/src/Actions/QueueEmail.php +++ b/backend/app-modules/notifications/src/Actions/QueueEmail.php @@ -8,12 +8,22 @@ use PHPeste\Notifications\Enums\DeliveryStatus; use PHPeste\Notifications\Enums\EmailTemplate; use PHPeste\Notifications\Jobs\SendEmailDelivery; +use PHPeste\Notifications\Mail\EmailComposer; use PHPeste\Notifications\Models\EmailDelivery; use PHPeste\Notifications\Models\EmailSuppression; use PHPeste\Notifications\Models\EmailUnsubscribe; class QueueEmail implements EditionMailer { + public function __construct(private readonly EmailComposer $composer) {} + + public function preview(string $editionId, EmailTemplate $template, string $email, array $variables = [], ?string $actionUrl = null): array + { + $rendered = $this->composer->compose($editionId, $template, $email, $variables, $actionUrl); + + return ['subject' => $rendered->subject, 'html' => $rendered->html, 'text' => $rendered->text]; + } + public function send(string $editionId, EmailTemplate $template, string $email, string $name, array $variables = [], ?string $actionUrl = null): string { return $this->queue($editionId, $template, $email, $name, $variables, $actionUrl)->id; diff --git a/backend/app-modules/notifications/src/Contracts/EditionMailer.php b/backend/app-modules/notifications/src/Contracts/EditionMailer.php index 9b21394..8ca0a40 100644 --- a/backend/app-modules/notifications/src/Contracts/EditionMailer.php +++ b/backend/app-modules/notifications/src/Contracts/EditionMailer.php @@ -12,4 +12,12 @@ interface EditionMailer * @param array $variables */ public function send(string $editionId, EmailTemplate $template, string $email, string $name, array $variables = [], ?string $actionUrl = null): string; + + /** + * O e-mail como sairia, com o tema e o texto da edição, sem enviar. + * + * @param array $variables + * @return array{subject: string, html: string, text: string} + */ + public function preview(string $editionId, EmailTemplate $template, string $email, array $variables = [], ?string $actionUrl = null): array; } diff --git a/backend/app-modules/notifications/src/Enums/EmailTemplate.php b/backend/app-modules/notifications/src/Enums/EmailTemplate.php index f4995b1..c0ab726 100644 --- a/backend/app-modules/notifications/src/Enums/EmailTemplate.php +++ b/backend/app-modules/notifications/src/Enums/EmailTemplate.php @@ -19,6 +19,7 @@ enum EmailTemplate: string case SpeakerInvited = 'speaker_invited'; case TaskAssigned = 'task_assigned'; case TaskDueSoon = 'task_due_soon'; + case AttendeeDataReminder = 'attendee_data_reminder'; public function label(): string { @@ -36,6 +37,7 @@ public function label(): string self::SpeakerInvited => 'Convite para palestrar', self::TaskAssigned => 'Tarefa atribuída', self::TaskDueSoon => 'Prazo de tarefa chegando', + self::AttendeeDataReminder => 'Dados do crachá faltando', }; } @@ -54,6 +56,7 @@ public function trigger(): string self::SpeakerInvited => 'Ao convidar alguém direto para palestrar', self::TaskAssigned => 'Ao virar responsável por uma tarefa', self::TaskDueSoon => '1 dia antes do prazo da tarefa', + self::AttendeeDataReminder => 'Quando a organização cobra os dados faltando', }; } @@ -72,7 +75,7 @@ public function variables(): array self::OrderRefunded => ['nome', 'edicao', 'pedido', 'valor', 'ingressos'], self::TicketTransferred => ['nome', 'edicao', 'data', 'remetente', 'ingresso'], self::CfpAccepted, self::CfpWaitlisted => ['nome', 'edicao', 'proposta', 'data', 'prazo'], - self::EventReminder => ['nome', 'edicao', 'data'], + self::EventReminder, self::AttendeeDataReminder => ['nome', 'edicao', 'data'], self::TeamInvite => ['nome', 'edicao', 'papel'], self::ProposalReceived => ['nome', 'edicao', 'proposta', 'data'], self::SpeakerConfirmationReminder, self::SpeakerInvited => ['nome', 'edicao', 'proposta', 'prazo'], @@ -96,6 +99,7 @@ public function defaultSubject(): string self::SpeakerInvited => 'Convite para palestrar no {edicao}', self::TaskAssigned => 'Nova tarefa para você no {edicao}: {tarefa}', self::TaskDueSoon => 'O prazo de "{tarefa}" é {prazo}', + self::AttendeeDataReminder => 'Complete seus dados para o crachá do {edicao}', }; } @@ -114,7 +118,8 @@ public function defaultBody(): string self::SpeakerConfirmationReminder => "Oi, {nome}!\n\nAinda não recebemos sua confirmação para a palestra \"{proposta}\" no {edicao}. O prazo vai até {prazo}; depois disso a vaga pode ir para a lista de espera.", self::SpeakerInvited => "Oi, {nome}!\n\nA organização do {edicao} convidou você para apresentar \"{proposta}\". Confirme sua participação pelo link abaixo até {prazo}.\n\nPara entrar, use este e-mail: se ainda não tem senha na plataforma, entre pelo GitHub ou peça uma senha em \"Esqueci minha senha\".", self::TaskAssigned => "Oi, {nome}!\n\nVocê é responsável pela tarefa \"{tarefa}\" no {edicao}. Prazo: {prazo}.", - self::TaskDueSoon => "Oi, {nome}!\n\nA tarefa \"{tarefa}\" do {edicao}, que está com você, vence {prazo}. Se já terminou, mova para a coluna de concluídas no painel." + self::TaskDueSoon => "Oi, {nome}!\n\nA tarefa \"{tarefa}\" do {edicao}, que está com você, vence {prazo}. Se já terminou, mova para a coluna de concluídas no painel.", + self::AttendeeDataReminder => "Oi, {nome}!\n\nAinda faltam dados do seu ingresso para o {edicao}, em {data}: o nome que vai no crachá e o tamanho da camiseta. Leva um minuto: entre com este e-mail pelo link abaixo e complete.", }; } @@ -132,6 +137,7 @@ public function actionLabel(): string self::ProposalReceived => 'Ver minha proposta', self::SpeakerConfirmationReminder, self::SpeakerInvited => 'Confirmar participação', self::TaskAssigned, self::TaskDueSoon => 'Ver tarefa', + self::AttendeeDataReminder => 'Completar meus dados', }; } diff --git a/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php b/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php index d5a750b..0e85966 100644 --- a/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php +++ b/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php @@ -20,7 +20,7 @@ it('lista os modelos da edição com o padrão de cada um', function (): void { $this->getJson($this->url) ->assertOk() - ->assertJsonCount(13, 'data') + ->assertJsonCount(14, 'data') ->assertJsonPath('data.0.id', 'order_confirmed') ->assertJsonPath('data.0.label', 'Confirmação de compra') ->assertJsonPath('data.0.trigger', 'Ao pagar o pedido') diff --git a/backend/app-modules/ticketing/routes/ticketing-routes.php b/backend/app-modules/ticketing/routes/ticketing-routes.php index afd1d4c..d44a254 100644 --- a/backend/app-modules/ticketing/routes/ticketing-routes.php +++ b/backend/app-modules/ticketing/routes/ticketing-routes.php @@ -41,6 +41,9 @@ 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'); Route::get('/tickets', [TicketController::class, 'index'])->name('ticketing.tickets.index'); + Route::get('/tickets/badges', [TicketController::class, 'badges'])->name('ticketing.tickets.badges'); + Route::get('/tickets/data-reminder', [TicketController::class, 'reminderPreview'])->name('ticketing.tickets.data-reminder.preview'); + Route::post('/tickets/data-reminder', [TicketController::class, 'remind'])->middleware('throttle:6,1')->name('ticketing.tickets.data-reminder'); Route::get('/tickets/{ticket}', [TicketController::class, 'show'])->whereUuid('ticket')->name('ticketing.tickets.show'); Route::patch('/tickets/{ticket}', [TicketController::class, 'update'])->whereUuid('ticket')->name('ticketing.tickets.update'); Route::post('/tickets/{ticket}/transfer', [TicketController::class, 'transfer'])->whereUuid('ticket')->name('ticketing.tickets.transfer'); diff --git a/backend/app-modules/ticketing/src/Actions/RemindMissingAttendeeData.php b/backend/app-modules/ticketing/src/Actions/RemindMissingAttendeeData.php new file mode 100644 index 0000000..5527990 --- /dev/null +++ b/backend/app-modules/ticketing/src/Actions/RemindMissingAttendeeData.php @@ -0,0 +1,47 @@ +data->missing(Ticket::query())->distinct()->count('holder_email'); + } + + public function handle(string $editionId, bool $confirm, ?int $recipients, ?string $actorId): int + { + $pending = $this->recipients(); + + if ($pending === 0) { + throw ValidationException::withMessages(['recipients' => 'Ninguém está com dados faltando.']); + } + + if (!$confirm || $recipients !== $pending) { + throw ValidationException::withMessages(['confirm' => sprintf('Confirme a cobrança por e-mail para %d %s.', $pending, $pending === 1 ? 'pessoa' : 'pessoas')]); + } + + DB::transaction(function () use ($editionId, $pending, $actorId): void { + event(new AttendeeDataReminderSent($editionId, $pending, $actorId)); + dispatch(new SendAttendeeDataReminders($editionId)); + }); + + return $pending; + } +} diff --git a/backend/app-modules/ticketing/src/Actions/UpdateTicketAttendee.php b/backend/app-modules/ticketing/src/Actions/UpdateTicketAttendee.php index 319b58a..a12b1ed 100644 --- a/backend/app-modules/ticketing/src/Actions/UpdateTicketAttendee.php +++ b/backend/app-modules/ticketing/src/Actions/UpdateTicketAttendee.php @@ -4,9 +4,17 @@ namespace PHPeste\Ticketing\Actions; +use BackedEnum; +use Illuminate\Support\Facades\DB; use Illuminate\Validation\ValidationException; +use PHPeste\Ticketing\Events\TicketAttendeeUpdated; use PHPeste\Ticketing\Models\Ticket; +/** + * Muda os dados de quem usa o ingresso e registra na auditoria o que mudou, + * com o valor de antes e o de depois. A acessibilidade entra só como + * "mudou", sem o texto. + */ class UpdateTicketAttendee { public const array FIELDS = ['holder_name', 'badge_name', 'company', 'tshirt_size', 'accessibility']; @@ -14,14 +22,45 @@ class UpdateTicketAttendee /** * @param array $data */ - public function handle(Ticket $ticket, array $data): Ticket + public function handle(Ticket $ticket, array $data, ?string $actorId = null): Ticket { if (!$ticket->isActive()) { throw ValidationException::withMessages(['ticket' => 'Ingresso cancelado não pode ser alterado.']); } - $ticket->update(array_intersect_key($data, array_flip(self::FIELDS))); + $ticket->fill(array_intersect_key($data, array_flip(self::FIELDS))); + $changed = array_keys($ticket->getDirty()); + + if ($changed === []) { + return $ticket; + } + + $before = []; + $after = []; + + foreach ($changed as $field) { + $before[$field] = $this->value($field, $ticket->getOriginal($field)); + $after[$field] = $this->value($field, $ticket->getAttribute($field)); + } + + DB::transaction(function () use ($ticket, $before, $after, $actorId): void { + $ticket->save(); + event(new TicketAttendeeUpdated($ticket->edition_id, $ticket->id, $before, $after, $actorId)); + }); return $ticket->refresh(); } + + private function value(string $field, mixed $value): ?string + { + if ($field === 'accessibility') { + return $value === null ? null : 'preenchido'; + } + + if ($value instanceof BackedEnum) { + return (string) $value->value; + } + + return is_scalar($value) ? (string) $value : null; + } } diff --git a/backend/app-modules/ticketing/src/Events/AttendeeDataReminderSent.php b/backend/app-modules/ticketing/src/Events/AttendeeDataReminderSent.php new file mode 100644 index 0000000..48afca1 --- /dev/null +++ b/backend/app-modules/ticketing/src/Events/AttendeeDataReminderSent.php @@ -0,0 +1,29 @@ +editionId, 'ticketing.attendee_data_reminder_sent', 'edition', $this->editionId, $this->actorId, null, ['recipients' => $this->recipients]); + } +} diff --git a/backend/app-modules/ticketing/src/Events/TicketAttendeeUpdated.php b/backend/app-modules/ticketing/src/Events/TicketAttendeeUpdated.php new file mode 100644 index 0000000..220616d --- /dev/null +++ b/backend/app-modules/ticketing/src/Events/TicketAttendeeUpdated.php @@ -0,0 +1,37 @@ + $before + * @param array $after + */ + public function __construct( + public readonly string $editionId, + public readonly string $ticketId, + public readonly array $before, + public readonly array $after, + public readonly ?string $actorId, + ) {} + + public function auditRecord(): AuditRecord + { + return new AuditRecord($this->editionId, 'ticketing.ticket_attendee_updated', 'ticket', $this->ticketId, $this->actorId, $this->before, $this->after); + } +} diff --git a/backend/app-modules/ticketing/src/Http/Controllers/AttendeeTicketController.php b/backend/app-modules/ticketing/src/Http/Controllers/AttendeeTicketController.php index e2d956a..4e3f38f 100644 --- a/backend/app-modules/ticketing/src/Http/Controllers/AttendeeTicketController.php +++ b/backend/app-modules/ticketing/src/Http/Controllers/AttendeeTicketController.php @@ -49,7 +49,7 @@ public function update(UpdateTicketAttendeeRequest $request, UpdateTicketAttende /** @var array $data */ $data = $request->validated(); - return $this->present($update->handle($this->ticket($request), $data)->load(['item', 'order'])); + return $this->present($update->handle($this->ticket($request), $data, (string) $this->user($request)->getAuthIdentifier())->load(['item', 'order'])); } public function transfer(TransferTicketRequest $request, TransferTicket $transfer): TicketResource diff --git a/backend/app-modules/ticketing/src/Http/Controllers/TicketController.php b/backend/app-modules/ticketing/src/Http/Controllers/TicketController.php index b939fce..c2c3ae6 100644 --- a/backend/app-modules/ticketing/src/Http/Controllers/TicketController.php +++ b/backend/app-modules/ticketing/src/Http/Controllers/TicketController.php @@ -5,23 +5,39 @@ namespace PHPeste\Ticketing\Http\Controllers; use Illuminate\Database\Eloquent\Builder; +use Illuminate\Http\JsonResponse; use Illuminate\Http\Request; use Illuminate\Http\Resources\Json\AnonymousResourceCollection; use Illuminate\Support\Facades\Gate; use Illuminate\Support\Str; use PHPeste\Community\Enums\EditionPermission; +use PHPeste\Community\Tenancy\CurrentEdition; +use PHPeste\Ticketing\Actions\RemindMissingAttendeeData; use PHPeste\Ticketing\Actions\TransferTicket; use PHPeste\Ticketing\Actions\UpdateTicketAttendee; use PHPeste\Ticketing\Enums\TicketStatus; use PHPeste\Ticketing\Enums\TshirtSize; +use PHPeste\Ticketing\Http\Requests\RemindAttendeeDataRequest; use PHPeste\Ticketing\Http\Requests\TransferTicketRequest; use PHPeste\Ticketing\Http\Requests\UpdateTicketAttendeeRequest; use PHPeste\Ticketing\Http\Resources\TicketResource; use PHPeste\Ticketing\Models\Ticket; +use PHPeste\Ticketing\Tickets\AttendeeData; +use PHPeste\Ticketing\Tickets\AttendeeHistory; +use PHPeste\Ticketing\Tickets\BadgeExport; use PHPeste\Ticketing\Tickets\TicketMailer; +use Symfony\Component\HttpFoundation\StreamedResponse; class TicketController { + public function __construct(private readonly AttendeeData $data) {} + + /** + * Uma linha por ingresso. Filtros: `status`, `tshirt_size`, + * `ticket_type_id`, `q` (nome, crachá, e-mail ou código), `missing` + * (sem crachá ou camiseta), `transferred` e `accessibility` (só a + * organização). `meta.summary` traz os números da edição inteira. + */ public function index(Request $request): AnonymousResourceCollection { Gate::authorize('ticketing.view'); @@ -32,7 +48,9 @@ public function index(Request $request): AnonymousResourceCollection $type = $request->query('ticket_type_id'); $search = mb_trim((string) $request->query('q')); - $tickets = Ticket::query()->with(['item', 'order']) + $tickets = $this->data->withPreviousHolder(Ticket::query()->select('tickets.*')->with(['item', 'order'])) + ->when($request->boolean('missing'), fn (Builder $query): Builder => $this->data->missing($query)) + ->when($request->boolean('transferred'), fn (Builder $query): Builder => $this->data->transferred($query)) ->when($status !== null, fn (Builder $query) => $query->where('status', $status?->value)) ->when($size !== null, fn (Builder $query) => $query->where('tshirt_size', $size?->value)) ->when(is_string($type) && Str::isUuid($type), fn (Builder $query) => $query->where('ticket_type_id', $type)) @@ -53,24 +71,80 @@ public function index(Request $request): AnonymousResourceCollection } } - return $collection; + return $collection->additional(['meta' => ['summary' => $this->data->summary($private)]]); } - public function show(Request $request): TicketResource + public function show(Request $request, AttendeeHistory $history): TicketResource { Gate::authorize('ticketing.view'); - return $this->present($this->ticket($request), history: true); + $ticket = $this->ticket($request); + $resource = $this->present($ticket, history: true); + $resource->edits = $history->for($ticket); + + return $resource; } - public function update(UpdateTicketAttendeeRequest $request, UpdateTicketAttendee $update): TicketResource + public function update(UpdateTicketAttendeeRequest $request, UpdateTicketAttendee $update, AttendeeHistory $history): TicketResource { Gate::authorize(EditionPermission::ManageEdition->value); /** @var array $data */ $data = $request->validated(); + $actor = $request->user()?->getAuthIdentifier(); + + $ticket = $update->handle($this->ticket($request), $data, is_string($actor) ? $actor : null)->load(['item', 'order']); + $resource = $this->present($ticket, history: true); + $resource->edits = $history->for($ticket); + + return $resource; + } + + /** + * Quantas pessoas vão receber a cobrança de dados e o e-mail como sai. + */ + public function reminderPreview(Request $request, RemindMissingAttendeeData $remind, TicketMailer $mail, CurrentEdition $currentEdition): JsonResponse + { + Gate::authorize(EditionPermission::ManageEdition->value); + + $first = $this->data->missing(Ticket::query())->orderBy('holder_name')->first(); + + return response()->json(['data' => [ + 'recipients' => $remind->recipients(), + 'email' => $first === null ? null : $mail->previewDataReminder((string) $currentEdition->id(), $first->holder_email, $first->holder_name), + ]]); + } - return $this->present($update->handle($this->ticket($request), $data)->load(['item', 'order'])); + /** + * Manda a cobrança. `recipients` precisa bater com o número da prévia. + */ + public function remind(RemindAttendeeDataRequest $request, RemindMissingAttendeeData $remind, CurrentEdition $currentEdition): JsonResponse + { + Gate::authorize(EditionPermission::ManageEdition->value); + + $actor = $request->user()?->getAuthIdentifier(); + $sent = $remind->handle((string) $currentEdition->id(), $request->boolean('confirm'), $request->integer('recipients'), is_string($actor) ? $actor : null); + + return response()->json(['data' => ['recipients' => $sent]], 202); + } + + /** + * CSV dos ingressos válidos para imprimir os crachás. + */ + public function badges(BadgeExport $export, CurrentEdition $currentEdition): StreamedResponse + { + Gate::authorize('ticketing.view'); + + $editionId = (string) $currentEdition->id(); + + return response()->streamDownload(fn () => $currentEdition->run($editionId, function () use ($export): void { + $out = fopen('php://output', 'w'); + + if ($out !== false) { + $export->write($out); + fclose($out); + } + }), sprintf('crachas-%s.csv', now()->format('Y-m-d')), ['Content-Type' => 'text/csv; charset=UTF-8']); } public function transfer(TransferTicketRequest $request, TransferTicket $transfer): TicketResource diff --git a/backend/app-modules/ticketing/src/Http/Requests/RemindAttendeeDataRequest.php b/backend/app-modules/ticketing/src/Http/Requests/RemindAttendeeDataRequest.php new file mode 100644 index 0000000..573a991 --- /dev/null +++ b/backend/app-modules/ticketing/src/Http/Requests/RemindAttendeeDataRequest.php @@ -0,0 +1,21 @@ +> + */ + public function rules(): array + { + return [ + 'confirm' => ['required', 'boolean'], + 'recipients' => ['required', 'integer', 'min:0'], + ]; + } +} diff --git a/backend/app-modules/ticketing/src/Http/Resources/TicketResource.php b/backend/app-modules/ticketing/src/Http/Resources/TicketResource.php index 875fd9c..7324feb 100644 --- a/backend/app-modules/ticketing/src/Http/Resources/TicketResource.php +++ b/backend/app-modules/ticketing/src/Http/Resources/TicketResource.php @@ -8,6 +8,7 @@ use Illuminate\Http\Request; use PHPeste\Ticketing\Models\Ticket; use PHPeste\Ticketing\Models\TicketTransfer; +use PHPeste\Ticketing\Tickets\AttendeeData; use PHPeste\Ticketing\Tickets\TicketPasses; class TicketResource extends ApiResource @@ -18,6 +19,11 @@ class TicketResource extends ApiResource public bool $withHistory = false; + /** + * @var list>|null + */ + public ?array $edits = null; + /** * @return array */ @@ -47,6 +53,8 @@ public function toArray(Request $request): array 'tshirt_size' => $ticket->tshirt_size?->value, ...($this->withAccessibility ? ['accessibility' => $ticket->accessibility] : []), ], + 'missing' => resolve(AttendeeData::class)->missingFields($ticket), + 'transferred_from' => is_string($ticket->getAttribute('transferred_from')) ? $ticket->getAttribute('transferred_from') : null, 'issued_at' => $this->isoDate($ticket->issued_at), 'cancelled_at' => $this->isoDate($ticket->cancelled_at), 'last_sent_at' => $this->isoDate($ticket->last_sent_at), @@ -58,6 +66,7 @@ public function toArray(Request $request): array 'transferred_by' => $transfer->transferred_by, 'at' => $this->isoDate($transfer->created_at), ])->all()] : []), + ...($this->edits === null ? [] : ['edits' => $this->edits]), ]; } } diff --git a/backend/app-modules/ticketing/src/Jobs/SendAttendeeDataReminders.php b/backend/app-modules/ticketing/src/Jobs/SendAttendeeDataReminders.php new file mode 100644 index 0000000..e4dbf3b --- /dev/null +++ b/backend/app-modules/ticketing/src/Jobs/SendAttendeeDataReminders.php @@ -0,0 +1,50 @@ +afterCommit(); + } + + public function handle(CurrentEdition $currentEdition, AttendeeData $data, TicketMailer $mailer): void + { + $currentEdition->run($this->editionId, function () use ($data, $mailer): void { + $sent = []; + + $data->missing(Ticket::query())->orderBy('id')->chunkById(200, function ($chunk) use ($mailer, &$sent): void { + foreach ($chunk as $ticket) { + $email = mb_strtolower($ticket->holder_email); + + if (isset($sent[$email])) { + continue; + } + + $sent[$email] = true; + $mailer->dataReminder($ticket); + } + }); + }); + } +} diff --git a/backend/app-modules/ticketing/src/Tickets/AttendeeData.php b/backend/app-modules/ticketing/src/Tickets/AttendeeData.php new file mode 100644 index 0000000..c7cd21d --- /dev/null +++ b/backend/app-modules/ticketing/src/Tickets/AttendeeData.php @@ -0,0 +1,85 @@ + $query + * @return Builder + */ + public function missing(Builder $query): Builder + { + return $query->where('status', TicketStatus::Active->value) + ->where(fn (Builder $inner) => $inner->whereNull('badge_name')->orWhereNull('tshirt_size')); + } + + /** + * @param Builder $query + * @return Builder + */ + public function transferred(Builder $query): Builder + { + return $query->whereHas('transfers'); + } + + /** + * Quem tinha o ingresso antes da primeira transferência. + * + * @param Builder $query + * @return Builder + */ + public function withPreviousHolder(Builder $query): Builder + { + return $query->addSelect(['transferred_from' => TicketTransfer::query() + ->select('from_name') + ->whereColumn('ticket_transfers.ticket_id', 'tickets.id') + ->oldest() + ->limit(1)]); + } + + /** + * @return list + */ + public function missingFields(Ticket $ticket): array + { + if (!$ticket->isActive()) { + return []; + } + + return array_values(array_filter(self::REQUIRED, fn (string $field): bool => $ticket->getAttribute($field) === null)); + } + + /** + * Números da edição inteira para o topo da tela, sem seguir o filtro. + * + * @return array{participants: int, complete: int, missing: int, accessibility: int|null, transferred: int} + */ + public function summary(bool $private): array + { + $active = fn (): Builder => Ticket::query()->where('status', TicketStatus::Active->value); + $participants = $active()->count(); + $missing = $this->missing(Ticket::query())->count(); + + return [ + 'participants' => $participants, + 'complete' => $participants - $missing, + 'missing' => $missing, + 'accessibility' => $private ? $active()->whereNotNull('accessibility')->count() : null, + 'transferred' => $this->transferred($active())->count(), + ]; + } +} diff --git a/backend/app-modules/ticketing/src/Tickets/AttendeeHistory.php b/backend/app-modules/ticketing/src/Tickets/AttendeeHistory.php new file mode 100644 index 0000000..36f6c87 --- /dev/null +++ b/backend/app-modules/ticketing/src/Tickets/AttendeeHistory.php @@ -0,0 +1,77 @@ + 'Nome', + 'badge_name' => 'Nome no crachá', + 'company' => 'Empresa', + 'tshirt_size' => 'Camiseta', + 'accessibility' => 'Acessibilidade', + ]; + + public function __construct( + private readonly AuditTrail $trail, + private readonly UserAccounts $accounts, + ) {} + + /** + * @return list, actor: array{id: string, name: string|null}|null, at: string}> + */ + public function for(Ticket $ticket): array + { + $entries = array_values(array_filter( + $this->trail->forSubject($ticket->edition_id, 'ticket', $ticket->id), + fn (AuditEntry $entry): bool => $entry->action === 'ticketing.ticket_attendee_updated', + )); + + $actorIds = array_values(array_unique(array_filter(array_map(fn (AuditEntry $entry): ?string => $entry->actorId, $entries)))); + $profiles = $actorIds === [] ? [] : $this->accounts->profiles($actorIds); + + return array_map(fn (AuditEntry $entry): array => [ + 'id' => $entry->id, + 'changes' => $this->changes($entry), + 'actor' => $entry->actorId === null ? null : ['id' => $entry->actorId, 'name' => $profiles[$entry->actorId]['name'] ?? null], + 'at' => $entry->createdAt->utc()->toIso8601ZuluString(), + ], $entries); + } + + /** + * @return list + */ + private function changes(AuditEntry $entry): array + { + $changes = []; + + foreach (self::LABELS as $field => $label) { + if (!array_key_exists($field, $entry->after ?? [])) { + continue; + } + + $from = $entry->before[$field] ?? null; + $to = $entry->after[$field] ?? null; + + $changes[] = [ + 'field' => $field, + 'label' => $label, + 'from' => $field === 'accessibility' || !is_scalar($from) ? null : (string) $from, + 'to' => $field === 'accessibility' || !is_scalar($to) ? null : (string) $to, + ]; + } + + return $changes; + } +} diff --git a/backend/app-modules/ticketing/src/Tickets/BadgeExport.php b/backend/app-modules/ticketing/src/Tickets/BadgeExport.php new file mode 100644 index 0000000..f6c847e --- /dev/null +++ b/backend/app-modules/ticketing/src/Tickets/BadgeExport.php @@ -0,0 +1,49 @@ +with('item') + ->where('status', TicketStatus::Active->value) + ->orderBy('id') + ->chunkById(500, function ($tickets) use ($out): void { + foreach ($tickets as $ticket) { + fputcsv($out, [ + $ticket->code, + $this->safe($ticket->badge_name ?? $ticket->holder_name), + $this->safe($ticket->holder_name), + $this->safe($ticket->company ?? ''), + $this->safe($ticket->item->ticket_type_name), + $ticket->tshirt_size->value ?? '', + ], ';', '"', ''); + } + }); + } + + /** + * Evita que a planilha execute fórmula vinda do nome digitado. + */ + private function safe(string $value): string + { + return $value !== '' && in_array($value[0], ['=', '+', '-', '@', "\t", "\r"], true) ? "'".$value : $value; + } +} diff --git a/backend/app-modules/ticketing/src/Tickets/TicketMailer.php b/backend/app-modules/ticketing/src/Tickets/TicketMailer.php index 2cec602..5367231 100644 --- a/backend/app-modules/ticketing/src/Tickets/TicketMailer.php +++ b/backend/app-modules/ticketing/src/Tickets/TicketMailer.php @@ -27,6 +27,26 @@ public function transferred(Ticket $ticket, string $fromName): void $this->send($ticket, EmailTemplate::TicketTransferred, ['remetente' => $fromName, 'ingresso' => $ticket->code]); } + public function dataReminder(Ticket $ticket): void + { + $this->mailer->send($ticket->edition_id, EmailTemplate::AttendeeDataReminder, $ticket->holder_email, $ticket->holder_name, ['nome' => $ticket->holder_name], $this->ticketsUrl($ticket->edition_id)); + } + + /** + * A cobrança de dados como a pessoa vai receber, sem enviar. + * + * @return array{subject: string, html: string, text: string} + */ + public function previewDataReminder(string $editionId, string $email, string $name): array + { + return $this->mailer->preview($editionId, EmailTemplate::AttendeeDataReminder, $email, ['nome' => $name], $this->ticketsUrl($editionId)); + } + + private function ticketsUrl(string $editionId): string + { + return mb_rtrim($this->sites->url($editionId), '/').'/ingressos'; + } + /** * @param array $variables */ @@ -35,7 +55,7 @@ private function send(Ticket $ticket, EmailTemplate $template, array $variables) $this->mailer->send($ticket->edition_id, $template, $ticket->holder_email, $ticket->holder_name, [ 'nome' => $ticket->holder_name, ...$variables, - ], mb_rtrim($this->sites->url($ticket->edition_id), '/').'/ingressos'); + ], $this->ticketsUrl($ticket->edition_id)); Ticket::query()->forEdition($ticket->edition_id)->whereKey($ticket->id)->update(['last_sent_at' => now()]); } diff --git a/backend/app-modules/ticketing/tests/Feature/TicketsTest.php b/backend/app-modules/ticketing/tests/Feature/TicketsTest.php index e23e9f5..5699f68 100644 --- a/backend/app-modules/ticketing/tests/Feature/TicketsTest.php +++ b/backend/app-modules/ticketing/tests/Feature/TicketsTest.php @@ -223,3 +223,94 @@ function emails(string $editionId, EmailTemplate $template): array $this->getJson($this->mine)->assertJsonPath('data.0.status', 'cancelled')->assertJsonMissingPath('data.0.qr'); $this->postJson("{$this->mine}/{$ticket->id}/transfer", ['name' => 'Xavier', 'email' => 'x@exemplo.com'])->assertStatus(422)->assertJsonPath('errors.ticket.0', 'Ingresso cancelado não pode ser transferido.'); }); + +it('participantes: filtra quem está com dados faltando e quem recebeu por transferência, com o resumo da edição', function (): void { + Sanctum::actingAs($this->organizer); + $ana = ticketOf($this->edition->id, 'ana@exemplo.com'); + $bia = ticketOf($this->edition->id, 'bia@exemplo.com'); + $this->patchJson("{$this->admin}/{$ana->id}", ['badge_name' => 'Aninha', 'tshirt_size' => 'M', 'accessibility' => 'Intérprete de Libras'])->assertOk(); + $this->postJson("{$this->admin}/{$bia->id}/transfer", ['name' => 'Carla Dias', 'email' => 'carla@exemplo.com'])->assertOk(); + + $this->getJson($this->admin) + ->assertOk() + ->assertJsonPath('meta.summary', ['participants' => 2, 'complete' => 1, 'missing' => 1, 'accessibility' => 1, 'transferred' => 1]); + + $this->getJson("{$this->admin}?missing=1") + ->assertJsonCount(1, 'data') + ->assertJsonPath('data.0.holder.name', 'Carla Dias') + ->assertJsonPath('data.0.missing', ['badge_name', 'tshirt_size']) + ->assertJsonPath('data.0.transferred_from', 'Bia Lima') + ->assertJsonPath('meta.summary.participants', 2); + $this->getJson("{$this->admin}?transferred=1")->assertJsonCount(1, 'data')->assertJsonPath('data.0.holder.email', 'carla@exemplo.com'); + $this->getJson("{$this->admin}?q=aninha")->assertJsonCount(1, 'data')->assertJsonPath('data.0.missing', [])->assertJsonPath('data.0.transferred_from', null); + + $finance = User::factory()->create(); + EditionMember::factory()->for($this->edition)->create(['user_id' => $finance->id, 'role' => EditionRole::Finance]); + Sanctum::actingAs($finance); + $this->getJson($this->admin)->assertJsonPath('meta.summary.accessibility', null); +}); + +it('a edição do nome do crachá fica registrada com quem mudou, de quê para quê, sem guardar o texto da acessibilidade', function (): void { + Sanctum::actingAs($this->organizer); + $ticket = ticketOf($this->edition->id, 'ana@exemplo.com'); + + $this->patchJson("{$this->admin}/{$ticket->id}", ['badge_name' => 'Aninha', 'accessibility' => 'Cadeira de rodas']) + ->assertOk() + ->assertJsonPath('data.edits.0.changes.0', ['field' => 'badge_name', 'label' => 'Nome no crachá', 'from' => null, 'to' => 'Aninha']) + ->assertJsonPath('data.edits.0.changes.1', ['field' => 'accessibility', 'label' => 'Acessibilidade', 'from' => null, 'to' => null]) + ->assertJsonPath('data.edits.0.actor.id', $this->organizer->id); + $this->patchJson("{$this->admin}/{$ticket->id}", ['badge_name' => 'Ana S.'])->assertOk(); + $this->patchJson("{$this->admin}/{$ticket->id}", ['badge_name' => 'Ana S.'])->assertOk(); + + $logs = AuditLog::query()->where('action', 'ticketing.ticket_attendee_updated')->orderBy('id')->get(); + expect($logs)->toHaveCount(2) + ->and($logs[1]->before)->toBe(['badge_name' => 'Aninha']) + ->and($logs[1]->after)->toBe(['badge_name' => 'Ana S.']) + ->and(json_encode($logs[0]->after))->not->toContain('Cadeira'); + + $this->getJson("{$this->admin}/{$ticket->id}") + ->assertJsonCount(2, 'data.edits') + ->assertJsonPath('data.edits.1.changes.0.from', 'Aninha') + ->assertJsonPath('data.edits.1.changes.0.to', 'Ana S.'); + + Sanctum::actingAs($this->ana); + $this->patchJson("{$this->mine}/{$ticket->id}", ['tshirt_size' => 'G'])->assertOk(); + expect(AuditLog::query()->where('action', 'ticketing.ticket_attendee_updated')->orderByDesc('id')->first()->actor_id)->toBe($this->ana->id); +}); + +it('cobra os dados faltando por e-mail, uma vez por pessoa, só depois de confirmar o número da prévia', function (): void { + Sanctum::actingAs($this->organizer); + $ana = ticketOf($this->edition->id, 'ana@exemplo.com'); + $this->patchJson("{$this->admin}/{$ana->id}", ['badge_name' => 'Aninha', 'tshirt_size' => 'M'])->assertOk(); + + $preview = $this->getJson("{$this->admin}/data-reminder")->assertOk(); + $preview->assertJsonPath('data.recipients', 1)->assertJsonPath('data.email.subject', 'Complete seus dados para o crachá do PHPeste 2027'); + expect($preview->json('data.email.text'))->toContain('Oi, Bia Lima!')->toContain('/ingressos') + ->and(emails($this->edition->id, EmailTemplate::AttendeeDataReminder))->toBe([]); + + $this->postJson("{$this->admin}/data-reminder", ['confirm' => true, 'recipients' => 2])->assertStatus(422)->assertJsonPath('errors.confirm.0', 'Confirme a cobrança por e-mail para 1 pessoa.'); + $this->postJson("{$this->admin}/data-reminder", ['confirm' => true, 'recipients' => 1])->assertStatus(202)->assertJsonPath('data.recipients', 1); + + expect(emails($this->edition->id, EmailTemplate::AttendeeDataReminder))->toBe(['bia@exemplo.com']) + ->and(AuditLog::query()->where('action', 'ticketing.attendee_data_reminder_sent')->sole()->after)->toBe(['recipients' => 1]); + + $finance = User::factory()->create(); + EditionMember::factory()->for($this->edition)->create(['user_id' => $finance->id, 'role' => EditionRole::Finance]); + Sanctum::actingAs($finance); + $this->getJson("{$this->admin}/data-reminder")->assertForbidden(); + $this->postJson("{$this->admin}/data-reminder", ['confirm' => true, 'recipients' => 1])->assertForbidden(); +}); + +it('exporta os crachás dos ingressos válidos, sem e-mail nem acessibilidade e sem virar fórmula', function (): void { + Sanctum::actingAs($this->organizer); + $ana = ticketOf($this->edition->id, 'ana@exemplo.com'); + $this->patchJson("{$this->admin}/{$ana->id}", ['badge_name' => '=Aninha', 'company' => 'PHP-PB', 'tshirt_size' => 'BL-M', 'accessibility' => 'Rampa'])->assertOk(); + + $csv = $this->get("{$this->admin}/badges")->assertOk()->assertHeader('Content-Type', 'text/csv; charset=UTF-8')->streamedContent(); + + expect($csv)->toStartWith("\u{FEFF}Código;\"Nome no crachá\";\"Nome completo\";Empresa;Ingresso;Camiseta") + ->toContain("{$ana->code};'=Aninha;\"Ana Souza\";PHP-PB;Geral;BL-M") + ->toContain(';"Bia Lima";"Bia Lima";;Geral;') + ->not->toContain('exemplo.com') + ->not->toContain('Rampa'); +}); diff --git a/docs/arquitetura/PHPeste_Arquitetura.pdf b/docs/arquitetura/PHPeste_Arquitetura.pdf index 6d4ac4e..f8345e9 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 6870ca0..b61e43a 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 · A16 (tela de pagamentos) · página 1
+
Fonte: código da main, backend/CLAUDE.md, docs/produto.md e ADRs 0001–0009.20/11/2026 · A17 (tela de participantes) · 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 · A16 (tela de pagamentos) · página 2
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · 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 · A16 (tela de pagamentos) · página 3
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · 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 · A16 (tela de pagamentos) · página 4
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · 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 · A16 (tela de pagamentos) · página 5
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 5
@@ -460,8 +460,8 @@

Os 15 módulos do backend

Ticketing tipos, lotes, cupons, pedidos, estoque atômico, -ingressos com QR, transferência, importação, -conciliação +ingressos com QR, participantes, transferência, +importação, conciliação 50 rotas @@ -523,7 +523,7 @@

Os 15 módulos do backend

casca -
PHPeste Platform · Arquitetura19/11/2026 · A16 (tela de pagamentos) · página 6
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 6
@@ -561,7 +561,7 @@

Como os módulos conversam

Ticketing → PaymentProcessor, PaymentLedger -→ PaymentAccounts (Payments), AuditTrail +→ PaymentAccounts (Payments), AuditTrail, EditionMailer AccountUsage, TicketVerifier, TicketRevenue ← Payments, CheckIn, Finance @@ -588,9 +588,9 @@

Como os módulos conversam

pelo listener genérico RecordAuditableEvent AuditTrail: histórico de um registro EditionMailer::send(...): todo e-mail, -com o tema da edição +com o tema; ::preview mostra sem enviar
  • 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 · A16 (tela de pagamentos) · página 7
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 7
@@ -692,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 · A16 (tela de pagamentos) · página 8
+
PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 8
@@ -713,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 · A16 (tela de pagamentos) · página 9
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 9
    @@ -787,7 +787,7 @@

    Ingresso: da compra ao QR

    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. 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 · A16 (tela de pagamentos) · página 10
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 10
    @@ -863,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 · A16 (tela de pagamentos) · página 11
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 11
    @@ -916,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 · A16 (tela de pagamentos) · página 12
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 12
    @@ -934,19 +934,19 @@

    Fila (Redis + Horizon)

    E-mail (Notifications)

      -
    • Todo e-mail sai por EditionMailer::send: registra em email_deliveries e enfileira com 5 tentativas.
    • +
    • Todo e-mail sai por EditionMailer::send: registra em email_deliveries e enfileira com 5 tentativas. EditionMailer::preview devolve o e-mail pronto, com o tema e o texto da edição, sem enviar (prévia da cobrança de dados dos participantes).
    • Modelo editável por edição, variáveis {nome} sem Blade, HTML escapado, layout com o tema publicado.
    • Não transacional leva descadastro com link assinado e List-Unsubscribe.
    • Webhook do Resend (assinatura Svix): entregue, bounce e spam. Bounce permanente ou spam bloqueia o endereço na edição, até para transacional, até a organização liberar.

    Auditoria

      -
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 23 eventos hoje.
    • +
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 25 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 · A16 (tela de pagamentos) · página 13
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 13
    @@ -956,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 · A16 (tela de pagamentos) · página 14
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 14
    @@ -1031,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 · A16 (tela de pagamentos) · página 15
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 15
    @@ -1044,7 +1044,7 @@

    Telas: o design do painel

    Tokens do tema Sertão
    Design: tokens do tema Sertão
    -
    PHPeste Platform · Arquitetura19/11/2026 · A16 (tela de pagamentos) · página 16
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 16
    @@ -1058,7 +1058,7 @@

    Telas: o painel em uso

    Login
    Entrar com e-mail e senha ou GitHub
    -
    PHPeste Platform · Arquitetura19/11/2026 · A16 (tela de pagamentos) · página 17
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 17
    @@ -1066,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.
    Pedidos: números da edição no topo (pagos, aguardando, reembolsos, taxa do gateway), 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.
    Pagamentos (só a organização): gateway da comunidade com chave mascarada, etapas para abrir vendas e Testar conexão, prévia do recebedor no checkout, métodos aceitos, webhook com o último evento e os últimos eventos do gateway com reprocessar.
    +
    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: números da edição no topo (pagos, aguardando, reembolsos, taxa do gateway), 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.
    Pagamentos (só a organização): gateway da comunidade com chave mascarada, etapas para abrir vendas e Testar conexão, prévia do recebedor no checkout, métodos aceitos, webhook com o último evento e os últimos eventos do gateway com reprocessar.
    Participantes (só a organização): uma linha por ingresso com crachá, acessibilidade (só a organização vê) e camiseta, filtros de dados faltando e transferidos, edição registrada na auditoria, cobrança de dados com prévia do e-mail e CSV dos crachás.
    -
    PHPeste Platform · Arquitetura19/11/2026 · A16 (tela de pagamentos) · página 18
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 18
    @@ -1076,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), A15 (pedidos e reembolso), A16 (pagamentos e gateway); faltam A17–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), A16 (pagamentos e gateway), A17 (participantes); faltam A18–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 · A16 (tela de pagamentos) · página 19
    +
    PHPeste Platform · Arquitetura20/11/2026 · A17 (tela de participantes) · página 19
    diff --git a/docs/arquitetura/fonte/gerar.py b/docs/arquitetura/fonte/gerar.py index 743bcbc..35de8a7 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 · A16 (tela de pagamentos)" +RETRATO = "20/11/2026 · A17 (tela de participantes)" # ---------------------------------------------------------------- estilo --- # Cores do tema Sertão (front-admin) para o que é da plataforma, e neutras @@ -281,7 +281,7 @@ def legend(): ("Community", "comunidades, edições, estados, equipe, convites, tenancy, Visão geral, clonagem", 26, "backend"), ("Branding", "tema por edição (rascunho/publicado), presets, contraste AA, logos, domínios e TLS", 17, "backend"), ("Cfp", "chamada, trilhas, critérios, propostas, avaliação cega, decisão, cota do Nordeste, confirmação", 52, "backend"), - ("Ticketing", "tipos, lotes, cupons, pedidos, estoque atômico, ingressos com QR, transferência, importação, conciliação", 50, "backend"), + ("Ticketing", "tipos, lotes, cupons, pedidos, estoque atômico, ingressos com QR, participantes, transferência, importação, conciliação", 50, "backend"), ("Payments", "contas de gateway por edição, drivers Asaas e Mercado Pago, cobranças, webhooks, reembolsos", 8, "backend"), ("Notifications", "e-mail transacional por edição com modelos editáveis, descadastro, Resend com bounce e spam", 12, "backend"), ("Audit", "trilha append-only das ações sensíveis, com redação de segredos", 1, "backend"), @@ -320,11 +320,11 @@ 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), AuditTrail", "AccountUsage, TicketVerifier,", "TicketRevenue ← Payments, CheckIn, Finance"]), + (390, 240, "Ticketing", ["→ PaymentProcessor, PaymentLedger", "→ PaymentAccounts (Payments), AuditTrail, EditionMailer", "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", "AuditTrail: histórico de um registro", "EditionMailer::send(...): todo e-mail,", "com o 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; ::preview mostra sem enviar"]), ] for x, y, title, lines in pairs: b.append(box(x, y, 340, 130, title, lines, "backend", size=9.8)) @@ -490,14 +490,14 @@ def legend():

    E-mail (Notifications)

      -
    • Todo e-mail sai por EditionMailer::send: registra em email_deliveries e enfileira com 5 tentativas.
    • +
    • Todo e-mail sai por EditionMailer::send: registra em email_deliveries e enfileira com 5 tentativas. EditionMailer::preview devolve o e-mail pronto, com o tema e o texto da edição, sem enviar (prévia da cobrança de dados dos participantes).
    • Modelo editável por edição, variáveis {nome} sem Blade, HTML escapado, layout com o tema publicado.
    • Não transacional leva descadastro com link assinado e List-Unsubscribe.
    • Webhook do Resend (assinatura Svix): entregue, bounce e spam. Bounce permanente ou spam bloqueia o endereço na edição, até para transacional, até a organização liberar.

    Auditoria

      -
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 23 eventos hoje.
    • +
    • Evento que implementa Auditable vira linha em audit_logs pelo listener genérico. 25 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.
    """ @@ -564,6 +564,7 @@ def legend(): ("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: números da edição no topo (pagos, aguardando, reembolsos, taxa do gateway), 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."), ("painel-pagamentos.png", "Pagamentos (só a organização): gateway da comunidade com chave mascarada, etapas para abrir vendas e Testar conexão, prévia do recebedor no checkout, métodos aceitos, webhook com o último evento e os últimos eventos do gateway com reprocessar."), + ("painel-participantes.png", "Participantes (só a organização): uma linha por ingresso com crachá, acessibilidade (só a organização vê) e camiseta, filtros de dados faltando e transferidos, edição registrada na auditoria, cobrança de dados com prévia do e-mail e CSV dos crachás."), ] 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.", @@ -573,7 +574,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), A15 (pedidos e reembolso), A16 (pagamentos e gateway); faltam A17–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), A16 (pagamentos e gateway), A17 (participantes); faltam A18–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-participantes.png b/docs/arquitetura/telas/painel-participantes.png new file mode 100644 index 0000000..313acf2 Binary files /dev/null and b/docs/arquitetura/telas/painel-participantes.png differ diff --git a/front-admin/CLAUDE.md b/front-admin/CLAUDE.md index 8b2fbfc..307e486 100644 --- a/front-admin/CLAUDE.md +++ b/front-admin/CLAUDE.md @@ -53,6 +53,7 @@ app/ 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 + participantes/index.vue # módulo attendees (só organização): uma linha por ingresso, filtros de dados faltando, acessibilidade e transferidos, detalhe com edição registrada, cobrança de dados com prévia do e-mail, CSV dos crachás pagamentos/index.vue # módulo payments (só organização): conectar/trocar gateway, testar conexão, webhook e último evento, prévia do recebedor, eventos com reprocessar 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 diff --git a/front-admin/app/application/locales/pt-br/index.ts b/front-admin/app/application/locales/pt-br/index.ts index a91205c..5dc91dd 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 attendees from '../../../modules/attendees/locales/pt-br' import orders from '../../../modules/orders/locales/pt-br' import payments from '../../../modules/payments/locales/pt-br' import cfpReview from '../../../modules/cfpReview/locales/pt-br' @@ -32,6 +33,7 @@ export default { team, cfpSettings, tickets, + attendees, orders, payments, cfpReview, diff --git a/front-admin/app/infrastructure/http/api-types.d.ts b/front-admin/app/infrastructure/http/api-types.d.ts index 1c33704..67c5649 100644 --- a/front-admin/app/infrastructure/http/api-types.d.ts +++ b/front-admin/app/infrastructure/http/api-types.d.ts @@ -2962,6 +2962,12 @@ export interface paths { path?: never; cookie?: never; }; + /** + * Uma linha por ingresso. Filtros: `status`, `tshirt_size`, + * `ticket_type_id`, `q` (nome, crachá, e-mail ou código), `missing` + * (sem crachá ou camiseta), `transferred` e `accessibility` (só a + * organização). `meta.summary` traz os números da edição inteira + */ get: operations["ticketing.tickets.index"]; put?: never; post?: never; @@ -2971,6 +2977,41 @@ export interface paths { patch?: never; trace?: never; }; + "/v1/editions/{edition}/ticketing/tickets/badges": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** CSV dos ingressos válidos para imprimir os crachás */ + get: operations["ticketing.tickets.badges"]; + put?: never; + post?: never; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; + "/v1/editions/{edition}/ticketing/tickets/data-reminder": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** Quantas pessoas vão receber a cobrança de dados e o e-mail como sai */ + get: operations["ticketing.tickets.data-reminder.preview"]; + put?: never; + /** Manda a cobrança. `recipients` precisa bater com o número da prévia */ + post: operations["ticketing.tickets.data-reminder"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; "/v1/editions/{edition}/ticketing/tickets/{ticket}": { parameters: { query?: never; @@ -3625,7 +3666,7 @@ export interface components { EmailDeliveryResource: { id: string; /** @enum {string} */ - template: "order_confirmed" | "pix_reminder" | "order_refunded" | "ticket_transferred" | "cfp_accepted" | "cfp_waitlisted" | "event_reminder" | "team_invite" | "proposal_received" | "speaker_confirmation_reminder" | "speaker_invited" | "task_assigned" | "task_due_soon"; + template: "order_confirmed" | "pix_reminder" | "order_refunded" | "ticket_transferred" | "cfp_accepted" | "cfp_waitlisted" | "event_reminder" | "team_invite" | "proposal_received" | "speaker_confirmation_reminder" | "speaker_invited" | "task_assigned" | "task_due_soon" | "attendee_data_reminder"; to_email: string; to_name: string; /** @enum {string} */ @@ -3651,15 +3692,15 @@ export interface components { * EmailTemplate * @enum {string} */ - EmailTemplate: "order_confirmed" | "pix_reminder" | "order_refunded" | "ticket_transferred" | "cfp_accepted" | "cfp_waitlisted" | "event_reminder" | "team_invite" | "proposal_received" | "speaker_confirmation_reminder" | "speaker_invited" | "task_assigned" | "task_due_soon"; + EmailTemplate: "order_confirmed" | "pix_reminder" | "order_refunded" | "ticket_transferred" | "cfp_accepted" | "cfp_waitlisted" | "event_reminder" | "team_invite" | "proposal_received" | "speaker_confirmation_reminder" | "speaker_invited" | "task_assigned" | "task_due_soon" | "attendee_data_reminder"; /** EmailTemplateResource */ EmailTemplateResource: { /** @enum {string} */ - id: "order_confirmed" | "pix_reminder" | "order_refunded" | "ticket_transferred" | "cfp_accepted" | "cfp_waitlisted" | "event_reminder" | "team_invite" | "proposal_received" | "speaker_confirmation_reminder" | "speaker_invited" | "task_assigned" | "task_due_soon"; + id: "order_confirmed" | "pix_reminder" | "order_refunded" | "ticket_transferred" | "cfp_accepted" | "cfp_waitlisted" | "event_reminder" | "team_invite" | "proposal_received" | "speaker_confirmation_reminder" | "speaker_invited" | "task_assigned" | "task_due_soon" | "attendee_data_reminder"; /** @enum {string} */ - label: "Confirmação de compra" | "Lembrete de pagamento" | "Reembolso do pedido" | "Ingresso transferido" | "Resultado do CFP: aprovada" | "Resultado do CFP: lista de espera" | "Antes do evento" | "Convite para a equipe" | "Proposta recebida" | "Lembrete de confirmação do palestrante" | "Convite para palestrar" | "Tarefa atribuída" | "Prazo de tarefa chegando"; + label: "Confirmação de compra" | "Lembrete de pagamento" | "Reembolso do pedido" | "Ingresso transferido" | "Resultado do CFP: aprovada" | "Resultado do CFP: lista de espera" | "Antes do evento" | "Convite para a equipe" | "Proposta recebida" | "Lembrete de confirmação do palestrante" | "Convite para palestrar" | "Tarefa atribuída" | "Prazo de tarefa chegando" | "Dados do crachá faltando"; /** @enum {string} */ - trigger: "Ao pagar o pedido" | "Quando a organização reenvia a cobrança" | "Ao reembolsar o pedido" | "Ao receber um ingresso transferido" | "Manual" | "7 dias antes" | "Ao convidar alguém para a equipe" | "Ao enviar uma proposta" | "2 dias antes do prazo de confirmação" | "Ao convidar alguém direto para palestrar" | "Ao virar responsável por uma tarefa" | "1 dia antes do prazo da tarefa"; + trigger: "Ao pagar o pedido" | "Quando a organização reenvia a cobrança" | "Ao reembolsar o pedido" | "Ao receber um ingresso transferido" | "Manual" | "7 dias antes" | "Ao convidar alguém para a equipe" | "Ao enviar uma proposta" | "2 dias antes do prazo de confirmação" | "Ao convidar alguém direto para palestrar" | "Ao virar responsável por uma tarefa" | "1 dia antes do prazo da tarefa" | "Quando a organização cobra os dados faltando"; transactional: boolean; variables: [ "nome", @@ -3709,7 +3750,7 @@ export interface components { "prazo" ]; /** @enum {string} */ - action_label: "Ver meu ingresso" | "Pagar o pedido" | "Ver meu pedido" | "Confirmar participação" | "Ver minha proposta" | "Ver programação" | "Aceitar convite" | "Ver tarefa"; + action_label: "Ver meu ingresso" | "Pagar o pedido" | "Ver meu pedido" | "Confirmar participação" | "Ver minha proposta" | "Ver programação" | "Aceitar convite" | "Ver tarefa" | "Completar meus dados"; subject: string; body: string; customized: boolean; @@ -4151,6 +4192,11 @@ export interface components { password: string; password_confirmation: string; }; + /** RemindAttendeeDataRequest */ + RemindAttendeeDataRequest: { + confirm: boolean; + recipients: number; + }; /** RemindSpeakersRequest */ RemindSpeakersRequest: { /** Format: uuid */ @@ -4685,6 +4731,8 @@ export interface components { } & { [key: string]: unknown; }) | unknown; + missing: string | unknown; + transferred_from: unknown; issued_at: (string | null) | unknown; cancelled_at: (string | null) | unknown; last_sent_at: (string | null) | unknown; @@ -13162,6 +13210,8 @@ export interface operations { parameters: { query?: { ticket_type_id?: string; + missing?: boolean; + transferred?: boolean; }; header?: never; path: { @@ -13203,12 +13253,107 @@ export interface operations { to: number | null; /** @description Total number of items being paginated. */ total: number; + summary: { + participants: number; + complete: number; + missing: number; + accessibility: number | null; + transferred: number; + }; + }; + }; + }; + }; + 401: components["responses"]["AuthenticationException"]; + 403: components["responses"]["AuthorizationException"]; + }; + }; + "ticketing.tickets.badges": { + parameters: { + query?: never; + header?: never; + path: { + edition: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + 200: { + headers: { + "Transfer-Encoding": "chunked"; + [name: string]: unknown; + }; + content: { + "text/csv; charset=UTF-8": string; + }; + }; + 401: components["responses"]["AuthenticationException"]; + 403: components["responses"]["AuthorizationException"]; + }; + }; + "ticketing.tickets.data-reminder.preview": { + parameters: { + query?: never; + header?: never; + path: { + edition: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + 200: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: { + recipients: number; + email: { + subject: string; + html: string; + text: string; + } | null; + }; + }; + }; + }; + 401: components["responses"]["AuthenticationException"]; + 403: components["responses"]["AuthorizationException"]; + }; + }; + "ticketing.tickets.data-reminder": { + parameters: { + query?: never; + header?: never; + path: { + edition: string; + }; + cookie?: never; + }; + requestBody: { + content: { + "application/json": components["schemas"]["RemindAttendeeDataRequest"]; + }; + }; + responses: { + 202: { + headers: { + [name: string]: unknown; + }; + content: { + "application/json": { + data: { + recipients: number; }; }; }; }; 401: components["responses"]["AuthenticationException"]; 403: components["responses"]["AuthorizationException"]; + 422: components["responses"]["ValidationException"]; }; }; "ticketing.tickets.show": { diff --git a/front-admin/app/modules/attendees/components/AttendeeDrawer.vue b/front-admin/app/modules/attendees/components/AttendeeDrawer.vue new file mode 100644 index 0000000..c776108 --- /dev/null +++ b/front-admin/app/modules/attendees/components/AttendeeDrawer.vue @@ -0,0 +1,132 @@ + + + diff --git a/front-admin/app/modules/attendees/components/AttendeesComponents.test.ts b/front-admin/app/modules/attendees/components/AttendeesComponents.test.ts new file mode 100644 index 0000000..f9de535 --- /dev/null +++ b/front-admin/app/modules/attendees/components/AttendeesComponents.test.ts @@ -0,0 +1,76 @@ +import { mountSuspended } from '@nuxt/test-utils/runtime' +import { describe, expect, it, vi } from 'vitest' +import AttendeeDrawer from './AttendeeDrawer.vue' +import ReminderModal from './ReminderModal.vue' +import type { AttendeeDetail } from '../types' + +const detail: AttendeeDetail = { + attendee: { + id: 't-1', code: 'K7QM-4XTD', active: true, statusLabel: 'Válido', orderNumber: 42, ticketTypeName: 'Geral', name: 'Carla Dias', email: 'carla@exemplo.com', + badgeName: 'Carla', company: null, tshirtSize: 'M', accessibility: 'Intérprete de Libras', missing: [], transferredFrom: null, lastSentAt: null, + }, + transfers: [], + edits: [{ id: 'e-1', changes: [{ field: 'badge_name', label: 'Nome no crachá', from: null, to: 'Carla' }, { field: 'accessibility', label: 'Acessibilidade', from: null, to: null }], actorName: 'Rita', at: '2027-06-10T12:00:00Z' }], +} +const flat = (text: string) => text.replace(/\s+/g, ' ') +const tick = () => new Promise((resolve) => setTimeout(resolve, 0)) + +describe('AttendeeDrawer', () => { + it('mostra a acessibilidade como dado só da organização e salva o formulário', async () => { + const save = vi.fn().mockResolvedValue({ ok: true }) + const wrapper = await mountSuspended(AttendeeDrawer, { props: { modelValue: true, detail, state: 'ready', disabled: false, canSeePrivate: true, save, resend: vi.fn() } }) + + expect(flat(wrapper.find('[data-testid="attendee-private"]').text())).toContain('Visível só para a organização') + expect(flat(wrapper.find('[data-testid="attendee-edits"]').text())).toContain('Nome no crachá: vazio → Carla') + expect(flat(wrapper.find('[data-testid="attendee-edits"]').text())).toContain('Acessibilidade alterada') + expect(flat(wrapper.find('[data-testid="attendee-edits"]').text())).not.toContain('Libras') + + await wrapper.find('#attendee-badge').setValue('Carlinha') + await wrapper.find('#attendee-form').trigger('submit') + expect(save).toHaveBeenCalledWith({ name: 'Carla Dias', badgeName: 'Carlinha', company: '', tshirtSize: 'M', accessibility: 'Intérprete de Libras' }) + }) + + it('sem permissão, não mostra acessibilidade nem deixa editar', async () => { + const wrapper = await mountSuspended(AttendeeDrawer, { props: { modelValue: true, detail, state: 'ready', disabled: true, canSeePrivate: false, save: vi.fn(), resend: vi.fn() } }) + + expect(wrapper.find('[data-testid="attendee-private"]').exists()).toBe(false) + expect(wrapper.find('#attendee-badge').attributes('disabled')).toBeDefined() + expect(wrapper.text()).not.toContain('Salvar dados') + }) + + it('erro de validação aparece no campo', async () => { + const save = vi.fn().mockResolvedValue({ ok: false, message: 'Use até 60 caracteres.', fieldErrors: { badgeName: 'Use até 60 caracteres.' } }) + const wrapper = await mountSuspended(AttendeeDrawer, { props: { modelValue: true, detail, state: 'ready', disabled: false, canSeePrivate: true, save, resend: vi.fn() } }) + + await wrapper.find('#attendee-form').trigger('submit') + await tick() + expect(wrapper.find('#attendee-badge').attributes('aria-invalid')).toBe('true') + }) +}) + +describe('ReminderModal', () => { + it('mostra quantas pessoas recebem e a prévia, e manda o número confirmado', async () => { + const preview = vi.fn().mockResolvedValue({ recipients: 3, subject: 'Complete seus dados para o crachá do PHPeste 2027', html: '

    Oi

    ' }) + const remind = vi.fn().mockResolvedValue({ ok: true }) + const wrapper = await mountSuspended(ReminderModal, { props: { modelValue: false, preview, remind } }) + await wrapper.setProps({ modelValue: true }) + await tick() + + const box = wrapper.find('[data-testid="reminder-preview"]') + expect(flat(box.text())).toContain('3 pessoas com ingresso válido') + expect(flat(box.text())).toContain('Assunto: Complete seus dados para o crachá do PHPeste 2027') + expect(box.find('iframe').attributes('sandbox')).toBe('') + + await wrapper.findAll('button').find((b) => b.text().includes('Enviar para 3 pessoas'))!.trigger('click') + expect(remind).toHaveBeenCalledWith(3) + }) + + it('sem ninguém com dados faltando, não oferece envio', async () => { + const wrapper = await mountSuspended(ReminderModal, { props: { modelValue: false, preview: vi.fn().mockResolvedValue({ recipients: 0, subject: null, html: null }), remind: vi.fn() } }) + await wrapper.setProps({ modelValue: true }) + await tick() + + expect(wrapper.text()).toContain('Todo mundo já completou os dados.') + expect(wrapper.text()).not.toContain('Enviar para') + }) +}) diff --git a/front-admin/app/modules/attendees/components/AttendeesPanel.vue b/front-admin/app/modules/attendees/components/AttendeesPanel.vue new file mode 100644 index 0000000..36ec5e5 --- /dev/null +++ b/front-admin/app/modules/attendees/components/AttendeesPanel.vue @@ -0,0 +1,179 @@ + + + diff --git a/front-admin/app/modules/attendees/components/ReminderModal.vue b/front-admin/app/modules/attendees/components/ReminderModal.vue new file mode 100644 index 0000000..de7ffae --- /dev/null +++ b/front-admin/app/modules/attendees/components/ReminderModal.vue @@ -0,0 +1,65 @@ + + +