Filtros avançados

Encontre qualquer registro com filtros rápidos e avançados.

Todas as listagens do novo sistema têm dois níveis de filtro:

  • Barra de filtros rápidos sempre visível no topo
  • Painel avançado acessível pelo botão "Filtros"

Ambos funcionam de forma combinada — os critérios de ambos são aplicados ao mesmo tempo.


Filtros rápidos

  • Barra superior traz os campos mais usados em cada tela.
  • Exemplo em Conta a Pagar: seletor de período, situação e campo de busca por texto.
  • Valores aplicados instantaneamente, sem precisar confirmar.
  • Campo de busca por texto usa fulltext no backend, aceita partes de palavras e ignora maiúsculas/minúsculas.


Painel avançado (gaveta)

  • Clicar em Filtros avançados ou no ícone de funil abre uma gaveta lateral.
  • Contém critérios menos usados: fornecedor, plano de conta, faixa de valor, número de documento, etc.
  • Critérios são cumulativos com os filtros rápidos.
  • Ao aplicar, a gaveta fecha e aparece a contagem de filtros ativos no botão (ex.: "Filtros · 3").


Múltiplas condições combinadas

  • Cada critério tem campo, operador e valor.
  • Permite criar filtros complexos e precisos.


Linguagem natural nos operadores

  • Os operadores do painel avançado e os chips de filtros ativos usam texto claro em vez de símbolos: "é igual a", "é diferente de", "maior que", "contém" — no lugar de =, , >.
  • O operador "Contém" (antes "Contém (case-sensitive)") não menciona mais maiúsculas/minúsculas — a busca sempre ignora isso, só o texto mudou.
  • Nada muda no que é enviado à API: é só a leitura que fica mais clara.


Histórico de buscas

  • O campo de busca por texto das listagens sugere as últimas buscas feitas naquela tela, por empresa.
  • A busca só dispara ao apertar Enter ou clicar na lupa — não a cada tecla digitada, evitando requisições desnecessárias.
  • Remova um item do histórico individualmente pelo x ao lado dele.
  • Navegação completa por teclado: setas para percorrer as sugestões, Enter para selecionar, Esc para fechar.


Período padrão

  • Todas as listagens financeiras abrem no mês corrente.
  • Seletor de período permite:
    • Escolher qualquer mês/ano com setas
    • Selecionar "Todos os períodos" para remover filtro de data
  • Ao selecionar "Todos os períodos", os KPIs de totalizador no topo são ocultados.

Persistência de filtros

  • Filtros não são salvos ao trocar de tela.
  • Mas ao usar o botão Voltar do browser, os filtros anteriores são mantidos (SPA).
  • Estado persiste enquanto a aba não for fechada.

Limpar filtros

  • Botão Limpar na barra