~~ODT~~

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

====== Lançar Frequência em Planilha ======

Este caso de uso trata de registrar as frequências dos discentes de uma turma virtual. Nele, o docente cadastrará a frequência em uma planilha, 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 em Planilha

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á exibida uma planilha onde as colunas indicam os discentes e 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 uma célula na planilha, o sistema comutará automaticamente entre o número de faltas possíveis. Por exemplo, clicando em uma mesma célula várias vezes, o seu valor será alterado para 2, 1, 0.

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.

As últimas colunas na planilha indicarão o total de faltas e o percentual correspondente.

===== 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 Frequência em Planilha

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.

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

Não se aplica.