~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Lançar Frequência ======

Este caso de uso trata de registrar as frequências dos discentes de uma turma virtual. Nele, o docente cadastrará a frequência dia-a-dia, indicando a quantidade de faltas que cada discente teve.

Pré-condição: Para iniciar o caso de uso, é necessário haver matrículas na turma e esta não estar consolidada.

===== Descrição do Caso de Uso =====

Este caso de uso é iniciado pelo seguinte caminho: Sigaa -> Portal do Docente -> Turma Virtual -> Alunos -> Lançar Frequência

Ao iniciar o caso de uso ([[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:alunos:lancar_frequencia|RN01]]), serão exibidos calendários que indicam quais dias podem ter a frequência registrada. Estes dias são calculados de acordo com o horário da turma ([[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:alunos:lancar_frequencia|RN02]]). Ao clicar em um dia do calendário, será exibida uma listagem com todos os discentes da turma, onde o docente poderá informar quantas faltas cada um teve, em uma lista de seleção. O docente pode, também, clicar nos ícones respectivos para marcar presença ou falta para um ou todos os alunos.

Os dias em que o professor já lançou as frequências aparecem com fundo verde. Os feriados devem aparecer com fundo em vermelho, As aulas canceladas devem aparecer com fundo amarelo e não é possível cadastrar frequência nelas.

Após a seleção do dia ([[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:alunos:lancar_frequencia|RN03]]), são exibidos os nomes de todos os alunos matriculados e a opção para marcar quantas faltas cada um recebeu.
Também é exibida uma opção para cancelar a aula naquele dia, ao clicar na opção o sistema redireciona para o caso de uso de [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:menu_turma_virtual:diario_eletronico:conteudo_programado:criar_topico_de_aula|Criar Tópico de Aula]], onde é possível cancelar a aula.

Caso a turma possua chamada por biometria, será exibida na listagem a forma com que a chamada foi registrada, se pela turma virtual ou pelo leitor de digitais.

Alunos faltosos aparecem em vermelho.

Caso queira remover as frequências lançadas para um dia, o docente pode selecionar a opção "Remover Frequências", após escolher um dia do calendário.

O docente deve, então, escolher a opção "Salvar Frequências". Com isso, as frequências para o dia selecionado são salvas e o caso de uso é finalizado.

===== Principais Regras de Negócio =====

  * **RN01** - A turma deve conter alunos matriculados para ser possível lançar as frequências
  * **RN02** - Caso a turma não possua um horário definido, será permitido cadastrar frequência em todos os dias do calendário letivo.
  * **RN03** - Só é possível lançar a frequência dos alunos caso a turma não tenha sido consolidada.
  * **RN04**  - Caso for alterado o Horário da Turma, e já houver frequências registradas, todas as frequências realizadas no horário anterior serão desativadas. Sendo necessário o preenchimento para o novo horário.

==== Resoluções/Legislações Associadas ====

Não se Aplica.

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.FrequenciaAluno | sigaa.ensino.frequencia_aluno ||


====== Plano de Teste ======

Sistema: Sigaa

Módulo: Turma Virtual

Link: Sigaa -> Portal Docente -> Turma Virtual -> Alunos -> Lançar Frequencia

Usuário: selan (turma com horário), ricardojosefo, ricardojose (turma sem horário)

Papel que o usuário deve ter: Docente


===== Cenários de Teste =====

  - Tentar cadastrar a frequência dos alunos de qualquer turma, verificando a regra de negócio.
  - Verificar se está permitindo cadastrar em qualquer data do calendário caso a turma não possua horário definido.
  - Verificar se ao clicar na opção Cancelar Aula o sistema está redirecionando para [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:menu_turma_virtual:diario_eletronico:conteudo_programado:criar_topico_de_aula|Criar Tópico de Aula]].

===== Dados para o Teste =====

Não se aplica.