O que é esta tela

Mostra a ordem de apresentações por participante, com horário calculado por slot, sala e categoria. Você pode filtrar por evento, categorias, período, intervalo entre apresentações e agrupamento, e baixar o mesmo resultado em PDF ou Excel.

Como usar

1. Abra Relatórios → Cronograma Detalhado.
2. Escolha um evento (obrigatório). Organizadores veem somente seus próprios eventos.
3. Se quiser, selecione categorias (somente ativas de competição), informe período (De/Até), ajuste o intervalo (0–120 min), marque rascunho para incluir pendentes e escolha o agrupamento (Categoria, Sala ou Sem agrupamento).
4. Clique em Gerar e confira a lista em ordem de horário. Cada linha traz número, participante (Inscrição #ID — Nome artístico), categoria, música (OK quando houver música_url) e entrada em cena (vazia para preenchimento manual).
5. Use PDF para imprimir ou Excel para trabalhar com a planilha.

Campos e regras

Campo	Como funciona
Evento	Obrigatório.
Categorias	Opcional. Múltipla. Somente categorias ativas de competição (competicao_*). Inativas são ignoradas.
De / Até	Filtra pelo horário calculado da apresentação, inclusive as duas datas.
Intervalo (gap)	0 a 120 minutos. Somado antes de cada apresentação e após a última do slot.
Rascunho	Quando marcado, inclui inscrições pendente além de pago/checkin; serviços (id_servico) nunca entram.
Agrupamento	Categoria (padrão), Sala ou Sem agrupamento. Categorias ordenadas pelo menor horário; quando há vários slots na mesma categoria, a descrição do slot diferencia as sessões (Categoria — Descrição).

Regras de cálculo

• Categoria com inscrições elegíveis precisa ter ao menos um slot com data_inicio; caso contrário, o relatório bloqueia e lista as categorias pendentes (HTTP 422).
• Distribuição ceil(total/slots) por slot, em ordem data_criacao ASC, id ASC; duração padrão 3 min quando tempo_apresentacao for nulo ou inválido (apresentacao TIME é ignorado).
• Durações antigas gravadas incorretamente como 180 minutos para uma apresentação de 3 minutos são corrigidas durante a migração dos dados.
• Se o cálculo ultrapassar data_fim do slot, o relatório bloqueia e informa categoria, slot e excesso em minutos (422).
• Limite de 2.000 apresentações aplicado após o filtro de período; acima disso, refine os filtros (422) — nenhum arquivo parcial é gerado.

Dicas

• A coluna Entrada em cena fica vazia para preenchimento manual.
• Se a lista parecer vazia, verifique rascunho, período e se os slots estão cadastrados com data de início.