======  Relatório por tipo de divisão  ======


Este caso de uso tem o intuito de permitir o acompanhamento das Ordens de Serviços existentes de acordo com o tipo de divisão de serviço solicitado na requisição. 

A divisão de serviço é a categoria do serviço solicitado na requisição, por exemplo: serviços de instalações elétricas, serviços de instalações de telecomunicação, serviços viários, dentre outros. Através desse caso de uso pode-se visualizar a quantidade de Ordens de Serviços que foram finalizadas, parcialmente finalizada e/ou não executadas. 

Além disso pode-se visualizar o número de ordens de serviços, finalizadas parcialmente e não executadas, cujo motivo da não finalização tenham sido: falta de mão de obra, falta de material, falta de equipamente ou outro motivo. Esse caso de uso é utilizado pelos servidores da Diretoria de Projetos e Obras da Superintendência de Infraestrutura.


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

O caso de uso inicia com o filtro para que o usuário informe o período para o qual deseja gerar o relatório, para isso deve-se informar:

  * **Período** *: Tipo - DATA, Formato -  dd/mm/aaaa ''ate'' dd/mm/aaa.
  * **Tipo(s) de Divisão** : Tipo - LÓGICO.


Após ter informado o período como parâmetro do relatório o usuário pode solicitar a geração do mesmo. No relatório gerado tem-se as seguintes informações:
  * **__Período__**: Tipo - TEXTO, Formato - dia/mês/ano ''a'' dia/mês/ano
  * **__Divisão__**: Tipo - TEXTO
  * **__Finalizadas Integralmente__**: Tipo - NUMÉRICO
  * Finalizadas Parcialmente: ( [[#principais_regras_de_negócio | RN02]] )
    * **__Mão de Obra__**:Tipo - NUMÉRICO
    * **__Material__**: Tipo - NUMÉRICO
    * **__Equipamento__**: Tipo - NUMÉRICO
    * **__Outros__**: Tipo - NUMÉRICO
    * **__Total__**: Tipo - NUMÉRICO
  * Não Executadas: ( [[#principais_regras_de_negócio | RN03]] )
    * **__Mão de Obra__**: Tipo - NUMÉRICO
    * **__Material__**: Tipo - NUMÉRICO
    * **__Equipamento__**: Tipo - NUMÉRICO
    * **__Outros__**: Tipo - NUMÉRICO
    * **__Total__**:Tipo - NUMÉRICO
  * **__Total Geral__**: Tipo - NUMÉRICO( [[#principais_regras_de_negócio | RN01]] )

O relatório exibido tem o seguinte formato:


 === RELATÓRIO POR TIPO DE DIVISÃO ===

**Perído**: dia/mês/ano ''a'' dia/mês/ano 


^ORDENS DE SERVIÇO |||||||||||||
^ Divisão ^ Finalizadas Integralmente ^ Finalizadas Parcialmente ^^^^^ Não Executadas ^^^^^ Total Geral |
|   |   ^ Mão de Obra ^ Material ^ Equipamento ^ Outros ^ Total ^ Mão de Obra ^ Material ^ Equipamento ^ Outros ^ Total | |
| Outros | 0  |   4 | 5 | 2 | 3 | 14 | 20 | 24 | 5 | 29 | 78 | 92 |


{{:desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:manutencao:relatorios:imagem_relatorio_tipo_divisao.jpg|}}

Após a exibição do realtório o caso de uso finaliza.

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

  * **RN01** - O Total Geral deve ser igual ao somatário das quantidades de Ordens de Serviços finalizadas, finalizadas parcialmente e não executadas
  * **RN02** - O Total de Ordens de Serviço não executadas deve ser igual ao somatório das quantidades de motivos pelos quais as Ordem de serviços não foram executadas: Mão de Obra, Meterial, Equipamento e/ou Outros.
  * **RN03** - O Total de Ordens de Serviço finalizadas parcialmente deve ser igual ao somatório das quantidades de motivos pelos quais as Ordem de serviços foram finalizadas parcialmente: Mão de Obra, Meterial, Equipamento e/ou Outros.
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| sipac.infra.requisicao_supinfra | br.ufrn.sipac.supinfra.projetos.dominio.RequisicaoSupInfra |
| sipac.infra.ordem_servico | br.ufrn.sipac.supinfra.manutencao.dominio.OrdemServico |
| sipac.infra.grupo_manutencao | br.ufrn.sipac.supinfra.manutencao.dominio.GrupoManutencao |


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

Sistema: SIPAC

Módulo: Superintendência de Infra-Estrutura

Link(s): Manutenção -> Relatórios -> Relatório por tipo de divisão 

Usuário: lane (gestor_obras), joca (gestor_manutencao)

Papel que usuário deve ter: SipacPapeis.GESTOR_OBRAS, SipacPapeis.GESTOR_MANUTENCAO


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

  - Testar a geração do relatório para diferentes períodos e observar se as quantidades textual e gráfica das ordens de serviços executadas estão correspondentes.
  - Pode-se [[ desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:manutencao:ordens_de_servico:gerar_ordem_de_servico | gerar uma ordem de serviço ]] para visualizar a mudança nas quantidade exibidas no relatório.

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

Não se aplica