~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Analisar Requisição/Gerar Ordem de Serviço ====== Este caso de uso permite analisar e gerar a ordem de serviço de manutenção. A ordem de serviço é um documento que tem a função de emitir comunicações sobre o que deve ser executado a respeito de uma manutenção. O caso de uso é utilizado pelos gestores de manutenção da Divisão de Manutenção da unidade de Infraestrutura. Pré-condições: É preciso que as unidades requisitantes cadastrem e envie a requisição para atendimento. ===== Descrição do Caso de Uso ===== O caso de uso pode ser acessado pela opção SIPAC -> Infraestrutura -> Manutenção -> Ordem de Serviço -> Analisar Requisição/Gerar Ordem de Serviço ([[#principais_regras_de_negócio|RN011]]) **PASSO 1** O Usuário seleciona o grupo de manutenção. **PASSO 2** O usuário faz consulta da requisição informando: * **__Tipo de Requisição__**: Tipo - TEXTO. * **__Divisão__:** Tipo - TEXTO. O Sistema exibe a Divisão selecionada no **PASSO 1**. * **Unidade Requisitante:** Tipo - TEXTO, formato: CÓDIGO - DENOMINAÇÃO. * **Período***: Tipo - Data, formato: DD/MM/AAAA a DD/MM/AAAA. * **Somente Requisições sem Ordem de Serviço Associada:** Tipo - LÓGICO. O Usuário confirma a busca e o sistema exibe uma listagem com as requisições encontradas com as seguinte informações: ([[#principais_regras_de_negócio|RN04]]) * **__Requisição__**: Tipo - NUMÉRICO, Formato: 9.../AAAA. O Sistema exibe opção para visualizar os detalhes da requisição através do caso de uso [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:fluxos:fluxo_historico_requisicao| visualizar histórico ]]. * **__Unidade Requisitante__**: Tipo - TEXTO * **__Descrição__**: Tipo TEXTO. * **__Tipo__**: Tipo TEXTO * **__Usuário__**: Tipo TEXTO. * Opção Alterar Requisição (quando o tipo da requisição for alterado), Arquivar Requisição, Atender Requisição e Gerar a Ordem de Serviço. ([[#principais_regras_de_negócio|RN01]]) O Sistema exibe as requisições que possuem ordens de serviço cadastradas e as que não possuem, exibe as Ordens de Serviço Finalizadas e não finalizadas, exibe opção para Gerar a Ordem de Serviço. **PASSO 3** (Análise/atendimento - Informações da requisição de manutenção) * **__Número__:** 9.../AAAA, Tipo - NUMÉRICO. * **__Usuário__:** Tipo - TEXTO. * **__Data de cadastro__:** Formato - DD/MM/AAAA, Tipo - DATA. * **__Unidade Requisitante__:** Tipo - TEXTO. * **__Serviço Solicitado__:** Tipo - TEXTO. O sistema permite alterar o tipo de requisição * **Tipo da Requisição***: Tipo - Texto. Opções: PLANEJAMENTO DE OBRA DO EXERCÍCIO, MANUTENÇÃO, MEIO AMBIENTE, PARECER TÉCNICO AVALIAÇÃO. ([[#principais_regras_de_negócio|RN012]]), ([[#principais_regras_de_negócio|RN013]]), ([[#principais_regras_de_negócio|RN014]]) O sistema permite informar o imóvel ([[#Principais Regras de Negócio|RN06]]), ([[#Principais Regras de Negócio|RN07]]), ([[#Principais Regras de Negócio|RN08]]), ([[#Principais Regras de Negócio|RN09]]), ([[#Principais Regras de Negócio|RN010]]) * **Imóvel/Terreno:*** Tipo - TEXTO. * **Zona do Imóvel:*** Tipo - TEXTO. * **Prédio:*** Tipo - TEXTO. O sistema apresenta o imóvel inserido no cadastro da requisição pela a unidade solicitante e o ator confirma a alteração das informações do imóvel. ([[#Principais Regras de Negócio|RN05]]) * **__Município__:*** Tipo - TEXTO. * **__Campus__:*** Tipo - TEXTO. * **__RIP__:** Tipo - TEXTO. * **__Imóvel__:*** Tipo - TEXTO. * **__Prédio__:*** Tipo - TEXTO. * **__Zona__:*** Tipo - TEXTO. * Opção de remover o registro inserido no cadastro da requisição. O apresenta os dados do solicitante permitindo alteração do usuário * **Nome*** Tipo - TEXTO. * **Telefone*** Tipo - TEXTO. * **Ramal*** Tipo - TEXTO. * **E-mail*** Tipo - TEXTO. * **Horário para Atendimento*** Tipo - TEXTO. O sistema permite ao usuário mudar o tipo de serviço: * **__Grupo de manutenção__** * **SubGrupo de manutenção*** Tipo - Texto. O sistema permite alterar: * **Descrição:*** Tipo - TEXTO. * **Descrição do Local:*** Tipo - TEXTO. * **Descrição complementar** * **Observação:** Tipo - TEXTO. O sistema permite alterar os anexos. * **Descrição do Documento** * **Arquivo** Lista de anexo inseridos * **__Descrição do documento__** * **__Arquivo__** * Opção de remover. O sistema exibe opções: Continuar ([[#Principais Regras de Negócio|RN015]]), Retornar Requisição, Negar Requisição, Voltar e Cancelar **PASSO 4** Ao selecionar para gerar uma ordem de serviço são exibidas algumas informações da requisição: * __**Número da Requisição**__: Tipo - NUMÉRICO, formato: 9.../AAAA. * __**Unidade Requisitante**__: Tipo - TEXTO * __**Solicitante**__: Tipo - TEXTO. * __**Descrição da Requisição**__: Tipo - TEXTO * __**Horário para atendimento**__: Tipo - TEXTO * __**Tipo de Serviço**__: Tipo TEXTO O Sistema dados do executante do serviço: * **Tipo de Servidor***: Tipo TEXTO. Opções: 'OUTROS SERVIDORES', 'TERCEIRIZADO' ou 'UFRN' * OUTROS SERVIDORES OU TERCEIRIZADO: * **Executante:*** Tipo - TEXTO. * **Categorias Profissionais**: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN02]]), indica o tipo do Executante, se é UFRN ou Terceirizado e dependendo desse tipo, no caso de ordem de serviço de manutenção, são mostradas as especialidades que o mesmo pode assumir, por exemplo ''ALMOXARIFE'', ''CALCETEIRO'', ''ELETRICISTA''. Essas especialidades podem ser visualizadas no caso de uso [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:cadastros:cadastros:categorias_de_servico:cadastrar | Listar Categoria Servidor]]. * **Servidor**: entrada de dados: NOME. Este campo é exibido se a opção for UFRN. Para executantes ou servidores adicionados, o Sistema exibe lista com as atributos: * **__SIAPE__**: Tipo - NUMÉRICO (Se Servidor). * **__Nome__**: Tipo - TEXTO. * **__Categorias Profissionais__**: Tipo - TEXTO. * Opção para remover ou alterar. O Sistema solicita os dados da vistoria: * **Diagnóstico da Vistoria**: Tipo TEXTO. * **Vistoria Executada**: Tipo - TEXTO. * Opções : * INTEGRALMENTE (Neste caso deve ser informada a **data** em que foi executada a vistoria) * PARCIALMENTE (Deve-se informar o **motivo** pelo qual a vistoria não foi completada, além da **data** em que foi executada) * NÃO EXECUTADO (Deve-se informar o **motivo** pelo qual a vistoria não foi executada) * **Técnico Responsável:** Entrada de dados: NOME. ([[#principais_regras_de_negócio|RN03]]) O sistema exibe opções de cadastrar ([[#principais_regras_de_negócio|RN05]]), voltar e cancelar. **PASSO 5** O Usuário confirma cadastro e o sistema exibe as informações da ordem de serviço: * **__Número da Requisição__:** * **__Unidade__:** * **__Solicitante__:** * **__Ramal__:** * **__Descrição da Requisição__:** * **__Local__:** * **__Executante(s)__:** * **__Diagnóstico da Vistoria__:** * **__Vistoria Executada__:** CONCLUÍDA NÃO EXECUTADA PARCIAL * **__Data de Cadastro__:** * **__Data de Conclusão__:** * **__Observações da Requisição__:** O sistema exibe opção para cadastrar outra ordem de serviço e imprimir ordem de serviço. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - Para uma requisição possuir uma ordem de serviço é necessário que a mesma tenha status de autorizada, aguardando execução, aguardando material ou em execução. * **RN02** - As categorias profissionais são exibidas de acordo com o fato do servidor pertencer à UFRN, TERCEIRIZADO ou OUTROS SERVIDORES. * **RN03** - O sistema deve exibir os servidores ativos na unidade informada no parâmetro ID_UNIDADE_INFRAESTRUTURA. * **RN04** - O sistema deve listar as requisições de infraestrutura do tipo manutenção que possui em status ENVIADA. * **RN05** - Quando confirmar a geração da ordem de serviço, o sistema deve atribuir os status AUTORIZADA e EM EXECUÇÃO em duas movimentações consecutivas. * **RN16** - Quando o valor do parametro ID_UNIDADE_INFRAESTRUTURA não foi preenchido corretamente o sistema informar que: O parâmetro de sistema ID_UNIDADE_INFRAESTRUTURA não foi preenchido ou não tem um valor válido. Por favor, entre em contato com o administrador do sistema. Sem esse parâmetro não é possível selecionar um técnico responsável. * **RN17** - Quando o valor do parametro ID_SECRETARIA_SIN não foi preenchido corretamente o sistema informar que: O parâmetro do sistema ID_SECRETARIA_SIN, que indica quem é o secretário de infraestrutura, não está preenchido ou não tem um valor válido. Por favor, entre em contato com o administrador do sistema. Regras relacionadas a analise da requisição: * **RN06** - O sistema deve permitir inserir mais de um registro de imóvel se o parâmetro PERMITE_INSERIR_MAIS_IMOVEIS for igual TRUE. Se o parâmetro PERMITE_INSERIR_MAIS_IMOVEIS for FALSE permitir inserir apenas um registro. * **RN07** - Se tiver cadastrado zoneamento para o terreno mostrar a zona para selecionar, caso contrário não mostrar. * **RN08** - Caso o imóvel tenha zoneamento definido o sistema deve mostrar as zonas do imóvel selecionado. * **RN09** - Caso o imóvel tenha zoneamento definido o sistema deve mostrar os prédios da zona escolhida pelo ator, se não tem zoneamento mostrar os prédios do imóvel escolhido pelo Ator. * **RN010** - O sistema só deve solicitar as informações de imóveis o parâmetro UTILIZA_PATRIMONIO_IMOVEL estiver habilitado. * **RN011** - O ator que tiver apenas a permissão AUTORIZADOR REQUISIÇÃO MANUTENÇÃO terá acesso apenas a este caso de uso para fazer o atendimento e gerar a ordem de serviço * **RN012** - Caso o usuário transforme o tipo da requisição para OBRA o sistema deve atribuir o status da requisição como AUTORIZA PARA INFRA para que a mesma seja exibida no caso de uso aba projetos -> requisições -> analisar/visualizar requisição de projeto/obra, para que possa ser feita uma nova análise. * **RN012** - a)Quando a unidade requisitante NÃO for vinculada a centro: Caso o usuário transforme o tipo da requisição para OBRA o sistema deve atribuir o status da requisição como PENDENTE DE AUTORIZAÇÃO CHEFE UNIDADE para que a mesma passe pela autorização da chefia da unidade demandante. A autorização se dá o caso de uso portal administrativo → menu requisições → autorizações → autorização requisição de planejamento de obra do exercício. Enviar e-mail para o chefe da unidade demandante e usuário que cadastrou (se forem diferentes) a requisição informando que: Assunto: Autorização da requisição número/ano. Corpo do e-mail: "A Superintendência de Infraestrutura transformou o tipo da requisição de , (número/ano), para obra e que é necessário a autorização do chefe da unidade requisitante para que a requisição tenha prosseguimento. Caminho para autorização do chefe: portal administrativo → menu requisições → autorizações → autorização requisição de planejamento de obra do exercício" b)Quando a unidade requisitante for vinculada a centro: Caso o usuário transforme o tipo da requisição para OBRA o sistema deve atribuir o status da requisição como PENDENTE DE AUTORIZAÇÃO DIREÇÃO CENTRO para que a mesma passe pela autorização da chefia da unidade demandante. A autorização se dá o caso de uso Portal Direção Centro -> aba requisições -> autorizações infraestrutura. Enviar e-mail para o chefe da unidade demandante e usuário que cadastrou (se forem diferentes) a requisição informando que: Assunto: Autorização da requisição número/ano. Corpo do e-mail: "A Superintendência de Infraestrutura transformou o tipo da requisição de , (número/ano), para obra e que é necessário a autorização da direção do centro para que a requisição tenha prosseguimento. Caminho para autorização: Portal Direção Centro -> aba requisições -> autorizações infraestrutura" * **RN013** - Caso o usuário transforme o tipo da requisição para PARECER TÉCNICO AVALIAÇÃO o sistema deve atribuir o status da requisição como PENDENTE DE RECEBIMENTO SIN para que a mesma seja exibida no caso de uso aba parecer técnico/avaliação -> analisar/visualizar requisição de parecer técnico/avaliação. * **RN014** - Caso o usuário transforme o tipo da requisição para MEIO AMBIENTE o sistema deve atribuir o status da requisição como ENVIADA para que a mesma seja exibida no caso de uso aba meio ambiente -> Requisições -> Analisar/visualizar requisição de meio ambiente, para que possa ser feita uma nova análise. * **RN015** - Caso o usuário mude o tipo da requisição, o sistema deve mostrar opção para "encaminhar a requisição para atendimento" e consequentemente não mostrar formulário da ordem de serviço e sim mensagem informando que "a requisição foi encaminhada para análise do setor responsável realizar análise/atendimento" ==== Resoluções/Legislações Associadas ==== Não se Aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.supinfra.manutencao.dominio.OrdemServico | administrativo.infra.ordem_servico | | br.ufrn.sipac.supinfra.projetos.dominio.RequisicaoSupInfra | administrativo.infra.requisicao_supinfra | | br.ufrn.sipac.supinfra.manutencao.struts.TipoOrdemServico | administrativo.infra.tipo_ordem_servico | | br.ufrn.sipac.supinfra.manutencao.dominio.TipoExecutanteOrdemServico | administrativo.infra.ordem_servico_tipo_exec | | br.ufrn.sipac.supinfra.manutencao.dominio.TipoExecutante.StatusOrdemServico | administrativo.infra.status_ordem_servico | | br.ufrn.sipac.supinfra.manutencao.dominio.TipoExecutante | administrativo.infra.tipo_executante | | br.ufrn.sipac.supinfra.manutencao.dominio.CategoriaServidor | administrativo.infra.categoria_servidor | | br.ufrn.sipac.supinfra.manutencao.dominio.ExecutanteCategorias | administrativo.infra.executante_categorias | ===== Plano de Teste ===== Sistema: SIPAC Módulo: Infraestrutura Link(s): Sipac -> Infraestrutura -> Manutenção -> Ordens de Serviço -> Analisar Requisição/Gerar Ordem de Serviço. Usuário: lane Papel que usuário deve ter: SipacPapeis.GESTOR_MANUTENCAO, SipacPapeis.AUTORIZADOR_REQUISICAO_MANUTENCAO ===== Cenários de Teste ===== Cenário apenas gravando a requisição de manutenção e confirmando alteração: - Acessar o UC Cadastrar Requisição em Portal Administrativo -> Requisições -> Infraestrutura -> Manutenção -> Cadastrar Requisição. de Infraestrutura (tipo manutenção) e apenas gravar a requisição. (Anotar o número da requisição) - Acessar o UC Modificar Requisição em Portal Administrativo -> Requisições -> Infraestrutura -> Manutenção -> Modificar Requisição. (Apenas confirmar alteração das informações) - Consultar a requisição por meio do UC Acompanhar Requisições Enviadas: - Portal Administrativo -> Requisições -> Infraestrutura -> Manutenção -> Acompanhar Requisições Enviadas. - Portal Administrativo -> Requisições -> Buscar Requisições. - Módulo Infraestrutura -> Requisições -> Infraestrutura -> Manutenção -> Acompanhar Requisições Enviadas. Cenário apenas gravando a requisição de manutenção e confirmando/enviando alteração: - Acessar o UC Cadastrar Requisição em Portal Administrativo -> Requisições -> Infraestrutura -> Manutenção -> Cadastrar Requisição. de Infraestrutura (tipo manutenção) e apenas gravar a requisição. (Anotar o número da requisição) - Acessar o UC Modificar Requisição em Portal Administrativo -> Requisições -> Infraestrutura -> Manutenção -> Modificar Requisição. (Confirmar alteração das informações e enviar) - Consultar a requisição por meio do UC Acompanhar Requisições Enviadas: - Portal Administrativo -> Requisições -> Infraestrutura -> Manutenção -> Acompanhar Requisições Enviadas. - Portal Administrativo -> Requisições -> Buscar Requisições. - Módulo Infraestrutura -> Requisições -> Infraestrutura -> Manutenção -> Acompanhar Requisições Enviadas. - Acessar o UC Analisar Requisição/Gerar Ordem de Serviço - Passo 1: Verificar se os grupos de manutenção estão sendo exibidos conforme inseridos no UC Cadastrar Grupo de manutenção na aba de Cadastros. - Passo 2: Na análise não alterar o tipo da requisição e sim as demais informações e continuar. - Passo 3: Informar os dados da OS e confirmar o cadastro. - Acessar o UC aba Manutenção -> Ordens de Serviço -> Consultar Ordem de Serviço. - Acessar o UC aba Manutenção -> Ordens de Serviço -> Alterar/Remover Ordem de Serviço. Verificar se ao finalizar o cadastro e optar por gerar uma nova ordem de serviço, o sistema volta para a tela de busca e exibe a mesma listagem inicial. ===== Dados para o Teste === Para encontrar uma requisição com status que satisfaça a primeira regra de negócio, basta acessar o caso de uso abaixo e informar o tipo de requisição "Manutenção" e o status da requisição, por exemplo, "Aguardando Execução". //**SIPAC -> INFRA-ESTRUTURA -> REQUISIÇÕES -> REQUISIÇÕES -> ACOMPANHAR REQUISIÇÕES ENVIADAS.**//