Dias Letivos

A plataforma Lumen ERP une automaticamente o Quadro de Horários da turma com o Calendário Letivo do ano para gerar, aula por aula, o que de fato deve acontecer em cada dia. Essa lista de aulas concretas é o ponto de partida para todo o fluxo de frequência — professores não precisam informar disciplina ou turno, pois o sistema já sabe o que está previsto para aquele dia.

Conceitos envolvidos

Quadro de Horários

Define os horários recorrentes da turma ao longo da semana: em qual dia, em qual ordem, em que horário, qual disciplina e qual professor. É o "roteiro semanal" que se repete durante o ano letivo.

Calendário Letivo

Lista as datas reais do ano escolar, classificando cada uma como dia letivo, feriado ou evento especial. Define quando o roteiro semanal realmente acontece — e quando não acontece.

Aula do Dia

Quando o dia da semana de uma data letiva coincide com um horário do Quadro, a plataforma gera automaticamente uma aula concreta para aquela data. Essa aula já carrega data, horário, disciplina e professor — e é a unidade usada para registrar a chamada.

Frequência

Cada registro de chamada é vinculado a uma aula concreta específica. Isso garante que frequências estejam sempre associadas ao contexto exato em que foram lançadas — data, horário, disciplina e professor —, sem ambiguidade.

Como as aulas são geradas

Sempre que o Quadro de Horários ou o Calendário Letivo são criados ou atualizados, a plataforma recalcula automaticamente a lista de aulas concretas do ano. O resultado alimenta a tela de frequência, os registros de chamada e o fluxo de autorizações administrativas.

Fonte A

Quadro de Horários

Dias da semana, horários, disciplinas e professores recorrentes

Fonte B

Calendário Letivo

Datas reais do ano: dias letivos, feriados e eventos

Plataforma

Geração automática de aulas

Cruza os horários recorrentes com as datas letivas reais do calendário

Resultado

Aulas concretas do ano letivo

Uma entrada por aula, com data, horário, disciplina e professor já definidos

UI

Lançar Frequência

Calendário → Dia → Aulas → Matriz de alunos

Registros

Frequências

Cada chamada vinculada à aula exata em que foi lançada

Aprovações

Autorizações

Lançamentos retroativos passam por aprovação administrativa

Comportamentos importantes

1

Atualização automática

Qualquer alteração no Quadro de Horários ou no Calendário Letivo aciona imediatamente a regeneração das aulas afetadas. O professor sempre vê o calendário atualizado ao abrir a tela de frequência.

2

Sem duplicidades

Cada aula é gerada uma única vez, independentemente de quantas vezes o Quadro ou o Calendário sejam salvos. Recalcular não cria registros duplicados.

3

Histórico preservado

Se um horário for removido do Quadro ou uma data for retirada do Calendário depois que frequências já foram lançadas naquela aula, a aula é marcada como cancelada — mas os registros de chamada não são apagados. Aulas que nunca receberam nenhum lançamento são simplesmente removidas.

4

Compatibilidade com registros anteriores

Frequências lançadas antes da implantação desta funcionalidade são associadas automaticamente à aula correspondente sempre que a combinação de turma, disciplina e data identificar uma aula de forma inequívoca.

Fluxo do professor (Lançar Frequência)

A tela de frequência é orientada por aulas, não por disciplinas. O professor navega pelo calendário da turma, seleciona um dia, escolhe a aula e lança a chamada — sem precisar informar nenhum contexto adicional.

  1. 1

    Calendário da turma

    O professor vê todos os dias do ano letivo. Cada dia recebe uma cor indicando o status agregado das aulas previstas: amarelo (hoje ou futuro), verde (todas as aulas registradas), âmbar (lançamento parcial), vermelho (dia passado sem registro), azul (aguardando aprovação), cinza (aprovação negada), laranja (feriado ou evento).

  2. 2

    Seleção do dia

    Ao clicar em um dia, a plataforma retorna as aulas que estão previstas naquela data — com horário, disciplina, professor e o status individual de cada uma.

  3. 3

    Seleção da aula

    O professor escolhe a aula desejada e vê a matriz de alunos da turma junto com as configurações de lançamento disponíveis para aquela aula.

  4. 4

    Lançamento da chamada

    O professor preenche presença, desempenho e observações de cada aluno e confirma o envio. A frequência é gravada vinculada à aula selecionada.

  5. 5

    Datas retroativas

    Caso a data da aula seja anterior ao dia atual, o lançamento não é gravado imediatamente — ele abre uma solicitação de autorização para um administrador aprovar. Após a aprovação, a frequência é registrada normalmente.

Na API de parceiros

Os mesmos conceitos estão disponíveis para integrações. Gravar o Quadro de Horários ou o Calendário Letivo pela API regenera as aulas do ano exatamente como na interface web.

Calendário Letivo GET / POST

/v1/partners/school/{cnpj}/school-year/{id}/calendar

Lê ou substitui as datas do ano (school_day, holiday, event). Salvar recalcula as aulas de todas as turmas do ano.

Grade de períodos GET / PUT

/v1/partners/school/{cnpj}/classroom/{classroom_id}/schedule

Define os períodos da semana da turma (dia, ordem, tipo e horário de início).

Quadro de Horários GET / PUT / DELETE

/v1/partners/school/{cnpj}/classroom/{classroom_id}/timetable

Atribui disciplina e professor a cada período. Salvar ou limpar recalcula as aulas da turma.

Geração automática do quadro GET / POST

/v1/partners/school/{cnpj}/classroom/{classroom_id}/timetable/preflight · /generate

O preflight aponta o que impede a geração; o generate devolve uma proposta de quadro sem gravar nada. Grave a proposta com o PUT do Quadro de Horários.

Calendário de frequência GET

/v1/partners/school/{cnpj}/classroom/{classroom_id}/attendance/calendar

Status agregado de cada dia da turma, o mesmo que colore o calendário do professor.

Aulas do dia GET

/v1/partners/school/{cnpj}/classroom/{classroom_id}/attendance/day

Aulas concretas de uma data, com o id de cada uma.

Chamada da aula GET / POST

/v1/partners/school/{cnpj}/classroom/{classroom_id}/attendance/lesson/{lesson_id}

Lê ou grava a frequência de uma aula concreta.

  • Gravar a chamada de uma aula de hoje responde "mode": "saved".
  • Para uma aula de data passada, a chamada não é gravada na hora: a resposta traz "mode": "authorization_requested" e o authorization_id da autorização administrativa criada. Um novo envio para a mesma aula substitui o pedido pendente.
  • Aulas futuras são recusadas com 422.
  • O Quadro de Horários (inclusive preflight e generate) e os endpoints de frequência fazem parte do plano Gestão Escolar (ERP): num cliente do plano simplificado respondem 403 com "code": "ERP_REQUIRED". O Calendário Letivo e a grade de períodos estão disponíveis em todos os planos.
  • Uma aula que deixa de existir no Quadro ou no Calendário depois de receber chamada fica com status canceled; consulte as aulas do dia antes de gravar.

Detalhes de cada endpoint em Calendário Letivo, Turmas e Frequências.