====== Consultas Contratos ======

Este caso de uso envia uma mensagem aos fornecedores com as informações semanais sobre contratos. Essas mensagens informam além de contratos cadastrados, movimentações lançadas (aditivo, supressões e etc.) e processos de pagamentos cadastrados na semana.

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

O timer verifica se há registros na semana de contratos cadastrados, movimentações lançadas e processos de pagamento cadastrados. E retorna as informações:
 
  * **__Número e Ano do Contrato__**;
  * **__Número da Licitação__**;
  * **__Nome do Contratado__**;
  * **__Vigência__**;
  * **__Objeto__**;



**Modelo:**

**__Informações semanais sobre Contratos - SIPAC__**
^Contratos Cadastrados na Semana (<data inicial> a <data final>)   ^^^^^
^   Contrato^   Licitação^Contratado^   Vigência   ^Objeto^
|   <número>/<ano>|   <modalidade> <número>/<ano>|<cpf/cnpj> - <nome>|   <data inicial> a <data final>   |<objeto do contrato>|


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

  * **RN01** - O timer será executado no início de toda semana, exibindo informações sobre contratos da semana anterior.

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

^ Classe                                                       ^ Tabela                                         |
| br.ufrn.sipac.arq.timers.TimerConsultasContratos | sistemas_comum.infra.registro_timer |
| br.ufrn.sipac.contratos.dominio.Contrato | administrativo.contratos.contrato |
| br.ufrn.sipac.compras.licitacao.dominio.ModalidadeLicitacao | administrativo.compras.modalidade_licitacao |
| br.ufrn.sipac.contratos.dominio.OperacoesContrato | administrativo.contratos.operacoes_contrato |
| br.ufrn.sipac.contratos.dominio.UnidadeBeneficiada | administrativo.contratos.unidade_beneficiada |
| br.ufrn.sipac.contratos.dominio.NotaUndBeneficiada | administrativo.contratos.notafiscal_unidade |
| br.ufrn.sipac.almoxarifado.entradas.dominio.NotaFiscal | administrativo.contratos.nota_fiscal |
| br.ufrn.sipac.almoxarifado.entradas.dominio.EmpenhoNotaFiscal | administrativo.liquidacao.empenho_notafiscal |
| br.ufrn.sipac.liquidacao.pagamento.dominio.ProcessoPagamento | administrativo.liquidacao.processo_pagamento |
| br.ufrn.sipac.cadastro.dominio.Pessoa | administrativo.comum.pessoa |

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

Sistema: SIPAC

Módulo: <NÃO SE APLICA>

Link(s): <NÃO SE APLICA>

Usuário: <NÃO SE APLICA>

Papel que usuário deve ter: <NÃO SE APLICA>

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

Para o timer definir um tempo curto (sugiro 2 ou 3 minutos) para o timer e o servidor de testes como servidor de restrição de execução. O tempo é definido [[desenvolvimento:arquitetura:documentacao_desenvolvimento#criando_uma_classe_timer|diretamento no banco]]. Monitorar o e-mail de desenvolvimento (desenv@info.ufrn.br) por fornecedor notificado.


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



Para o cadastro de contratos acesse o caminho:

   * Módulos → Contratos → Geral → Contrato → Cadastrar/Editar Contrato → Despesa  

Preencha a data de início, término e de publicação dentro do intervalo da semana atual (no terceiro passo do cadastro).

O e-mail gerado deve mostrar esse contrato recém cadastrado.

A consulta abaixo é equivalente.
<code sql>
SELECT DISTINCT C.NUMERO,C.ANO,C.OBJETO,C.DATA_CADASTRO, C.ID, C.DATA_INICIO, C.DATA_FIM, C.ORIGEM_CONTRATO,  C.NUM_LICITACAO,
 C.ANO_LICITACAO, L.ABREVIACAO AS SIGLA_LICITACAO,   F.CPF_CNPJ, F.NOME AS NOME_PESSOA  
	FROM CONTRATOS.contrato C   INNER JOIN comum.pessoa F ON F.ID_PESSOA = C.ID_FORNECEDOR  
	INNER JOIN COMPRAS.MODALIDADE_LICITACAO L ON L.ID = C.ID_MODALIDADE
        INNER JOIN comum.unidade U ON U.ID_UNIDADE = C.id_unidade_gestora  

        -- data_cadastro = semana atual. Nesse exemplo coloquei a semana de 31/05/2010 a 07/06/2010
	WHERE CAST(C.DATA_CADASTRO AS DATE) >= '2010-05-31'  AND CAST(C.DATA_CADASTRO AS DATE) <= '2010-06-07' AND C.STATUS <> 102 AND U.id_gestora = 605
	ORDER BY C.NUMERO,C.ANO
</code>