~~ODT~~

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

====== Assinar Documentos ======

Este caso de uso tem a finalidade de assinar documentos escritos no sistema. Essa funcionalidade é utilizada pelos servidores da instituição.

Pré condição: Ter documentos pendentes de assinatura do usuário logado.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Protocolo -> Processos -> Assinatura -> Assinar Documentos//.

Ao acessar o caso de uso todos os documentos são listados exibindo os seguintes dados:

  * **Número/Ano**: Formato: 9.../Ano. Número sequencial gerado para cada tipo.
  * **Processo Associado**: Número do processo, caso o documento esteja anexo.
  * **Protocolo do Documento**: Número de protocolo do documento, caso tenha sido gerado deforma avulsa.
  * **Tipo do Documento**: Tipo do documento definido no cadastro.
  * **Data**: Data de cadastro do documento.

Cada um dos documentos encontrados terão as opções de //Visualizar//, //Alterar//, //Assinar// e //Remover//.

  * **Visualizar Documento**: Visualiza o texto do documento.
  * **Assinar Documento**: Opção para assinar o documento.
    * **Cargo**: Combo com a listagem dos cargos que o usuário possui.
    * **Senha**: Senha de acesso do usuário logado.
  * **Alterar Documento**: Habilita a alteração do documento. ([[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:processos:cadastro:cadastrar_processo#descricao_do_caso_de_uso|Passo 3 do cadastro de processo]])
  * **Cancelar Documento**: Cancela o documento. ([[#principais_regras_de_negócio|RN01]])

O caso de uso é finalizado.

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

  * **RN01** - Opção disponível apenas se o documento tiver um único assinante.
  * **RN02** - Quando o último assinante do documento cadastrar a assinatura, o status do documento é alterado de PENDENTE DE ASSINATURA para ATIVO.
  * **RN03** - Ao selecionar a Função de assinatura: (1) se for uma atividade, será setada a coluna id_atividade na tabela protocolo.autenticador_documento. (2) Se for um Cargo (última opção do combobox), será setada a coluna id_cargo.
  * **RN04** - Só é permitido Cancelar documentos que possuam um único assinante (ou seja, apenas o próprio usuário logado).
  * **RN05** - Ao Cancelar o documento, é enviado um e-mail ao usuário que cadastrou o documento (exceto se foi o próprio que cancelou).
  * **RN06** - Após remover assinantes de um documento, caso não haja mais nenhum usuário pendente de assinatura, o status do documento é alterado de PENDENTE DE ASSINATURA para ATIVO. 
  * **RN07** - Ao Alterar ou Cancelar um documento, é cadastrado um registro mudança no documento. É possível visualizar estas mudanças no popup de visualizar documento.
  * **RN08** - Um documento deve ter pelo menos um assinante.
  * **RN09** - A cada alteração do documento escrito, caso o texto do documento seja alterado, uma nova versão será criada.
  * **RN10** - Não é possível alterar documentos do tipo TERMO DE JUNTADA (seja ele apensação, anexação e desapensação) ou DESPACHO.
==== Resoluções/Legislações Associadas ====

  * [[http://www.planalto.gov.br/ccivil_03/_Ato2015-2018/2015/Decreto/D8539.htm|Decreto 8539 de 8 de outubro de 2015]]

<ifauth@admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.protocolo.dominio.AutenticadorDocumento | administrativo.protocolo.autenticador_documento |

<\ifauth>
====== Plano de Teste ======

Sistema: SIPAC

Módulo: Protocolo

Link(s): Processos -> Assinatura -> Assinar Documentos

Usuário: narasouza

Papel que usuário deve ter: Qualquer papel que dê acesso ao módulo

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

**Cenário 1:**

[[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:documentos:cadastro:cadastrar_documento|Cadastrar Documento]], selecionando a opção de escrever documento. Logar com um servidor de assinatura informado no passo anterior e Assinar o documento.

=> Verificar na tabela protocolo.autenticador_documento se foram persistidas corretamente as colunas data_autenticacao, registro_autenticadao e o cargo ou atividade da assinatura.

=> Verificar se o status do documento foi alterado para ATIVO quando o último usuário cadastrar a assinatura

**Cenário 2:**

Realizar o mesmo procedimento acima, mas assinando vários documentos de uma vez (selecionando pelos checkboxes).

**Cenário 3:**

[[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:documentos:cadastro:cadastrar_documento|Cadastrar Documento]], selecionando a opção de escrever documento. Logar com um servidor de assinatura informado no passo anterior e Alterar o documento.

=> Verificar se os dados são alterados corretamente

=> Verificar se foi registrada uma movimentação de alteração no documento

=> Verificar se, ao remover os usuários que estão pendentes de assinatura, o status do documento é alterado para ATIVO

**Cenário 4:**

[[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:documentos:cadastro:cadastrar_documento|Cadastrar Documento]], selecionando a opção de escrever documento. Logar com um servidor de assinatura informado no passo anterior e Cancelar o documento.

=> Verificar se o status do documento é alterado para CANCELADO

=> Verificar se é registrado na tabela documento.autenticador_documento as colunas data_inativacao e registro_inativacao relacionadas ao documento cancelado.
===== Dados para o Teste =====

[[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:documentos:cadastro:cadastrar_documento|Cadastrar Documento]]