~~ODT~~

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


====== Cadastrar Documento do Veículo ======

Este caso de uso é utilizado pelos gestores de transportes com o objetivo de realizar o cadastro de documentos de veículos da instituição.

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

O caso de uso está disponível através do caminho: //SIPAC -> Transportes -> Licenciamento ->  Documento do Veículo -> Cadastrar//

Ao acessar o caso de uso, são solicitados os seguintes dados para o cadastro:

  * **Tipo do documento***: Tipo - TEXTO. 
  * **Órgão emissor***: Tipo - AUTOCOMPLETE, formato - SIGLA/NOME DO ÓRGÃO/SIGLA DO ESTADO.
  * **Via do documento***: Tipo - NUMÉRICO.
  * **RENAVAM***: Tipo - NUMÉRICO.
  * **RNTRC**: Tipo - TEXTO.
  * **Ano exercício***: Tipo - NUMÉRICO, formato: AAAA.
  * **Local da emissão***: Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO CIDADE/SIGLA ESTADO. [[#principais_regras_de_negócio|RN01]].
  * **Data da emissão***: Tipo - DATA. Formato: DD/MM/AAAA. [[#principais_regras_de_negócio|RN02]].
  * **Dados do Veículo**
    * **Placa***: Tipo - AUTOCOMPLETE. Formato - XXX-9999.
    * Ao informar a //placa//, são listados os seguintes dados deste:
      * **__Local do Emplacamento__**: Tipo - TEXTO.
      * **__Chassi__**: Tipo - TEXTO.
      * **__Espécie tipo__**: Tipo - TEXTO.
      * **__Combustível__**: Tipo - TEXTO.
      * **__Marca/Modelo__**: Tipo - TEXTO.
      * **__Ano de fabricação__**: Tipo NUMÉRICO, formato: AAAA.
      * **__Ano do modelo__**: Tipo NUMÉRICO, formato: AAAA.
      * **__Cap/Pot/Cil__**: Tipo - TEXTO.
      * **__Categoria__**: Tipo - TEXTO.
      * **__Cor__**: Tipo - TEXTO.
  * **Dados do Proprietário**
    * **Cpf/Cnpj***: Tipo - NUMÉRICO. Formato: 999.999.999-99.
    * Ao informar o //Cpf/Cnpj//, e solicitar a busca do proprietário, são listados os seguintes dados deste:
      * **__Nome__**: Tipo - TEXTO.
      * **__Endereço__**: Tipo - TEXTO.
      * **__Bairro__**: Tipo - TEXTO.
      * **__Cidade/UF__**: Tipo - TEXTO.
  * **IPVA**
    * **Faixa IPVA**: Tipo - NUMÉRICO.
    * **IPVA**: Tipo TEXTO. São exibidas as seguintes opções, Cota Única ou Parcelamento.
      * **Cota Única**
        * **Cota única**: Tipo - NUMÉRICO.
        * **Vencimento**: Tipo DATA.
      * **Parcelamento**
        * **Parcela/Cota**: Tipo - NUMÉRICO. Formato: 9/99...
        * **Pagamento 1ª parcela**: Tipo DATA.
        * **Pagamento 2ª parcela**: Tipo DATA.
        * **Pagamento 3ª parcela**: Tipo DATA.
  * **Dados Seguro Obrigatório**
    * **Prêmio tarifário**: Tipo - NUMÉRICO.
    * **IOF**: Tipo - NUMÉRICO.
    * **Prêmio total**: Tipo - NUMÉRICO.
    * **Data de pagamento**: Tipo DATA.
  * **Observações**: Tipo - TEXTO.

O caso de uso é finalizado.

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

  * **RN01** - O órgão emissor deve ter a permissão de emissão do documento para o local de emissão informado, ou seja, devem ser do mesmo estado.
  * **RN02** - A data de emissão do documento deve ser igual ou anterior a data atual.

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

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

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.DocumentoVeiculo | administrativo.transporte.documento_veiculo |
| br.ufrn.sipac.transportes.dominio.Veiculo | administrativo.transporte.veiculo |

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

Sistema: SIPAC

Módulo: Transportes

Link(s):  Licenciamento ->  Documento do Veículo -> Cadastrar

Usuário: bergue

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.GESTOR_TRANSPORTES_LICENCIAMENTO_MULTA, 
  * SipacPapeis.GESTOR_TRANSPORTES_VEICULO.
===== Cenários de Teste =====

Teste o caso de uso para as seguintes situações:

  * Submeter a página sem preencher os campos -> verificar se aparece a mensagem de campo obrigatório para todos os campos de preenchimento obrigatório;
  * Preencher todos os campos com a capacidade máxima de caracteres permitidos ou se o campo não tiver limite colocar uma grande quantidade de caracteres e vê se o sistema se comporta normal;
  * Efetuar o cadastro para os dois tipos de documentos no campo "Tipo de Documento", utilizando o campo "IPVA" como Cota Única e Parcelado;
  * Colocar dados inválidos nos campos de datas e campos numéricos. Nos campos numéricos tentar colocar caracteres alfabéticos e especiais, pode utilizar CTRL + C e CTRL + V com caracteres para ver como se comporta o campo;
  * Tentar preencher os campos "Placa" e o "CPF/CNPJ" com dados inválidos.
  * Verificar como se comporta o campo "Observações" tentando preencher com mais de 500 caracteres, pode forçar tentando segurar uma tecla até passar do limite;
  * Preenchendo o campo de "Placa" e "CPF/CNPJ" verificar se os dados que aparecem referente ao veículo e ao proprietário estão corretos e são suficientes. A verificação dos dados do veículo e do proprietário pode ser feita nos casos de uso de [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:frota:frota:veiculo:cadastrar|Cadastro de Veículo]] e [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:frota:frota:veiculo:listar_alterar|Listar / Alterar Veículo]]

Após efetuar o cadastramento verificar se os dados aparecem corretamente na listagem exibida no caso de uso de [[.listar_alterar | Listar/Alterar Documento do Veículo]].


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

No SigAdmin cadastre um login para um dos seguintes papéis: SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, SipacPapeis.GESTOR_TRANSPORTES_VEICULO.

Em seguida entre o módulo de transportes e acesse o link: Licenciamento → Documento do Veículo → Cadastrar