Vista Documentos

Visão geral

A vista Documentos é uma biblioteca de documentos para uma feature: um layout mestre-detalhe com um painel explorador (árvore de agrupamento) à esquerda, cartões de documento ao centro, e um painel de pré-visualização à direita. Cobre o carregamento (seletor de ficheiros ou digitalização por câmara no telemóvel), pré-visualização, transferência, organização por arrastar e largar, operações em massa, e extração estruturada por AI.

Em ecrãs estreitos (<600px) o explorador recolhe para uma gaveta e selecionar um documento troca o corpo para a pré-visualização.

Explorador (agrupamento)

O explorador agrupa documentos ao longo de um eixo. O eixo escolhido, os nós recolhidos e a pasta ativa são todos guardados por utilizador e por vista, e sincronizam entre dispositivos.

Eixo	Agrupa por	Aceita arrastar e largar
Coluna	Até 3 colunas aninhadas, construindo uma árvore de categorias	Sim — move o documento para a pasta onde foi largado
Tipo	Tipo de ficheiro (PDF, imagem, …) — derivado	Não
Data	Mês de carregamento — derivado	Não
Estado	Estado de staging da AI (Por processar, Pendente, A processar, Em staging, Rascunho, Validado, Duplicado, Importado, Ignorado, Erro) — só é mostrado quando há um workflow de AI configurado	Não

Arrastar um cartão para um nó de Coluna atualiza os valores de coluna da linha para corresponder ao caminho completo da pasta (todos os níveis). Quando a alteração empurraria o documento para fora do filtro atualmente ativo na vista (os mesmos filtros de coluna/pesquisa que a vista aplica, avaliados pelo motor de filtros — não a pasta do explorador), aparece uma notificação de 5 segundos com uma ação Anular — o filtro em si nunca é alterado.

O explorador tem o seu próprio campo de pesquisa para filtrar a lista de pastas por nome; isto é separado da pesquisa principal de documentos.

Trilho de navegação

Quando uma pasta está ativa, aparece uma barra de trilho de navegação acima dos cartões de documento, mostrando o caminho ativo completo, por exemplo:

Todos os documentos › Categoria A › Sub-categoria B

Clicar em Todos os documentos limpa a pasta ativa e mostra todos os documentos.

Layout e preferências persistidas

Em ecrãs largos, os três painéis (explorador, cartões, pré-visualização) são separados por divisores arrastáveis. Pode:

• Redimensionar os painéis do explorador (esquerda) e da pré-visualização (direita) arrastando os seus limites.
• Ocultar ou mostrar cada painel usando os botões de alternância no cabeçalho.

Tudo isto — larguras dos painéis, se cada painel está visível, o eixo de agrupamento escolhido, e a ordem de ordenação — é guardado por utilizador e por vista, e acompanha-o entre dispositivos.

Carregar documentos

O carregamento está sempre disponível a partir do cabeçalho (não só no estado vazio):

• Carregar — abre o seletor de ficheiros (permite vários ficheiros; restringido por Extensões permitidas quando configurado). Cada ficheiro torna-se um novo registo, com o ficheiro mapeado para a coluna de documento da vista.
• Digitalizar (apenas Android/iOS) — digitaliza páginas com a câmara:
  • Uma página → integrada imediatamente como um registo.
  • Várias páginas → abre-se uma caixa de diálogo de agrupamento. Páginas consecutivas pertencem ao mesmo documento; use o chip Novo doc. para dividir. Cada documento com várias páginas é fundido num único PDF (por exemplo, uma fatura de 3 páginas torna-se um único PDF com as 3 páginas) — um documento, um registo.

Os carregamentos falhados mostram uma notificação de erro por ficheiro com uma ação Tentar de novo; os ficheiros bem-sucedidos nunca são revertidos.

Modos de exibição

Modo	Descrição
Lista	Lista compacta com os detalhes do ficheiro em linhas
Grelha	Grelha de miniaturas com número de itens por linha configurável (predefinição: 3)
Largura completa	Cada documento ocupa a largura total

O modo escolhido é guardado por utilizador e sobrepõe-se à predefinição do admin sem a alterar.

Pesquisa e ordenação

O botão Pesquisar no cabeçalho abre um campo de pesquisa. A pesquisa verifica, por documento:

• O nome do ficheiro.
• O texto OCR ("texto extraído") — o texto captado a partir do próprio documento.
• Os valores dos campos extraídos/estruturados ("dados extraídos"), verificados recursivamente — apenas os valores, nunca os nomes dos campos.

Não verifica outras colunas do registo (os mapeamentos de título/subtítulo controlam apenas o que um cartão mostra, não o que a pesquisa consulta). Os acentos são ignorados, pelo que escrever "informacao" também encontra "informação". Os resultados atualizam-se à medida que escreve; quando uma correspondência vem do OCR ou de dados extraídos, o painel de pré-visualização mostra uma secção Correspondência com os excertos correspondentes destacados, e a secção Texto extraído (quando presente) destaca o termo em linha.

A ordenação está disponível através do botão de ordenação no cabeçalho:

Opção
Nome	Alfabética pelo nome do ficheiro
Data	Por data de carregamento
Tamanho	Por tamanho do ficheiro

Cada uma pode ser alternada entre ascendente e descendente. A ordenação escolhida é guardada por utilizador e sobrepõe-se à predefinição do admin.

Etiquetas dos cartões

