~~ODT~~

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

====== Relatório de Serviços de Manutenção======

Este caso de uso tem o intuito de permitir o acompanhamento das [[desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:manutencao:ordens_de_servico:gerar_ordem_de_servico|ordens de serviço]] de manutenção cadastradas em um determinado ano. Com isso a superintendência de infra-estrutura, mais especificamente a Divisão de Manutenção, pode controlar de maneira eficiente os serviços durante um ano.

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

Este Caso de Uso encontra-se em: SIPAC -> Infra-Estrutura -> Manutenção -> Relatórios -> Serviços de Manutenção.


Para gerar o relatório é necessário informar um ano de referência:
  * **Ano:*** Tipo - NUMÉRICO.

O Usuário confirma busca e o Sistema exibe o relatório conforme modelo: ([[#Principais Regras de Negócio|RN01, RN02, RN03]])

**Relatório de Serviços de Manutenção**

**__Ano__:** Tipo - NUMÉRICO.

^^Denominação^^Área(m²)^^Quantidade^^Finalizadas^^
|| Tipo - TEXTO||Tipo - NMÚERICO||Tipo - NUMÉRICO||Tipo - NUMÉRICO||
||  **Total**|||| Tipo - NUMÉRICO||Tipo - NUMÉRICO||

O caso de uso é finalizado.

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


  * **RN01**: Para ser exibida na contagem de ordens de serviços finalizadas a ordem de serviço precisa ter o status concluída.
  * **RN02**: Só deve ser exibida área executada na categoria de Pintor e Calceteiro.
  * **RN03**: Só devem contadas as ordens de serviço de manutenção.


==== Resoluções/Legislações Associadas ====

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.supinfra.manutencao.dominio.CategoriaServidor | administrativo.infra.categoria_servidor|
| br.ufrn.sipac.supinfra.manutencao.dominio.EspecialidadeServico | administrativo.infra.especialidade_servico |



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

Sistema: SIPAC 

Módulo: Infra-Estrutura

Link(s): Manutenção -> Relatórios -> Serviços de Manutenção

Usuário: lane

Papel que usuário deve ter: SipacPapeis.GESTOR_OBRAS

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

Conferir se os dados exibidos conferem com os filtros escolhidos.

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

A contagem de uma ordem de serviço no relatório se dá depois do seu cadastro em [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:infra_estrutura:casos_de_uso:manutencao:ordens_de_servico:gerar_ordem_de_servico|ordem de serviço]]. A ordem de serviço pode ser alterada neste mesmo local.

Pode-se usar a sql abaixo para comparar os dados gerados no relatório:

<code>
select categoria.id, categoria.descricao, count(ordem.id), sum(executante.area_pintor), sum(executante.area_calceteiro) 
from infra.categoria_servico as categoria  join infra.executante_categorias executante  
on executante.id_categoria_servico = categoria.id  join infra.ordem_servico_executante osexecutante  
on executante.id_ordem_servico_executante = osexecutante.id_ordem_servico_executante 
join infra.ordem_servico_tipo_exec tipoexecutante  on  osexecutante.id_ordem_servico_tipo_exec = tipoexecutante.id_ordem_servico_tipo_exec  
join infra.ordem_servico ordem on tipoexecutante.id_ordem_servico = ordem.id 
where ordem.ano = 2010 and categoria.id_tipo_ordem_servico = 1 
group by categoria.descricao, categoria.id 
order by categoria.descricao
</code>