Agendamento de professores

O agendamento de professores no TimelyChurch conecta professores, classes e lições em datas específicas. O sistema suporta designação de professor, fluxos de confirmação, seleção de lições, gestão de tarefas de preparação e tratamento de feriados.

Como funciona o agendamento

Agendas são criadas pelo módulo Eventos (Hub do Evento) e vinculam ao sistema de classes. Cada registro de agenda representa uma sessão de aula em uma data específica e inclui:

• Classe — Qual classe está sendo ministrada.
• Data — A data da sessão de aula.
• Professor — O professor designado.
• Lição — A lição a ser ministrada (opcional na criação, pode ser atribuída depois).
• Status — O estado atual da agenda.

Status das agendas

Designando professores às classes

Na criação da classe

Ao criar uma nova classe, você pode selecionar professores durante o processo de criação. Esses professores são designados como líderes da classe.

Pela página de detalhes da classe

1. Abra a classe na lista de Classes.
2. Use a seção de gestão de professores para adicionar ou alterar professores.
3. Professores designados à classe estão disponíveis como professores padrão ao criar agendas para essa classe.

Em agendas individuais

Professores também podem ser designados diretamente a entradas de agenda individuais, substituindo os professores padrão da classe. Útil para designações pontuais ou quando o professor regular está indisponível.

Fluxo de confirmação do professor

O TimelyChurch inclui um fluxo de confirmação integrado para garantir que professores estejam cientes e tenham aceito suas designações.

Como funciona

1. Admin cria uma agenda com professor designado.
2. Confirmação é solicitada — O sistema envia uma notificação ao professor pedindo confirmação.
3. Professor responde pelo portal:
   • Confirmar — O professor aceita a designação. O status da agenda atualiza para "Confirmada".
   • Recusar — O professor não pode ministrar. Informa um motivo e a agenda muda automaticamente para "Precisa de substituto".

Lembretes automatizados

O sistema envia lembretes automatizados para agendas não confirmadas:

• Lembrete de 4 dias — Enviado 4 dias antes da data agendada se o professor ainda não respondeu.
• Lembrete de 2 dias — Enviado 2 dias antes da data agendada se ainda não confirmado.

Cada lembrete é enviado apenas uma vez e é rastreado para evitar notificações duplicadas.

Confirmação por e-mail

Professores podem confirmar ou recusar diretamente pela notificação por e-mail usando um token de confirmação seguro e único. Isso permite responder sem precisar fazer login no portal.

Atribuição de lições

Professores e admins podem atribuir lições às agendas de várias formas:

Admin atribui uma lição

1. Ao criar ou editar uma agenda, selecione uma lição da biblioteca de lições.
2. Apenas lições aprovadas estão disponíveis para seleção.

Professor seleciona uma lição

Se a opção "Professor escolhe lição" estiver habilitada em uma agenda:

1. O professor recebe notificação de que precisa selecionar uma lição.
2. Ele navega pela biblioteca de lições pelo portal.
3. Seleciona uma lição e ela é atribuída à agenda.

Professor propõe uma lição

Se um professor quiser ministrar conteúdo que ainda não está na biblioteca:

1. Pelo portal, escolhe propor uma nova lição para sua agenda.
2. Preenche título, descrição e referência bíblica da lição.
3. A proposta é enviada com status "Pendente".
4. Um admin revisa a proposta e pode:
   • Aprovar — A lição é criada na biblioteca e atribuída à agenda. O professor é notificado.
   • Rejeitar — O professor é notificado com o motivo da rejeição e pode enviar uma proposta revisada.

Professor cria uma lição

Se "Permitir que professores criem lições" estiver habilitado em Configurações de lições:

1. Professores podem criar novas lições diretamente pelo portal.
2. Se aprovação for exigida, a lição começa como Rascunho.
3. Uma vez aprovada, fica disponível para agendamento.

Notificações de lição necessária

Quando uma agenda tem professor designado, mas nenhuma lição selecionada, o sistema notifica automaticamente o professor de que precisa escolher uma lição. Esta notificação é disparada quando:

