~~ODT~~



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


====== Cadastrar Medição ======

Este caso de uso tem a finalidade de permitir o cadastro das medições da obra. Envolvidos: Gestores de obras da infraestrutura.

Pré-condições: 

  * A obra deve está cadastrada no sistema.
  * É preciso que o Cronograma tem sido cadastrado.
  * É preciso que o usuário tem permissão de ADMINISTRADOR LOCAL SUPINFRA, GESTOR DE ACOMPANHAMENTO DE OBRAS, GESTOR DE CRONOGRAMA ou FISCAL DE OBRA para executar a funcionalidade.


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

SIPAC -> Infraestrutura -> Aba Obras -> Cronograma Físico -> Cronograma Físico -> Cadastrar Medição.

**Passo 1**

O Usuário faz busca utilizando os seguintes parâmetros:
  * **Modalidade/Número/Ano:** Formato - Sigla da Modalidade (Opções de Molalidade exibidas: CC, CI, CV, DL, IN, PR, TP) / 9... / AAAA / Origem (Opções de Origem: FUNPEC, UFRN e EXTERNO).
  * **Requisição - Número/Ano:** TIPO - NUMÉRICO. Formato - 9.../AAAA.
  * **Empenho - Número/Ano:** TIPO - NUMÉRICO. Formato - 9.../AAAA.
  * **Contrato - Número/Ano:** TIPO - NUMÉRICO. Formato - 9.../AAAA.
  * **Descrição:** TIPO - TEXTO.
  * **Período:** TIPO - DATA, Formato - DD/MM/AAAA a DD/MM/AAAA.

O Sistema exibe a lista de cronogramas encontrados na busca com os atributos:

  * **__Requisição__** TIPO - NUMÉRICO. Formato - 9.../AAAA.
  * **__Empenho:__** TIPO - NUMÉRICO. Formato - 9.../AAAA.
  * **__Contrato__** TIPO - NUMÉRICO. Formato - 9.../AAAA.
  * **__Descrição da obra__** TIPO - TEXTO.
  * **__Licitação__** TIPO - NUMÉRICO. Formato - Sigla  da Modalidade - 9.../AAAA, Origem.

Para cada cronograma, o sistema lista opção de inserir medição. O Usuário seleciona cronograma para incluir medição e o sistema exibe os dados especificados no passo 2.


**Passo 2**

Dados do Cronograma Físico:

  * **__Tipo do Cronograma__:** TIPO - TEXTO.
  * **__Descrição da obra__:** TIPO - TEXTO.
  * **__Modalidade Nº/Ano Origem__:** TIPO - NUMÉRICO. Formato - Sigla  da Modalidade - 9.../AAAA, Origem.
  * **__Contrato__** TIPO - NUMÉRICO, Formato - 9.../AAAA.
  * **__Valor Contratado__:** TIPO - NUMÉRICO.
  * **__Razão Social (Fornecedor)__:** TIPO - TEXTO.
  * **__CPF/CNPJ (Fornecedor)__** TIPO - NUMÉRICO.
  * **__Intervalo de Medições__** TIPO - NUMÉRICO.
  * **__Data do Contrato__:** TIPO - DATA.
  * **__Requisição__** TIPO - NUMÉRICO, Formato - 9.../AAAA.
  * **__Empenho__** TIPO - NUMÉRICO, Formato - 9.../AAAA.
 
O sistema exibe a lista de Fiscais adicionados com Nome e Cargo.

Dados da Medição:
  * **Número da Medição:** TIPO - NUMÉRICO.

O usuário confirma medição e o sistema exibe os serviços inseridos com a quantidade de medições em colunas ( [[#Principais Regras de Negócio| RN01 ]] ).
  * **__Item__:** TIPO - NUMÉRICO.
  * **__Descrição dos serviços__:** TIPO - TEXTO.
  * **__Preco (R$)__:** TIPO - NUMÉRICO.
  * **__Colunas das medições__:** TIPO - NUMÉRICO.
  * **__Total da coluna preço__:** TIPO - NUMÉRICO.

**Passo 3**

O sistema exibe os dados do cronograma físico e lista de fiscais (Nome e Cargo) adicionados.


O Sistema exibe os dados dos serviços de acordo com a medição informada no passo anterior (Prazo das Medições e Número da Medição selecionada).

A lista dos serviços contém os atributos:
  * **__Descrição__**
  * **__Preço em Reais__**
  * **__Número da Medição (Prazo da Medição)__:** Nesta coluna o sistema exibe o valor da medição e o valor executado informado.

  * Para cada serviço na lista, o sistema exibe opção de informar o valor executador em reais.
  * O sistema exibe Valor Total referentes aos preços.  


**Passo 4**

O Sistema exibe os dados do cronograma físico, lista de fiscais da obra, dados dos serviços especificados no passo 3 e solicita ao usuário observação da medição (opcional).

O Sistema solicita confirma do usuário.


**Passo 5**

O usuário confirma dados da medição no passo anterior e sistema exibe a tela de confirma com os dados do cronograma físico, fiscais da obra, serviços inseridos.


O caso de uso é finalizado.
===== Principais Regras de Negócio =====

  * **RN01** - O número da medição informada não pode ser superior a quantidade de medições (quantidade).  (Adicionado em 28/06/2012 referente a tarefa 76687)
  * **RN02** - É possível cadastrar um cronograma mesmo a obra possua um termo de recebimento com os status de definitivo, provisório e provisório parcial.  (Adicionado em 04/07/2012 referente a Tarefa 94214)
==== Resoluções/Legislações Associadas ====

Não se aplica.
===== Classes Persistentes e Tabelas Envolvidas =====


^ Classe ^ Tabela |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.Obra | administrativo.infra.obra |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.PagamentoObra | administrativo.infra.obra_pagamento |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.ProjetosObra | administrativo.infra.obra_projeto_pesquisa |
| br.ufrn.sipac.contratos.dominio.Contrato | administrativo.contratos.contrato |
| br.ufrn.sipac.supinfra.acompanhamento.dominio.CronogramaFisico | administrativo.infra.cronograma_fisico |

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

Sistema: SIPAC

Módulo: infraestrutura

Link(s): Obras -> Cronograma Físico -> Cronograma Físico -> Cadastrar Medição.

Usuário: lane

Papel que usuário deve ter: SipacPapeis.ADMINISTRADOR_LOCAL_SUPINFRA, SipacPapeis.GESTOR_ACOMPANHAMENTO_OBRAS, SipacPapeis.GESTOR_CRONOGRAMA, SipacPapeis.FISCAL_DE_OBRA (o fiscal somente através do portal administrativo).
===== Cenários de Teste =====

Não se aplica.


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

Para verificar se uma obra possui termo de recebimento usar a consulta abaixo:

<code sql>
   
  Select termo.num_termo, termo.ano_termo FROM infra.obra obra 
  INNER JOIN infra.termo_recebimento termo ON (obra.id_obra=termo.id_obra)
	WHERE obra.num_contrato=NUM_CONTRATO AND obra.ano_contrato=ANO_CONTRATO AND termo.id_tipo= ID_DO_TIPO
	--ID dos TIPO PROVISORIO = 1         DEFINITIVO = 2         PROVISORIO_PARCIAL = 3;
  
</code>