Documentos com Atraso na Tramitação

Este caso de uso é utilizado por usuários com a permissão de enviar processos/documentos de protocolo e tem a finalidade de listar os documentos que após o recebimento na unidade de destino mais atual excederam o tempo esperado de permanecer na mesma.

Descrição do Caso de Uso

Esse caso de uso é iniciado quando o usuário acessa o caminho: SIPAC → Módulos → Protocolo → Consultas/Relatórios → Relatórios → Documentos com Atraso na Tramitação.

O usuário acessa uma página com um formulário contendo as seguintes opções de busca para gerar o relatório:

Todos os Documentos com Atraso: Tipo LÓGICO.
Tipo de Documento: Tipo - AUTOCOMPLETE, formato: DENOMINAÇÃO DO TIPO, entrada de dados: DENOMINAÇÃO.
Assunto do Documento: Tipo - AUTOCOMPLETE, formato: DENOMINAÇÃO DO TIPO, entrada de dados: DENOMINAÇÃO (RN01).
Unidade de Origem: Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO), entrada de dados: DENOMINAÇÃO ou CÓDIGO.
Unidade de Destino Atual: Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO), entrada de dados: DENOMINAÇÃO ou CÓDIGO.

As seguintes opções de visualização também são apresentadas:

Ordenar por: Formato - são apresentadas as opções Número de Protocolo, Data do Documento e Data de Cadastro, Tipo - TEXTO.
Ordenação: Formato - são apresentadas as opções Crescente e Decrescente, Tipo - TEXTO.

No relatório serão listados os documentos que após o recebimento na unidade de destino mais atual excederam o tempo esperado de permanecer nela.

São exibidas as seguintes informações para cada documento (RN03):

Tipo do Documento: Formato - DENOMINAÇÃO DO TIPO DO PROCESSO (QUANTIDADE), Tipo - TEXTO (RN02).
Assunto do Documento: Formato - CÓDIGO - NOME COMPLETO (QUANTIDADE), Tipo - TEXTO (RN02).
Protocolo: Formato - RADICAL.NÚMERO/ANO-DÍGITOS, Tipo - NUMÉRICO.
Documento: Formato - NÚMERO/ANO, Tipo - NUMÉRICO.
Data de Cadastro: Formato - DD/MM/AAAA, Tipo - DATA.
Destino Atual: Formato - NOME (CÓDIGO), Tipo - TEXTO.
Último Envio: Formato - DD/MM/AAAA, Tipo - DATA.
Último Recebimento: Formato - DD/MM/AAAA, Tipo - DATA.
Tempo Esperado: Formato - 999 dia(s), Tipo - NUMÉRICO.
Data Esperada de Envio: Formato - DD/MM/AAAA, Tipo - DATA.
Atraso: Formato - 999 dia(s), Tipo - NUMÉRICO.
Total Geral: Formato - 999, Tipo - NUMÉRICO.

O relatório é exibido no seguinte formato:

Protocolo	Documento	Data de Cadastro	Destino Atual	Último Envio	Último Recebimento	Tempo Esperado	Data Esperada de Envio	Atraso
TIPO DE PROCESSO / CLASSIFICAÇÃO CONARQ (QUANTIDADE) (RN02)
RADICAL.NÚMERO/AAAA-DV	…9/AAAA	DD/MM/AAAA	NOME DA UNIDADE (CÓDIGO)	DD/MM/AAAA	DD/MM/AAAA	999 dia(s)	DD/MM/AAAA	999 dia(s)
RADICAL.NÚMERO/AAAA-DV	…9/AAAA	DD/MM/AAAA	NOME DA UNIDADE (CÓDIGO)	DD/MM/AAAA	DD/MM/AAAA	999 dia(s)	DD/MM/AAAA	999 dia(s)
…
Total Geral: 999

O caso de uso é finalizado.

Principais Regras de Negócio

RN01 - Esse filtro só é mostrado quando o parâmetro UTILIZA_CLASSIFICACAO_CONARQ estiver ativado.
RN02 - Se o parâmetro UTILIZA_CLASSIFICACAO_CONARQ estiver ativado, os documentos serão agrupados por assunto. Caso contrário, o agrupamento será por tipo de documento.
RN03 - Apenas são listados os documentos cadastrados pela unidade do usuário logado ou aqueles que esta unidade corresponde ao destino anterior ao atual. Não são listados documentos para os quais não foi definido o tempo esperado para permanência na unidade de destino da última tramitação, nem aqueles ainda não recebidos.

Resoluções/Legislações Associadas

Não se aplica.

Classes Persistentes e Tabelas Envolvidas

Classe	Tabela
br.ufrn.sipac.protocolo.dominio.Documento	administrativo.protocolo.documento
br.ufrn.sipac.protocolo.dominio.MovimentoDocumento	administrativo.protocolo.movimento_documento
br.ufrn.sipac.protocolo.dominio.ClassificacaoConarq	administrativo.protocolo.classificacao_conarq
br.ufrn.sipac.protocolo.dominio.TipoDocumentoProtocolo	administrativo.protocolo.tipodocumento

Plano de Teste

Sistema: SIPAC

Módulo: Protocolo

Link(s): Consultas/Relatórios → Relatórios → Documentos com Atraso na Tramitação

Usuário: elizabete, marcilia

Papel que usuário deve ter: ProtocoloPapeis.ENVIAR_PROTOCOLO.

Cenários de Teste

Acessar o(s) caso(s) de uso Cadastrar Documento ou Registrar Envio (Saída), e cadastrar/enviar documentos preenchendo o campo Tempo Esperado no Destino (Em Dias).

Em seguida, os documentos devem ser recebidos em suas respectivas unidades de destino.

Por fim, deve-se alterar as datas de envio/recebimento dos mesmos para que fiquem em atraso. O script abaixo decrementa em um mês as datas de recebimento e envio de todas as movimentações do documento informado:

UPDATE protocolo.movimento_documento
SET dataenvioorigem = dataenvioorigem - INTERVAL '1 month', datarecebimentodestino = datarecebimentodestino - INTERVAL '1 month'
WHERE iddocumento IN (
	SELECT iddocumento
	FROM protocolo.documento
	WHERE numero_protocolo = <NÚMERO DO PROTOCOLO AQUI>
	AND ano_protocolo = <ANO DE PROTOCOLO AQUI>
);

Recomenda-se executar o script abaixo toda vez que rodar o script acima para algum documento. O script abaixo decrementa a data de cadastro do documento em um mês. Isso vai evitar que o documento apareça com a data de cadastro no futuro em relação às datas de movimentações do mesmo.

UPDATE protocolo.documento
SET datacadastro = datacadastro - INTERVAL '1 month'
WHERE numero_protocolo = <NÚMERO DO PROTOCOLO AQUI>
AND ano_protocolo = <ANO DE PROTOCOLO AQUI>;

Dados para o Teste

Para ativar/inativar o parâmetro UTILIZA_CLASSIFICACAO_CONARQ, utilize o scripts abaixo no banco COMUM:

UPDATE comum.parametro SET valor = 'true' WHERE nome = 'UTILIZA_CLASSIFICACAO_CONARQ'