• Uma nova agenda é criada com professor, mas sem lição.
• Um professor é recém-designado a uma agenda existente sem lição.
• Uma lição é removida de uma agenda existente.

Notificações não são enviadas para agendas passadas ou feriados.

Tarefas de preparação

Agendas podem ter tarefas de preparação associadas para ajudar professores a se preparar para a aula.

O que são tarefas de preparação

Tarefas de preparação são itens de afazer vinculados a uma agenda específica. Exemplos incluem:

• "Imprimir folhas de exercícios da lição"
• "Montar sala com materiais de artesanato"
• "Preparar lanche para 15 crianças"

Campos da tarefa de preparação

Cada tarefa inclui:

• Título — O que precisa ser feito.
• Descrição — Detalhes adicionais.
• Tipo de tarefa — O tipo de preparação necessária.
• Quantidade — Quantos de algo são necessários (se aplicável).
• Designado a — Quem é responsável por esta tarefa.
• Data de vencimento — Quando a tarefa deve ser concluída.
• Prioridade — Baixa, normal ou alta.
• Tempo estimado — Quantos minutos a tarefa deve levar.
• Status — Pendente, concluída ou ignorada.

Acompanhando tarefas de preparação

• A agenda mostra um percentual de conclusão de todas as tarefas de preparação.
• Tarefas atrasadas são sinalizadas automaticamente.
• Tarefas que precisam de atenção aparecem na fila Precisa de Atenção do admin.

Tratamento de feriados

Para marcar uma data como feriado (sem aula):

1. Crie uma entrada de agenda para a data.
2. Habilite a flag Feriado.
3. Opcionalmente informe o nome do feriado (por exemplo, "Domingo de Páscoa" ou "Recesso de Natal").

Agendas de feriado:

• Não exigem professor nem lição.
• Exibem o nome do feriado em vez de status.
• São excluídas de relatórios "precisa de atenção".
• Não disparam notificações de lição necessária.

Marcando uma sessão como ministrada

Após uma sessão de aula ser concluída:

1. Encontre a entrada de agenda.
2. Clique em Marcar como ministrada.
3. O status muda para "Concluída".
4. Clicar novamente alterna de volta para "Agendada" se marcado por engano.

Quando uma lição é marcada como ministrada, a contagem de ministrações da lição é incrementada e sua data "última ministração em" é atualizada.

Visibilidade da agenda e acesso a materiais

Visibilidade pública

Cada agenda pode controlar quais informações são visíveis ao público. O campo public_visibility no modelo Schedule aceita um de quatro valores, correspondendo às constantes definidas em App\Models\Schedule:

Substituições por campo (por exemplo, "mostrar título mas ocultar descrição para esta agenda") são armazenadas na coluna JSON visibility_overrides e mescladas com os padrões em toda a igreja quando a página pública é renderizada.

Acesso a materiais

Controle como anexos e materiais da lição são acessíveis. O campo materials_access_mode (com materials_pin opcional) em cada agenda mapeia para estas quatro constantes:

Quando Protegido por PIN é selecionado, o campo materials_pin da agenda é verificado primeiro. Se estiver vazio, o public_materials_pin em toda a igreja (definido em configurações de Compartilhamento público) é usado como fallback. PINs podem ser configurados em dois níveis: por agenda ou em toda a igreja.

Para instruções sobre habilitar e personalizar a página pública de lições (onde esta proteção por PIN entra em vigor), veja Compartilhamento público de lições.

Dicas para agendamento eficaz

• Agende com antecedência — Configure agendas várias semanas à frente para que professores tenham tempo de se preparar.
• Use o fluxo de confirmação — Habilite confirmações para sempre saber quais professores se comprometeram com suas designações.
• Aproveite tarefas de preparação — Adicione tarefas de preparação às agendas para que nada passe despercebido.
• Monitore itens em Precisa de Atenção — Agendas sem professor, sem lição ou que precisam de substituto são sinalizadas automaticamente.
• Marque feriados cedo — Adicione entradas de feriado à agenda para que professores planejem em torno dos intervalos.