~~ODT~~

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

====== Autuar Processo ======

Um processo é um documento ou um conjunto de documentos que exige um estudo mais detalhado, bem como procedimentos expressados por despachos, pareceres técnicos, anexos ou, ainda, instruções para pagamento de despesas. 

Autuar um processo consiste em receber um documento que envolva uma decisão administrativa. Considera-se autuação o ato de reunir documentos em processo. Com a autuação, o documento protocolado passa a ter curso próprio, chamando-se "PROCESSO".

Esse caso de uso tem a finalidade de realizar a autuação de um processo.

É utilizado por servidores habilitados a realizar o cadastro de processos protocolados ou documento nas unidades.

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

Esse caso de uso se inicia quando o usuário acessa o caminho: //SIPAC -> Protocolo -> Processos -> Cadastro -> Autuar Processo//.

=== Passo 1 ===

O caso de uso começa com o usuário acessando o sistema e buscando pelo documento que deseja autuar no processo. Para essa busca são apresentadas os seguintes filtos:

  * **Protocolo**: Formato - 99999.999999/AAAA-99 [RADICAL.NÚMERO-ANO/DÍGITO VERIFICADOR], Tipo - NUMÉRICO.
  * **Código de Barras**: Formato - 99999.999999/AAAA-99 [RADICAL.NÚMERO-ANO/DÍGITO VERIFICADOR], Tipo - NUMÉRICO.
  * **Origem**: Formato - INTERNA | EXTERNA, Tipo - TEXTO.
  * **Número/Ano**: Formato - 9999/AAAA, Tipo -	NUMÉRICO.
  * **Ano do Documento**: Formato - AAAA, Tipo - NUMÉRICO.
  * **Assunto do Documento**: Formato - CÓDIGO | DENOMINAÇÃO , Tipo - AUTOCOMPLETE.
  * **Tipo do Documento**: Formato - DENOMINAÇÃO DO TIPO DE DOCUMENTO, Tipo - TEXTO.
  * **Unidade de Origem**: Formato - CÓDIGO DA UNIDADE | NOME DA UNIDADE, Tipo - AUTOCOMPLETE.
  * **Órgão Externo de Origem**: Formato - NOME DO ÓRGÃO EXTERNO, Tipo - AUTOCOMPLETE.
  * **Período do Documento**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **Período do Cadastro**: Formato - DD/MM/AAAA, Tipo - DATA.
  * **Todos os Documentos**: Tipo - LÓGICO
  * **__Dados da Última Movimentação__**:
    * **Unidade de Origem**: Formato - CÓDIGO DA UNIDADE | NOME DA UNIDADE, Tipo - AUTOCOMPLETE.
    * **Órgão Externo de Origem**: NOME DO ÓRGÃO EXTERNO, Tipo - AUTOCOMPLETE.
    * **Período do Envio**: Formato - DD/MM/AAAA, Tipo - DATA.
    * **Período do Recebimento**: Formato - DD/MM/AAAA, Tipo - DATA.

