BK-241 - Hotfix da Central de Cancelamento para peças online

Objetivo

Corrigir a Central de Cancelamento de Sessão em admin/modulos/pecas/index.php para:

• listar no select Espetáculo apenas peças elegíveis da vitrine pública pecas.php;
• listar no select Sessão apenas sessões de hoje em diante, incluindo as de hoje;
• ajustar os textos padrão das mensagens de cancelamento sem reabrir a regressão de elegibilidade.

Escopo

• admin/modulos/pecas/session_cancel_console_helper.php
• admin/modulos/pecas/index.php
• docs/modules/pecas/KNOWN_TRAPS.md

Motivação

• o select Espetáculo da Central de Cancelamento havia voltado a listar todos os eventos, em vez de espelhar somente o catálogo público com venda online;
• o select Sessão estava trazendo sessões antigas, o que aumentava o risco operacional no console;
• a rodada também exigiu refinamento iterativo dos textos padrão enviados por WhatsApp;
• ficou explícita a necessidade de registrar traps locais do módulo e reforçar a disciplina de comparar arquivo atual + bkp_original + backup antigo útil por hunk antes de reaproveitar trecho antigo.

Direção do patch

• centralizar no helper do console a mesma elegibilidade pública de pecas.php;
• reutilizar essa elegibilidade tanto na listagem do select quanto na validação do event_id;
• filtrar as sessões por s.sec_data >= CURDATE() para manter apenas hoje em diante;
• deixar comentário preventivo no ponto do select em index.php;
• criar docs/modules/pecas/KNOWN_TRAPS.md com data de inclusão e registrar:
• regra do select da Central de Cancelamento;
• regra de sempre comparar os últimos bkp_original antes de copiar hunks úteis;
• regra de acrescentar novos traps sempre que uma alteração voltar a dar problema recorrente;
• ajustar os templates padrão das mensagens com placeholder de primeiro nome e a copy final aprovada na rodada.

Execução da rodada

• admin/modulos/pecas/session_cancel_console_helper.php
• criada a função session_cancel_console_public_catalog_where() para espelhar a elegibilidade pública de pecas.php;
• session_cancel_console_fetch_events() passou a listar apenas peças com venda online elegíveis no catálogo público;
• session_cancel_console_find_event() passou a rejeitar event_id fora dessa mesma elegibilidade;
• session_cancel_console_fetch_sessions() passou a retornar apenas sessões de hoje em diante;
• mensagens padrão passaram a aceitar personalização com {primeiro nome} no envio real;
• textos finais das mensagens 3/4 e não concluído foram refinados conforme aprovação humana durante a rodada.
• admin/modulos/pecas/index.php
• comentário explícito inserido ao lado do select Espetáculo avisando que a fonte deve espelhar pecas.php.
• docs/modules/pecas/KNOWN_TRAPS.md
• arquivo criado para memória técnica local do módulo com traps datados e regra de auditoria por hunk em backups.

Validações executadas

• php -l admin/modulos/pecas/session_cancel_console_helper.php
• php -l admin/modulos/pecas/index.php
• validação funcional incremental no admin, com feedback humano durante a rodada:
• correção da elegibilidade do select Espetáculo;
• correção do select Sessão para hoje em diante;
• revisão dos textos padrão das mensagens.

Estado atual

• hotfix aplicado no código vivo;
• memória local do módulo criada em docs/modules/pecas/KNOWN_TRAPS.md;
• fechamento documental concluído;
• pronto para commit seletivo dos arquivos do BK-241.

Próximo passo operacional

Executar commit seletivo apenas dos arquivos do BK-241, sem incluir mudanças paralelas já existentes no repositório.