~~ODT~~

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

====== Meus Orientandos ======

Este caso de uso permite ao docente visualizar os discentes sob sua [[desenvolvimento:especificacoes:sigaa:portal_coordenador_graduacao:casos_de_uso:aluno:cadastrar_orientacao_academica | orientação acadêmica]]. Essas orientações acadêmicas são cadastradas pelo Coordenador de Graduação.

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

O caso de uso inicia quando o usuário acessa //SIGAA -> Portal do Docente -> Ensino -> Orientação Acadêmica -> Meus orientandos//.

O sistema exibe uma lista dos orientandos ativos, seguindo o modelo em tabela abaixo: ([[#principais_regras_de_negocio|RN01]])

^  Lista de Orientações Acadêmicas (Nº de Orientandos)  ^^^^^
^ Status do Discente ^ Discente ^ E-mail ^ Início da Orientação ^^
|Nível de Ensino|||||
| Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO | Formato - DD/MM/AAAA, Tipo - DATA| |
| ------ | ------ | ------ | ------ ||
^ Lista de E-mail do Grupo de Orientandos ^^^^^
| Tipo - TEXTO|||||
^ Últimas Mensagens Enviadas ([[#principais_regras_de_negocio|RN03]]) ^^^^^
| Tipo - TEXTO  |||||

A partir desta lista, o docente tem as seguintes opções ([[#principais_regras_de_negocio|RN02]]):

=== Visualizar Histórico ===
O sistema disponibiliza o download do [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:alunos:documentos:emitir_historico#dados_pessoais|histórico do discente]] selecionado.

=== Emitir Atestado de Matrícula ===
O sistema [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:alunos:documentos:emitir_atestado_de_matricula|emite o atestado de matrícula]] do discente selecionado.

=== Enviar E-mail === 
O sistema permite [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:ensino:orientacao_academica:enviar_mensagem_aos_orientandos#descrição_do_caso_de_uso|enviar e-mail]] ao discente selecionado.

=== Visualizar Orientações Dadas === 
O sistema permite 
[[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:ensino:orientacao_academica:meus_orientandos:visualizar_orietacoes_dadas|visualizar orientações dadas]] ao discente selecionado. 

=== Relatório das Integralizações do Currículo ===
O sistema exibe as informações do discente e lista a estrutura curricular do curso com as integralizações realizadas e as pendentes seguindo o modelo abaixo:

  * **__Matrícula__**: Tipo - NUMÉRICO.
  * **__Discente__**: Tipo - TEXTO.
  * **__Curso__**: Formato - NOME CURSO - CAMPUS - MODALIDADE - TURNO - TITULAÇÃO, Tipo - TEXTO.
  * **__Status__**: Tipo - TEXTO.
  * **__Tipo__**: Tipo - TEXTO.
  * **__Período Atual__**: Tipo - NUMÉRICO.
  * **__Índice de Integralização__**: Formato - 99,99, Tipo - NUMÉRICO.

^  Estrutura Curricular  ^^^
^ Código ^ Componente ^ Cursado |
|  PERÍODO  |||
| Tipo - TEXTO e NUMÉRICO | Tipo - TEXTO | Tipo - LÓGICO | 
| ------ | ------ | ------ |
|  PERÍODO  |||
| ------ | ------ | ------ |


O caso de uso é finalizado.

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

   * **RN01** - O docente só pode visualizar os discentes que orienta.
   * **RN02** - O caso de uso de "Remover Orientação Acadêmica" está disponível apenas para o coordenador de curso.
   * **RN03** - A listagem de últimas mensagens enviadas deve estar disponível apenas para os docentes.

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.OrientacaoAcademica | sigaa.ensino.orientacao_academica |

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

Sistema: SIGAA

Módulo: Portal do Docente

Link(s): Ensino -> Orientação Acadêmica -> Meus Orientandos

Usuário: gomes (ORIENTADOR_ACADEMICO), jmarcos(ORIENTADOR_ACADEMICO)

Papel que usuário deve ter: ser Docente ou  SigaaPapeis.ORIENTADOR_ACADEMICO

===== Cenários de Teste =====
Testar se os discentes estão ordenados por status e ordem alfabética.

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

  * A SQL que identifica os docentes que possuem o papel ORIENTADOR_ACADEMICO:
  
  select u.login,p.nome,s.siape from graduacao.orientacao_academica o inner join rh.servidor s using(id_servidor)
  inner join comum.pessoa p  on s.id_pessoa = p.id_pessoa inner join comum.usuario u on u.id_pessoa = p.id_pessoa
  where (o.fim is null or o.fim >= now()) and tipoorientacao ='A'