Histórias do usuário · Processos

Histórias do cadastro e do espelho

As histórias se referem ao mesmo cadastro de Processo. O CRUD do registro principal e as operações dos registros relacionados têm limites próprios; “completo” não implica CRUD de movimentações ou de histórico. As histórias do cadastro utilizam as operações disponíveis. As histórias US-PRO-007 e US-PRO-008 descrevem a evolução prevista para seleção de origem e migração sob demanda.

US-PRO-001 · Cadastrar processo manualmente

Ator: usuário do Hub.

Necessidade: Registrar um processo diretamente no Hub.

Critérios de aceitação:

Informar Título e Procedimento para criar o processo.
Permitir informar número, situação, núcleos, cliente e entrevista de origem.
Abrir a ficha do registro local criado e utilizá-lo nas operações do módulo.

US-PRO-002 · Localizar e consultar processos locais

Ator: usuário do Hub.

Necessidade: Encontrar um processo já cadastrado e consultar suas informações.

Critérios de aceitação:

Pesquisar o acervo local e consultar o detalhe do resultado escolhido.
Permitir Busca, Procedimento, Situação e Núcleo no acervo atual.
Oferecer o resumo sob demanda no título de cada resultado, sem impedir a abertura da ficha quando o provedor estiver indisponível.
Paginar os resultados respeitando o alcance do usuário.

US-PRO-003 · Alterar processo local

Ator: usuário do Hub.

Necessidade: Manter atualizados os dados editáveis do processo.

Critérios de aceitação:

Alterar os campos manuais do cadastro.
Manter fase, autoria e resumo da última movimentação sob responsabilidade do servidor.
Consultar o histórico das alterações.

US-PRO-004 · Excluir processo local

Ator: usuário do Hub.

Necessidade: Retirar um processo do acervo disponível.

Critérios de aceitação:

Aplicar a autorização de exclusão do processo.
Retirar o registro das consultas usuais por exclusão lógica.
Preservar os registros no banco; restauração não integra o contrato atual.

US-PRO-005 · Manter partes e numerações

Ator: usuário do Hub.

Necessidade: Organizar participantes e identificadores do processo.

Critérios de aceitação:

Listar, adicionar e remover partes e numerações.
Permitir uma parte vinculada a Pessoa ou identificada apenas pelo nome.
Respeitar o limite de uma parte principal e uma numeração principal.
A edição direta dos registros filhos permanece pendente de definição para ampliar o CRUD atual.

US-PRO-006 · Acompanhar movimentações e histórico

Ator: usuário do Hub.

Necessidade: Consultar o andamento e acrescentar movimentações locais ao processo.

Critérios de aceitação:

Registrar data e descrição de uma movimentação local.
Consultar movimentações ordenadas pela data do ato.
Consultar fase derivada e histórico das operações.
Não apresentar alteração ou exclusão de movimentações como operações disponíveis.

US-PRO-007 · Buscar processos no espelho

Ator: usuário do Hub.

Necessidade: Escolher o espelho do Projuris como origem da busca para localizar um processo útil.

Critérios de aceitação:

Permitir informar à API que a pesquisa deve usar o espelho.
Consultar o espelho em lugar do banco interno quando essa origem for escolhida.
Apresentar os resultados externos para escolha do usuário.
Manter a busca separada da incorporação, que pertence à US-PRO-008.

Definições pendentes: filtros e alcance da pesquisa; nome e valores do seletor. Capacidade prevista, sem contrato disponível.

US-PRO-008 · Migrar um processo selecionado

Ator: usuário do Hub.

Necessidade: Incorporar ao Hub um processo útil encontrado no espelho ao interagir com ele.

Critérios de aceitação:

Partir de um processo identificado nos resultados do espelho.
Migrar o processo para o sistema a partir da interação definida para essa finalidade.
Permitir o uso do processo resultante no cadastro local.
Utilizar o mesmo cadastro local da US-PRO-001 após a incorporação.

Definições pendentes: apresentação do comando explícito, dados e vínculos transferidos e contrato de autorização e falhas. A repetição deverá devolver o registro já incorporado sem sobrescrever alterações locais.

Fluxos críticos

Busca externa e incorporação ao Hub

Histórias relacionadas: US-PRO-007 e US-PRO-008.

Condição: o usuário deseja localizar um processo no espelho do Projuris.

O usuário informa à API a escolha do espelho como origem e os critérios de busca.
A API consulta o espelho, em lugar do banco interno, e devolve os resultados.
O usuário identifica um processo útil.
O usuário solicita a incorporação por comando explícito, separado da leitura.
O processo é migrado para o Hub e passa a ser tratado como registro local.

Resultado esperado: o processo escolhido pode ser utilizado no cadastro local.

Alternativas a definir: processo já incorporado, dados insuficientes, perda de acesso e falha durante a transferência. Pesquisa sem resultado não oferece processo para incorporar. Repetição e falha parcial pertencem à mesma operação de incorporação; não são um fluxo adicional de sincronização.

Fora de escopo: atualização contínua pelo espelho e escrita no Projuris.

Consulta externa por Pessoa

História relacionada: US-PRO-007. A consulta associada a uma Pessoa integra a leitura externa; não é uma pré-condição obrigatória para toda busca no legado.

Um consumidor autorizado consulta os processos do espelho associados a uma Pessoa local.
A API verifica o acesso à Pessoa e consulta o espelho pelo vínculo Projuris.
O consumidor autorizado consulta as movimentações de um processo externo.

Resultado: leitura do acervo externo. Esse fluxo ainda não migra nem cria processo local.

Refinamento previsto da listagem e incorporação

A listagem de Processos deixará de duplicar o filtro Número. O filtro Criado por mim ficará no Sheet de filtros avançados. A remoção do filtro duplicado não retirará o número das linhas da listagem.

Os resultados do espelho usarão exatamente o renderizador da listagem nativa, com indicador Projuris, sem componente próprio de listagem. A consulta ficará sob responsabilidade do módulo Projuris Legado.

A incorporação será um comando explícito, separado da leitura. A repetição devolverá a entidade nativa já incorporada sem sobrescrever alterações locais. Processos e Movimentações preservarão o UUID nativo e uma única identidade legada por entidade.