~~ODT~~

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

====== Minhas turmas ======

Este caso de uso tem como objetivo permitir ao Instrutor de uma Turma de Capacitação a busca e a consolidação das turmas em que atua. O Instrutor pode ser interno ou externo. Instrutores internos são servidores da instituição que possuem as suas atribuições enquanto funcionários mas que também atuam como instrutores. Instrutores externos são contratados especificamente para atuar como instrutores.
Para maiores informações sobre o contexto da aplicação, ver o [[desenvolvimento:especificacoes:sigrh:capacitacao:casos_de_uso:operacoes:turmas:cadastrar| Cadastro de Turmas]] e [[desenvolvimento:especificacoes:sigrh:capacitacao:negocio|Documento de Negócio - Capacitação]].

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

Este caso de uso pode ser acessado quando o usuário acessa a opção: SIGRH -> Portal do Servidor -> Capacitação -> Instrutor -> Minhas turmas

Este caso de uso assemelha-se bastante ao descrito em [[desenvolvimento:especificacoes:sigrh:capacitacao:casos_de_uso:operacoes:turmas:listar_alterar|Listar/Alterar Turmas de Capacitação]].

As diferenças principais são:
  * O instrutor não tem a opção de buscar turmas por instrutor ([[#principais_regras_de_negócio|RN02]]).
  * O instrutor não tem acesso à alteração ou remoção de turmas ([[#principais_regras_de_negócio|RN03]]).
  * São diretamente disponibilizadas ao instrutor as opções: Visualizar Inscritos, Consolidar Turma, Lançar Frequencia e Relatório de Consolidação de Turma.
    * **__Visualizar Inscritos__**: Permite visualizar informações gerais sobre a turma e informações sobre os inscritos, a saber:
        * **__Dados da turma__**
            * **__Nome__**: Tipo - TEXTO.
            * **__Vagas__**: Tipo - NUMÉRICO.
            * **__Período de realização__**:  Tipo - TEXTO.
            * **__Hora início__**: Tipo - TEXTO, Formato: 99:99
            * **__Hora fim__**: Tipo - TEXTO, Formato: 99:99
            * **__Dias da semana__**: Tipo - TEXTO.
            * **__Local__**: Tipo - TEXTO.
        * **__Servidores inscritos na turma__** (Informações exibidas para cada servidor inscrito na turma).
            * **__Nome__**: Tipo - TEXTO.
            * **__Unidade__**: Tipo - TEXTO.
            * **__Autorização da Diretoria__**: Tipo - TEXTO.
            * **__Vaga concedida__**: Tipo - TEXTO.
    * **__Consolidar Turma__**: Permite visualizar informações sobre os alunos e atribuir/confirmar as notas de cada inscrito, a partir das informações abaixo listadas. A consolidação só é possível se houver alunos associados à turma ([[#principais_regras_de_negócio|RN01]]).
        * **__Dados da turma__**
            * **__Nome__**: Tipo - TEXTO.
            * **__Vagas__**: Tipo - NUMÉRICO.
            * **__Período de realização__**:  Tipo - TEXTO.
            * **__Hora início__**: Tipo - TEXTO, Formato: 99:99
            * **__Hora fim__**: Tipo - TEXTO, Formato: 99:99
            * **__Dias da semana__**: Tipo - TEXTO.
            * **__Local__**: Tipo - TEXTO.
        * **__Avaliação da Turma__** (Informações exibidas para cada servidor inscrito na turma).
            * **__Siape__**: Tipo - TEXTO.
            * **__Nome__**: Tipo - TEXTO.
            * **Nota**: Tipo - NUMÉRICO.
            * **Freqüência**: Tipo - NUMÉRICO.
            * **Situação**: Tipo - TEXTO. São dadas as opções: ''Abandono, Aprovado, Pendente, Reprovado por conceito, Reprovado por freqüência e Transferido.''
    * **__Relatório de Consolidação de Turma__**: Exibe um relatório com as informações consolidadas para a turma, a saber:
        * **__Dados da turma__**
            * **__Nome__**: Tipo - TEXTO.
            * **__Vagas__**: Tipo - NUMÉRICO.
            * **__Período de realização__**:  Tipo - TEXTO.
            * **__Hora início__**: Tipo - TEXTO, Formato: 99:99
            * **__Hora fim__**: Tipo - TEXTO, Formato: 99:99
            * **__Dias da semana__**: Tipo - TEXTO.
            * **__Local__**: Tipo - TEXTO.
        * **__Avaliação da Turma__** (Informações exibidas para cada servidor inscrito na turma).
            * **__Siape__**: Tipo - TEXTO.
            * **__Nome__**: Tipo - TEXTO.
            * **__Nota__**: Tipo - NUMÉRICO.
            * **__Freqüência__**: Tipo - NUMÉRICO.
            * **__Situação__**: Tipo - TEXTO.
    * **__Lançar Frequência__**: Permite lançar a frequência (falta ou presença) para os servidores participantes da turma, a saber:
        * Ao optar por //Lançar Frequência//, é solicitada a data da frequência:
        * **Data da Frequência**: Tipo DATA.
        * são exibidos todos os participantes da turma com os seguintes dados:
          * **__Matrícula__**: Tipo - NUMÉRICO.
          * **__Nome__**: Tipo - TEXTO.
        * Para cada participante existem as opções de //Marcar Presença// e //Marcar Ausência//.        
    * **__Mapa de Frequências__**: Ao acessar o caso de uso, o sistema exibe os dados do caso de uso [[desenvolvimento:especificacoes:sigrh:capacitacao:casos_de_uso:declaracoes_relatorios:turmas:mapa_de_frequencias|Mapa de Frequências]]. 

Exemplo de exibição do relatório:

^Avaliação da turma^^^^^
^Siape^Nome^Nota^Freq.(%)^Situação^
|9999999 | nome | 100 | 100 | Aprovado |





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

  * **RN01**: Uma turma só poderá ser consolidada se houver alunos associados a ela.
  * **RN02**: Considerando o acesso ao sistema pelo caminho especificado para este caso de uso, um instrutor só pode visualizar suas próprias turmas.
  * **RN03**: Considerando o acesso ao sistema pelo caminho especificado para este caso de uso, um instrutor não tem acesso a alteração ou remoção de turmas.
  * **RN04**: Não é possivel lançar frequência para uma turma encerrada.
  * **RN05**: Ao consolidar a turma, todos os responsáveis (diretor e vice) pela unidade de cada servidor inscrito, será notificado via e-mail sobre o encerramento da atividade.
==== Resoluções/Legislações Associadas ====

Não se aplica.

<ifauth @admin>

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

^ Classe                                                      ^ Tabela                                                 ^
| br.ufrn.sigrh.capacitacao.dominio.Turma                     | administrativo.capacitacao.turma                       |
| br.ufrn.sigrh.capacitacao.dominio.InstrutorTurma            | administrativo.capacitacao.instrutor_turma             |
| br.ufrn.sigrh.capacitacao.dominio.PropostaEventoCapacitacao | administrativo.capacitacao.proposta_evento_capacitacao |
| br.ufrn.sigrh.capacitacao.dominio.ProgramaCapacitacaoTurma  | administrativo.capacitacao.programa_capacitacao_turma  |
| br.ufrn.sigrh.capacitacao.dominio.HorarioTurma              | administrativo.capacitacao.horario_turma               |
| br.ufrn.sigrh.capacitacao.dominio.FrequenciaTurmaServidor   | capacitacao.frequencia_turma_servidor                  |

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

Sistema: SIGRH

Módulo: Portal do Servidor

Link(s): Capacitação → Instrutor → Minhas Turmas

Usuário: Qualquer servidor que esteja cadastrado como instrutor, independentemente de papel, por exemplo, dalton.

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

Para adicionar uma turma e associá-la a um instrutor, com fim de testes do sistema, deve-se realizar login no sistema com o papel GESTOR_CAPACITACAO. A usuária mirian possui tal permissão. A seguir, deve-se acessar: SIGPRH -> Módulos -> Capacitação -> Operações -> Turmas -> Cadastrar. Será exibida uma tela de busca por Eventos de Capacitação, haja vista que uma turma só pode ser cadastrada quando associada a um desses eventos. Selecionando-se a opção buscar, sem adicionar critérios de busca, todos os eventos de capacitação cadastrados são listados. Ao selecionar a opção ofertar evento, para um dos eventos cadastrados, os dados para abertura de turma são solicitados e a turma pode ser inserida.

Para inscrever alunos na turma, basta acessar SIGPRH -> Módulos -> Capacitação -> Operações -> Turmas -> Inscrever Servidor/Consultar Inscritos, com a usuária mirian.

Lançar a frequência dos alunos de uma turma e verificar se a frequência foi lançada/removida corretamente em Capacitação → Declaração/Relatórios → Turmas → Mapa de Frequências.

===== Dados para o teste =====

<code>

select u.login, p.nome from capacitacao.instrutor i
inner join rh.servidor s on s.id_servidor = i.id_servidor
inner join comum.pessoa p on p.id_pessoa = s.id_pessoa
inner join comum.usuario u on (u.id_servidor = s.id_servidor or p.id_pessoa = u.id_pessoa)

</code>

</ifauth>