Fechamento | Download de múltiplos arquivos

Contexto

Os arquivos de comprovantes são enviados aos clientes e, com a mudança para salvá-los automaticamente no Portal, a funcionalidade de download de múltiplos arquivos na tela de detalhe do processo contribuirá para ganho de tempo da equipe responsável e do próprio cliente.

O download deverá considerar arquivos individuais, e os limites de quantidade de arquivos e tamanho total suportado poderão ser definidos em conjunto com a engenharia.

Critérios de aceite

1. Seleção de arquivos/pasta

• Usuário consegue selecionar um ou mais arquivos de uma mesma pasta para realizar o download
• O botão de seleção deve permanecer sempre visível em cada arquivo
• A opção Selecionar / Desselecionar todos deve ser exibida ao usuário
• A seleção múltipla deve considerar apenas arquivos pertencentes à mesma pasta
• Quando todos os arquivos forem selecionados manualmente, a opção "Selecionar todos" deve refletir o estado selecionado
• Ao acionar "Selecionar todos", todos os arquivos da pasta devem ser selecionados
• Se "Selecionar todos" estiver ativo e o usuário desselecionar um ou mais arquivos manualmente, o estado de "Selecionar todos" deve ser desmarcado
• Se houver seleção parcial e o usuário acionar "Selecionar todos", todos os arquivos devem ser selecionados novamente
• Se todos os arquivos estiverem selecionados e o usuário acionar "Selecionar todos", todos os arquivos devem ser desmarcados
• Permitir que o usuário faça o download da pasta inteira, sem precisar abri-la

2. Ação de download

• Após a seleção de ao menos um arquivo, a ação de download deve ser habilitada
• Quando nenhum arquivo estiver selecionado, a ação de download deve permanecer desabilitada
• O download dos arquivos selecionados é realizado em uma única ação, com os arquivos sendo baixados individualmente
• Os limites de quantidade e tamanho serão definidos com Engenharia
• Arquivos devem estar sem corrupção e manter extensão original

3. Feedback e acompanhamento

• Durante o download, o Portal deve exibir o retorno visual (ver referência)
• Deve exibir o progresso no formato realizada / total
• Ao final, deve confirmar sucesso ou erro
• Em caso de falha parcial, os arquivos disponíveis devem ser baixados
• A mensagem deve indicar quais arquivos tiveram erro

4. Comportamento da interface

• O atalho de visualização deve estar no canto superior direito do bloco do arquivo
• Deve manter comportamento de abrir detalhes na lateral
• A seleção deve ser mantida ao abrir detalhes e ao fechar a lateral
• Após download, a seleção deve ser mantida

7. Compatibilidade e permissões

• Não deve impactar upload múltiplo existente
• Usuários com acesso à aba de Arquivos podem baixar

Cenários de teste (BDD)

Contexto base — usuário na tela de detalhe do processo, com permissão para visualizar a aba de Arquivos, e arquivos existentes numa mesma pasta.

1. Habilitar download com seleção — ao selecionar pelo menos um arquivo, a ação de download é habilitada.
2. Download desabilitado sem seleção — sem nenhum arquivo selecionado, a ação permanece desabilitada.
3. Selecionar todos via ação — ao acionar "Selecionar todos", todos os arquivos são selecionados.
4. Refletir seleção total manual — ao marcar todos manualmente, a opção "Selecionar todos" reflete o estado marcado.
5. Desmarcar ao remover item — desselecionar um arquivo de uma seleção total desmarca "Selecionar todos".
6. Seleção total a partir de parcial — acionar "Selecionar todos" com seleção parcial seleciona todos.
7. Alternar total para nenhum — acionar "Selecionar todos" com tudo marcado desmarca todos.
8. Realizar download — acionar o download com itens selecionados baixa todos em uma única ação.
9. Exibir progresso — download iniciado exibe realizados / total.
10. Falha parcial — erro em um ou mais arquivos: baixa os disponíveis e informa os com erro.
11. Integridade dos arquivos — após o download, arquivos mantêm extensão original e não estão corrompidos.
12. Permissão de acesso — usuário com acesso à aba consegue selecionar e baixar.
13. Usuário sem permissão — sem permissão, não visualiza arquivos nem download.

Solução

Adicionei na aba Arquivos da tela de Detalhe Processo:

• Checkbox grande no canto superior-esquerdo do cartão de cada arquivo — sempre visível, não escondido em hover
• Toolbar fixa acima dos arquivos com "Selecionar todos" (estado parcial / total / nenhum) + ação Baixar selecionados (N) que fica disabled sem seleção
• Botão Baixar pasta inteira sempre disponível ao lado da toolbar — atalho pra download da pasta sem precisar abrir
• Toast/banner de progresso X de Y baixados fixo no canto inferior-direito durante a operação
• Banner pós-download mostra resumo: ✓ sucesso, ⚠️ falha parcial com lista de arquivos com erro
• Ícone olho mantido no canto superior-direito do cartão (não conflita com checkbox)
• Detalhe lateral preserva a seleção ao abrir/fechar

Outcomes

Concluída no Jira em maio/2026. Implementação pela engenharia (assignee: Henrique Silva). Os 13 cenários BDD definidos no ticket estão refletidos no protótipo navegável que está na v1.1.0 da tela Detalhe Processo.

Próximo passo (medição pós-rollout): cronometrar tempo real de envio de comprovantes ao cliente antes/depois e validar se a hipótese de ~8min → menos de 1min se confirma.

Link Jira: PRJ-5559 — Fechamento | Download de múltiplos arquivos