~~ODT~~

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

====== Alterar Situação do Projeto ======

Este caso de uso é utilizado pelos gestores de projetos para alterar a situação de uma proposta de projeto. Projetos que possuem prazo de execução expirado têm os seus status automaticamente alterados para vencido pelo TimerProjetosPrazoExpirado ([[#principais_regras_de_negócio|RN01]]). 


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

O caso de uso inicia-se ao acessar o caminho //Sipac -> Projetos/Convênios -> Projetos -> Projetos em Andamento -> Alterar Situação do Projeto.//

==== Passo 1 - Opções para Consulta de Projeto(s)=====
Inicialmente, o sistema exibe as seguintes opções de busca para os projetos:

 Os passos de consultar os projetos e visualizar seus detalhes, são os mesmo que o caso de uso [[desenvolvimento:especificacoes:sipac:projetos_convenios:casos_de_uso:projetos:consultas:consulta_geral_de_projetos|Consulta Geral de Projetos]].

  * //Há também a opção de Selecionar Projetos.//


====Passo 2 - Selecionar Projeto====

Ao selecionar um projeto serão exibidos os seguintes dados:

  * **__Informações Gerais__**
    * **__Dados da Proposta de Projeto__**:
      * **__Número/Ano__** Formato - 9999/AAAA. Tipo NUMÉRICO.
      * **__Tipo do Projeto__**: Tipo TEXTO.
      * **__Projeto__**: Tipo TEXTO.
      * **__Objetivo__**: Tipo TEXTO.
      * **__Justificativa__**: Tipo TEXTO.
      * **__Metodologia__**: Tipo TEXTO.
      * **__Objetivos Específicos__**: Tipo TEXTO.
      * **__Proponente__**: Tipo TEXTO.
      * **__Concedente__**: Tipo TEXTO.
      * **__Situação__**: Tipo TEXTO.
    * //Há também a opção de visualizar a proposta.//
====Passo 3 - Alterar Situação da Proposta de Projeto====
  * **__Alterar Situação da Proposta de Projeto __** ([[#principais_regras_de_negócio|RN02 e RN03]])
    * **Nova Situação da Proposta***: Tipo TEXTO. Pode ser ''APROVADO'', ''ATIVO'', ''PENDENTE ANÁLISE FUNDAÇÃO'', ''AGUARDANDO DOCUMENTOS'', entre outros.
    * **Observações sobre a alteração***: Tipo TEXTO.
    * **Confirmar Senha***: Tipo SENHA. Confirmar a senha do usuário.
====Passo 4 - Visualizar Proposta====
Ao selecionar a opção de visualizar a proposta, será exibida uma tela conforme descrito em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_projeto | Visualizar Projeto ]]
  * //Há também as opções de imprimir declarações e imprimir relatório geral.//

Ao selecionar a opção de imprimir declarações será exibido um arquivo com as declarações relacionando a legislação correspondentes. 

O caso de uso é finalizado.

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

  * **RN01** - Existe um timer que roda diariamente sobre este caso de uso afim de alterar o status para VENCIDO dos projetos com fim de execução exiparado.  
  * **RN02** - Quando o usuário muda a situação do projeto para **RETORNADO PARA AJUSTE**, o usuário que cadastrou o projeto irá receber uma e-mail informado que o projeto retornou para ajustes.
  * **RN03** - Quando o usuário muda a situação do projeto para **RETORNADO PARA AJUSTE**, um extrato do projeto é gerado e associado a esse retorno, servindo como histórico antes do ajuste.
  * **RN04** - Caso a instituição não possua o SIGED instalado em seus ambientes, será necessário acessar o link: SIGAdmin -> Config. do Sistema -> Manutenção  os Sistemas e desmarque a opção de //Ativo// para o //SIGED// e salvar.
==== Resoluções/Legislações Associadas ====

Não se aplica.


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

^ Classe ^ Tabela |
| br.ufrn.sipac.convenios.dominio.Projeto  | administrativo.convenios.projeto  |
| br.ufrn.sipac.convenios.dominio.Convenio  | administrativo.convenios.convenio  |
| br.ufrn.sipac.convenios.dominio.ClassificacaoConvenio | administrativo.convenios.classificacao_convenio |
| br.ufrn.sipac.convenios.dominio.TipoDocConvenio | administrativo.convenios.tipo_documento_convenio |
| br.ufrn.sipac.cadastro.dominio.Unidade | administrativo.comum.unidade |
| br.ufrn.sipac.cadastro.dominio.Pessoa | administrativo.comum.pessoa |
| br.ufrn.sipac.convenios.dominio.ConvenenteTipoConvenente | administrativo.convenios.convenente_tipo_convenente |


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

Sistema: SIPAC

Módulo: Projetos/Convênios

Link(s): Aba Projetos -> Projetos em Andamento -> Alterar Situação do Projeto

Usuário: fabiobarreto

Perfil: Docentes e/ou Chefe de Departamento

Papel que usuário deve ter: SipacPapeis.GESTOR_PROJETOS


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

  * Verificar se o fluxo do caso de uso está funcionando corretamente.
  * Focar os testes nas **RN02** e **RN03**.
    * 1. Retornar para ajuste um projeto pelo caso de uso de Alterar Situação do Projeto (SIPAC → Projetos/Convênios → Projetos → Projetos em Andamento → Alterar Situação do Projeto)
    * 2. Verificar o arquivo de extrato na consulta do projeto, ele ficará entre os dados das Alterações de Situação do Projeto (Aparecerá um link para visualizar)


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

  * Para verificar os dados dos projetos, pode-se utilizar a consulta abaixo:

<code sql>
  SELECT * FROM convenios.projeto
</code>

  * Para testar o timer:
  * Buscar os projetos que deveriam estar vencidos:

<code sql>
        SELECT * FROM convenios.projeto where tipo = 2 and status not in (1,2,5,9,17) and fim_execucao < CURRENT_DATE
</code>

  
      * Executar o timer:


<code sql>
UPDATE infra.registro_timer
SET ultima_execucao = null, executar_agora=true
WHERE classe = 'br.ufrn.sipac.projetos.timers.TimerProjetosPrazoExpirado';
</code>

  

  * Após executar, verifique se o timer já foi executado olhando se os atributos ultima_execucao != null e executar_agora = false. Executar o primeiro passo novamente para verificar se os projetos foram alterados.
  

  * Caso atualmente não haja projetos que deveriam estar vencidos, é possível alterar a data do fim de execução de um projeto indo no caso de uso Projetos -> Projetos -> Editar Projetos.