Apenas os documentos que estão na unidade do usuário serão listados abaixo ([[#Principais Regras de Negócio|RN01]]). Na listagem são mostrados os seguintes dados do documento:

  * **__Protocolo__**: Formato - 99999.999999/AAAA-99 [RADICAL.NÚMERO-ANO/DÍGITO VERIFICADOR], Tipo - NUMÉRICO. 
  * **__Número__**: Tipo - TEXTO. 
  * **__Ano__**: Formato - AAAA, Tipo - NUMÉRICO. 
  * **__Data de Cadastro__**: DD/MM/AAAA, Tipo - DATA.
  * **__Tipo do Documento__**: Formato - DENOMINAÇÃO DO TIPO DE DOCUMENTO, Tipo - TEXTO.
  * **__Origem__**:  Tipo - TEXTO, a Origem pode ser uma Unidade Interna ou um Órgão Externo, assim, temos os seguintes formatos possíveis:
    * Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE).
    * Formato - NOME DO ÓRGÃO EXTERNO (UF - ESFERA ADMINISTRATIVA).
  * **__Assunto do Documento__**:  CÓDIGO DO ASSUNTO (999.999) - DENOMINAÇÃO DO ASSUNTO, Tipo - TEXTO. Caso o documento apresente uma classificação Conarq.
  * **__Assunto do Memorando__**:  Tipo - TEXTO. Caso o documento seja um memorando eletrônico.
  * **__Assunto__**: Formato - NÃO DEFINIDO, Tipo - TEXTO. Caso os dois caso acima não seja observado.
  * **__Observação__**: Tipo - TEXTO.
  * Para da documento são apresentadas duas opções:
    * **//Exibir Detalhes//**: que mostras os dados gerais do documento.
    * **//Selecionar Documento//**: ao ser escolhida segue para o fluxo de [[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:processos:cadastro:cadastrar_processo| Cadastro de Processo]], que no caso terá o nome de Autuar Processo. A única mudança em relação ao cadastro de processo é que ao atuar um processo sua origem é interna, assim, no caso de uso a opção de  //Origem// já vem selecionada como //Interna// e não poderá ser alterada. E ao fim do cadastro, o processo apresentará o mesmo protocolo do documento selecionado.


Fim do caso de uso.

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

  * **RN01** - Apenas os documentos na unidade do usuário poderá ser atuado em um processo. Este não poderá já está associado a um processo e, no caso de ser um memorando eletrônico, este deve está autenticado. 
  * **RN02** - Apenas os usuários que apresentam a permissão de cadastrar protocolo na unidade na qual está logado no sistema pode acessar o caso de uso. Ou seja, além de ter o papel de cadastrar protocolo, o usuário deve ter permissão desse papel para a unidade que está acessando o sistema.
  * **RN03** - Caso um memorando seja autuado, este não poderá mais se encaminhado.
==== Resoluções/Legislações Associadas ====

{{:desenvolvimento:especificacoes:sipac:protocolo:portaria_normativa_5-2002.pdf | PORTARIA NORMATIVA Nº 5, DE 19 DE DEZEMBRO DE 2002}}: Dispõe  sobre os procedimentos gerais para utilização  dos  serviços  de  protocolo,  no âmbito  da  Administração  Pública  Federal, para  os  órgãos  e  entidades  integrantes  do Sistema de Serviços Gerais - SISG.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.protocolo.dominio.Processo             | administrativo.protocolo.processo |
| br.ufrn.sipac.protocolo.dominio.Documento            | administrativo.protocolo.documento|
| br.ufrn.sipac.cadastro.dominio.Unidade               | administrativo.comum.unidade  |
| br.ufrn.sipac.protocolo.dominio.OrgaoExternoProtocolo| administrativo.protocolo.orgao_externo_protocolo |
| br.ufrn.sipac.protocolo.dominio.MovimentoDocumento   | administrativo.protocolo.movimento_documento |
| br.ufrn.sipac.protocolo.dominio.ClassificacaoConarq (Assunto)   | administrativo.protocolo.classificacao_conarq |

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

Sistema: SIPAC

Módulo: Protocolo

Link(s): Processos -> Cadastro -> Autuar Processo

Usuário: marcilia, paulinho, bruma

Papel que usuário deve ter: ProtocoloPapeis.CADASTRAR_PROTOCOLO

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

  * Verificar se no final da atuação o protocolo do processo é o mesmo do documento selecionado.

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

Para **RN01**. A consulta abaixo traz os documentos que estão na unidade do usuário os quais não estão associados a um processo e, no caso dos memorandos eletrônicos, este esteja autenticado.

<code sql>
SELECT d.* 
FROM protocolo.documento d
     JOIN protocolo.movimento_documento m ON m.idmovimento_documento = d.id_movimento_atual
     JOIN comum.unidade u ON u.id_unidade = m.codigounidadedestino
WHERE m.datarecebimentodestino IS NOT NULL
AND u.codigo_unidade = <CÓDIGO DA UNIDADE DO USUÁRIO>
AND (d.idtipodocumento != 976 OR (d.idtipodocumento = 976 AND d.data_autenticacao IS NOT NULL)) -- 976: Memorando Eletrônico
AND d.id_processo IS NULL
ORDER BY d.iddocumento;
</code>


Para a **RN02**, podemos usar:

  * Para encontrar usuários com a permissão de cadastrar protocolo e que apresentam mais de uma unidade, usamos : 
<code sql>
SELECT pa.nome, u.login
FROM comum.usuario_unidade uu
     JOIN comum.usuario u ON u.id_usuario = uu.id_usuario
     JOIN comum.pessoa p ON p.id_pessoa = u.id_pessoa
     JOIN comum.unidade un ON un.id_unidade = uu.id_unidade
     JOIN comum.permissao pe ON pe.id_usuario = u.id_usuario
     JOIN comum.papel pa ON pa.id = pe.id_papel
WHERE pe.id_papel = 6
GROUP BY pe.id_unidade_papel, pa.nome, u.login, uu.id_usuario
ORDER BY u.login
</code>

  * Para saber quais das unidades o usuário tem permissão de cadastrar protocolo, usamos:
<code sql>
SELECT pa.nome, u.login, un.codigo_unidade, un.nome
FROM comum.usuario u
     JOIN comum.permissao pe ON pe.id_usuario = u.id_usuario
     JOIN comum.papel pa ON pa.id = pe.id_papel
     JOIN comum.unidade un ON un.id_unidade = pe.id_unidade_papel
WHERE u.login like '<LOGIN DO USUÁRIO>'
AND pe.id_papel = 6
</code>