Status: done
En tant que Contributeur ou CDO, je veux parcourir une bibliothèque de cas d'usage IA organisée par secteur et fonction, afin de m'inspirer ou de pré-remplir le formulaire de soumission.
Given j'accède au formulaire de soumission (/submit/[workspaceSlug])
When je clique sur "Parcourir la bibliothèque"
Then une modale s'ouvre avec la bibliothèque organisée par secteur (distribution, industrie, services, santé, finance) et fonction (RH, finance, supply chain, commercial, opérations)
And je peux filtrer par secteur et par fonction via des pills cliquables
Given je consulte la bibliothèque depuis le formulaire (contributeur)
When je sélectionne un cas d'usage
Then le champ problemDescription du formulaire est pré-rempli avec la description du cas sélectionné
And un badge "Inspiré de : [titre du cas]" s'affiche avec un bouton de réinitialisation
And département, impact estimé et fréquence restent à renseigner par le contributeur
Given je suis authentifié en tant que Transformateur (CDO)
When j'accède à /workspace/[workspaceId]/library
Then je vois la même bibliothèque avec les mêmes filtres secteur/fonction
And chaque cas propose un bouton "Copier le lien" qui copie /submit/[workspaceSlug]?caseId=[id]
And chaque filtre de catégorie propose un bouton "Copier ce filtre" qui copie /submit/[workspaceSlug]?sector=[s]&department=[d]
Given un contributeur ouvre le lien partagé /submit/[workspaceSlug]?caseId=[id]
When la page se charge
Then le formulaire est pré-rempli avec la description du cas de bibliothèque correspondant
And le badge "Inspiré de : [titre]" est visible
Given un contributeur ouvre le lien /submit/[workspaceSlug]?sector=[s]&department=[d]
When la page se charge
Then la modale bibliothèque s'ouvre automatiquement avec les filtres pré-sélectionnés
Given la bibliothèque est vide (avant le seed de Story 2.4b) When j'ouvre la modale ou la page bibliothèque Then un empty state s'affiche : "Les cas d'usage seront disponibles prochainement" And aucune erreur n'est levée
Given je clique sur un exemple IA contextuel (ExamplePill) dans le panneau de droite du formulaire
When je clique sur le pill
Then le champ problemDescription est pré-rempli avec le texte de l'exemple
[x] Task 1 : Modèle Prisma LibraryCase + migration (AC: #1, #2, #4)
LibraryCase dans prisma/schema.prisma - champs : id (cuid), sector (String), department (String), title (String), description (Text), createdAt, updatedAt ; index sur [sector], [department], [sector, department] ; pas de workspaceId (bibliothèque globale partagée)prisma/migrations/ avec le nom YYYYMMDD_add_library_caseprisma generate)[x] Task 2 : tRPC router library.ts (AC: #1, #2, #3, #6)
src/server/api/routers/library.ts avec deux publicProcedure : getAll (input : { sector?: string; department?: string } via Zod, retourne LibraryCase[] triés alphabétiquement par titre) et getById (input : { id: string }, retourne LibraryCase | null)libraryRouter dans src/server/api/root.ts[x] Task 3 : Composants UI bibliothèque (AC: #1, #6)
src/components/library/LibraryCaseCard.tsx - props : { case: LibraryCase; onSelect?: (c: LibraryCase) => void; showShareButton?: boolean; shareUrl?: string } ; variante compact (titre + secteur + fonction + extrait description) ; role="button" si onSelect fourni ; aria-pressed selon sélectionsrc/components/library/LibraryCategoryFilter.tsx - pills secteur et pills fonction, sélection multiple possible, prop value: { sector?: string; department?: string } + onChange ; chaque pill a un role="checkbox" et aria-checkedsrc/components/library/LibraryBrowser.tsx - utilise api.library.getAll via tRPC React Query, intègre LibraryCategoryFilter + liste de LibraryCaseCard, skeleton 4 cards pendant le chargement, EmptyState si 0 résultats (message "Les cas d'usage seront disponibles prochainement"), callback onSelectCase?: (c: LibraryCase) => void passé à chaque cardsrc/components/library/LibraryModal.tsx - Dialog de shadcn/ui wrappant LibraryBrowser, props : { open: boolean; onOpenChange: (v: boolean) => void; onSelectCase: (c: LibraryCase) => void; initialFilters?: { sector?: string; department?: string } } ; titre "Bibliothèque de cas d'usage IA" ; accessible (focus trap, Escape pour fermer)[x] Task 4 : Intégration formulaire contributeur (AC: #2, #4, #5, #7)
src/components/form/ExamplesPanel.tsx - ajouter prop onPrefill?: (text: string) => void, passer la callback comme onClick à chaque ExamplePill ; retirer le texte placeholder "pré-remplissage à venir"src/components/form/IdeaSubmissionForm.tsx - ajouter état libraryModalOpen: boolean + librarySourceTitle: string | null ; ajouter handler handlePrefill(text: string) qui met à jour form.problemDescription ; ajouter bouton ghost "Parcourir la bibliothèque →" dans la colonne droite sous ExamplesPanel ; afficher badge "Inspiré de : [title]" avec bouton ✕ si librarySourceTitle non null ; passer onPrefill={handlePrefill} à ExamplesPanelIdeaSubmissionForm.tsx - ajouter props initialPrefillText?: string et autoOpenLibrary?: boolean + initialLibraryFilters?: { sector?: string; department?: string } ; si initialPrefillText → pré-remplir problemDescription à l'init ; si autoOpenLibrary → ouvrir LibraryModal au montagesrc/app/(public)/submit/[workspaceSlug]/page.tsx (Server Component) - lire searchParams.caseId, searchParams.sector, searchParams.department ; si caseId présent → appeler api.library.getById server-side et passer initialPrefillText + initialLibrarySourceTitle ; si sector ou department → passer autoOpenLibrary=true + initialLibraryFilters[x] Task 5 : Page bibliothèque CDO (AC: #3)
src/app/(dashboard)/workspace/[workspaceId]/library/page.tsx - page protégée (session requise, createWorkspaceProcedure), récupérer workspaceSlug depuis la session/DB, passer showShareButton=true + shareUrl calculée à chaque LibraryCaseCardLibraryCaseCard - si showShareButton et shareUrl fournis : bouton ghost qui copie shareUrl dans le presse-papier + toast de confirmation "Lien copié !"LibraryCategoryFilter - prop optionnelle getFilterShareUrl?: (filters) => string ; si fournie, afficher bouton copie filtre actif ; copie l'URL et affiche toast[x] Task 6 : Tests (AC: #1, #2, #3, #6, #7)
src/server/api/routers/library.test.ts - logique de filtrage getAll (sector, department, combinés)src/components/library/LibraryCaseCard.test.tsx - rendu titre + description, clic appelle onSelect, bouton share copie URLsrc/components/library/LibraryBrowser.test.tsx - empty state si 0 cas, skeleton pendant chargement, sélection d'un cas appelle onSelectCaseExamplesPanel.tsx + ExamplePill.tsx existent dans src/components/form/. ExamplePill a déjà la prop onClick?: () => void. ExamplesPanel a le texte "pré-remplissage à venir" (à retirer). Ces composants sont prêts pour l'extension.IdeaSubmissionForm.tsx existe avec layout 2 colonnes. Champs : contributorEmail, department, problemDescription, estimatedImpact, frequency. Pas de champ "titre" explicite dans le formulaire - la description du cas bibliothèque pré-remplit problemDescription. Le titre du cas est affiché dans le badge "Inspiré de".publicProcedure (pas protectedProcedure ni createWorkspaceProcedure). La page CDO lit aussi la même bibliothèque publique./submit/[workspaceSlug]?caseId=[id]. Le CDO copie ce lien et le transmet à ses contributeurs. Quand un contributeur ouvre ce lien, le Server Component lit searchParams.caseId, fetch le cas en DB et passe le texte de pré-remplissage.model LibraryCase {
id String @id @default(cuid())
sector String // distribution | industrie | services | sante | finance
department String // rh | finance | supply-chain | commercial | operations
title String
description String @db.Text
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
@@index([sector])
@@index([department])
@@index([sector, department])
}
// src/server/api/routers/library.ts
import { z } from "zod";
import { createTRPCRouter, publicProcedure } from "~/server/api/trpc";
export const libraryRouter = createTRPCRouter({
getAll: publicProcedure
.input(
z.object({
sector: z.string().optional(),
department: z.string().optional(),
})
)
.query(async ({ ctx, input }) => {
return ctx.db.libraryCase.findMany({
where: {
...(input.sector ? { sector: input.sector } : {}),
...(input.department ? { department: input.department } : {}),
},
orderBy: { title: "asc" },
});
}),
getById: publicProcedure
.input(z.object({ id: z.string() }))
.query(async ({ ctx, input }) => {
return ctx.db.libraryCase.findUnique({ where: { id: input.id } });
}),
});
// Dans IdeaSubmissionForm.tsx
const handleSelectFromLibrary = (libraryCase: LibraryCase) => {
setForm((prev) => ({ ...prev, problemDescription: libraryCase.description }));
setLibrarySourceTitle(libraryCase.title);
setLibraryModalOpen(false);
};
const handlePrefill = (text: string) => {
setForm((prev) => ({ ...prev, problemDescription: text }));
setLibrarySourceTitle(null); // ExamplePill n'a pas de titre explicite
};
// src/app/(public)/submit/[workspaceSlug]/page.tsx
// searchParams est passé automatiquement par Next.js App Router
interface PageProps {
params: { workspaceSlug: string };
searchParams: { caseId?: string; sector?: string; department?: string };
}
export default async function SubmitPage({ params, searchParams }: PageProps) {
// Fetch workspace, puis si caseId présent, fetch le cas bibliothèque
const libraryCase = searchParams.caseId
? await db.libraryCase.findUnique({ where: { id: searchParams.caseId } })
: null;
// Passer les props dérivées à IdeaSubmissionForm
}
LibraryCase est global (pas de workspaceId) - intentionnel et documenté. La page CDO valide la session Transformateur avant d'afficher la bibliothèque.library.getAll + library.getById : cohérent avec /submit/[workspaceSlug] qui est public. Pas d'isolation workspace nécessaire pour la bibliothèque.libraryRouter, LibraryCaseCard, LibraryBrowser, LibraryModal, LibraryCategoryFilter - PascalCase pour composants, camelCase pour router.api.library.getAll.useQuery(filters) - pas de fetch direct (contrairement à ExamplesPanel qui utilise fetch natif car sans auth).TRPCError({ code: "NOT_FOUND" }) si getById appelé avec un ID inexistant depuis le CDO. Côté contributeur (Server Component), si caseId invalide → libraryCase = null → formulaire vide sans erreur.| Fichier | Action |
|---|---|
prisma/schema.prisma |
Modifier - ajouter modèle LibraryCase |
prisma/migrations/YYYYMMDD_add_library_case/migration.sql |
Créer |
src/server/api/routers/library.ts |
Créer - libraryRouter |
src/server/api/root.ts |
Modifier - enregistrer libraryRouter |
src/components/library/LibraryCaseCard.tsx |
Créer |
src/components/library/LibraryCategoryFilter.tsx |
Créer |
src/components/library/LibraryBrowser.tsx |
Créer |
src/components/library/LibraryModal.tsx |
Créer |
src/components/form/ExamplesPanel.tsx |
Modifier - prop onPrefill, retirer texte placeholder |
src/components/form/IdeaSubmissionForm.tsx |
Modifier - gestion modal bibliothèque, badge, pré-remplissage |
src/app/(public)/submit/[workspaceSlug]/page.tsx |
Modifier - lecture searchParams.caseId, sector, department |
src/app/(dashboard)/workspace/[workspaceId]/library/page.tsx |
Créer - page CDO bibliothèque |
#ede9fe, texte #5b21b6, bouton ✕ ghost pour reset. Positionné sous le label du champ problemDescription, au-dessus du textarea.navigator.clipboard.writeText(url). Toast de confirmation via shadcn/ui useToast() : "Lien copié !" (succès vert, 3s). Gérer le cas où l'API clipboard n'est pas disponible (fallback silencieux ou message).2px solid #7c3aed au clic, fond #faf5ff, 150ms.Utiliser Vitest + React Testing Library (cohérent avec Story 2.3).
// Exemple test LibraryBrowser empty state
import { render, screen } from "@testing-library/react";
import { LibraryBrowser } from "~/components/library/LibraryBrowser";
// Mock tRPC
vi.mock("~/trpc/react", () => ({
api: {
library: {
getAll: {
useQuery: () => ({ data: [], isLoading: false }),
},
},
},
}));
it("affiche le empty state si aucun cas", () => {
render(<LibraryBrowser />);
expect(screen.getByText(/seront disponibles prochainement/i)).toBeInTheDocument();
});
generateContextualExamples existe dans src/server/services/llm.ts (ne pas dupliquer pour la bibliothèque - les cas bibliothèque viennent de la DB, pas du LLM)FALLBACK_EXAMPLES dans src/lib/fallbackExamples.ts - référencer dans les tests si nécessaireExamplesPanel appelle /api/llm/examples via fetch (Route Handler, public) - la bibliothèque utilise tRPC publicProcedure (approche plus cohérente pour une requête DB)bg-[#e9d5ff]/50, hauteur h-12 - réutiliser dans LibraryBrowser#faf5ff (fond IA), #e9d5ff (bordure), #6b21a8 (texte violet), #7c3aed (primaire), #fef3c7/#b45309 (amber pour AIBadge) - à respecter dans tous les nouveaux composants{{agent_model_name_version}}