Recherche
Un seul champ pour chaque élément de roadmap?, commentaire, version et retour brut du projet. Ouvrez-le avec cmd-K (ou ctrl-K), ou cliquez sur le champ de la barre du haut.
Ouvrir la recherche
Deux points d'entrée, les mêmes résultats :
- Clavier.
cmd-Ksur macOS,ctrl-Ksur Windows et Linux. Fonctionne partout dans le tableau de bord. - Barre du haut. Le champ de recherche toujours visible du tableau de bord. Sur les petits écrans, il devient une icône qui ouvre directement la recherche.
Les résultats sont groupés par type : éléments de roadmap d'abord, puis commentaires, versions et retours. Les groupes sans résultat masquent leur titre. Les flèches naviguent, Entrée ouvre, Échap ferme.
Ce qui est cherché
| Type | Lignes incluses | Champs |
|---|---|---|
| Éléments de roadmap | Tous, archivés compris | titre, texte, auteur, noms des tags |
| Commentaires | Approuvés uniquement | texte, auteur |
| Versions | Brouillons et publiées | titre, texte, auteur |
| Retours | Tri, rattachés, archivés | texte, auteur |
Les commentaires en attente ou rejetés sont exclus volontairement : un texte non relu n'apparaît jamais dans la recherche, même pour les admins. Les adresses e-mail des expéditeurs ne figurent jamais dans les résultats.
Classement et extraits
Les résultats sont classés selon l'endroit où ils correspondent : le titre compte le plus, puis le texte, puis le nom de l'auteur, puis les noms des tags. Les mots proches les uns des autres remontent : une recherche de trois mots tous dans le titre passe devant une recherche éparpillée dans une version de 2000 mots.
Les extraits montrent environ 30 mots autour de la correspondance, surlignés avec <mark>. À égalité, le plus récent l'emporte.
Syntaxe
Tapez comme dans n'importe quel champ de recherche. Quelques extras fonctionnent :
"phrase exacte": les guillemets imposent les mots dans cet ordre.-mot: un signe moins devant exclut le terme.mot1 or mot2: unorlittéral entre les termes élargit la recherche.
Une recherche vide ne renvoie rien : le champ attend au moins un caractère.
Portée et confidentialité
- Réservée aux admins. La recherche vit dans le tableau de bord connecté ; les visiteurs de votre roadmap publique n'y ont pas accès.
- Par projet. Un projet à la fois. Changer de projet change les résultats sans refermer la recherche.
- Plafonnée. Jusqu'à 100 résultats par recherche. Au-delà, affinez la recherche. C'est voulu : un bouton « voir plus » laisserait croire que paginer est la solution, et ce n'est pas le cas.
- Limitée en débit. La saisie en direct a sa propre limite, généreuse. Les appels automatisés doivent utiliser un debounce.
API de recherche
La recherche est une fine couche au-dessus d'un seul endpoint authentifié :
GET /api/v1/projects/{project_id}/search?q=&limit=
Renvoie une liste de résultats typés (kind, entity_id, title, snippet, rank, updated_at). Le schéma complet et les paramètres sont dans la référence OpenAPI sur /docs/api.