CL-2026-04-09-BK-241 - Hotfix da Central de Cancelamento para peças online

Contexto

A Central de Cancelamento de Sessão do módulo de peças voltou a divergir da vitrine pública:

• o select Espetáculo estava listando todos os eventos ativos, em vez de apenas as peças com venda online que aparecem em pecas.php;
• o select Sessão ainda carregava sessões antigas;
• os textos padrão das mensagens precisavam de refinamento iterativo durante o uso real no admin.

Além do patch funcional, a rodada expôs um problema de retomada: a correção anterior não estava óbvia perto do código, o que levou à criação de uma memória técnica local do módulo.

O que mudou

admin/modulos/pecas/session_cancel_console_helper.php

• a elegibilidade pública foi centralizada em session_cancel_console_public_catalog_where();
• o select Espetáculo passou a espelhar a mesma regra comercial de pecas.php:
• status = 'A'
• (id_produtor IS NULL OR parceria_online = 1)
• exclusão de Teste
• temporada ainda válida
• exclusão do item legado id = 17
• a validação de event_id no backend passou a usar a mesma regra, impedindo selecionar item fora da vitrine por request manual;
• o select Sessão passou a listar apenas s.sec_data >= CURDATE(), incluindo as sessões de hoje;
• o envio passou a personalizar {primeiro nome} por destinatário na mensagem real;
• os textos padrão finais ficaram alinhados à copy aprovada durante a rodada.

admin/modulos/pecas/index.php

• foi deixado um comentário explícito no ponto do select Espetáculo avisando que a fonte precisa continuar espelhando pecas.php.

docs/modules/pecas/KNOWN_TRAPS.md

• arquivo novo criado para registrar armadilhas recorrentes do módulo perto do código;
• incluídas regras datadas para:
• não deixar o select da Central de Cancelamento divergir de pecas.php;
• sempre comparar arquivo atual + bkp_original mais novo + backup antigo útil antes de reaproveitar trecho antigo;
• acrescentar novos traps sempre que uma alteração voltar a dar problema recorrente.

Validação

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:
• filtro do select Espetáculo;
• filtro do select Sessão;
• revisão das mensagens padrão.

Resultado

Ao final do BK-241:

• a Central de Cancelamento voltou a operar apenas sobre o catálogo vendável de pecas.php;
• sessões antigas deixaram de aparecer no fluxo;
• os textos padrão do console foram ajustados no próprio helper;
• o módulo ganhou memória técnica local para reduzir regressão e melhorar retomada futura.