~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Cadastrar Manutenção ====== Esta funcionalidade é utilizada pelos gestores de transportes com a finalidade de realizar o registro de [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:veiculo:frota:item_de_manutencao:cadastrar|materiais ou serviços]] utilizados na manutenção de veículos. É considerada como manutenção, toda e qualquer ocorrência que provoque a troca de peça ou execução de serviço em um veículo. ===== Descrição do Caso de uso ===== Esse caso de uso se inicia quando o usuário acessa o caminho: //SIPAC → Módulo Transporte → Aba Gastos/Manuteção → Manutenção → Cadastrar//. Inicialmente, é requerido que o usuário informe a placa do veículo ([[#Principais regras de Negócio|RN01]]), a ser cadastrado: * **Placa do Veículo***: Tipo AUTOCOMPLETE, formato: XXX-9999, entrada de dados: PLACA. Ao digitar a placa aparecerá os dados do veículo, e abaixo os seguintes campos: * **__Denominação__**: Tipo TEXTO. * **__Ano de Fabricação__**: Tipo NUMÉRICO, formato: AAAA. * **__Unidade__**: Tipo TEXTO, formato: NOME UNIDADE (CÓDIGO UNIDADE). * **__Tombamento__**: Tipo NUMÉRICO. São solicitados os dados complementares a manutenção do veículo: ***Hodômetro*** ([[#Principais regras de Negócio|RN03]]): Tipo NUMÉRICO. ***Tipo***: Tipo TEXTO, são apresentadas as opções: Preventiva e Corretiva. ***Origem***: Tipo TEXTO, são apresentadas as opções: Própria e Empresa. ***Data***: Tipo DATA, formato: DD/MM/AAAA. ***Unidade beneficiada*** ([[#Principais regras de Negócio|RN02]]): Tipo TEXTO. Serão solicitados os dados da nota fiscal da manutenção do veículo caso a origem seja **Empresa**, em outras palavras, terceirizada: ***Número*** ([[#Principais regras de Negócio|RN03]]): Tipo NUMÉRICO. ***Série*** ([[#Principais regras de Negócio|RN04]]): Tipo NUMÉRICO. ***Fornecedor*** ([[#Principais regras de Negócio|RN05]]): Tipo AUTOCOMPLETE, formato: NOME EMPRESA, entrada de dados: NOME EMPRESA. ***Data de Emissão*** ([[#Principais regras de Negócio|RN06]]): Tipo DATA. ***Valor*** ([[#Principais regras de Negócio|RN07]]): Tipo NUMÉRICO. ***Desconto** ([[#Principais regras de Negócio|RN07]]): Tipo NUMÉRICO. ***__Valor líquido__**: Tipo NUMÉRICO. Uma opção de buscar a Nota Fiscal é disponibilizada, e caso esta opção seja utilizada, os dados serão preenchidos automaticamente deixando disponível apenas a informação de um eventual desconto: ***Número**: Tipo NUMÉRICO. ***Série**: Tipo TEXTO. ***Fornecedor**: Tipo AUTOCOMPLETE, formato: NOME EMPRESA, entrada de dados: NOME. Então a opção de inserir os materiais e serviços referentes à manutenção é disponibilizada. Esses são inseridas um a um, através de uma busca feita pela **Denominação** do material ou serviço. A listagem é organizada mostrando os seguintes campos: * **__Denominação__**: Tipo TEXTO. * **__Ações__**: Tipo TEXTO. Após escolhido o(s) material(ais) ou serviço(s), pode-se incluí-lo(s) na listagem, sendo necessário fornecer os seguintes dados: ***__Item__**: Tipo NUMÉRICO. ***__Denominação__**: Tipo TEXTO. ***Garantia em Meses**: Tipo NUMÉRICO. ***Garantia em Km**: Tipo NUMÉRICO. ***Quantidade***: Tipo NUMÉRICO. ***Valor Unitário***: Tipo NUMÉRICO. ***__Total__**: Tipo NUMÉRICO. Abaixo será mostrado o valor total acumulado de peças e serviços no formato: ***__Valor total__**: Tipo NUMÉRICO. Pode-se também a qualquer momento remover os materiais e serviços inseridos. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - Para realizar o cadastro da manutenção é necessário informar a placa de um veículo previamente cadastrado. * **RN02** - A unidade beneficiada referencia a unidade que será beneficiada pela manutenção. O seu preenchimento é obrigatório. * **RN03** - O número da nota deverá representar o número da nota fiscal sem a série. O seu preenchimento é obrigatório. * **RN04** - A série deverá representar a série da nota fiscal. O seu preenchimento é obrigatório. * **RN05** - O fornecedor representa o emissor da nota fiscal. O seu preenchimento é obrigatório quando a origem for **Empresa**. * **RN06** - A data de emissão é a data em que a nota fiscal foi emitida. O seu preenchimento é obrigatório. * **RN07** - O valor da nota fiscal deve ser superior a 0 (zero), sendo obrigatório o seu preenchimento. * **RN08** - O valor da nota fiscal deve ser igual a soma dos valores dos serviços e/ou peças. * **RN09** - A quantidade de quilômetros do hodômetro do veículo deve ser informado.O seu preenchimento é obrigatório. ==== Resoluções/Legislações Associadas ==== Não se Aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.transportes.dominio.ManutencaoNova| sipac.transporte.manutencao_nova | | br.ufrn.sipac.transportes.dominio.ManutencaoItemNovo| sipac.transporte.manutencao_item_novo | | br.ufrn.sipac.transportes.dominio.ItemManutencao| sipac.transporte.item_manutencao | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Transporte Link(s): Gastos/Manutenção -> Manutenção -> Cadastrar Usuários: bergue (Gerente da Garagem) (por enquanto, é o único usuário com os papeis utilizados) Papel que usuário deve ter: SipacPapeis.GESTOR_TRANSPORTES_GLOBAL ou SipacPapeis.GESTOR_TRANSPORTES_UNIDADES ou SipacPapeis.GESTOR_TRANSPORTES_MANUTENCAO ===== Cenários de Teste ===== * Verificar se a manutenção foi cadastrada corretamente através do caso de uso [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:operacoes:operacoes:manutencao_nova:listar_alterar|Listar/Alterar]]. ===== Dados para o Teste ===== As placas de veículos podem ser obtidas através do seguinte relatório: Transportes-> Relatórios-> Todos os Veículos por Unidade