# ENG-3115 — Situações e padrão de busca nos filtros

**Status:** desenho aprovado para implementação.

## Decisões

- Usar as sete situações descritas no protótipo: rascunho, em contagem, em conferência, aguardando aprovação, aprovado, concluído e reprovado. O estado persistido `iniciado` corresponde semanticamente a “Em contagem”; os demais valores sem produtores reais podem resultar em zero. Isso amplia somente consulta/validação de filtro: não cria transições nem inventários de exemplo.
- Manter enums correspondentes no backend e frontend. A lista de opções de situação será estática, não dependente de situações existentes no banco.
- Aplicar o padrão `SearchFilter` (campo de busca selecionável, entrada com ícone de lupa) aos campos pesquisáveis de responsável, origem, família e produto. A API recebe `search_by` e restringe a busca ao critério escolhido; “Todos” preserva a busca combinada atual.
- Seguir o fluxo de `UsersSearch` na tela Tarefas de Saídas: selecionar diretamente um resultado da lista de sugestões e mostrar a seleção como chip removível, sem um segundo `<select>` nativo. O `UsersSearch` global não será reutilizado diretamente porque não restringe opções aos inventários consultáveis. O autocomplete de inventários continua usando `/inventory/filter-options`, mantém os IDs já aplicados e permite selecionar somente um valor por filtro, conforme o contrato atual.
- Exibir uma única label visível por campo. A label acessível da entrada de busca permanece programática, sem repetir “Buscar …” visualmente. Situação e Tipo continuam filtros de seleção estáticos.
- A busca geral da lista continua combinada por número/código/descrição: já tem uma única label e não pertence aos campos de busca redundantes dentro do painel de filtros.

## Limites

Não implementar estados operacionais, não migrar registros e não adicionar produtores de contagem/conferência/decisão. Valores de situação sem persistência correspondente são filtros válidos que podem retornar lista vazia.

## Validação

Cobrir enum/opções independentes de dados, validação das sete situações, mapeamento `iniciado`/“Em contagem”, busca por critério para cada tipo de opção e seleção direta/removível das sugestões sem um segundo select; validar ausência de labels duplicadas em E2E.
