~~ODT~~

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

====== Listar/Alterar Garagem ======

Através deste caso de uso é possível buscar, alterar ou remover as garagens cadastradas.

Uma garagem representa um local onde veículos são armazenados.

Esta funcionalidade é utilizada por gestores regionais e nacionais de frota.


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

O caso de uso é acionado quando o usuário acessa a opção: //SIPAC -> Transportes -> Frota -> Frota -> Garagem -> Listar/Alterar//.

É exibido um formulário para busca de garagem. São exibidos os seguintes filtros de busca:

  * **Tipo**: Tipo - TEXTO, Formato - são apresentadas as opções ''PRÓPRIA'' e ''TERCEIRO'', busca pelo tipo de garagem selecionado.
  * **Nome**: Tipo - TEXTO, Formato - LIVRE, busca pelo nome informado.
  * **CEP**: Tipo - CEP, Formato - 99.999-999, busca pelo CEP informado.
  * **Logradouro**: Tipo - TEXTO, Formato - LIVRE, busca pelo logradouro informado.
  * **Bairro**: Tipo - TEXTO, Formato - LIVRE, busca pelo bairro informado.
  * **UF**: Tipo - TEXTO, Formato - AA, busca pelo UF selecionado.
  * **Cidade**: Tipo - TEXTO, Formato - NOME DO MUNICÍPIO, busca pelo município selecionado.
  * **Todas as Garagens**: busca todas as garagens cadastradas.

Em seguida é exibida a lista com as garagens encontradas, na qual são apresentadas as seguintes informações:

  * **__UF__**: Tipo - TEXTO.
  * **__Cidade__**: Tipo - TEXTO.
  * **__Nome__**: Tipo - TEXTO.
  * **__Endereço__**: Tipo - TEXTO, Formato - "LOGRADOURO, NÚMERO, BAIRRO, COMPLEMENTO".
  * **__Qtd. Veículos__**: Tipo - NUMÉRICO, Formato - 999.

No campo **Qtd. Veículos** há um link onde é possível listar os veículos localizados na garagem, exibindo as seguintes informações para cada veículo:

^ Foto ^ Modelo ^ Denominação ^ Status ^ Cor ^
| | DENOMINAÇÃO COMPLETA DO MODELO | APELIDO| NOME DO STATUS | DENOMINAÇÃO DA COR |
| FOTO | **__Unidade__**: NOME COMPLETO (SIGLA) (CÓDIGO) || **__Tipo de Uso do Veículo__**: DENOMINAÇÃO DO TIPO DE USO ||
| | **__Proprietário__**: NOME OU RAZÃO SOCIAL (CPF OU CNPJ) || **__Categoria__**: DENOMINAÇÃO DA CATEGORIA ||

Para cada garagem ainda é possível realizar as seguintes operações:

  * //Alterar// - segue para o mesmo fluxo do [[cadastrar|cadastro]] de garagem ([[#principais_regras_de_negócio|RN01]]).
  * //Remover// - é solicitada uma confirmação da remoção ([[#principais_regras_de_negócio|RN02]]).

O caso de uso é finalizado.


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

   * **RN01** - Não é possível alterar o nome de uma garagem para o nome de uma garagem já existente na mesma cidade.
   * **RN02** - Não é possível remover uma garagem que esteja associada a algum veículo cadastrado.

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


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

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.Garagem | administrativo.transporte.garagem |


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

Sistema: SIPAC

Módulo: Transportes

Link(s): Frota -> Frota -> Garagem -> Listar/Alterar

Usuários: bergue (Gestor de Transportes Unidades), robertofilho (Gestor de Transportes Global)

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.GESTOR_TRANSPORTES_VEICULO,
  * SipacPapeis.AUDITOR.

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

Verificar se as operaçãos de buscar, alterar e remover são realizadas corretamente, respeitando as regras de negócio.

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

É possível cadastrar garagens no caso de uso [[cadastrar|Cadastrar Garagem]].