diff --git a/SUGESTOES_UI.md b/SUGESTOES_UI.md new file mode 100644 index 0000000..ddf7232 --- /dev/null +++ b/SUGESTOES_UI.md @@ -0,0 +1,113 @@ +# Sugestões de Melhoria — Fluxo da Interface + +**Data:** 02/03/2026 + +--- + +## 1. Indicador de progresso das etapas + +O fluxo possui 3–4 passos bem definidos (`Importando → ConfigurandoColunas → ExibindoResultado`), mas não há nenhum indicador visual de onde o usuário está. + +**Sugestão:** Adicionar um breadcrumb simples no topo de todas as telas: + +``` +① Arquivo ② Colunas ③ Resultado +``` + +O passo atual ficaria destacado. Isso orienta o usuário sobre o que falta sem exigir nenhuma regra de negócio adicional. + +--- + +## 2. Unificar importação e configuração de colunas em um único painel + +Atualmente o caminho é: +1. Selecionar arquivo → clicar **"▶ Configurar Colunas"** +2. Configurar colunas → clicar **"▶ Importar e Analisar"** + +São 3 ações separadas para chegar à análise. + +**Sugestão:** Mover as configurações CSV/XLSX para a mesma tela de importação como uma seção expansível ("Configurações avançadas"), deixando o botão principal como **"▶ Importar e Analisar"** direto. + +--- + +## 3. Pré-visualização das primeiras linhas do arquivo + +Após selecionar o arquivo, o usuário precisa alternar entre a aplicação e a planilha para descobrir quais índices correspondem a cada campo. + +**Sugestão:** Exibir as primeiras 3–5 linhas do arquivo em uma tabela simples logo após a seleção, para que o usuário identifique visualmente o índice de cada coluna sem sair do app. + +--- + +## 4. Confirmação ao clicar em "Nova Análise" + +O botão **"< Nova Análise"** em `resultado.rs` executa `app.notas_importadas.clear()` imediatamente, sem nenhum modal de confirmação. Um clique acidental descarta o resultado atual sem aviso. + +**Sugestão:** Exibir modal de confirmação com a mensagem: +> "Deseja iniciar uma nova análise? O resultado atual será descartado." + +Botões: **Confirmar** | **Cancelar** + +--- + +## 5. Reorganizar seções do resultado + +A ordem atual das seções em `resultado.rs` é: + +``` +Totais → Faltantes → Duplicatas +``` + +O objetivo principal do software é detectar faltantes e duplicatas; os totais são informação complementar. + +**Sugestão:** Inverter para: + +``` +Faltantes → Duplicatas → Totais +``` + +Isso coloca a informação mais relevante no topo da tela. + +--- + +## 6. Seletor de layout também na tela de configuração de colunas + +O dropdown de layouts está disponível apenas em `import.rs`. O usuário frequentemente percebe que precisa de um layout diferente **depois** de visitar a tela de configuração e ver os campos. + +**Sugestão:** Duplicar o seletor de layout no topo de `configuracao_colunas.rs`, evitando que o usuário volte à tela anterior só para trocar o layout. + +--- + +## 7. Botão "Salvar como layout..." na tela de configuração + +Para salvar um layout atualmente o usuário precisa navegar para `GerenciandoLayouts`. Esse desvio quebra o fluxo principal. + +**Sugestão:** Adicionar um botão **"💾 Salvar como layout..."** diretamente em `configuracao_colunas.rs` que abre um modal simples pedindo apenas o nome do layout. Internamente, chama o mesmo use case `salvar_layout`. + +--- + +## 8. Feedback visual durante a análise + +A transição `ConfigurandoColunas → ExibindoResultado` pode demorar com arquivos grandes (até 100k registros, conforme RNF03). Atualmente o app não exibe nenhum sinal enquanto processa, parecendo travado. + +**Sugestão:** Adicionar o estado `Analisando` no `EstadoApp` (já previsto no IMPLEMENTACAO.md mas não implementado) e exibir uma mensagem simples tipo: + +``` +⏳ Analisando... aguarde. +``` + +Mesmo sem progresso percentual, já elimina a percepção de travamento. + +--- + +## Resumo de Impacto + +| # | Sugestão | Impacto UX | Esforço estimado | +|---|----------|------------|-----------------| +| 1 | Breadcrumb de etapas | Médio | Baixo | +| 2 | Unificar importação + configuração | Alto | Médio | +| 3 | Pré-visualização do arquivo | Alto | Médio | +| 4 | Confirmação em "Nova Análise" | Baixo | Baixo | +| 5 | Reordenar seções do resultado | Médio | Baixo | +| 6 | Seletor de layout em configuração | Médio | Baixo | +| 7 | Salvar layout na tela de configuração | Médio | Baixo | +| 8 | Feedback durante análise | Alto | Baixo |