====== Alerta de Vencimento dos Contratos ======

Este caso de uso envia uma mensagem a cada 30 dias aos envolvidos (Fiscais ativos do contrato e responsáveis) nos contratos que estão no prazo de alerta de vencimento. 

Esse prazo corresponde ao valor definido no momento do cadastro de um contrato (por exemplo [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:cadastrar_editar_contrato:academico|Contrato Acadêmico]])

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

O Timer verifica uma vez por mês os contratos que estão dentro do prazo de alerta de vencimento.

Após obter todos os contratos é disparado um e-mail para cada fiscal ativo, fornecedor e e-mails que devem ser alertados daquele contrato.

Para cada contrato são exibidos:
  * //**Contrato**//. Formato 99/2009. Tipo : NUMÉRICO
  * //**UG do Contrato**//. Tipo - TEXTO.
  * //**Vigência**//. Formato DD/MM/AAAA a DD/MM/AAAA. Tipo : DATA
  * //**Dias para Vencimento**//. Tipo : NUMÉRICO
  * //**Licitação**//. Formato 	DL 20025/2009. Tipo : TEXTO E NUMÉRICO
  * //**Contratado**//. 08.469.280/0001-93 - FUNDAÇÃO NORTE-RIO-GRANDENSE DE PESQUISA E CULTURA - FUNPEC. Tipo : NUMÉRICO e TEXTO
  * //**Objeto**//. Tipo : TEXTO

Modelo do E-mail:

Assunto:
            Alerta de vencimento de Contratos

Corpo:

**Contratos a Vencer**
^ Contrato  | **UG do Contrato**                           ^ Vigência                 ^ Dias para Vencimento  ^ Licitação      ^ Contratado                                                                        ^ Objeto                                                     ^
| 99/2009   | UNIVERSIDADE FEDERAL DO RIO GRANDE DO NORTE  | 01/01/2009 a 02/10/2009  | 2                     | DL 20025/2009  | 08.469.280/0001-93 - FUNDAÇÃO NORTE-RIO-GRANDENSE DE PESQUISA E CULTURA - FUNPEC  | REALIZAR UM PROJETO DE EXTENSAO SOB O TÍTULO "XV CIENTEC"  |
| ...       |                                              | ...                      | ...                   | ...            | ...                                                                               | ...                                                        |


O email é configurado através dos seguintes parâmetros:
  * QUANT_PADRAO_DIAS_ALERTA_VENCIMENTO_CONTRATOS : indica quantos dias antes da data de término da vigência o contrato entrará na listagem da mensagem eletrônica de alerta.

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

  - O timer é executado uma vez por mês.
  - Um contrato só entra na lista do email enviado se na data em que o timer for processado, estiver faltando QUANT_PADRAO_DIAS_ALERTA_VENCIMENTO_CONTRATOS dias para o vencimento do contrato ou caso possua a informação definida no próprio contrato no campo "Quantidade de Dias para Alerta de Vencimento".

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

^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.Contrato       | administrativo.contratos.contrato        |
| br.ufrn.sipac.contratos.dominio.FiscalContrato | administrativo.contratos.fiscal_contrato |


====== 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 =====

  * 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]]. 

  * Para verificar se o fiscal está recebendo o e-mail, associar um novo fiscal definindo um e-mail válido para teste. (O caminho se encontra descrito na área **Dados para o Teste**)

  * Para verificar se a lista de emails está recebendo o alerta, mude o valor do campo E-mails Alertados, no cadastro ou edição de um contrato.

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

Para ver se o resultado esta fornecendo os contratos corretamente o testador pode:

Cadastrar um contratos acessando o caminho:

   * SIPAC -> Módulos Contratos -> Aba Geral -> Cadastrar/Editar Contrato -> Acadêmico 

Editar um contrato já existente acessando o caminho:

   * SIPAC -> Módulos Contratos -> Aba Geral -> Cadastrar/Editar Contrato -> Editar Contrato 

Buscar um contrato já existente acessando o caminho:

   * SIPAC -> Módulos Contratos -> Aba Consulta/Relatórios -> Garais -> Listar Contratos

Associar um fiscal a um contrato acessando o caminho:

   * SIPAC -> Módulos Contratos -> Aba Consulta/Relatórios -> Associações -> Associar Fiscais ao Contrato