Status: done
En tant que Transformateur, je veux rechercher des idées par mots-clés dans le backlog, afin de retrouver rapidement une idée spécifique parmi plusieurs soumissions.
Given je suis sur la vue liste du backlog (Story 3.2) When je consulte la zone de filtres Then un champ de recherche par mots-clés est visible (placeholder : "Rechercher une idée…") And le champ est positionné en tête du panneau de filtres existant
Given je saisis des mots-clés dans le champ de recherche
When j'ai saisi au moins 1 caractère (avec debounce ~300 ms)
Then la liste du backlog est filtrée pour n'afficher que les idées dont le titre (llmTitle), la description (problemDescription), le domaine (llmDomain), le type IA (llmAiType) ou le département (department) contient les mots-clés (insensible à la casse)
And la recherche se combine avec les filtres existants (statut, domaine, contributeur, non-prioritaires) via logique AND
Given le champ de recherche contient du texte When je consulte le champ Then un bouton "Effacer" (icône ×) est visible pour réinitialiser la recherche uniquement And cliquer sur "Effacer" vide le champ et restaure la liste complète (les autres filtres restent actifs)
Given aucune idée ne correspond à la recherche
When la requête retourne 0 résultats alors qu'un searchQuery est actif
Then un message "Aucune idée ne correspond à votre recherche." s'affiche avec un lien "Effacer la recherche"
And ce message est distinct de l'empty state "aucune idée dans le workspace" (Story 3.2)
Given le champ de recherche est vide When je consulte le backlog Then toutes les idées correspondant aux autres filtres actifs s'affichent (comportement identique à Story 3.2)
Given un utilisateur non propriétaire du workspace appelle idea.getBacklog avec searchQuery
When la procédure tRPC est appelée
Then une erreur UNAUTHORIZED est retournée (ownership check inchangé - comportement identique à Story 3.2)
[x] Task 1 : Ajouter searchQuery au schéma input getBacklog dans src/server/api/routers/idea.ts (AC: #2, #5, #6)
searchQuery: z.string().optional() à l'objet .input() de getBacklog[x] Subtask 1.2 : Dans ctx.db.idea.findMany, ajouter la clause OR de recherche multi-champs quand searchQuery est défini et non vide :
...(input.searchQuery?.trim() && {
OR: [
{ llmTitle: { contains: input.searchQuery, mode: "insensitive" } },
{ problemDescription: { contains: input.searchQuery, mode: "insensitive" } },
{ llmDomain: { contains: input.searchQuery, mode: "insensitive" } },
{ llmAiType: { contains: input.searchQuery, mode: "insensitive" } },
{ department: { contains: input.searchQuery, mode: "insensitive" } },
],
}),
[x] Subtask 1.3 : Vérifier que la logique AND avec les filtres existants est préservée - la clause OR s'ajoute aux autres propriétés du where Prisma (isolation implicite par AND)
[x] Task 2 : Ajouter l'état de recherche et le debounce dans src/components/backlog/BacklogListView.tsx (AC: #2, #5)
const [searchInput, setSearchInput] = useState("") - valeur brute de l'inputconst [searchQuery, setSearchQuery] = useState("") - valeur débouncée (~300 ms)[x] Subtask 2.3 : Implémenter le debounce via useEffect :
useEffect(() => {
const timer = setTimeout(() => setSearchQuery(searchInput), 300);
return () => clearTimeout(timer);
}, [searchInput]);
[x] Subtask 2.4 : Passer searchQuery: searchQuery || undefined à api.idea.getBacklog.useQuery (ne pas transmettre une string vide)
[x] Task 3 : Créer le composant SearchInput dans src/components/backlog/SearchInput.tsx (AC: #1, #3)
"use client" - props : value: string, onChange: (v: string) => voidSearch (lucide-react) absolue à gauche - largeur min w-[220px]X visible quand value !== "" - appelle onChange("") au clic, aria-label="Effacer la recherche"placeholder="Rechercher une idée…", aria-label="Rechercher dans le backlog", type="search"[x] Task 4 : Intégrer SearchInput dans BacklogListView.tsx et gérer l'empty state "pas de résultats" (AC: #1, #4)
<SearchInput value={searchInput} onChange={setSearchInput} /> dans la div des filtres, avant <BacklogFilters>searchQuery !== "" et ideas.length === 0 → afficher message "Aucune idée ne correspond à {searchQuery}" avec lien "Effacer la recherche"searchQuery === "" et ideas.length === 0 → afficher <BacklogEmptyState workspaceId={workspaceId} /> (existant - Story 3.2)[x] Task 5 : Tests (AC: #2, #5, #6)
src/server/api/routers/idea.getBacklog.test.ts (Vitest)searchQuery défini → findMany appelé avec clause OR contenant les 5 champssearchQuery absent (undefined) → findMany appelé sans clause ORsearchQuery vide "" ou après .trim() → pas de clause OR (trim guard)searchQuery + filterStatus → les deux conditions sont présentes dans le wheresrc/components/backlog/SearchInput.test.tsx (Vitest + RTL)SearchInput : saisie → onChange appelé avec la valeurSearchInput : bouton × absent quand value === "", présent quand value !== ""SearchInput : clic sur × → onChange("") appeléApproche retenue : enrichir getBacklog (Option A - in-place)
Plutôt que de créer un router séparé (searchBacklog), searchQuery est ajouté au getBacklog existant :
Pattern Prisma OR search (mode insensitive) :
// Dans getBacklog - après la construction de statusWhere et des autres filtres
const ideas = await ctx.db.idea.findMany({
where: {
workspaceId: input.workspaceId,
...(Object.keys(statusWhere).length > 0 && { status: statusWhere }),
...(input.filterDomain && { llmDomain: input.filterDomain }),
...(input.filterContributor && { contributorEmail: input.filterContributor }),
// Nouveau : recherche multi-champs (AND avec les filtres ci-dessus)
...(input.searchQuery?.trim() && {
OR: [
{ llmTitle: { contains: input.searchQuery, mode: "insensitive" } },
{ problemDescription: { contains: input.searchQuery, mode: "insensitive" } },
{ llmDomain: { contains: input.searchQuery, mode: "insensitive" } },
{ llmAiType: { contains: input.searchQuery, mode: "insensitive" } },
{ department: { contains: input.searchQuery, mode: "insensitive" } },
],
}),
},
orderBy: buildBacklogOrderBy(input.sortBy, input.sortOrder),
// ... select, take: 200
});
Note Prisma :
mode: "insensitive"est supporté nativement par PostgreSQL (Neon eu-central-1) - aucune configuration supplémentaire requise. Ne pas utilisersearch(Prisma full-text search) qui nécessite une extension PostgreSQL@@fulltextet un index dédié -contains+mode: "insensitive"est suffisant pour MVP avec ≤ 200 idées (NFR5).
Debounce côté client :
// BacklogListView.tsx
const [searchInput, setSearchInput] = useState(""); // valeur brute de l'input
const [searchQuery, setSearchQuery] = useState(""); // valeur après debounce ~300 ms
useEffect(() => {
const timer = setTimeout(() => setSearchQuery(searchInput), 300);
return () => clearTimeout(timer);
}, [searchInput]);
// Dans useQuery
const { data: ideas, isLoading, isError } = api.idea.getBacklog.useQuery({
workspaceId,
sortBy,
sortOrder,
filterStatus: filters.filterStatus.length > 0 ? filters.filterStatus : undefined,
filterDomain: filters.filterDomain || undefined,
filterContributor: filters.filterContributor || undefined,
includeNotPriority: filters.includeNotPriority,
searchQuery: searchQuery || undefined, // ne pas envoyer "" - inutile et pollue le cache React Query
});
Composant SearchInput :
"use client";
import { Search, X } from "lucide-react";
import { Input } from "~/components/ui/input";
interface SearchInputProps {
value: string;
onChange: (value: string) => void;
}
export function SearchInput({ value, onChange }: SearchInputProps) {
return (
<div className="relative min-w-[220px]">
<Search className="absolute left-2.5 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground" />
<Input
type="search"
value={value}
onChange={(e) => onChange(e.target.value)}
placeholder="Rechercher une idée…"
aria-label="Rechercher dans le backlog"
className="h-8 pl-8 pr-7 text-xs"
/>
{value && (
<button
onClick={() => onChange("")}
className="absolute right-2 top-1/2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
aria-label="Effacer la recherche"
type="button"
>
<X className="h-3.5 w-3.5" />
</button>
)}
</div>
);
}
Positionnement dans BacklogListView :
{/* Zone filtres + recherche - dans la div flex-col gap-4 existante */}
<div className="flex flex-col gap-2">
<SearchInput value={searchInput} onChange={setSearchInput} />
<BacklogFilters
workspaceId={workspaceId}
filters={filters}
onFiltersChange={setFilters}
/>
</div>
Empty state "pas de résultats de recherche" (inline) :
{!isLoading && !isError && ideas?.length === 0 && (
searchQuery ? (
<div className="rounded-lg border bg-white p-8 text-center text-sm text-muted-foreground">
Aucune idée ne correspond à{" "}
<strong>“{searchQuery}”</strong>.{" "}
<button
onClick={() => setSearchInput("")}
className="text-violet-600 hover:underline"
type="button"
>
Effacer la recherche
</button>
</div>
) : (
<BacklogEmptyState workspaceId={workspaceId} />
)
)}
La recherche s'effectue sur des colonnes existantes du modèle Idea :
| Champ | Type Prisma | Rationale |
|---|---|---|
llmTitle |
String? |
Titre normalisé LLM - terme le plus court et précis |
problemDescription |
String @db.Text |
Description brute du contributeur - mots du métier |
llmDomain |
String? |
Domaine métier (ex. "RH", "Supply Chain") |
llmAiType |
String? |
Type IA (ex. "Automatisation", "Prédiction") |
department |
String |
Département saisi par le contributeur |
Non inclus dans la recherche :
contributorEmail - couvert par le filtre contributeur existant dans BacklogFiltersllmExplanation - texte long, bruit pour la recherche rapide MVPIndex existants utilisés : @@index([workspaceId, status]) - performant pour les filtres combinés. Le contains PostgreSQL sur text est un scan séquentiel sur la partition workspace (acceptable ≤ 200 idées - NFR5).
Aucun prisma migrate requis pour cette story.
| Fichier | Action |
|---|---|
src/server/api/routers/idea.ts |
Modifier - ajouter searchQuery?: z.string().optional() à getBacklog + clause OR dans findMany |
src/components/backlog/SearchInput.tsx |
Créer - input search avec icône + bouton × |
src/components/backlog/BacklogListView.tsx |
Modifier - état searchInput/searchQuery, debounce useEffect, intégration SearchInput, empty state recherche |
src/components/backlog/SearchInput.test.tsx |
Créer - tests RTL composant |
src/server/api/routers/idea.getBacklog.test.ts |
Créer ou étendre - tests Vitest searchQuery |
getBacklog → aucune modification requise (AC #6 couvert automatiquement)workspaceId : inchangé - workspaceId reste le premier critère du wherez.string().optional() - ne pas utiliser .min(1) pour permettre la valeur vide côté client (guard dans le code applicatif avec ?.trim())useQuery changent - le debounce suffit à limiter les appels*.test.ts ou *.test.tsx à côté du fichier testéStory 3.2 (vue liste backlog) :
api.idea.getBacklog.useQuery est configuré dans BacklogListView avec les paramètres des filtres - ajouter searchQuery suit exactement le même patternsearchQuery change (valeur débouncée)take: 200 (NFR5) s'applique après le filtre searchQuery → les 200 premiers résultats de la rechercheStory 3.5 (gestion des statuts) :
utils.idea.getBacklog.invalidate() (sans paramètres) invalide toutes les queries getBacklog du workspace, y compris celles avec searchQuery - cohérent après changement de statutStatusSelect continue de fonctionner dans les lignes de résultats de recherche sans modificationStory 3.4 (fiche détaillée) :
getById - uniquement getBacklogllmTitle, llmDomain, llmAiType peuvent être null (idées avec llmEnrichFailed: true) - Prisma contains sur un champ null retourne false silencieusement, comportement attenduStory 3.1 (enrichissement LLM) :
llmEnrichFailed: true n'ont pas de llmTitle, llmDomain, llmAiType - leur problemDescription et department restent dans le scope de recherche → ces idées restent trouvables par la description ou le départementcontains PostgreSQL est performant sur ce volume avec l'index existant @@index([workspaceId, status])workspaceId filtre en premier[&::-webkit-search-cancel-button]:hidden), effacement immédiat sans flash (setSearchQuery direct), max(200) sur searchQuery (Zod), test whitespace-trimming, reset global filtres + recherche via onSearchReset callback dans BacklogFilters. 325/325 tests verts.Composer (Cursor)
searchQuery ajouté au schéma input getBacklog + clause OR multi-champs (llmTitle, problemDescription, llmDomain, llmAiType, department) avec mode: "insensitive" PostgreSQLsearchInput/searchQuery + debounce 300 ms via useEffect dans BacklogListView