====== Obras por Status ======

Este caso de uso tem como objetivo permitir ao usuário buscar obras segundo o status da mesma. Diante das obras retornadas, é possível realizar algumas operações, como atualizar a obra e notificar fornecedor, e visualizar informações sobre as obras, tais como processos, projetos, cronogramas e planilha orçamentária. Este caso de uso se encontra no portal da fundação e deve ser usado pelos gestores de obra da fundação.

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

O caso de uso se inicia com uma busca pelas obras com um determinado status. Pode-se também realizar essa busca através de mais filtros:

    * Modalidade/Número/Ano, onde é feita a busca pela modalidade, número, ano e origem da licitação.
    * Origem, é informado a origem da obra (no caso FUNPEC).
    * Fiscal, referente ao fiscal da(s) obra(s).
    * Contrato, faz referência ao número e ano do contrato da obra.
    * Empresa, nome ou parte do nome da empresa associado a(s) obra(s).
    * Descrição, que seria uma breve descrição da obra.
    * Período, informa as obras cadastradas no período selecionado.
    * Status, verifica se obra está em andamento, concluída, etc.

O resultado dessa busca será uma lista de obras segundo o filtro informado, para cada obra será mostrato algumas opções de operação, caso o usuário seja GESTOR_OBRAS_FUNDACAO teremos as seguintes operações:

  * Atualizar Obra: Utilizado para realizar a alteração e atualização de uma obra.
  * Remover Obra: Utilizado para remover uma obra. Obs.: Caso a obra estiver associada com algum outro registro será necessário excluir este registro.
  * Relatório de Obras em Andamento: Onde é exibido em formato de relatório um resumo do andamento da obra.
  * Alterar Status: utilizado para alterar o status da obra.
  * Adicionar Pagamento a Obra: Utilizado para cadastrar o pagamento a obra. Inserido apenas caso já tenha sido cadastrado um cronograma físico.
  * Despacho da Obra: Emite um despacho da obra.
  * Contrato da Obra: Exibe o contrato relacionado com a obra.
  * Planilha Orçamentária : Exibe a planilha orçamentária de uma obra.
  * Projetos: Lista os projetos de uma obra.
  * Ordem de Serviço: Lista as ordens de serviço de uma obra.
  * Empenho: lista os empenhos de uma obra.
  * Notificar Fornecedor: Entra no caso de uso de notificação de fornecedor.
  * Livro de Ocorrencia: Lista as alterações de status que a obra sofreu.
  * Portaria: Exibe as portarias cadastradas para a obra.
  * Cronogramas: Lista os cronogramas físicos cadastrados para a obra.
  * Processos: Lista os processos relacionados com a obra.
  * Fotografias Associadas à Obra: exibe o álbum de fotográfias da obra.

Diante das opções citadas anteriormente, cade ao usuário selecionar aquela que deseja realizar.


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

Não se aplica.

===== Entidades Persistentes Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.Obra | administrativo.infra.obra |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.EmpenhoObra | adiministrativo.infra.obra_empenho |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.PagamentoObra | adiministrativo.infra.obra_pagamento |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.ProjetosObra | adiministrativo.infra.obra_projeto_pesquisa |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.FonteRecursoObra | adiministrativo.infra.fonte_recurso_obra | 
| br.ufrn.sipac.contratos.dominio.Contrato | adiministrativo.contratos.contrato |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.MovimentoObra | adiministrativo.infra.movimento_obra |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.Medicao | adiministrativo.infra.medicoes |


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

Sistema: SIPAC 

Módulo: Portal da Fundação

Link(s): Portal da Fundação -> Obras -> Relatorios -> Obras por Status

Usuário: wendell (getor de obras da fundação)

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_OBRAS_FUNDACAO


===== Cenários de teste =====

Informar pelo menos o status da obra no formulário de Buscar Requisição e clicar no botão Buscar, então será listada todas as obras relacionadas com o status informado.

Na obra desejada, basta selecionar o ícone de Visualizar o Menu e dentre as opções que aparecerão escolher a opção desejada.

Para verificar se as obras retornadas são as esperadas, basta visualizar a coluna Status, e ver se está de acordo com o status informado.

===== Dados para o teste =====

Informar pelo menos o status da obra.