Busca

Uma só caixa para cada item do roadmap, comentário, lançamento e mensagem de feedback do projeto. Abra com cmd-K (ou ctrl-K), ou clique no campo da barra superior.

Abrir a busca

Duas formas de abrir, os mesmos resultados:

Teclado. cmd-K no macOS, ctrl-K no Windows e Linux. Funciona em qualquer lugar do painel.
Barra superior. O campo de busca sempre visível no painel. Em telas estreitas ele vira um ícone que abre a busca direto.

Os resultados são agrupados por tipo: itens do roadmap primeiro, depois comentários, lançamentos e feedback. Grupos sem resultado escondem o título. As setas navegam, Enter abre, Esc fecha.

O que é buscado

Tipo	Linhas incluídas	Campos
Itens do roadmap	Todos, inclusive arquivados	título, texto, autor, nomes das tags
Comentários	Só aprovados	texto, autor
Lançamentos	Rascunhos e publicados	título, texto, autor
Feedback	Triagem, anexados, arquivados	texto, autor

Comentários pendentes e rejeitados ficam de fora de propósito: texto não revisado nunca aparece na busca, nem para admins. Os e-mails de quem enviou nunca estão nos resultados.

Ordem e trechos

Os resultados são ordenados por onde a busca encontrou: título pesa mais, depois o texto, depois o nome do autor e por fim os nomes das tags. Palavras que aparecem próximas sobem na lista: uma busca de três palavras que caem todas no título ganha de uma que se espalha por um lançamento de 2000 palavras.

Os trechos mostram cerca de 30 palavras em volta do resultado, com destaques em <mark>. Em caso de empate, ganha o mais recente.

Sintaxe da busca

Digite como em qualquer outra busca. Alguns extras funcionam:

"frase exata": aspas duplas exigem as palavras nessa ordem.
-palavra: um sinal de menos na frente exclui o termo.
palavra1 or palavra2: um or literal entre os termos amplia a busca.

Busca vazia não traz resultados: a caixa espera pelo menos um caractere.

Alcance e privacidade

Só para admins. A busca fica dentro do painel com login; visitantes do seu roadmap público não têm acesso.
Por projeto. Um projeto por vez. Trocar de projeto muda os resultados sem fechar a busca.
Limitada. Até 100 resultados por busca. Passou disso, refine a busca. É de propósito: um botão "mostrar mais" daria a entender que paginar é a resposta, e não é.
Com limite de taxa. Digitar ao vivo usa um limite separado e generoso. Chamadas automáticas devem usar debounce.

API de busca

A busca é uma camada fina sobre um único endpoint autenticado:

GET /api/v1/projects/{project_id}/search?q=&limit=

Retorna uma lista de resultados tipados (kind, entity_id, title, snippet, rank, updated_at). O esquema completo e os parâmetros estão na referência OpenAPI em /docs/api.