# Story 2.4b : Bibliothèque — contenu seed au lancement (FR14-IA6) Status: done ## Story En tant que système, je veux disposer d'un contenu seed minimal pour la bibliothèque au lancement, afin que les contributeurs et CDO aient des exemples concrets dès le premier usage. ## Acceptance Criteria 1. **Given** la bibliothèque est déployée (Story 2.4a — modèle `LibraryCase` en base) **When** le script de seed est exécuté (`pnpm prisma db seed`) **Then** la bibliothèque contient au minimum 5 cas d'usage IA par secteur principal : distribution, industrie, services, sante, finance **And** la bibliothèque contient au minimum 5 cas d'usage IA par fonction principale : rh, finance, supply-chain, commercial, operations 2. **Given** le script de seed est exécuté plusieurs fois (idempotence) **When** je relance `pnpm prisma db seed` **Then** aucun doublon n'est créé **And** le nombre total de cas reste identique 3. **Given** la base de données est vierge (environnement de CI ou reset dev) **When** `pnpm prisma migrate deploy && pnpm prisma db seed` est exécuté **Then** les 25 cas d'usage sont disponibles sans erreur 4. **Given** les cas seed sont en base **When** un contributeur ouvre la bibliothèque depuis le formulaire **Then** au moins un cas est visible pour chaque secteur et chaque fonction **And** le empty state "Les cas d'usage seront disponibles prochainement" n'apparaît plus ## Tasks / Subtasks - [x] Task 1 : Configurer le seed Prisma dans le projet (AC: #1, #2, #3) - [x] Subtask 1.1 : Ajouter `tsx` en devDependency (`pnpm add -D tsx`) — requis pour exécuter TypeScript en environnement ESM (`"type": "module"`) - [x] Subtask 1.2 : Ajouter dans `package.json` la section `"prisma": { "seed": "tsx prisma/seed.ts" }` (à la racine de l'objet JSON, au même niveau que `"scripts"`) - [x] Subtask 1.3 : Ajouter le script `"db:seed": "prisma db seed"` dans la section `"scripts"` de `package.json` - [x] Task 2 : Créer le script `prisma/seed.ts` avec les 25 cas d'usage (AC: #1, #2, #3) - [x] Subtask 2.1 : Importer PrismaClient depuis `../generated/prisma` (chemin du client généré dans ce projet — voir `schema.prisma` `output = "../generated/prisma"`) - [x] Subtask 2.2 : Implémenter la fonction `main()` avec `prisma.libraryCase.upsert()` pour chacun des 25 cas — `where: { id: }` ou, si pas d'unique sur le titre, utiliser `createMany` avec `skipDuplicates: true` après vérification qu'aucune contrainte unique n'existe sur (sector, department, title) - [x] Subtask 2.3 : Écrire les 25 cas d'usage (matrice 5 secteurs × 5 fonctions) en français, langage métier, sans acronymes IA (voir contenu détaillé dans les Dev Notes) - [x] Subtask 2.4 : Ajouter `main().catch(console.error).finally(() => prisma.$disconnect())` en fin de script - [x] Task 3 : Tests (AC: #1, #2) - [x] Subtask 3.1 : Créer `prisma/seed.test.ts` — tester que la fonction seed insère bien 25 entrées dans une DB de test (ou mock Prisma) et que la ré-exécution n'ajoute pas de doublons ## Dev Notes ### Contexte et dépendances - **Story 2.4a complète (in-progress → à compléter avant ce seed)** : Le modèle `LibraryCase` existe dans `prisma/schema.prisma` et la migration `20260227110000_add_library_case` a été appliquée. Ce seed présuppose que la table `LibraryCase` existe en base. - **Pas de seed.ts existant** : Aucun fichier `prisma/seed.ts` ni script `db:seed` n'est présent dans le projet. Ce sont des créations pures. - **Environnement ESM** : Le projet a `"type": "module"` dans `package.json`. Prisma recommande `tsx` (ou `ts-node --esm`) pour les scripts de seed TypeScript en mode ESM. `tsx` est la solution la plus simple et fiable. - **Client Prisma custom output** : Le `schema.prisma` a `output = "../generated/prisma"`. L'import dans le seed doit donc être `import { PrismaClient } from "../generated/prisma"` (et non `@prisma/client`). - **Idempotence via `createMany + skipDuplicates`** : Le modèle `LibraryCase` n'a pas de contrainte `@@unique` sur (sector, department, title). L'approche recommandée est d'utiliser des IDs stables (`cuid()` pré-calculés ou UUID fixes) avec `upsert`. Alternativement, ajouter un `@@unique([sector, department, title])` dans le schéma permettrait `createMany({ skipDuplicates: true })` — mais cela nécessiterait une nouvelle migration. **Décision recommandée** : utiliser des IDs stables codés en dur dans le seed (ex. `seed-dist-rh-001`) et `upsert`. Ainsi, pas besoin de migration supplémentaire. ### Structure du fichier `prisma/seed.ts` ```typescript import { PrismaClient } from "../generated/prisma"; const prisma = new PrismaClient(); const libraryCases = [ // distribution { id: "seed-dist-rh", sector: "distribution", department: "rh", title: "Planification prédictive des effectifs saisonniers", description: "Le système analyse les historiques de ventes, les calendriers de promotions et les données de flux clients pour anticiper les besoins en personnel semaine par semaine. Les responsables reçoivent des suggestions de plannings avant chaque pic d'activité, réduisant les sureffectifs et les ruptures de couverture.", }, { id: "seed-dist-fin", sector: "distribution", department: "finance", title: "Détection automatique des anomalies de facturation", description: "Le système compare chaque facture fournisseur aux bons de commande et réceptions associés. Toute discordance (écart de prix, quantité incorrecte, doublon) est signalée automatiquement avant validation, évitant les paiements erronés et réduisant le temps de contrôle manuel.", }, { id: "seed-dist-sc", sector: "distribution", department: "supply-chain", title: "Optimisation automatique des réapprovisionnements", description: "À partir des niveaux de stock, des tendances de vente et des délais fournisseurs, le système propose des ordres de réapprovisionnement ajustés en temps réel. Les ruptures de stock sont anticipées plusieurs jours à l'avance et les excédents coûteux sont réduits.", }, { id: "seed-dist-com", sector: "distribution", department: "commercial", title: "Personnalisation automatique des offres promotionnelles", description: "En analysant l'historique d'achats et les comportements de navigation, le système recommande les promotions les plus pertinentes pour chaque segment client. Les équipes commerciales peuvent lancer des campagnes ciblées sans traitement manuel des données.", }, { id: "seed-dist-ops", sector: "distribution", department: "operations", title: "Tri intelligent et acheminement automatisé des colis", description: "Le système lit et interprète les étiquettes et adresses des colis (y compris endommagées ou manuscrites) pour orienter chaque envoi vers le bon circuit d'acheminement. Les erreurs de tri sont réduites et la cadence de traitement augmentée sans intervention humaine supplémentaire.", }, // industrie { id: "seed-ind-rh", sector: "industrie", department: "rh", title: "Identification des besoins de formation technique prioritaires", description: "Le système croise les données de performance des opérateurs, les incidents qualité et les évolutions des équipements pour identifier les lacunes de compétences les plus critiques. Les plans de formation sont générés automatiquement et priorisés selon l'impact sur la production.", }, { id: "seed-ind-fin", sector: "industrie", department: "finance", title: "Prévision des coûts de maintenance avant défaillance", description: "En analysant les données des capteurs industriels et l'historique des pannes, le système prédit quels équipements sont susceptibles de tomber en panne dans les prochaines semaines. Les responsables financiers peuvent ainsi budgéter les interventions préventives à l'avance.", }, { id: "seed-ind-sc", sector: "industrie", department: "supply-chain", title: "Anticipation des ruptures de matières premières", description: "Le système surveille en continu les délais fournisseurs, les niveaux de stock et les plans de production pour alerter les équipes approvisionnement avant toute rupture. Des suggestions de substitution ou de réordre sont générées automatiquement.", }, { id: "seed-ind-com", sector: "industrie", department: "commercial", title: "Estimation automatisée des délais de livraison pour les devis", description: "Lors de la création d'un devis, le système calcule un délai de livraison réaliste en tenant compte de la charge des ateliers, des disponibilités matières et des contraintes logistiques. Les commerciaux disposent d'une réponse fiable en quelques secondes sans solliciter la production.", }, { id: "seed-ind-ops", sector: "industrie", department: "operations", title: "Détection précoce des défauts sur ligne de production", description: "Le système analyse en temps réel les données des capteurs de contrôle qualité et identifie les pièces non conformes avant qu'elles n'atteignent l'étape suivante. Les alertes permettent d'arrêter la ligne immédiatement, réduisant les rebuts et les retouches coûteuses.", }, // services { id: "seed-svc-rh", sector: "services", department: "rh", title: "Analyse des signaux de désengagement des collaborateurs", description: "Le système croise les données RH disponibles (absences, feedback, mobilité interne) pour identifier les collaborateurs à risque de départ. Les managers reçoivent des alertes discrètes et des suggestions d'actions avant que la situation ne se détériore.", }, { id: "seed-svc-fin", sector: "services", department: "finance", title: "Classification automatique des notes de frais", description: "Le système lit les justificatifs soumis par les collaborateurs, les catégorise selon la politique de l'entreprise et détecte les anomalies (montants inhabituels, doublons, catégories incorrectes). Le contrôleur de gestion valide uniquement les cas signalés, réduisant le temps de traitement de 80 %.", }, { id: "seed-svc-sc", sector: "services", department: "supply-chain", title: "Optimisation des tournées d'intervention terrain", description: "En tenant compte des adresses clients, des compétences des techniciens et des créneaux disponibles, le système génère des tournées optimisées chaque matin. Les déplacements inutiles sont réduits et le nombre d'interventions réalisées par jour augmente.", }, { id: "seed-svc-com", sector: "services", department: "commercial", title: "Priorisation automatique des relances clients à fort potentiel", description: "Le système analyse le comportement des prospects (ouvertures d'emails, visites de pages, interactions passées) pour classer les relances à effectuer par ordre de probabilité de conversion. Les commerciaux concentrent leur énergie sur les contacts les plus chauds.", }, { id: "seed-svc-ops", sector: "services", department: "operations", title: "Traitement automatique des demandes de support récurrentes", description: "Le système identifie les demandes d'assistance fréquentes et génère des réponses adaptées en s'appuyant sur la base de connaissances interne. Les agents de support se concentrent sur les cas complexes, tandis que les demandes simples sont traitées automatiquement en quelques secondes.", }, // sante { id: "seed-san-rh", sector: "sante", department: "rh", title: "Gestion des compétences et habilitations du personnel soignant", description: "Le système suit les certifications, les formations obligatoires et les habilitations de chaque soignant, et alerte automatiquement avant leur expiration. Les plannings sont générés en tenant compte des qualifications requises pour chaque poste, réduisant les risques de non-conformité réglementaire.", }, { id: "seed-san-fin", sector: "sante", department: "finance", title: "Optimisation du codage des actes médicaux pour la facturation", description: "Le système analyse les comptes rendus médicaux et suggère les codes d'actes les plus appropriés pour la facturation à l'assurance maladie. Les erreurs de cotation sont réduites et le taux de remboursement est optimisé sans surcharge administrative pour les praticiens.", }, { id: "seed-san-sc", sector: "sante", department: "supply-chain", title: "Gestion automatisée des stocks de médicaments et consommables", description: "Le système surveille en temps réel les niveaux de stock des médicaments et consommables médicaux, et déclenche automatiquement les commandes avant rupture. Les dates de péremption proches sont signalées pour prioriser l'utilisation et réduire les destructions coûteuses.", }, { id: "seed-san-com", sector: "sante", department: "commercial", title: "Analyse des parcours patients pour améliorer l'orientation", description: "Le système analyse les données de parcours de soin (délais, réorientations, abandons) pour identifier les points de friction dans l'accueil et l'orientation des patients. Les équipes peuvent prioriser les améliorations ayant le plus d'impact sur la satisfaction et la fluidité des prises en charge.", }, { id: "seed-san-ops", sector: "sante", department: "operations", title: "Anticipation des pics d'activité aux urgences", description: "En analysant les historiques d'admissions, les données météo et les événements locaux, le système prédit les pics d'affluence aux urgences avec plusieurs heures d'avance. Les cadres de santé peuvent adapter les effectifs et préparer les ressources avant l'arrivée du flux.", }, // finance { id: "seed-fin-rh", sector: "finance", department: "rh", title: "Automatisation du traitement des fiches de paie", description: "Le système collecte automatiquement les variables de paie (absences, heures supplémentaires, primes) depuis les différents outils RH et les centralise pour le traitement mensuel. Les erreurs de saisie manuelle sont éliminées et les délais de clôture de paie raccourcis.", }, { id: "seed-fin-fin", sector: "finance", department: "finance", title: "Détection des transactions inhabituelles et alertes fraude", description: "Le système analyse en continu les flux de transactions pour repérer les comportements inhabituels (montants atypiques, horaires anormaux, bénéficiaires inconnus). Les équipes de conformité reçoivent des alertes ciblées en temps réel, réduisant le temps de réponse aux incidents.", }, { id: "seed-fin-sc", sector: "finance", department: "supply-chain", title: "Automatisation du rapprochement bancaire et des clôtures comptables", description: "Le système rapproche automatiquement les relevés bancaires avec les écritures comptables, identifie les écarts et propose les lettrage manquants. Les clôtures mensuelles sont accélérées et les équipes comptables libérées des tâches de vérification répétitives.", }, { id: "seed-fin-com", sector: "finance", department: "commercial", title: "Évaluation automatisée du risque crédit des prospects", description: "Lors de l'instruction d'un dossier de crédit, le système analyse les données financières du prospect, son historique et les signaux de marché pour générer un score de risque argumenté. Les conseillers disposent d'une recommandation structurée en quelques minutes au lieu de plusieurs heures.", }, { id: "seed-fin-ops", sector: "finance", department: "operations", title: "Extraction et vérification automatique des données contractuelles", description: "Le système lit les contrats et documents réglementaires pour en extraire les clauses clés (échéances, montants, obligations), les structure dans le système d'information et alerte en cas d'incohérence ou d'échéance approchante. Le temps de traitement documentaire est réduit de plusieurs heures par dossier.", }, ] as const; async function main() { console.log("🌱 Seeding library cases..."); for (const libraryCase of libraryCases) { await prisma.libraryCase.upsert({ where: { id: libraryCase.id }, update: { title: libraryCase.title, description: libraryCase.description, }, create: libraryCase, }); } console.log(`✅ ${libraryCases.length} library cases seeded successfully.`); } main() .catch(console.error) .finally(() => prisma.$disconnect()); ``` ### Modification `package.json` Deux ajouts nécessaires dans `package.json` : ```json { "scripts": { "db:seed": "prisma db seed" }, "prisma": { "seed": "tsx prisma/seed.ts" } } ``` La section `"prisma"` est ajoutée à la **racine** de l'objet JSON (au même niveau que `"scripts"`, `"dependencies"`, etc.). ### Contenu seed — Matrice 5×5 | | **rh** | **finance** | **supply-chain** | **commercial** | **operations** | |---|---|---|---|---|---| | **distribution** | seed-dist-rh | seed-dist-fin | seed-dist-sc | seed-dist-com | seed-dist-ops | | **industrie** | seed-ind-rh | seed-ind-fin | seed-ind-sc | seed-ind-com | seed-ind-ops | | **services** | seed-svc-rh | seed-svc-fin | seed-svc-sc | seed-svc-com | seed-svc-ops | | **sante** | seed-san-rh | seed-san-fin | seed-san-sc | seed-san-com | seed-san-ops | | **finance** | seed-fin-rh | seed-fin-fin | seed-fin-sc | seed-fin-com | seed-fin-ops | 25 cas au total — chaque secteur : 5 cas ; chaque fonction : 5 cas. Satisfait FR14-IA6. ### Architecture Compliance - **Bibliothèque globale** : `LibraryCase` n'a pas de `workspaceId` — intentionnel (partagé entre tous les workspaces). Le seed ne nécessite aucun contexte workspace. - **Import PrismaClient** : `import { PrismaClient } from "../generated/prisma"` — respecte le `output` configuré dans `schema.prisma`. Ne pas utiliser `@prisma/client`. - **Idempotence par ID stable** : Les IDs de seed (`seed-dist-rh`, etc.) sont des chaînes courtes lisibles. Ils ne ressemblent pas à des cuids, mais sont valides (le champ `id` est `String`, pas contraint à un format particulier). Cette approche évite les doublons sans migration supplémentaire. - **ESM / `"type": "module"`** : `tsx` est requis. Ne pas utiliser `ts-node` seul (incompatible sans flag `--esm`). `tsx` gère nativement ESM. - **Pas de dépendance runtime** : `tsx` est une devDependency uniquement — pas d'impact sur le bundle de production. - **Langage des descriptions** : Toutes en français, sans acronymes IA (NLP, OCR, ML, LLM, API) — conforme à FR14-IA2. ### Structure des fichiers | Fichier | Action | |---------|--------| | `prisma/seed.ts` | Créer — script de seed avec 25 cas d'usage | | `package.json` | Modifier — ajouter section `"prisma"` et script `"db:seed"` | ### Patterns de test recommandés Vitest + mock Prisma (cohérent avec les stories précédentes). ```typescript // prisma/seed.test.ts import { describe, it, expect, vi, beforeEach } from "vitest"; // Mock du PrismaClient const mockUpsert = vi.fn().mockResolvedValue({}); const mockDisconnect = vi.fn().mockResolvedValue(undefined); vi.mock("../generated/prisma", () => ({ PrismaClient: vi.fn().mockImplementation(() => ({ libraryCase: { upsert: mockUpsert }, $disconnect: mockDisconnect, })), })); describe("prisma seed", () => { beforeEach(() => { vi.clearAllMocks(); }); it("appelle upsert 25 fois", async () => { const { main } = await import("./seed"); await main(); expect(mockUpsert).toHaveBeenCalledTimes(25); }); it("couvre les 5 secteurs", async () => { const { main } = await import("./seed"); await main(); const sectors = mockUpsert.mock.calls.map((c) => c[0].create.sector); const uniqueSectors = new Set(sectors); expect(uniqueSectors.size).toBe(5); expect(uniqueSectors).toContain("distribution"); expect(uniqueSectors).toContain("industrie"); expect(uniqueSectors).toContain("services"); expect(uniqueSectors).toContain("sante"); expect(uniqueSectors).toContain("finance"); }); it("couvre les 5 fonctions", async () => { const { main } = await import("./seed"); await main(); const departments = mockUpsert.mock.calls.map((c) => c[0].create.department); const uniqueDepts = new Set(departments); expect(uniqueDepts.size).toBe(5); expect(uniqueDepts).toContain("rh"); expect(uniqueDepts).toContain("finance"); expect(uniqueDepts).toContain("supply-chain"); expect(uniqueDepts).toContain("commercial"); expect(uniqueDepts).toContain("operations"); }); }); ``` **Note** : Pour que la fonction `main()` soit testable, elle doit être exportée depuis `seed.ts` : ```typescript export async function main() { ... } // puis en bas du fichier (hors export) : if (process.argv[1] === import.meta.url) { main().catch(console.error).finally(() => prisma.$disconnect()); } ``` Alternativement, tester via un mock de la liste `libraryCases` exportée. ### Référence story précédente (2.4a) — acquis importants - **Modèle `LibraryCase`** : créé dans `schema.prisma`, migration `20260227110000_add_library_case` appliquée. Les champs `id`, `sector`, `department`, `title`, `description`, `createdAt`, `updatedAt` sont disponibles. - **Valeurs valides** : - `sector` : `distribution | industrie | services | sante | finance` - `department` : `rh | finance | supply-chain | commercial | operations` - **`publicProcedure`** `library.getAll` et `library.getById` existent dans `src/server/api/routers/library.ts` — pas de modification nécessaire. - **Empty state** `LibraryBrowser` : le message "Les cas d'usage seront disponibles prochainement" disparaîtra automatiquement une fois le seed exécuté. - **Palette Livinia** : aucune modification UI — le seed ne concerne que les données. ### References - [Source: epics.md#Story 2.4b] - [Source: prd.md#FR14-IA6] - [Source: implementation-artifacts/2-4a-bibliotheque-de-cas-dusage-ia-ui-et-pre-remplissage-fr14-ia3-fr14-ia4-fr14-ia5.md] - [Source: prisma/schema.prisma#LibraryCase] - [Source: architecture.md#Data Architecture — Prisma Migrate] ## Dev Agent Record ### Agent Model Used {{agent_model_name_version}} ### Debug Log References ### Completion Notes List - ✅ Task 1 : tsx ajouté en devDependency, section prisma et script db:seed configurés dans package.json - ✅ Task 2 : prisma/seed.ts créé avec 25 cas d'usage (matrice 5×5), upsert avec IDs stables pour idempotence, exécution conditionnelle (évite auto-run en contexte Vitest) - ✅ Task 3 : prisma/seed.test.ts avec 5 tests (25 upserts, 5 secteurs, 5 fonctions, IDs stables, idempotence double exécution) - ✅ Code review : M1 — update inclut sector/department ; M2 — $transaction pour atomicité ; M3 — test idempotence réel ; L1 — commentaire VITEST ### File List - aimpact-hub/package.json (modifié — db:seed, prisma.seed) - aimpact-hub/prisma/seed.ts (créé) - aimpact-hub/prisma/seed.test.ts (créé)