~~ODT~~


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

====== Registrar Projeto ======

Este caso de uso é utilizado pelo gestores de projetos com a finalidade de registrar um projeto no sistema que não seja de origem pelo coordenador, ou para registro de termos de cessão de servidores.

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

Este caso de uso inicia quando o usuário acessa //SIPAC -> Projetos/Convênios -> Projetos -> Projetos -> Registrar Projeto//.([[#principais regras de negócio|RN20]])

==== Passo 1 ====

Inicialmente, deve-se informar os dados gerais do projeto:
  * **__Dados Gerais do Projeto__**
    * **Classificação***: Tipo TEXTO. Pode ser ''CONVÊNIO'' ou ''CONTRATO''.([[#principais regras de negócio|RN19]])
    * **Título***: Tipo TEXTO.
    * **Número Externo**: Tipo TEXTO, formato: 9.../AAAA.
    * <del>**Número de Cadastro**: Tipo NUMÉRICO, formato: 9.../AAAA.(Ocultado na tarefa 117218) </del>
    * <del>**Número do Contrato**: Tipo NUMÉRICO, formato: 9.../AAAA. ([[#principais regras de negócio|RN15 e RN17]]) (Ocultado na tarefa 117218) </del>
    * **Previsão de Execução**: Tipo DATA Formato ''DD/MM/AAAA'' a ''DD/MM/AAAA''.([[#principais regras de negócio|RN01]])
    * **Objetivos***: Tipo TEXTO.
    * **Justificativas***: Tipo TEXTO.
    * **Tipo de Documento***: Tipo TEXTO. Pode ser ''Tipo B'', ''Tipo C'', ''CONVÊNIO'', entre outros.
    * **Âmbito***: Tipo TEXTO. Pode ser ''Nacional'' ou ''Internacional''.
    * **Valor do Projeto**: Tipo NÚMERICO.
    * **Tipo do Projeto***: Tipo TEXTO. ([[#Principais Regras de Negócio|RN14]]): ([[#principais regras de negócio|RN20]])
    * **Subtipo do Projeto***: Tipo TEXTO. Pode ser ''CIENTÍFICO E TECNOLÓGICO'' ou ''INSTITUCIONAL'' ou ''GRADUAÇÃO'', entre outros.
    * **Licitação (Modalidade - Número/Ano)**: Formato - XX - 9.../AAAA. Tipo TEXTO e NUMÉRICO. ([[#principais regras de negócio|RN02]])
    * **__Inserir Processo__** ([[#Principais Regras de Negócio|RN13]]):
      * **Número Processo**: Formato - 9.../AAAA. Tipo NÚMERICO.

  * Após buscar um processo serão exibidos os dados do processo encontrado:
    * **__Processo Encontrado__**:
      * **__Número__**: Tipo NUMÉRICO, formato: RADICAL.NÚMERO/ANO-DÍGITOS VERIFICADORES.
      * **__Ano__**: Tipo NUMÉRICO.
      * **__Assunto__**: Tipo TEXTO.
      * //Há a opção de inserir um processo//.

  * Após inserir um processo será exibida uma listagem com os processos já inseridos em que se mostra os seguintes dados:
    * **__Processos Inseridos__**:
      * **__Número__**: Tipo NUMÉRICO, formato: RADICAL.NÚMERO/ANO-DÍGITOS VERIFICADORES.
      * **__Ano__**: Tipo NUMÉRICO.
      * **__Assunto__**: Tipo TEXTO.
      * **__Interessados__**: Tipo TEXTO.
      * //Há também a opção de //Remover// um processo já inserido//.

==== Passo 2 ====

São exibidos os dados do projeto e deve-se adicionar as unidades interessadas:

  * **__Dados Gerais do Projeto__**
    * **__Número de Cadastro__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Valor do Projeto__**: Tipo NUMÉRICO Formato - R$ 999,99.
    * **__Âmbito__**: Tipo TEXTO.
    * **__Tipo do Documento__**: Tipo TEXTO.
    * **__Classificação__**: Tipo TEXTO.
    * **__Tipo de Projeto__**: Tipo TEXTO.
    * **__Número Externo__**: Tipo NÚMERICO. Formato - 9…/AAAA.
    * **__Subtipo de Projeto__**: Tipo TEXTO.
    * **__Período de Execução__**: Tipo DATA. Formato ''DD/MM/AAAA'' a ''DD/MM/AAAA''.
    * **__Título__**: Tipo TEXTO.
    * **__Objetivos__**: Tipo TEXTO.
    * **__Justificativas__**: Tipo TEXTO.

  * **__Adicionar Unidade Interessada__**:
    * **Unidade***: Tipo TEXTO.

  * Ao adicionar unidades interessadas os seguintes dados serão exibidos numa listagem:
    * **__Unidades Inseridas__**:
      * **__Código__**: Tipo NUMÉRICO.
      * **__Nome__**: Tipo TEXTO.
      * //Há também a opção de //Remover// uma unidade que foi adicionada//.

==== Passo 3 ====

Nesse passo são exibidos os dados do projeto e devem ser informados os participantes do projeto:([[#principais regras de negócio|RN16]])

  * **__Dados Gerais do Projeto__**:
    * **__Número de Cadastro__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Valor do Projeto__**: Tipo NUMÉRICO.
    * **__Âmbito__**: Tipo TEXTO.
    * **__Tipo do Documento__**: Tipo TEXTO.
    * **__Classificação__**: Tipo TEXTO.
    * **__Tipo de Projeto__**: Tipo TEXTO.
    * **__Número Externo__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Título__**: Tipo TEXTO.
    * **__Período de Execução__**: Tipo DATA ''DD/MM/AAAA'' a ''DD/MM/AAAA''.
    * **__Subtipo de Projeto__**: Tipo TEXTO.
    * **__Objetivos__**: Tipo TEXTO.
    * **__Justificativas__**: Tipo TEXTO.

  * **__Adicionar Partícipes__**:
    * **__Nome__***: Tipo TEXTO.
    * **__CPF/CNPJ__***: Formato - 999.999.999-99 ou 99.999.999/9999-99. Tipo NUMÉRICO.
    * **__Endereço__**: Tipo TEXTO.
    * **__CEP__**: Formato - 99.999-999. Tipo NUMÉRICO.
    * **__Tipo Convenente__***: Tipo TEXTO. Pode ser ''CONTRATADO'' ou ''CONTRATANTE''.
    * **__Financiador__***: Tipo LÒGICO. Pode ser ''SIM'' ou ''NÃO''.

  * Ao adicionar participantes será exibida uma listagem com os participantes já inseridos:
    * **__Nome__**: Tipo TEXTO.
    * **__Financiador__**: Tipo TEXTO.
    * //Exitem também as opções de //Alterar// ou //Excluir// um partícipe já adicionado//.

==== Passo 4 ====

  * Neste passo do cadastro do projeto, devem ser informadas as origens de recurso. A escolha dessas origens deve ser feita com base nos participantes financiadores do projeto:

  * **__Dados Gerais do Projeto__**:
    * **__Número de Cadastro__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Valor do Projeto__**: Tipo NUMÉRICO.
    * **__Âmbito__**: Tipo TEXTO.
    * **__Tipo do Documento__**: Tipo TEXTO.
    * **__Classificação__**: Tipo TEXTO.
    * **__Tipo de Projeto__**: Tipo TEXTO.
    * **__Número Externo__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Subtipo de Projeto__**: Tipo TEXTO.
    * **__Período de Execução__***: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo DATA.
    * **__Título__**: Tipo TEXTO.
    * **__Objetivos__**: Tipo TEXTO.
    * **__Justificativas__**: Tipo TEXTO.
    * **__Adicionar Origem de Recurso__**
      * **Esfera**: Tipo TEXTO
      * **Origem de Recurso**: Tipo TEXTO
      * **Sub-esfera**: Tipo TEXTO	
      * **Valor**: Tipo NUMÉRICO
      * **Percentual(%)**: Tipo NUMÉRICO
    * **__Origens de Recurso Inseridas__**
      * **__Esfera__**: Tipo TEXTO
      * **__CPF/CNPJ__**: Tipo NUMÉRICO 
      * **__Nome__**: Tipo TEXTO
      * **__Valor__**: Tipo NUMÉRICO
      * **__Perc.(%)__**: Tipo NUMÉRICO
	Exitem também as opções de Alterar ou Excluir um recursos já adicionado.

===Alterar Origem de Recurso===

O Sistema exibe os mesmos dados do passo de Adicionar Origem de Recursos.

===Remover Origem de Recurso===

O Sistema exibe mensagem de confirmação sobre a remoção dos dados de Origem de Recursos selecionados.
==== Passo 5 ====

  * Nesse passo são exibidos os dados do projeto e devem ser informadas as informações necessárias para a conclusão do cadastro:

  * **__Dados Gerais do Projeto__**:
    * **__Número de Cadastro__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Valor do Projeto__**: Tipo NUMÉRICO.
    * **__Âmbito__**: Tipo TEXTO.
    * **__Tipo do Documento__**: Tipo TEXTO.
    * **__Classificação__**: Tipo TEXTO.
    * **__Tipo de Projeto__**: Tipo TEXTO.
    * **__Número Externo__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Subtipo de Projeto__**: Tipo TEXTO.
    * **__Período de Execução__***: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo DATA.
    * **__Título__**: Tipo TEXTO.
    * **__Objetivos__**: Tipo TEXTO.
    * **__Justificativas__**: Tipo TEXTO.
    * **__Dados Complementares do Projeto__**:
      * **Código SIAFI**: Formato - 9999. Tipo NUMÉRICO. ([[#principais regras de negócio|RN05]])
      * **Data de Assinatura***: Formato - DD/MM/AAAA. Tipo DATA.
      * **Prazo de Vigência**: Formato - DD/MM/AAAA. Tipo DATA. ([[#principais regras de negócio|RN04]])
      * **Prazo Prest. de Contas**: Formato - DD/MM/AAAA. Tipo DATA. ([[#principais regras de negócio|RN04]])
      * **Responsável do Setor**: Formato - NOME. Tipo TEXTO.
      * **Coordenador**: Tipo TEXTO. ([[#principais regras de negócio|RN05]])
      * **Vice-Coordenador**: Tipo TEXTO.
      * **Avaliador**: Tipo TEXTO.
      * **Fiscalizador**: Tipo TEXTO.
      * **Observações**: Tipo TEXTO.
      * **Informar Publicação**: Tipo LÓGICO - Formato ''SIM'' ou ''NÃO''.
    * **__Dados da Publicação__**: Caso o usuário deseja informar esses dados, será exibido um form solicitando as informações abaixo.
      * **Data***:  Formato - DD/MM/AAAA. Tipo DATA.
      * **Local***: Formato - DENOMINAÇÃO. Tipo TEXTO.
      * **Informar Local***: Tipo TEXTO. Este campo só será necessário caso o local selecionado seja do tipo ''OUTRO''.
      * **Seção***: Tipo TEXTO.
      * **Página***: Tipo NUMÉRICO.
      * **Arquivo**: É possível anexar um arquivo.

==== Passo 6 ====

  * **__Informações do Projeto__**:
    * **__Descrição do Projeto__**:
      * **__Classificação__**: Tipo TEXTO.
      * **__Número de Registro__**: Formato - 9999.99.9999. Tipo NUMÉRICO.
      * **__Número de Cadastro__**: Formato - 9999.99.9999. Tipo NUMÉRICO.
      * **__Título do Projeto__**: Tipo TEXTO.
      * **__Período de Execução__**: Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo DATA.
      * **__Valor do Projeto__**: Tipo NUMÉRICO.
      * **__Objetivos__**: Tipo TEXTO.
      * **__Justificativa__**: Tipo TEXTO.
      * **__Tipo de Documento__**: Tipo TEXTO.
      * **__Âmbito__**: Tipo TEXTO.
      * **__Tipo Convênio__**: Formato - TIPO DO PROJETO - SUBTIPO DO PROJETO. Tipo TEXTO.
      * **__Licitação__**: Formato - XX - 99/AAAA. Tipo TEXTO e NUMÉRICO. ([[#principais regras de negócio|RN06]])
    * **__Processos Inseridos__**: ([[#principais regras de negócio|RN07, RN13]])
      * **__Número__**: Formato - 99999.999999/AAAA-99.
      * **__Ano__**: Formato - AAAA. Tipo NUMÉRICO.
      * **__Assunto__**: Tipo TEXTO.
    * **__Unidades Interessadas__**:
      * **__Código__**: Formato - 99999. Tipo NUMÉRICO.
      * **__Nome__**: Tipo TEXTO.
    * **__Partícipes Inseridos__**:
      * **__Nome__**: Formato - NOME - CPF/CNPJ - TIPO CONVENENTE.
      * **__Origens de Recurso Inseridas__** 
      * **__Esfera__**: Tipo TEXTO
      * **__CPF/CNPJ__**: Tipo NUMÉRICO
      * **__Nome__**: Tipo TEXTO
      * **__Valor__**: Tipo NUMÉRICO
      * **__Perc.(%)__**: Tipo NUMÉRICO
    * **__Dados Complementares do Projeto__**:
      * **__Data de Assinatura__**: Formato - DD/MM/AAAA. Tipo DATA.
      * **__Responsável do Setor__**: Tipo TEXTO. ([[#principais regras de negócio|RN08]])
      * **__Coordenador__**: Tipo TEXTO. ([[#principais regras de negócio|RN09]])
      * **__Telefone__**: Formato - 99999999. Tipo NUMÉRICO. ([[#principais regras de negócio|RN09]])
      * **__E-mail__**: Tipo TEXTO. ([[#principais regras de negócio|RN09]])
      * **__Vice-Coordenador__**: Tipo TEXTO. ([[#principais regras de negócio|RN10]])
      * **__Telefone__**: Formato - 99999999. Tipo NUMÉRICO. ([[#principais regras de negócio|RN10]])
      * **__E-mail__**: Tipo TEXTO. ([[#principais regras de negócio|RN10]])
      * **__Avaliador__**: Tipo TEXTO. ([[#principais regras de negócio|RN11]])
      * **__Telefone__**: Formato - 99999999. Tipo NUMÉRICO. ([[#principais regras de negócio|RN11]])
      * **__E-mail__**: Tipo TEXTO. ([[#principais regras de negócio|RN11]])
      * **__Fiscalizador__**: Tipo TEXTO. ([[#principais regras de negócio|RN12]])
      * **__Telefone__**: Formato - 99999999. Tipo NUMÉRICO. ([[#principais regras de negócio|RN12]])
      * **__E-mail__**: Tipo TEXTO. ([[#principais regras de negócio|RN12]])
    * **__Dados da Publicação__**: 
      * **__Data__**:  Formato - DD/MM/AAAA. Tipo DATA.
      * **__Local__**: Formato - DENOMINAÇÃO. Tipo TEXTO.
      * **__Informar Local__**: Tipo TEXTO. Este campo só será necessário caso o local selecionado seja do tipo ''OUTRO''.
      * **__Seção__**: Tipo TEXTO.
      * **__Página__**: Tipo NUMÉRICO.
      * **__Arquivo__**: Tipo TEXTO.
    * //Há as opções de Registrar e Registrar e Efetivar.//

==== Passo 7 ====

  * Ao Registrar ou Registrar e Efetivar um projeto, será mostrada uma tela com os seguintes dados do projeto confirmando a operação:

  * **__Dados Gerais do Projeto__**:
    * **__Novo Número__**: Tipo NUMÉRICO. Formato - 9999.99.9999.
    *	**__Contrato__**: Tipo NUMÉRICO. Formato - 9..../9999 ([[#principais regras de negócio|RN17]])
    * **__Número de Cadastro__**: Tipo NUMÉRICO. Formato - 9..../9999
    * **__Valor do Projeto__**: Tipo NUMÉRICO.    
    * **__Âmbito__**: Tipo TEXTO.
    * **__Tipo do Documento__**: Tipo TEXTO.
    * **__Classificação__**: Tipo TEXTO.
    * **__Tipo de Projeto__**: Tipo TEXTO.
    * **__Número Externo__**: Tipo NUMÉRICO. Formato - 9…/AAAA.
    * **__Subtipo de Projeto__**: Tipo TEXTO.
    * **__Título__**: Tipo TEXTO.
    * **__Objetivos__**: Tipo TEXTO.
    * **__Justificativas__**: Tipo TEXTO.
É possível também //[[desenvolvimento:especificacoes:sipac:projetos_convenios:casos_de_uso:projetos:projetos_em_andamento:anexar_remover_documentos:anexar_remover|Anexar Documento]]//, //Imprimir Comprovante//  e //Gerar Processo no Protocolo//.

O caso de uso é finalizado.
===== Principais Regras de Negócio =====
 listados todos os almoxarifados, senão serão listados apenas os almoxarifados que podem atender a requisição de acordo com a unidade requisitante.
  * **RN01** - Independente da classificação os campos **Previsão de Início da Execução** e **Previsão de Fim da Execução** serão obrigatórios.
  * **RN02** - Somente se a classificação for do tipo ''Contrato'', então o campo ''Licitação (Modalidade - Número/Ano)'' será mostrado e é obrigatório.
  * **RN03** - Se a classificação for do tipo ''Convênio'', então o campo **Código SIAFI** será mostrado e se o valor do projeto for maior que zero, então ele será obrigatório.
  * **RN04** - Se a classificação for do tipo ''Convênio'', os campos **Prazo de Vigência** e **Prazo Prest. de Contas** serão mostrados. E o **Prazo de Vigência** será obrigatório.
  * **RN05** - Se o tipo do projeto não for ''ESTÁGIO'', então o campo **Coordenador** será obrigatório, caso contrário não será obrigatório.
  * **RN06** - Somente se a classificação for do tipo ''Contrato'', então o campo **Se a classificação for do tipo ''Contrato'',** será mostrado.
  * **RN07** - A subtabela dos ''Processos Inseridos'' será mostrada se pelo menos um processo tiver sido inserido no projeto.
  * **RN08** - O campo **Responsável do Setor** só será exibido caso tenha sido informado durante o fluxo do caso de uso.
  * **RN09** - Os campos **Coordenador**, **Telefone** e **E-mail** só serão exibidos caso tenha sido informado o coordenador durante o fluxo do caso de uso.
  * **RN10** - Os campos **Vice-Coordenador**, **Telefone** e **E-mail** só serão exibidos caso tenha sido informado o vice-coordenador durante o fluxo do caso de uso.
  * **RN11** - Os campos **Avaliador**, **Telefone** e **E-mail** só serão exibidos caso tenha sido informado o avaliador durante o fluxo do caso de uso.
  * **RN12** - Os campos **Fiscalizador**, **Telefone** e **E-mail** só serão exibidos caso tenha sido informado o fiscalizador durante o fluxo do caso de uso.
  * **RN13** - Caso o parâmetro UTILIZA_PROTOCOLO_SIPAC esteja configurado como false, o sistema solicitará ao usuário a informação do processo no formato 99999.999999/9999-99 (radical.número/ano-dv). Não será criado um processo em protocolo, pois o módulo esta desativado.
  * **RN14** - O campo **Tipo do Projeto** lista os tipos que tem permissão avulso igual a true ( ESTÁGIO E FINANCEIRO). Ou seja, no combox só irá aparece os itens do tipo que tem na tabela contrato.tipo_projeto a coluna "permite_registro_avulso" igual a true.
  * <del>**RN15** - Se a classificação for do tipo Contrato, então sera apresentado o campo ''Número do Contrato''.</del>
  * **RN16** - Apenas apresentado o passo, caso o projeto tenha valor declarado.  
  * <del>**RN17** - Caso não seja informado o número do contrato o sistema gera automaticamente ao fim do registro do projeto.</del>
  * **RN18** - Quando o usuário possuir papel de GESTOR PROJETOS SRI, só será permitido informar o âmbito internacional.
  * **RN19** - Quando o usuário possuir o papel //SipacPapeis.GESTOR_PROJETOS_CESSAO_SERVIDOR// a //classificação// do projeto deverá ser fixa como //Convênio//;
  * **RN20** - Quando o usuário possuir o papel //SipacPapeis.GESTOR_PROJETOS_CESSAO_SERVIDOR// o //Tipos de Projeto// só deve aparecer as opções //Financeira// e //Outras Ações Acadêmicas//.
  * **RN21** - O papel //SipacPapeis.GESTOR_PROJETOS_CESSAO_SERVIDOR// não pode ser associado aos papeis SipacPapeis.GESTOR_PROJETOS E/OU SipacPapeis.GESTOR_PROJETOS_SRI.
==== Resoluções/Legislações Associadas ====

Não se Aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.convenios.dominio.Projeto | administrativo.patrimonio.projeto |
| br.ufrn.sipac.cadastro.dominio.Pessoa | administrativo.comum.pessoa |
| br.ufrn.sipac.convenios.dominio.Ambito | administrativo.convenios.ambito |
| br.ufrn.sipac.convenios.dominio.ParticipeProjeto | administrativo.convenios.participe_projeto |
| br.ufrn.sipac.convenios.dominio.TipoConvenente | administrativo.convenios.tipo_convenente |
| br.ufrn.sipac.convenios.dominio.Convenio | administrativo.convenios.convenio |
| br.ufrn.sipac.protocolo.dominio.Processo | administrativo.protocolo.processo|


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

Sistema: SIPAC

Módulo: PROJETOS/CONVÊNIOS

Link(s): SIPAC -> Projetos/Convênios -> Projetos -> Projetos -> Registrar Projeto

Usuário: fabiobarreto

Papel que usuário deve ter: GESTOR_PROJETOS e/ou SipacPapeis.GESTOR_PROJETOS_SRI ou SipacPapeis.GESTOR_PROJETOS_CESSAO_SERVIDOR

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

Verificar se o projeto está sendo cadastrado corretamente, para isso basta acessar a [[desenvolvimento:especificacoes:sipac:projetos_convenios:casos_de_uso:projetos:consultas:consulta_geral_de_projetos|Consulta Geral de Projetos]] e buscar pelo projeto recém criado.


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

Não se aplica.