~~ODT~~

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


======Relatório de Ocupação======

Este caso de uso é utilizado pelos gestores de depósito para gerar um relatório que exiba informações sobre a ocupação do depósito.

Pré-condição: Deve haver um depósito cadastrado e registros de ocupação no sistema.

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Atendimento de Requisições -> Depósito -> Relatórios -> Relatório de Ocupaçao


===Passo 1===

Ao acessar o caso de uso, os seguintes filtros são disponibilizados para o usuário: ([[#principais regras de negócio|RN01]]).

  * **Depósito**: Tipo TEXTO. ([[#principais regras de negócio|RN02]]).
  * **Tipo de Armazenamento**: Tipo TEXTO. 
  * **Tipo de Volume**: Tipo TEXTO.
  * **Material**: Tipo AUTOCOMPLETE.([[#principais regras de negócio|RN03]]).
  * **Período**: Tipo DATA. formato: DD/MM/AAAA a DD/MM/AAAA. Período de cadastro da solicitação de armazenamento de material.
  * **Unidade**: Tipo AUTOCOMPLETE. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE. Entrada de dados: CÓDIGO OU NOME DA UNIDADE. Filtra as solicitações considerando a unidade que requisitou o armazenamento de material.

Os depósitos são exibidas com as seguintes informações:

  * **__Depósito__**: Tipo TEXTO.
  * **__Prateleiras__**: Tipo NUMÉRICO. Quantidade de prateleiras que o depósito possui.
  * **__Níveis/Subníveis__**: Tipo NUMÉRICO. Quantidade de níveis/subníveis cadastrados no depósito.
  * **__Volume(m3)__**: Tipo NUMÉRICO. Capacidade volumétrica em m2 que o depósito suporta com base nos valores informados para cada nível e subnível.
  * **__Ocupação(%)__**: Tipo NUMÉRICO. Taxa de ocupação em percentual obtida a partir do registro de ocupação e da capacidade volumétrica do depósito.

Para cada depósito listado, é disponibilizado a opção de visualizar detalhes.

===Passo 2 - Visualizar Detalhes===

O sistema exibe o mapa de espaço(nível e subnível) do deposito com as seguintes informações:

  * **__Volume(m3)__**: Tipo NUMÉRICO.
  * **__Peso(Kg)__**: Tipo NUMÉRICO.
  * **__Ocupação(%)__**: Tipo NUMÉRICO. 

Ao selecionar o espaço, as seguintes informações são exibidas:

**Nível**

  * **__Altura(cm)__**: Tipo NUMÉRICO. Formato:99.
  * **__Largura(cm)__**: Tipo NUMÉRICO. Formato:99.
  * **__Profundidade(cm)__**: Tipo NUMÉRICO. Formato:99.
  * **__Peso(kg)__**: Tipo NUMÉRICO. Formato:99.
  * **__Volume(m3)__**: tipo NUMÉRICO. Obtido pela multiplicação da altura x largura x profundidade.

**Subnível**

  * **__Altura(cm)__**: Tipo NUMÉRICO. Formato:99.
  * **__Largura(cm)__**: Tipo NUMÉRICO. Formato:99.
  * **__Profundidade(cm)__**: Tipo NUMÉRICO. Formato:99.
  * **__Peso(kg)__**: Tipo NUMÉRICO. Formato:99.
  * **__Volume(m3)__**: tipo NUMÉRICO. Obtido pela multiplicação da altura x largura x profundidade.

Para o nível e subnível, são exibidos os volumes que estão ocupando o espaço:

  * **__Número/Ano__**: Tipo NUMÉRICO. Formato: 9.../AAAA. Número e ano da solicitação de armazenamento. É permitido consultar as informações das solicitações, conforme especificado em [[desenvolvimento:especificacoes:sipac:atendimento_de_requisicoes:casos_de_uso:deposito:requisicoes:analisar_solicitacao_armazenamento_material|Analisar solicitação de armazenamento de material]].
  * **__Código do volume__**: Tipo NUMÉRICO. Identificação do volume.
  * **__Tipo de volume__**: Tipo TEXTO.
  * **__Data de envio__**: Tipo DATA.
  * **__Permanência__**: Tipo DATA.
  * **__Altura(cm)__**: Tipo NUMÉRICO.
  * **__Largura(cm)__**: Tipo NUMÉRICO.
  * **__Profundidade(cm)__**: Tipo NUMÉRICO.
  * **__Peso(kg)__**:  Tipo NUMÉRICO.
  * **__Volume Total(m3)__**:  Tipo NUMÉRICO. Obtido pela multiplicação da altura x largura x profundidade.


O caso de uso é finalizado.

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

   * **RN01** - Caso seja informado um depósito, o relatório já exibe os dados, conforme descrito no passo 2. Ao utilizar os demais filtros, o sistema irá exibir a lista dos depósitos que tiverem registro de ocupação segundo os filtros passados.
   * **RN02** - O sistema exibe uma lista dos depósitos ativos.
   * **RN03** - São listados apenas os materiais cadastrados no módulo catálogo de materiais da natureza de despesa de material de consumo e material permanente.

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

<ifauth @admin>

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

^ Classe                                                                   ^ Tabela                                      ^
| br.ufrn.sipac.requisicoes.deposito.dominio.SolicitacaoDevolucaoMaterial  | administrativo.requisicoes.solicitacao_devolucao_material  |
| br.ufrn.sipac.requisicoes.deposito.dominio.TipoArmazenamento             | administrativo.requisicoes.tipo_armazenamento_deposito     |
| br.ufrn.sipac.requisicoes.deposito.dominio.TipoVolumeDeposito            | administrativo.requisicoes.tipo_volume_deposito            |
| br.ufrn.sipac.requisicoes.deposito.dominio.DepositoMateriais             | administrativo.requisicoes.deposito_materiais              |
| br.ufrn.sipac.requisicoes.material.dominio.Material                      | administrativo.comum.material                              |
| br.ufrn.comum.dominio.PessoaGeral                                        | administrativo.comum.pessoa                                |

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

Sistema: SIPAC

Módulo: Atendimento de Requisições

Link(s): Depósito -> Relatórios -> Relatório de Ocupação

Usuários: diretordmp

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_DEPOSITO

===== Cenários de Teste =====
Verificar se todos os links e filtros estão funcionando corretamente.


===== Dados para o Teste =====
Para cadastrar novos registros de ocupação basta acessar o caso de uso [[desenvolvimento:especificacoes:sipac:atendimento_de_requisicoes:casos_de_uso:deposito:requisicoes:atendimento:registrar_ocupacao|Registrar Ocupação]].

</ifauth>