~~ODT~~

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

====== Registrar Ocorrência ======

Este caso de uso é utilizado pelos gestores de contratos com a finalidade de gerar um livro de ocorrência de um determinado contrato, permitindo adicionar observações que devem ser registradas ao longo da vigência do contrato. O processo é realizado quando ocorre algum tipo de ocorrência contratual. 

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Contratos -> Aba Geral -> Contrato -> Outros -> Registrar Ocorrência. 

O sistema solicita e o usuário informa:

  * **Número***: Tipo NUMÉRICO.
  * **Ano do Contrato***: Tipo NUMÉRICO, formato: AAAA.


O sistema exibe os dados dos contratos, conforme parâmetros informados na pesquisa. Os atributos apresentados são:

  * **__Número__**: Formato 9.../AAAA, Tipo - NUMÉRICO.
  * **__Empresa__**: Tipo - TEXTO.
  * **__Tipo__**: Os tipos de contrato são ''ACADÊMICO'', ''DESPESA/GLOBAL'', ''DESPESA/ORDINÁRIO'' ou ''RECEITA''.
  * **__Cadastro__**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **__Login Cadastro__**: Tipo - TEXTO.


Ao selecionar o contrato desejado, o sistema exibe os seguintes dados do contrato:
  * **__Número do Contrato__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  * **__Licitação__**: Tipo TEXTO, formato: SIGLA LICITAÇÃO - 9.../AAAA.
  * **__Tipo do Contrato__**: Tipo TEXTO.
  * **__Subtipo do Contrato__**: Tipo TEXTO.
  * **__Contratado__**: Tipo TEXTO, formato: CPF ou CNPJ -  DENOMINAÇÃO CONTRATADO.
  * **__Data de Início__**: Tipo DATA, formato: DD/MM/AAAA.
  * **__Data de Término__**: Tipo DATA, formato: DD/MM/AAAA.
  * **__Continuado__**: Tipo TEXTO.

O sistema solicita ao usuário os dados da Ocorrência:

  * **Data***: Formato - DD/MM/AAAA, Tipo - DATA. Corresponde ao data da ocorrência do contrato.
  * **Descrição***: Tipo - TEXTO.
  * **Documentos Associados**: Tipo - TEXTO.
  * **Providências/Observações**.: Tipo - TEXTO.
  * **Arquivo**: Tipo - TEXTO ( [[#principais_regras_de_negócio|RN02]] )
  * **Notificar Fiscal do Contrato:** Tipo - LÓGICO. Quando esta opção for marcada o sistema deve enviar as providências tomadas para os fiscais do contrato.

O sistema exibe a lista dos arquivos associados durante a inclusão da ocorrência com os atributos:
  * **__N__º**.: Tipo - NUMÉRICO. Formato - Sequencial.
  * **__Nome Arquivo__**: Tipo - TEXTO.
  * O sistema disponibiliza a opção para remover para registro associado.

O sistema exibe lista de ocorrências inseridas com atributos:
  * **__Data__**: Tipo - TEXTO. Corresponde a data da ocorrência informada no cadastro.
  * **__Ocorrência__**: Tipo - TEXTO. Descrição da ocorrência informada no cadastro.

O sistema disponibiliza as opções de Alterar e Remover ( [[#principais_regras_de_negócio|RN05]] )  para cada ocorrência inserida ( [[#principais_regras_de_negócio|RN04]] ). A opção de visualizar á apresentada se existir arquivo anexo.

O usuário confirma o cadastro e o sistema

O Caso de Uso é finalizado.   

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

  * **RN01** - Os registros da ocorrência devem ser inseridos automaticamente com a origem TIPO FISCAL.
  * **RN02** - É permitido anexar qualquer tipo de arquivo, um ou mais arquivos.
  * <del>**RN03** - Na edição de uma ocorrência é desativada a anterior, se mantendo um histórico somente na base de dados e criada uma nova ocorrências com os dados atualizados.</del>
  * **RN04** - Na remoção de uma ocorrência é somente desativada.
  * **RN05** - O usuário logado pode apenas alterar ou remover as ocorrências inseridas por ele.
==== Resoluções/Legislações Associadas ====

"Não se Aplica".  

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

^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.Contrato           | administrativo.contratos.contrato            |
| br.ufrn.sipac.contratos.dominio.OcorrenciaContrato | administrativo.contratos.ocorrencia_contrato |

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

Sistema: SIPAC

Módulo: Contratos

Link(s): Aba Geral -> Contrato -> Outros -> Registrar Ocorrência (Gestor Contratos)

Usuário: rcsl

Papel que usuário deve ter: SipacPapeis.GESTOR_CONTRATO, SipacPapeis.GESTOR_FATURAS, SipacPapeis.GESTOR_CONTRATOS_GESTORA.

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

Efetuar cadastro de um registro de Ocorrência através do caminho:

SIPAC -> Contratos -> Aba Geral → Contrato → Outros → Registrar Ocorrência 

Deve-se atentar para as regras de negócios descritas no caso de uso. Confronta-las.

Para saber se o cadastro foi realizado com sucessão, alem da listagem exibida no próprio caso de uso, pode ser verificado no caminho:

SIPAC -> Contratos -> Aba Fiscal/Área demandante → Gerais → Livro de Ocorrências 

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

Para se cadastrar um registro de ocorrência deve ter um contrato já cadastrado no sistema, para obter um contrato, o testador pode encontrar pelo caminho:

SIPAC -> COntrato -> Aba Consulta/Relatório -> gerais -> Listar Contratos