Buscar Sugestões de Repertório

Gerado pelo Writer (Reversa) em 2026-05-11 doc_level: detalhado | Módulo pai: sugestao-repertorio

Visão Geral

Caso de uso que exibe a lista de sugestões de repertório disponíveis, com busca textual fuzzy e filtro por tempo litúrgico, mostrando apenas sugestões com data futura ou presente.

Regras de Negócio

• Apenas sugestões com data ≥ hoje são exibidas 🟢
• Busca fuzzy usa fuse.js no campo titulo com debounce de 500ms 🟢
• Filtro de tempoLiturgico é aplicado após a busca textual 🟢
• Sugestões sem match no calendário são silenciosamente omitidas 🟢

Requisitos Funcionais

ID	Requisito	Prioridade	Critério de Aceite
RF-01	Listar sugestões futuras ordenadas por data	Must	Lista em ordem crescente de data, apenas data ≥ hoje
RF-02	Buscar por título com debounce de 500ms	Should	Input dispara busca após 500ms de inatividade
RF-03	Filtrar por tempo litúrgico via chip	Should	Chip filtra a lista pelo tempo selecionado

Critérios de Aceitação

Dado que há sugestões de repertório no banco local
Quando o usuário acessa a lista
Então apenas sugestões com data >= hoje aparecem, ordenadas por data

Dado que o usuário digita "natal" na busca
Quando o debounce expira (500ms)
Então apenas sugestões com "natal" no título são exibidas

Dado que o usuário seleciona o filtro "Advento"
Quando o filtro é aplicado
Então apenas sugestões de TempoLiturgico.ADVENTO aparecem

Rastreabilidade de Código

Arquivo	Função / Classe	Cobertura
src/view/screen/sugestaoRepertorio/SugestoesRepertorioListaScreen.tsx	SugestoesRepertorioListaScreen	🟢
src/repository/BibliotecaSugestoesRepertorioRepository.ts	findBy	🟢
src/store/SugestoesRepertorio/SugestoesRepertorio.action.ts	carregarLista, buscar	🟢