~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>";
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>
====== Cadastrar Porte de Arma ======
Este caso de uso permite o cadastro do Porte de Arma para os servidores aposentados da Instituição. O porte de Arma
é o documento, que autoriza o cidadão a portar, transportar e trazer consigo uma arma de fogo, de forma discreta, fora
das dependências de sua residência ou local de trabalho.

Os envolvidos nesta funcionalidade são os responsáveis pelo controle do porte de arma.

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

Este caso de uso inicia quando o usuário acessa a opção: SIGRH → Identificação Funcional → Cadastro → Porte de Arma → Cadastrar/Alterar.

Ao acessar o caso de uso o sistema apresenta o seguinte filtro:

//**Passo 1**//: Realizar uma consulta pelo servidor desejado, com pelo menos um dos seguintes campos:

  * **Servidor:** Tipo: AUTOCOMPLETE. Entrada de dados: MATRÍCULA INTERNA, CPF, SIAPE, NOME DE IDENTIFICAÇÃO, NOME DO SERVIDOR. ([[#Principais Regras de Negócio|RN01]]).
  * **Unidade de Exercício:** Tipo: AUTOCOMPLETE. Formato:NOME DA UNIDADE(CÓDIGO).
  * **Considerar Unidades Vinculadas à Unidade de Exercício:** Tipo: LÓGICO.
  * **Unidade de Lotação:** Tipo: AUTOCOMPLETE. Formato: NOME DA UNIDADE(CÓDIGO).
  * **Considerar Unidades Vinculadas à Unidade de Lotação:** Tipo: LÓGICO.

//**Passo 2**//: O sistema lista o resultado da busca mostrando os servidores encontrados e seus respectivos dados:

  * **__Servidor__**: Formato SIAPE NOME DO SERVIDOR Tipo - TEXTO.   
  * **__Nome de Identificação__**: Tipo – TEXTO.
  * **__Categoria__**:  Tipo – TEXTO.
  * **__Cargo__**: Tipo - TEXTO.
  * **__Unidade de Exercício__**: Tipo - TEXTO.
  * **__Unidade de Lotação__**: Tipo - TEXTO.

//**Passo 3**//: Após a seleção do servidor as seguintes informações são mostradas:

  * **__Servidor__**: Tipo - TEXTO.
  * **__Nome de Identificação__**: Tipo – TEXTO.
  * **__SIAPE__**: Tipo – NUMÉRICO.
  * **__Categoria__**: Tipo – TEXTO.
  * **__Cargo__**: Tipo - TEXTO.
  * **__Unidade de Exercício__**: Tipo - TEXTO.
  * **__Unidade de Lotação__**: Tipo - TEXTO.

Caso o servidor selecionado já tenha portes de arma cadastrados as seguintes informações serão exibidas:
  * **__Número do Porte__**: Tipo – NUMÉRICO. 
  * **__Situação do Porte__**: Tipo – TEXTO.
  * **__Data de validade__**: Formato DD/MM/AAAA Tipo – DATA.
  * **__Data de Entrega__**: Formato DD/MM/AAAA Tipo – DATA. Data de Entrega do documento para o servidor.
  * **__Data de Recolhimento__**: Formato DD/MM/AAAA Tipo – DATA. Data de recolhimento do documento quando da expiração da data de validade.


//**Passo 4**//: O sistema possibilita o cadastro do porte de arma. Ao selecionar a opção de //Registrar Porte de Arma// é possível cadastrar um novo registro.
  * **Número do Porte***: Tipo – NUMÉRICO. 
  * **Data de validade***: Formato DD/MM/AAAA Tipo – DATA.
  * **Data de Entrega**: Formato DD/MM/AAAA Tipo – DATA. Data de Entrega do documento para o servidor.
  * **Data de Recolhimento**: Formato DD/MM/AAAA Tipo – DATA. Data de recolhimento do documento quando da expiração da data de validade.

//**Passo 5**//: O sistema possibilita a alteração dos dados do porte de arma. Ao selecionar a opção de //Alterar Porte// é possível alterar os dados do porte já cadastrados. Os mesmos dados listados acima são exibidos e aptos para edição.

//**Passo 6**//: O sistema possibilita a exclusão dos dados do porte de arma. Ao selecionar a opção de //Remover Porte// é possível excluir os dados do porte já cadastrados.

O caso de uso é finalizado.


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

  * **RN01**: Na busca por servidores, o sistema deve retornar apenas os servidores aposentados. 
  * **RN02**: Caso o servidor já tenha registros cadastrados, o sistema lista todas as informações.
 
==== Resoluções/Legislações Associadas ====

Não se aplica.

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

^ Classe ^ Tabela |                                
| br.ufrn.sigrh.identificacao_funcional.dominio.PorteArma     | administrativo.identificacao_funcional.porte_arma      |
| br.ufrn.sigrh.identificacao_funcional.dominio.SituacaoPorteArma     | administrativo.identificacao_funcional.situacao_porte_arma     |

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

Sistema: SIGRH

Módulo: Identificação Funcional

Link(s): Identificação Funcional -> Cadastro -> Porte de Arma -> Cadastrar/Alterar

Usuário: mirian

Papel que usuário deve ter: SigrhPapeis.GESTOR_DOCUMENTACAO_FUNCIONAL

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

Cadastrar,alterar e remover porte de arma e verificar se os dados persistem. 


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

Consulta que retorna todos portes de armas cadastrados:

<code sql>
  SELECT id_porte_arma,numero, data_validade,id_situacao_porte_arma FROM identificacao_funcional.porte_arma 
</code>