# Story 3.6 : Recherche dans le backlog (FR27)
Status: done
## Story
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.
## Acceptance Criteria
1. **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
2. **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
3. **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)
4. **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)
5. **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)
6. **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)
## Tasks / Subtasks
- [x] Task 1 : Ajouter `searchQuery` au schéma input `getBacklog` dans `src/server/api/routers/idea.ts` (AC: #2, #5, #6)
- [x] Subtask 1.1 : Ajouter `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 :
```typescript
...(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)
- [x] Subtask 2.1 : Ajouter `const [searchInput, setSearchInput] = useState("")` — valeur brute de l'input
- [x] Subtask 2.2 : Ajouter `const [searchQuery, setSearchQuery] = useState("")` — valeur débouncée (~300 ms)
- [x] Subtask 2.3 : Implémenter le debounce via `useEffect` :
```typescript
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)
- [x] Subtask 3.1 : Composant `"use client"` — props : `value: string`, `onChange: (v: string) => void`
- [x] Subtask 3.2 : Input shadcn avec icône `Search` (lucide-react) absolue à gauche — largeur min `w-[220px]`
- [x] Subtask 3.3 : Bouton icône `X` visible quand `value !== ""` — appelle `onChange("")` au clic, `aria-label="Effacer la recherche"`
- [x] Subtask 3.4 : Attributs : `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)
- [x] Subtask 4.1 : Placer `` dans la `div` des filtres, avant ``
- [x] Subtask 4.2 : Gérer les deux empty states :
- Si `searchQuery !== ""` et `ideas.length === 0` → afficher message "Aucune idée ne correspond à `{searchQuery}`" avec lien "Effacer la recherche"
- Si `searchQuery === ""` et `ideas.length === 0` → afficher `` (existant — Story 3.2)
- [x] Task 5 : Tests (AC: #2, #5, #6)
- [x] Subtask 5.1 : Créer ou étendre `src/server/api/routers/idea.getBacklog.test.ts` (Vitest)
- [x] Subtask 5.2 : Test : `searchQuery` défini → `findMany` appelé avec clause `OR` contenant les 5 champs
- [x] Subtask 5.3 : Test : `searchQuery` absent (undefined) → `findMany` appelé sans clause `OR`
- [x] Subtask 5.4 : Test : `searchQuery` vide `""` ou après `.trim()` → pas de clause `OR` (trim guard)
- [x] Subtask 5.5 : Test : `searchQuery` + `filterStatus` → les deux conditions sont présentes dans le `where`
- [x] Subtask 5.6 : Créer `src/components/backlog/SearchInput.test.tsx` (Vitest + RTL)
- [x] Subtask 5.7 : Test `SearchInput` : saisie → `onChange` appelé avec la valeur
- [x] Subtask 5.8 : Test `SearchInput` : bouton × absent quand `value === ""`, présent quand `value !== ""`
- [x] Subtask 5.9 : Test `SearchInput` : clic sur × → `onChange("")` appelé
## Dev Notes
### Architecture & Décisions techniques
**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 :
- Combinaison native avec les filtres existants (AND implicite Prisma)
- Un seul call réseau par render
- Invalidation React Query cohérente avec les mutations Story 3.5
- Aucune migration Prisma requise
**Pattern Prisma `OR` search (mode insensitive) :**
```typescript
// 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 utiliser `search` (Prisma full-text search) qui nécessite une extension PostgreSQL `@@fulltext` et un index dédié — `contains` + `mode: "insensitive"` est suffisant pour MVP avec ≤ 200 idées (NFR5).
**Debounce côté client :**
```typescript
// 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` :**
```tsx
"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 (
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 && (
)}
);
}
```
**Positionnement dans `BacklogListView` :**
```tsx
{/* Zone filtres + recherche — dans la div flex-col gap-4 existante */}
```
**Empty state "pas de résultats de recherche" (inline) :**
```tsx
{!isLoading && !isError && ideas?.length === 0 && (
searchQuery ? (
Aucune idée ne correspond à{" "}
“{searchQuery}”.{" "}
) : (
)
)}
```
### Schéma Prisma — aucune migration requise
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 `BacklogFilters`
- `llmExplanation` — texte long, bruit pour la recherche rapide MVP
Index 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.**
### Structure des fichiers
| 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` |
### Conventions architecture à respecter
- **Ownership check AVANT toute opération** : déjà présent dans `getBacklog` → aucune modification requise (AC #6 couvert automatiquement)
- **Filtrer par `workspaceId`** : inchangé — `workspaceId` reste le premier critère du `where`
- **Zod input validation** : `z.string().optional()` — ne pas utiliser `.min(1)` pour permettre la valeur vide côté client (guard dans le code applicatif avec `?.trim()`)
- **React Query** : re-fetch automatique quand les paramètres de `useQuery` changent — le debounce suffit à limiter les appels
- **Tests co-localisés** : `*.test.ts` ou `*.test.tsx` à côté du fichier testé
- **Toast** : non requis pour cette story (lecture seule, pas de mutation)
### Apprentissages des stories précédentes
**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 pattern
- React Query re-déclenche la requête automatiquement dès que `searchQuery` change (valeur débouncée)
- Le `take: 200` (NFR5) s'applique après le filtre `searchQuery` → les 200 premiers résultats de la recherche
**Story 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 statut
- `StatusSelect` continue de fonctionner dans les lignes de résultats de recherche sans modification
**Story 3.4 (fiche détaillée) :**
- La recherche ne concerne pas `getById` — uniquement `getBacklog`
- Les champs `llmTitle`, `llmDomain`, `llmAiType` peuvent être `null` (idées avec `llmEnrichFailed: true`) — Prisma `contains` sur un champ `null` retourne `false` silencieusement, comportement attendu
**Story 3.1 (enrichissement LLM) :**
- Les idées avec `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épartement
### NFR concernés
- **NFR5** : backlog < 3 s pour ≤ 200 idées — `contains` PostgreSQL est performant sur ce volume avec l'index existant `@@index([workspaceId, status])`
- **NFR14** : isolation workspace — ownership check inchangé, `workspaceId` filtre en premier
### References
- [Source: epics.md#Story 3.6 — Recherche dans le backlog (FR27)]
- [Source: prd.md#FR27 — recherche par mots-clés dans le backlog]
- [Source: architecture.md#Implementation Patterns — protectedProcedure, ownership check, tRPC errors, naming conventions]
- [Source: architecture.md#Pattern Examples — getIdeas avec workspaceId filter]
- [Source: architecture.md#API Naming Conventions — procédures tRPC camelCase]
- [Source: prisma/schema.prisma — model Idea (fields: llmTitle, problemDescription, llmDomain, llmAiType, department)]
- [Source: src/server/api/routers/idea.ts — getBacklog procedure (Story 3.2), IDEA_STATUS_VALUES, patterns filtres]
- [Source: src/components/backlog/BacklogListView.tsx — état filters, useQuery getBacklog, structure layout]
- [Source: src/components/backlog/BacklogFilters.tsx — pattern filtres combinés, import Select shadcn]
- [Source: src/components/backlog/BacklogEmptyState.tsx — empty state existant à distinguer du "pas de résultats de recherche"]
- [Source: implementation-artifacts/3-2-vue-liste-du-backlog-fr22-fr24.md — patterns table, React Query, empty state]
- [Source: implementation-artifacts/3-5-gestion-des-statuts-et-statut-non-prioritaire-fr26.md — invalidation React Query, architecture patterns]
## Change Log
- 2026-02-28 : Implémentation complète Story 3.6 (FR27) — recherche par mots-clés dans le backlog. Backend : searchQuery dans getBacklog avec clause OR multi-champs. Frontend : SearchInput, debounce 300 ms, empty state "pas de résultats". 8 tests ajoutés (4 getBacklog, 4 SearchInput).
- 2026-02-28 : Post code-review — corrections H1/H2/M1/M2/M3 : suppression bouton webkit natif (`[&::-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.
## Dev Agent Record
### Agent Model Used
Composer (Cursor)
### Debug Log References
### Completion Notes List
- ✅ Task 1 : `searchQuery` ajouté au schéma input `getBacklog` + clause OR multi-champs (llmTitle, problemDescription, llmDomain, llmAiType, department) avec `mode: "insensitive"` PostgreSQL
- ✅ Task 2 : État `searchInput`/`searchQuery` + debounce 300 ms via useEffect dans BacklogListView
- ✅ Task 3 : Composant SearchInput créé (icône Search, bouton ×, placeholder, aria-labels)
- ✅ Task 4 : SearchInput intégré avant BacklogFilters ; empty state "pas de résultats" distinct du BacklogEmptyState
- ✅ Task 5 : 4 tests getBacklog (searchQuery) + 4 tests SearchInput (RTL)
- Tous les 324 tests passent, aucune régression
### File List
- aimpact-hub/src/server/api/routers/idea.ts (modifié)
- aimpact-hub/src/server/api/routers/idea.getBacklog.test.ts (modifié)
- aimpact-hub/src/components/backlog/SearchInput.tsx (créé)
- aimpact-hub/src/components/backlog/SearchInput.test.tsx (créé)
- aimpact-hub/src/components/backlog/BacklogListView.tsx (modifié)