~~ODT~~

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

====== Gerenciar Equipes de Docentes da Residência ======

Este caso de uso tem o objetivo de permitir aos gestores da PPG responsáveis pelo regsitro acadêmico das Residências realizarem o gerenciamento das equipes de docentes de um dado programa de residência.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIGAA → Módulo Residência em Saúde → Aba Cadastros → Equipe de Docentes da Residência//.


=== Seleção da Residência === 

Inicialmente, o sistema deve requerer uma definição acerca de qual programa de residência deve-se realizar a gerência de sua equipe: 

  ***Programa de Residência***: Tipo TEXTO, formato: NOME_PROGRAMA_RESIDÊNCIA;
    * //Combo com todos os Programas de Residência já inseridos no sistema//;


=== Equipe do Programa de Residência === 

Uma vez definido o programa, O sistema exibe os seguintes duas listagens (a primeira relacionando o **corpo docente** e a segunda relacionada com o **corpo de preceptores** do programa de residência)e dados dispostos em formato de listagem, com os seguintes campos:

  * **Corpo Docente do Programa**
    ***__Docente__**: Tipo TEXTO, formato: NOME_DOCENTE (CPF_DOCENTE);
    ***__Categoria__**: Tipo TEXTO;
      * //Categoria funcional obtido do cadastro do próprio docente. Atestar que, para os docentes externos, exibir o valor 'EXTERNO À INSTITUIÇÃO';//
    ***__Mestrado__**: Tipo TEXTO.
      * //É possível que esse campo possua valores 'SIM' e 'NÃO'//;
    ***__Doutorado__**: Tipo TEXTO;
      * //É possível que esse campo possua valores 'SIM' e 'NÃO'//; 

  * **Corpo de Precepetores do Programa**
    ***__Preceptor__**: Tipo TEXTO, formato: NOME_PRECEPTOR(CPF);
    ***__Formação__**: Tipo TEXTO;

Para cada item listado, o sistema disponibiliza a opção de Alterar os Dados do Docente e removê-lo.

Adicionalmente, o sistema possibilita a opção de **cadastrar membro** do corpo docente do programa de residência.

=== Cadastrar Membro do Corpo Docente ===

O sistema exibe os seguintes dados para preenchimento:

  ***__Programa de Residência__**: Tipo TEXTO, formato: DENOMINAÇÃO_RESIDÊNCIA;
  ***Lotação***: Tipo TEXTO, são apresentadas as opções: 'TODOS DA UFRN', 'SOMENTE DA MINHA UNIDADE', 'SOMENTE EXTERNOS';
  ***Usuário***: Tipo AUTOCOMPLETE, formato: 'Nº_SIAPE - NOME_SERVIDOR' (para os servidores da instituição) ou 'CPF - NOME_PESSOA' (para docentes externos ou preceptores), entrada de dados: NOME;
    * //Para o caso de uso em questão, criar uma possibilidade de selecionar um [[desenvolvimento:especificacoes:sigaa:residencia_em_saude:casos_de_uso:administracao:preceptores:cadastrar|preceptor]] já cadastrado no sistema//;
  ***Tipo de Vinculação**: Tipo TEXTO, são apresentadas as opções 'DOCENTE' e 'PRECEPTOR';
    * //Que seja disponibilizado dois checkboxes para que um mesmo indivíduo possa ser definido como 'DOCENTE' e 'PRECEPTOR'//;
  ***Mestrado***: Tipo LÓGICO ([[#principais REgras de Negócio|RN01]]);
  ***Doutorado***: Tipo LÓGICO ([[#principais REgras de Negócio|RN01]]);

=== Alterar Membro === 

Segue o mesmo fluxo descrito em [[#cadastrar_membro_do_programa|Cadastrar Membro do Programa]], com a diferenciação de exibir os dados para alteração.

=== Remover Membro ===

Caso deseje-se remover um docente do corpo docente do sistema, faz-se necessária uma confirmação positiva e então o docente é removido.

O caso de uso é finalizado.

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

  ***RN01** - Campo apenas disponível se o checkbox de 'DOCENTE' esteja preenchido.
  ***RN02** - Apenas é possível realizar o cadastro de um usuário como preceptor, se esse tiver sido definido como tal através da funcionalidade [[desenvolvimento:especificacoes:sigaa:residencia_em_saude:casos_de_uso:administracao:preceptores:cadastrar|cadastro de preceptores]] e estiver no período de vigência.

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

Não se Aplica.

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

^ Classe                                                             ^ Tabela                                                ^
| br.ufrn.sigaa.complexohospitalar.dominio.EquipeProgramaResidencia  | sigaa.complexo_hospitalar.equipe_programa_residencia  |
| br.ufrn.sigaa.complexohospitalar.dominio.PreceptorResidencia       | sigaa.complexo_hospitalar.preceptor_residencia        |
| br.ufrn.sigaa.complexohospitalar.dominio.VinculoEquipeResidencia   | sigaa.complexo_hospitalar.vinculo_equipe_residencia   |
| br.ufrn.sigaa.dominio.Unidade                                      | sigaa.comum.unidade                                   |
| br.ufrn.sigaa.pessoa.dominio.DocenteExterno                        | sigaa.ensino.docente_externo                          |
| br.ufrn.sigaa.pessoa.dominio.Pessoa                                | sigaa.comum.pessoa                                    |
| br.ufrn.sigaa.pessoa.dominio.Servidor                              | sigaa.rh.servidor                                     |



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

Sistema: SIGAA

Módulo: Residência em Saúde

Link(s): Cadastros → Equipe de Docentes da Residência

Usuário: 

Papel que usuário deve ter: GESTOR_COMPLEXO_HOSPITALAR

===== Cenários de Teste =====
Não se aplica.

===== Dados para o Teste =====
Não se aplica.