A etiqueta de cada cartão é configurável no separador Cabeçalhos da configuração da vista:

• Coluna de título — quando definida e não vazia na linha, substitui o nome do ficheiro como título do cartão (o nome do ficheiro passa para a linha de meta-informação)
• Coluna de subtítulo — texto descritivo secundário
• Colunas adicionais — valores extra acrescentados à linha de meta-informação
• Tamanho do ficheiro / data de carregamento / carregado por — ativados pelas definições correspondentes

Sem uma coluna de título, o cartão mostra o nome do ficheiro.

Ações do documento

Cada documento expõe o mesmo conjunto de ações de documento único, acessível a partir de dois locais:

Menu de opções do cartão (o botão ⋮ em cada cartão):

Ação	Notas
Pré-visualizar	Seleciona o documento, mostrando-o no painel de pré-visualização
Abrir registo	Abre o registo subjacente
Descarregar	Transferência por URL assinado (oculto quando enableDownload está desativado)
Copiar nome	Copia o nome do ficheiro para a área de transferência
Renomear	Altera apenas o nome de exibição — o ficheiro armazenado não é tocado
Copiar ligação	Copia uma ligação assinada partilhável para a área de transferência
Substituir	Ver Substituir um ficheiro abaixo
Editar páginas	Apenas PDFs — ver Editar páginas de PDF abaixo
Apagar	Remove o ficheiro do armazenamento e limpa a linha (é necessária confirmação; oculto quando enableDelete está desativado)

Barra de ferramentas do painel de pré-visualização (quando um documento está selecionado): expandir em ecrã completo, transferir, Substituir, e Editar páginas como botões de ícone, mais um menu Mais com Renomear, Copiar nome, e Copiar ligação.

Substituir um ficheiro

Substituir troca o ficheiro de um documento no mesmo lugar: carrega o novo ficheiro, elimina a extração de AI associada, e repõe o estado de staging do documento para "Por processar" — não desencadeia reprocessamento por si só. Uma caixa de diálogo de confirmação explica isto antes de escolher o ficheiro de substituição, e é mostrado o progresso enquanto o carregamento/patch decorre. Esta ação não pode ser anulada.

Editar páginas de PDF

Editar páginas abre um editor de páginas para documentos PDF. Por página, pode:

• Rodar — rodar 90°
• Remover — eliminar a página (desativado quando resta apenas uma página)
• Reordenar — arrastar páginas para uma nova ordem
• Juntar PDF — anexar as páginas de outro PDF que escolher

Selecione uma ou mais páginas através da respetiva caixa de verificação para as Separar num documento totalmente novo (a seleção deve incluir algumas, não todas, as páginas).

O botão Aplicar só fica ativo depois de fazer uma edição real ao plano de páginas (rodar/remover/reordenar/juntar — selecionar páginas por si só não conta) e pede confirmação: substitui o ficheiro atual pelas páginas editadas e elimina a extração associada, e não pode ser anulado. Separar também pede confirmação antes de mover as páginas selecionadas para o novo documento.

Seleção e ações em massa

Premir continuamente (ou tocar, quando já existe uma seleção) alterna um documento na seleção múltipla. Aparece uma barra flutuante na parte inferior com:

Ação	Descrição	Ativação por configuração
Selecionar todos	Estende a seleção a todos os documentos visíveis (mostrado enquanto restam alguns por selecionar)	—
Descarregar	Transferência por URL assinado de cada ficheiro selecionado	enableDownload
Processar com AI	Executa o workflow de AI configurado em cada documento selecionado	Workflow de AI configurado + coluna de documento definida
Apagar	Remove os ficheiros do armazenamento e limpa as linhas (é necessária confirmação)	enableDelete

Cmd/Ctrl+F abre o campo de pesquisa. Esc fecha primeiro um campo de pesquisa aberto; se a pesquisa já estiver fechada, limpa a seleção múltipla; se não houver seleção múltipla, limpa a seleção da pré-visualização.

Painel de pré-visualização

Selecionar um cartão mostra a pré-visualização integrada (renderização de PDF/imagem, tabela de metadados). A barra de ferramentas e o menu de opções expõem as ações por documento descritas em Ações do documento acima.

Processamento por AI

Defina Workflow AI (o separador AI da configuração da vista) para um workflow que contenha a ação AI — processar documento.

Quando há um workflow de AI configurado:

• Aparece um botão Processar com AI no painel de pré-visualização e na barra de ações em massa para documentos não processados.
• Um chip de estado ao vivo acompanha a execução: Em fila → A processar (n) → Processado / Erro — sem necessidade de atualização manual.
• Re-processar volta a executar um documento já num estado terminal (concluído/erro). Cada nova tentativa produz uma entrada de registo distinta; o botão fica desativado enquanto uma execução está em fila ou em curso.
• O eixo de agrupamento Estado fica disponível no explorador, permitindo ver rapidamente quantos documentos estão pendentes, em processamento, concluídos, ou em erro.

Ordenação e filtragem

Definição	Opções
Pesquisa	Verifica o nome do ficheiro, o texto OCR, e os valores dos campos extraídos/estruturados (ver Pesquisa e ordenação)
Ordenar por	Nome, Data, ou Tamanho — ascendente ou descendente; persistido por utilizador
Filtros	Filtros base do admin + filtros avançados por utilizador
Extensões permitidas	Restringe carregamentos/exibição a tipos de ficheiro específicos (por exemplo, só PDFs)