====== Validar Transferência de Localidade ======

Este caso de uso permite que o gestor de patrimônio valide transferências de localidade realizadas pelos usuários no caso de uso [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:patrimonio:transferir_responsabilidade_de_localidade|Transferir Responsabilidade de Localidade]] e autenticadas pelos usuários de destino no caso de uso [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:patrimonio:receber_responsabilidade_de_localidade|Receber Responsabilidade de Localidade]]. As localidades representam locais físicos dentro das unidades da instituição que contêm bens. Uma vez que a transferência for autenticada o usuário de destino passará a ser o novo responsável pelo conjunto de bens pertencentes à localidade transferida. O gestor deverá verificar se essas movimentações de localidades realmente estão aptas de aprovação.

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

Este caso de uso inicia quando o usuário acessa //SIPAC -> Patrimônio -> Gerência -> Movimentações -> Validar Transferência de Localidade//

===Passo 1===
O caso de uso se inicia com uma consulta pelas transferências pendentes de validação do gestor. Os filtros para a consulta são:

  ***Localidade**: Tipo: ALFANUMÉRICO. Formato: CÓDIGO - DENOMINAÇÃO DA LOCALIDADE.
  ***Responsável**: Tipo: TEXTO. Formato: NOME DO NOVO RESPONSÁVEL DA LOCALIDADE.
  ***Unidade Responsável**: Tipo: TEXTO. Formato: CÓDIGO - NOME DA UNIDADE RESPONSÁVEL PELA LOCALIDADE. ([[#principais_regras_de_negocio|RN02]])
  ***Unidade Gestora**: Tipo: ALFANUMÉRICO. Formato: CÓDIGO - DENOMINAÇÃO DA UNIDADE GESTORA. ([[#principais_regras_de_negocio|RN01]])

São exibidas as transferências pendentes de validação com as seguintes informações:

  ***__Localidade__**: Tipo: ALFANUMÉRICO. Formato: CÓDIGO - DENOMINAÇÃO DA LOCALIDADE. 
  ***__Responsável__**: Tipo: TEXTO. Formato: NOME DO RESPONSÁVEL DA LOCALIDADE.
  ***__Unidade Responsável__**: Tipo: ALFANUMÉRICO. Formato: CÓDIGO - DENOMINAÇÃO DA UNIDADE RESPONSÁVEL.
  ***__Unidade Gestora__**: Tipo: ALFANUMÉRICO. Formato: CÓDIGO - DENOMINAÇÃO DA UNIDADE GESTORA.

===Passo 2===

Ao selecionar uma transferência para validação o sistema encaminhará o usuário para um tela onde ele deverá confirmar os dados. Os seguintes dados são exibidos na tela de confirmação: 

  * **__Servidor__**: Tipo: TEXTO. Formato: NOME DO SERVIDOR.
  * **__Nº. SIAPE__**: Tipo - NUMÉRICO. Formato: CÓDIGO DO SIAPE.
  * **__Lotação__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA UNIDADE DO USUÁRIO.
  * **__Cargo__**: Tipo: TEXTO. Formato: CARGO DO SERVIDOR.
  * **__Código__**: Tipo: NUMÉRICO. Formato: CÓDIGO DA LOCALIDADE.
  * **__Denominação da Localidade__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA LOCALIDADE.
  * **__Unidade Responsável__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA UNIDADE RESPONSÁVEL DA LOCALIDADE.
  * **__Unidade Gestora__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA UNIDADE GESTORA. 

Ao confirmar a passagem de responsabilidade o gestor automaticamente gera a movimentação da responsabilidade da localidade para a responsabilidade do usuário de destino. Durante a confirmação um e-mail é enviado automaticamente para os envolvidos (antigo responsável e novo responsável) informando da concretização da transferência.
Caso o usuário opte por negar a a transferência em questão, o sistema desfaz a operação em questão e a responsabilidade da localidade volta ao seu usuário inicial. No caso da negação o usuário é encaminhado a uma tela onde deve detalhar o motivo da negação da transferência. Nessa tela são disponibilizadas novamente as informações da transferência.

  * **__Servidor__**: Tipo: TEXTO. Formato: NOME DO SERVIDOR.
  * **__Nº. SIAPE__**: Tipo - NUMÉRICO. Formato: CÓDIGO DO SIAPE.
  * **__Lotação__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA UNIDADE DO USUÁRIO.
  * **__Cargo__**: Tipo: TEXTO. Formato: CARGO DO SERVIDOR.
  * **__Código__**: Tipo: NUMÉRICO. Formato: CÓDIGO DA LOCALIDADE.
  * **__Denominação da Localidade__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA LOCALIDADE.
  * **__Unidade Responsável__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA UNIDADE RESPONSÁVEL DA LOCALIDADE.
  * **__Unidade Gestora__**: Tipo: TEXTO. Formato: DENOMINAÇÃO DA UNIDADE GESTORA. 

É disponibilizado também o campo motivo para que o gestor detalhe a razão pelo qual não autorizou a passagem da responsabilidade.

  * **__Motivo__**: Tipo: TEXTO.

Um e-mail também será enviado para os envolvidos (antigo responsável e novo responsável) informando da não concretização da operação.
O caso de uso é finalizado.

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

  ***RN01** - O campo unidade gestora só será disponibilizado para usuários com o papel de gestor de patrimônio global.
  ***RN02** - O campo unidade responsável só deverá trazer as unidades pertencentes a mesma hierarquia da unidade gestora do usuário.

==== Resoluções/Legislações Associadas ====
Não se aplica.

===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe                                                                           ^ Tabela                                                               ^
| br.ufrn.sipac.patrimonio.comuns.dominio.TransferenciaResponsabilidadeLocalidade  | administrativo.patrimonio.transferencia_responsabilidade_localidade  |
| br.ufrn.sipac.patrimonio.comuns.dominio.ResponsavelLocalBem                      | administrativo.patrimonio.responsavel_local_bem                      |

====== Plano de Teste ======
Não se aplica.

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

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