~~ODT~~

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


====== Cadastrar ======

Este caso de uso é destinado aos usuários da PRÓ-REITORIA DE ASSUNTOS ESTUDANTIS com a finalidade de cadastrar uma nova Residência Universitária.

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

Este caso de uso inicia-se quando a opção //SIGAA -> Assistência ao Estudante -> Gerência das Residências -> Cadastrar // é acessada.

Ao selecionar o caso de uso é exibido um formulário a ser preenchido com os Dados Da Residência, contendo os seguintes campos:

  * **__Nome da Residência__:*** Tipo - TEXTO.
  * **__Sexo__:*** Tipo - LÓGICO. Opções: ''Masculino, Feminino e Mista''.
  * **__Nome da Casa/Bloco__:*** Tipo - TEXTO.
  * **__Nome do Cômodo__:*** Tipo - TEXTO.
  * **__Dormitório?__** Tipo - LÓGICO.
  * **__Ocupação Máxima do Cômodo__:** Tipo - NUMÉRICO.

Ao preencher o formulário, o usuário terá a opção de //Adicionar Cômodo// ou //Cadastrar// a Residência.

==Adicionar Cômodo== 

Ao selecionar esta opção, será adicionado o cômodo que o usuário informou ao preencher o formulário, exibindo uma listagem com os Cômodos Adicionados, como segue o modelo da tabela abaixo ([[#principais_regras_de_negócio|RN01]]):

^Nome do Quarto^  Ocupação Máxima  ^
|  NOME  |QUANTIDADE MÁXIMA PERMITIDA NO CÔMODO|

Após adicionar o cômodo, o usuário terá que adicionar o mesmo a Casa/Bloco. 

  * Adicionar Casa/Bloco

Ao selecionar esta opção, será adicionado a Casa/Bloco o cômodo que o usuário adicionou, exibindo uma lista com os seguintes dados:

  * **__Nome da Casa/Bloco__**: Tipo - TEXTO.
  * **__Nome do Quarto__**: Tipo - TEXTO.
  * **__Dormitório__**: Tipo - TEXTO. Opções: ''Sim ou Não''
  * **__Ocupação Máxima__**: Tipo - NUMÉRICO.

Como segue o modelo abaixo:
^Nome da Casa/Bloco^^^
^Nome do Quarto^  Dormitório  ^  Quantidade Máxima  ^
|NOME DADO AO ADICIONAR O CÔMODO|  POSSUI OU NÃO DORMITÓRIO  | QUANTIDADE MÁXIMA DO CÔMODO|

É possível //Alterar ou Remover// os dados da Casa/Bloco cadastrada.

  * **Alterar**:Ao selecionar esta opção, o usuário deverá alterar o campo //Casa/Bloco// no formulário, e adicionar o cômodo informado a Casa/Bloco novamente, podendo também alterar //Nome do Quarto, Dormitório e Quantidade máxima// antes de adicionar novamente o cômodo a nova Casa/Bloco.

  * **Remover**: Ao selecionar esta opção, será removido a Casa/Bloco que foi adicionado a residência.

==Cadastrar==

Após preencher o formulário, tendo ou não adicionado cômodos a residência, o usuário deverá selecionar a opção //Cadastrar// para que a Residência seja cadastrada com sucesso ([[#principais_regras_de_negócio|RN02]]).

O caso de uso é finalizado.

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

  * **RN01** - Só é possível adicionar um Cômodo se os campos //Nome do Cômodo// e //Nome da Casa/Bloco// estiverem preenchidos, visto que após adicionar um cômodo, será necessário adicionar o mesmo a uma Casa/Bloco.
  * **RN02** - Para realizar o cadastro da residência com sucesso é necessário ter preenchido o //Nome da Residência// no formulário.

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

Não se aplica.

<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====



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

Sistema: SIGAA

Módulo: Assistência ao Estudante

Link(s): Assistência ao Estudante -> Gerência das Residências -> Cadastrar

Usuário: gracacosta

Papel que usuário deve ter: SigaaPapeis.SAE_COORDENADOR

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

Não se aplica.

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

Não se aplica.
</ifauth>