🚀 Começando Agora

• 1. Configuração Inicial: Defina primeiro o Período Letivo (PL1 a PL4) e o Turno. Só depois, selecione o Curso e a Turma no menu lateral.
• 2. Período Letivo: Selecione o Período Letivo oficial. O sistema preenche automaticamente as datas de Inicio e Fim do calendario daquele plano.
• 3. Identidade Visual: Clique na bolinha colorida para definir a cor de fundo da disciplina.
• 4. Professores: Se a disciplina for dividida, marque "Múltiplos?" e adicione os docentes com suas respectivas Cargas Horárias parciais.
• 5. Modelo de Oferta: Todas as componentes seguem o padrão por Faixas. Defina docentes, carga horária e período para cada oferta.
• 6. Data inicial da componente: Defina o inicio oficial pelo mini calendário da Faixa 1. A grade desenha horários, mas não deve empurrar essa data por conta própria.
• 7. Alocacao Manual (somente na Grade Semanal): Desenhe os slots clicando nos quadradinhos da grade. Se o regime mudar, ative a faixa 2 ou 3 e desenhe explicitamente o novo padrão.
• 8. Leitura da Grade Semanal: Slots bloqueados indicam ocupação real na semana visível. Navegue entre semanas ou ajuste início/faixa para visualizar e editar corretamente.
• 9. Turnos e sábado: Quando houver aula excepcional em outro turno, o sistema mostra avisos visuais em calendários, agendas e Gantt. Se necessário, mude o turno visível da grade para enxergar esses slots.
• 10. Importação em Bloco (PPC): Ao usar a opção de "Importar Componentes", é obrigatório ir na aba Lista de Ofertas e editar o horário/data de cada componente pendente para alocá-los na grade corretamente.
• 11. Mesclagem de Calendários: Você pode usar a ferramenta de Importação (JSON) para carregar o trabalho salvo de outro diretor de curso e checar se há choques.

🧩 1. Fluxo Canônico por Faixas

A operação da grade segue um fluxo único e previsível:

• Cada componente pode ter uma ou mais faixas, com datas e slots proprios.
• A data oficial da componente passa pela Faixa 1; o mini calendario da faixa e a referencia de edicao.
• Ao editar uma oferta, redesenhe os slots da faixa para manter a estrutura consistente.
• Conflitos e mudancas de turno devem ser resolvidos por ajuste explicito de data e horario.

💡 Dica: use a Lista de Ofertas como painel principal de revisao antes de publicar. As componentes aparecem em ordem alfabetica, com as faixas agrupadas em sequencia.

🧭 2. Regra Canônica de Conflito

A validação usa um critério único: só existe conflito quando coincidem período, dia e slot. Não há estado especial de componente no calendário atual.

📣 Em caso de choque, ajuste data e/ou horário da oferta para manter a grade coerente.

🔍 3. Auditoria Global de Conflitos de Professor

O sistema protege a agenda dos professores contra falhas humanas. Ao importar a grade de outro diretor, vá na aba Visão do Professor. Um alerta vermelho aparecerá automaticamente caso algum professor esteja alocado em dois lugares ao mesmo tempo.

⚠️ Quando uma aula ocorrer em turno diferente do turno nativo da turma, os calendarios e agendas mostram um aviso visual de turno.

📤 4. Exportação por Escopo

Ao clicar em Exportar, o sistema pergunta qual escopo você deseja:

• ✅ [OK] → Exporta somente as turmas do curso atual (ex: EP). Ideal para o diretor de cada curso.
• 🌐 [Cancelar] → Exporta todos os cursos do IECOS. Ideal para a coordenação geral.

📁 O nome do arquivo gerado reflete o escopo: backup_iecos_EP_PL1_2026-01-05_2026-03-06_2026-03-21_10-30.json.

📊 5. Gráfico de Gantt por Docente

O Gráfico de Gantt agora usa a mesma base canonica dos calendarios e exibe a carga de cada professor em ordem cronológica, com leitura por turno e detalhes de barra.

• Turma + Código + Abreviação: ex. EP2026 EP05003 LabInfo (30h)
• As linhas respeitam os turnos reais da execução, inclusive quando houver mudança excepcional de turno.
• Quando a disciplina é subdividida em sub-turmas, aparece o prefixo: [T01] ou [T02] antes do nome.
• Quando a disciplina é compartilhada entre docentes, a fatia do outro professor mostra o nome e CH dele.

🏷️ 6. Identificação Automática de Turmas por Bloco

A caixa de seleção de turmas exibe automaticamente o Bloco Curricular com base no Período Letivo selecionado:

• PL2 → Blocos Ímpares (BL1, BL3, BL5...)
• PL4 → Blocos Pares (BL2, BL4, BL6...)
• PL1 e PL3 → turma exibida sem bloco (períodos curtos)

📌 Exemplo: EP2026 no PL2 de 2026 aparece como EP2026_BL1. A turma EP2025 no mesmo período aparece como EP2025_BL3.

👥 7. Sub-turmas para Laboratórios

Quando uma disciplina (ex: laboratório) precisar ser ministrada em dois grupos separados:

1. Selecione a disciplina no formulário. O sistema detecta a duplicata e exibe um aviso de confirmação.
2. Confirme e preencha o campo "Identificador do Sub-grupo" com: BL1_T01 (grupo 1) ou BL1_T02 (grupo 2).
3. O rótulo final na grade será EP2026_BL1_T01 e EP2026_BL1_T02.

💡 Ao usar Importar Componentes em Bloco, o identificador BL1 já é atribuído automaticamente a todas as disciplinas importadas.