Histórias do usuário · Entrevistas

US-ENTREVISTAS-001 · Registrar entrevista

Ator: usuário autenticado com acesso à pessoa cliente.

Necessidade: registrar o atendimento e encaminhar seu relato aos núcleos responsáveis pela análise.

Critérios de aceitação:

Selecionar a pessoa cliente e informar ao menos um núcleo destinatário existente.
Permitir assunto, data do atendimento, relato, estudo inicial e pesquisa de recurso.
Derivar nome e área do assunto a partir do catálogo.
Criar a entrevista em ABERTA, com autor e registro de criação no histórico.
Usar a data corrente em America/Recife quando a data não for informada.
Apresentar a recusa quando a pessoa ou os núcleos não puderem ser utilizados.

US-ENTREVISTAS-002 · Localizar entrevistas

Ator: usuário autenticado que consulta seu acervo de entrevistas.

Necessidade: localizar registros por pessoa, classificação, encaminhamento e situação.

Critérios de aceitação:

Listar apenas entrevistas compreendidas no alcance do usuário e não excluídas.
Combinar busca textual, núcleo, pessoa, situações, área, assunto, marcas e período de cadastro.
Permitir mais de uma situação no mesmo filtro.
Ordenar as entrevistas mais recentes primeiro e carregar páginas seguintes por cursor.
Manter o relato fora do conteúdo pesquisável.

US-ENTREVISTAS-003 · Consultar e corrigir a ficha

Ator: usuário autorizado a acessar e editar a entrevista.

Necessidade: consultar os dados do atendimento e corrigir seu conteúdo sem trocar a pessoa atendida.

Critérios de aceitação:

Exibir pessoa, autor, data, assunto, núcleos, marcas, relato e situação.
Permitir editar núcleos, assunto, data, marcas e relato.
Manter a pessoa cliente fixa após a criação.
Permitir remover o assunto e limpar o relato.
Registrar alterações efetivas no histórico.
Exibir processos relacionados e o dossiê da entrevista, respeitando os acessos de cada recurso.

US-ENTREVISTAS-004 · Acompanhar a situação

Ator: usuário autorizado a alterar a situação da entrevista.

Necessidade: registrar o andamento da análise, sua conclusão, arquivamento ou reabertura.

Critérios de aceitação:

Oferecer as transições devolvidas para o usuário pela API.
Solicitar o estado de destino e permitir justificativa de até 500 caracteres.
Recusar transições fora da tabela e mudanças para o próprio estado.
Aplicar a autorização adicional exigida para reabertura.
Atualizar a ficha e registrar origem, destino e justificativa no histórico.

US-ENTREVISTAS-005 · Consultar histórico e resumo

Ator: usuário com acesso à entrevista.

Necessidade: acompanhar as operações e obter uma síntese do atendimento.

Critérios de aceitação:

Apresentar o histórico em ordem cronológica, com paginação.
Solicitar o resumo a partir do relato e do histórico legível.
Reutilizar o resumo guardado enquanto não houver escrita que o invalide.
Informar falha ou indisponibilidade da geração e permitir nova tentativa manual.

US-ENTREVISTAS-006 · Consultar e juntar documentos

Ator: usuário com acesso à entrevista e às operações documentais correspondentes.

Necessidade: reunir documentos no dossiê da pessoa e relacioná-los ao atendimento.

Critérios de aceitação:

Listar as juntadas relacionadas à entrevista e carregar páginas seguintes.
Permitir selecionar arquivo, categoria e rótulo opcional para uma nova juntada.
Obter a pessoa cliente da entrevista no servidor.
Vincular o documento por relação de tipo entrevista e referência ao UUID da ficha.
Respeitar a autorização própria do documento; acesso à entrevista não concede automaticamente acesso ao arquivo.
Apresentar o resultado de cada operação do envio e da juntada.

US-ENTREVISTAS-007 · Excluir entrevista

Ator: usuário com capacidade de exclusão sobre a entrevista.

Necessidade: retirar um registro do acervo consultável.

Critérios de aceitação:

Disponibilizar a ação conforme canDelete devolvido no detalhe.
Validar a autorização no servidor.
Registrar autor e instante da exclusão lógica e o evento correspondente.
Retirar a entrevista da listagem e impedir sua consulta pelas rotas do registro.

US-ENTREVISTAS-008 · Consultar entrevistas do Projuris

Ator: usuário com acesso à pessoa cliente.

Necessidade: consultar o acervo externo da pessoa junto ao acompanhamento no Hub.

Critérios de aceitação:

Consultar o espelho pela identificação local da pessoa.
Apresentar assunto, cliente, relato, data, situação, responsável e unidade quando disponíveis.
Manter os rótulos externos e o identificador opaco do espelho.
Paginar o acervo externo separadamente das entrevistas nativas.
Informar indisponibilidade da integração, sem apresentar uma falha como acervo vazio.

US-ENTREVISTAS-009 · Profissionalizar o relato com confirmação

Ator: usuário autorizado a editar a entrevista.

Necessidade: revisar a redação do relato antes de gravá-la.

Estado: em implementação na API.

Critérios de aceitação:

A profissionalização devolve uma prévia do relato revisado sem salvar (RN-ENTREVISTAS-014).
O relato revisado só é gravado após a confirmação do usuário.
Título e entrevistador podem ser informados sem serem obrigatórios (RN-ENTREVISTAS-013).

Fluxos críticos

Registro e manutenção da entrevista

Histórias relacionadas: US-ENTREVISTAS-001 e US-ENTREVISTAS-003.

O usuário informa os dados da entrevista.
A API valida a entrada, os núcleos, o assunto e a pessoa legível.
Na criação, atribui autor, situação inicial, data padrão e dados derivados; na edição, aplica apenas os campos enviados.
Persiste o registro e seu evento na mesma transação. Uma edição sem alteração efetiva não acrescenta evento.
O web atualiza a listagem ou a ficha após o sucesso; uma recusa mantém a operação sem confirmação de salvamento.

Transição de situação

História relacionada: US-ENTREVISTAS-004.

A ficha recebe os destinos permitidos para o usuário.
O usuário seleciona destino e justificativa opcional.
A API verifica acesso, autorização de reabertura quando aplicável e validade da transição.
A mudança e seu evento são persistidos na mesma transação.
A ficha é recarregada com o novo estado e as novas capacidades.

Envio e juntada de documento

História relacionada: US-ENTREVISTAS-006.

O usuário seleciona arquivo e categoria.
O servidor consulta a entrevista e obtém sua pessoa cliente.
Envia o arquivo ao serviço de Documentos.
Usa o identificador recebido para criar a juntada no dossiê da pessoa, relacionada à entrevista.
Em sucesso, atualiza o dossiê da ficha.

Alternativa: se o envio funcionar e a juntada falhar, o documento já enviado permanece sem aquela juntada. A interface informa a falha e não repete automaticamente as operações.

Refinamento previsto da busca e incorporação

A busca de Entrevistas terá filtros avançados em Sheet, incluindo o switch Buscar no Projuris. Os resultados externos usarão exatamente o renderizador da listagem nativa, com indicador Projuris, sem componente próprio de listagem.

A consulta ao legado ficará sob responsabilidade do módulo Projuris Legado. Ler ou selecionar um resultado não criará uma Entrevista nativa. A incorporação exigirá comando explícito, autorização e os dados necessários ao domínio; a repetição deverá devolver a Entrevista já incorporada sem sobrescrever alterações locais.

A escolha entre busca exclusiva no espelho e busca combinada com a base nativa permanece pendente.