` : Impact, Faisabilité, Urgence
- État local `localScores` = useState initialisé depuis `manualScore*` ?? `llmScore*`
- Bouton "Enregistrer les scores" → `api.idea.updateScores.useMutation`
- [x] Subtask 5.7 : Section pièces jointes :
- Titre "Pièces jointes" + compteur `(n)`
- ``
- [x] Subtask 5.8 : Gestion `isError` → message "Impossible de charger cette fiche" + bouton "Retour au backlog"
- [x] Subtask 5.9 : Toast pour erreur updateScores - utiliser `~/components/ui/toast` (shadcn, déjà disponible si installé) ou fallback `alert()` si pas disponible
- [x] Task 6 : Tests - `ScoreSlider.test.tsx` et `IdeaDetailView.test.tsx` (AC: #3, #4, #5)
- [x] Subtask 6.1 : Créer `src/components/idea/ScoreSlider.test.tsx` :
- Test A : affiche badge amber si score manuel null (valeur LLM active)
- Test B : affiche badge violet "Ajusté" si score manuel présent
- Test C : tooltip sur badge "Ajusté" affiche la valeur LLM originale
- Test D : onChange est appelé lors du changement du slider
- Test E : affiche "-" si `llmScore = null` et `manualScore = null`
- [x] Subtask 6.2 : Créer `src/components/idea/IdeaDetailView.test.tsx` :
- Mock `api.idea.getById.useQuery` et `api.idea.updateScores.useMutation`
- Mock `api.idea.retryEnrich.useMutation`
- Test F : affiche skeleton pendant `isLoading`
- Test G : affiche titre, domaine, explication si enrichi
- Test H : affiche badge "À qualifier manuellement" si `llmEnrichFailed = true`
- Test I : bouton "Enregistrer les scores" appelle `updateScores.mutate`
- Test J : affiche message "Aucune pièce jointe" si attachments vides
- Test K : affiche le lien de téléchargement si pièce jointe présente
- Test L : affiche date d'ajustement "Ajusté le" si un `manualScore*` est défini
## Dev Notes
### Contexte de la story
Cette story implémente la **page de fiche détaillée d'une idée**, destination de tous les liens existants dans `IdeaRow.tsx` (backlog liste) et `KanbanCard.tsx` (kanban). La route `/workspace/[workspaceId]/ideas/[ideaId]` n'existe pas encore - ces liens aboutissent actuellement sur une 404.
Toute la logique d'enrichissement LLM et les champs de scores (LLM et manuels) sont **déjà présents dans la base** (Story 3.1 + schéma initial) :
- `llmTitle`, `llmDomain`, `llmAiType`, `llmExplanation`, `llmScoreImpact/Feasibility/Urgency` - remplis par `POST /api/llm/enrich`
- `manualScoreImpact/Feasibility/Urgency` - `Int?` dans le schéma Prisma, actuellement `null` pour toutes les idées
- `llmEnrichFailed` - `Boolean @default(false)`, `true` si enrichissement échoué
**Aucune migration Prisma requise pour cette story.**
### Interprétation de "tracé dans l'historique" (FR20) - décision MVP
La spec (FR20) demande que les ajustements soient "tracés dans l'historique". Il n'existe pas de table `ScoreHistory` dans le schéma actuel. L'approche MVP validée :
- Les champs `manualScore*` stockent la valeur actuelle (last write wins)
- Le champ `updatedAt` de l'`Idea` trace automatiquement la date du dernier ajustement
- La fiche affiche "Ajusté le [date]" calculé depuis `updatedAt` si au moins un `manualScore*` est non-null
- La valeur LLM originale reste accessible dans le tooltip "Suggestion IA : X/5"
Cette implémentation est conforme à l'esprit de FR20 pour le MVP. Une table d'historique dédiée pourrait être ajoutée en Story 4.x si nécessaire.
### Procédures tRPC - patterns existants à suivre
Identique à `getBacklog` (Story 3.2) - même structure :
```typescript
// 1. Ownership check avec findUnique sur workspace
// 2. findUnique sur idea avec vérification workspaceId
// 3. Retour des données
```
Pour `updateScores`, le pattern suit `retryEnrich` (Story 3.1) - double vérification workspace ownership + idea ownership.
L'ownership check est **délibérément redondant** (workspace + idea) pour respecter la défense en profondeur (architecture.md : "filtrer par workspaceId + ownership check").
### Composant `ScoreSlider` - anatomie
Depuis `ux-design-specification.md` (ligne 613) :
```
label + valeur actuelle + AIBadge si valeur = suggestion LLM · slider 1–5 · historique ajustements (tooltip)
États : ai-suggested · manually-set · editing
```
Implémentation recommandée :
```tsx
// Valeur effective affichée = manualScore ?? llmScore
const effectiveScore = manualScore ?? llmScore;
const isManuallySet = manualScore !== null;
// Slider natif (pas de composant shadcn dédié nécessaire)
```
Le slider ne DOIT PAS appeler `updateScores` à chaque mouvement - uniquement via le bouton "Enregistrer les scores" groupant les 3 scores en une seule mutation.
### Page Server Component - pattern identique à Story 3.3
```typescript
// Identique à KanbanPage / BacklogPage (Stories 3.2, 3.3)
const session = await auth();
if (!session?.user?.id) { redirect("/signin"); }
// Pas de prefetch tRPC (données chargées côté client par IdeaDetailView)
```
La page ne fait PAS de prefetch tRPC - `IdeaDetailView` utilise `useQuery` côté client. C'est intentionnel (cohérence avec le pattern Stories 3.2/3.3).
### Skeleton layout recommandé (3 zones)
```tsx
// Zone 1 : en-tête
// Titre
// Statut badge
// Zone 2 : scores (3 colonnes)
{[1,2,3].map(i => )}
// Zone 3 : pièces jointes
```
### Format taille pièces jointes - fonction pure
```typescript
function formatSize(bytes: number): string {
if (bytes < 1024) return `${bytes} o`;
if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} Ko`;
return `${(bytes / (1024 * 1024)).toFixed(1)} Mo`;
}
```
### `toast` shadcn - vérifier la disponibilité
Avant d'utiliser `useToast` (shadcn), vérifier si le composant est déjà installé :
```
src/components/ui/toast.tsx
src/components/ui/toaster.tsx
```
Si non installé, fallback acceptable : afficher un `` d'erreur inline dans le composant. **Ne pas bloquer la story sur l'installation de toast.**
### Schéma Prisma - aucune migration requise
Tous les champs nécessaires existent :
- `status` (IdeaStatus enum)
- `llmTitle`, `llmDomain`, `llmAiType`, `llmExplanation`, `llmScoreImpact/Feasibility/Urgency`, `llmEnrichedAt`, `llmEnrichFailed`
- `manualScoreImpact`, `manualScoreFeasibility`, `manualScoreUrgency` (Int? - Story 3.4)
- `attachments IdeaAttachment[]` (Story 2.6)
- `updatedAt DateTime @updatedAt` (utilisé pour la date d'ajustement)
### Structure des fichiers
| Fichier | Action |
|---------|--------|
| `src/server/api/routers/idea.ts` | Modifier - ajouter `getById` et `updateScores` |
| `src/app/(dashboard)/workspace/[workspaceId]/ideas/[ideaId]/page.tsx` | Créer - page détail Server Component |
| `src/components/idea/IdeaDetailView.tsx` | Créer - composant client principal (useQuery + mutations) |
| `src/components/idea/ScoreSlider.tsx` | Créer - slider 1-5 avec badge IA/Ajusté et tooltip |
| `src/components/idea/IdeaAttachmentList.tsx` | Créer - liste pièces jointes avec taille formatée |
| `src/components/idea/ScoreSlider.test.tsx` | Créer - tests Vitest + RTL |
| `src/components/idea/IdeaDetailView.test.tsx` | Créer - tests Vitest + RTL |
### Apprentissages des stories précédentes
**Story 3.2/3.3 - patterns UI directs à réutiliser :**
- `STATUS_LABELS`, `STATUS_CLASSES` depuis `~/lib/ideaStatus` (exportés)
- Pattern skeleton : `` shadcn dans un layout similaire
- Pattern composant client : `"use client"`, `api.xxx.useQuery`
- Pattern lien retour : `← Retour` avec flèche
**Story 3.1 - retryEnrich déjà câblé :**
- `api.idea.retryEnrich.useMutation` déjà disponible - NE PAS recréer la procédure
- Pattern : appel fire-and-forget côté serveur, l'UI affiche juste le feedback immédiat
**Tests (Stories 3.2/3.3) - patterns de mock établis :**
```typescript
// Mock useQuery tRPC
vi.mock("~/trpc/react", () => ({
api: {
idea: {
getById: { useQuery: vi.fn() },
updateScores: { useMutation: vi.fn() },
retryEnrich: { useMutation: vi.fn() },
},
},
}));
// Mock next/link
vi.mock("next/link", () => ({ default: ({ href, children }) => {children} }));
// Mock Tooltip (éviter les erreurs de provider)
vi.mock("~/components/ui/tooltip", () => ({
Tooltip: ({ children }) => <>{children}>,
TooltipTrigger: ({ children }) => <>{children}>,
TooltipContent: ({ children }) => {children}
,
}));
```
**PowerShell - exécution des tests :**
```powershell
cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"; pnpm vitest run --reporter=verbose 2>&1 | Select-Object -First 150
```
### Séquence d'affichage complète
```
Transformateur clique une IdeaRow ou KanbanCard
→ Navigation vers /workspace/[workspaceId]/ideas/[ideaId]
→ IdeaDetailPage (Server Component) vérifie auth (session NextAuth)
→ IdeaDetailView monté (Client Component)
→ api.idea.getById.useQuery({ ideaId, workspaceId })
→ Skeleton 3 zones pendant isLoading
[données reçues]
→ Section en-tête : titre, statut, contributeur, département, date
→ Si llmEnrichFailed = false :
→ Bloc enrichi : domaine, type IA, explication
→ Section scores : 3 ScoreSlider (Impact, Faisabilité, Urgence)
→ badge "Suggestion IA" si manualScore* = null
→ badge "Ajusté" si manualScore* ≠ null + tooltip LLM original
→ Bouton "Enregistrer les scores"
→ Si llmEnrichFailed = true :
→ Badge "À qualifier manuellement"
→ Bouton "Relancer l'enrichissement"
→ Section pièces jointes : liste ou "Aucune pièce jointe"
→ Lien "← Backlog"
[interaction : ajustement score]
→ Slider déplacé → localScores state mis à jour
→ Bouton "Enregistrer" cliqué
→ api.idea.updateScores.mutate({ ideaId, workspaceId, manualScore* })
→ Spinner pendant mutation
→ Succès : badge passe à "Ajusté", date "Ajusté le [today]" visible
→ Erreur : message d'erreur inline
```
### NFR concernés
- **NFR18** : scores LLM toujours labellisés "Suggestion IA - à ajuster" (badge amber) jusqu'à ajustement manuel
- **NFR14** : isolation workspace - ownership check `workspace.ownerId === session.user.id` dans les 2 procédures
- **NFR5** : perf < 3s pour `getById` - simple `findUnique` + `attachments` (relations, pas de jointures complexes)
### References
- [Source: epics.md#Story 3.4 - Fiche détaillée d'une idée (FR25, FR19, FR20)]
- [Source: prd.md#FR19, FR20, FR25]
- [Source: ux-design-specification.md#ScoreSlider - anatomy, états, badges]
- [Source: ux-design-specification.md#AIBadge - variantes suggested/enriched/generic]
- [Source: architecture.md#Enrichissement & Scoring - components/idea/ScoreSlider.tsx]
- [Source: architecture.md#Backlog (FR22–FR28) - workspace/[workspaceId]/backlog/, routers/idea.ts]
- [Source: architecture.md#Implementation Patterns - protectedProcedure, filtrer par workspaceId, ownership check]
- [Source: prisma/schema.prisma - manualScoreImpact/Feasibility/Urgency (Int?), IdeaAttachment, updatedAt]
- [Source: implementation-artifacts/3-1-enrichissement-llm-post-soumission-fr18-fr18b-fr21.md - retryEnrich déjà implémenté, llmEnrichFailed]
- [Source: implementation-artifacts/3-2-vue-liste-du-backlog-fr22-fr24.md - getBacklog pattern, STATUS_LABELS]
- [Source: implementation-artifacts/3-3-vue-kanban-4-colonnes-fr23.md - KanbanCard links to /ideas/[ideaId], ideaStatus.ts]
- [Source: src/server/api/routers/idea.ts - getBacklog, retryEnrich patterns existants]
- [Source: src/lib/ideaStatus.ts - STATUS_LABELS, STATUS_CLASSES partagés]
- [Source: src/components/backlog/IdeaRow.tsx - IdeaRowData interface]
- [Source: src/components/ui/tooltip.tsx, badge.tsx, skeleton.tsx, button.tsx - composants shadcn disponibles]
## Dev Agent Record
### Agent Model Used
claude-4.6-sonnet-medium-thinking (Cursor)
### Debug Log References
### Completion Notes List
- ✅ Task 1 : `idea.getById` et `idea.updateScores` - protectedProcedure, ownership check, select complet avec attachments
- ✅ Task 2 : Page `/workspace/[workspaceId]/ideas/[ideaId]/page.tsx` - Server Component, auth redirect, metadata
- ✅ Task 3 : `ScoreSlider` - badge amber/violet, tooltip LLM, slider natif 1-5, value prop pour sync local
- ✅ Task 4 : `IdeaAttachmentList` - formatSize, icônes par type MIME, lien target=_blank
- ✅ Task 5 : `IdeaDetailView` - getById useQuery, skeleton 3 zones, retryEnrich, updateScores, toast sonner
- ✅ Task 6 : 22 tests - idea.getById.test.ts (10), ScoreSlider.test.tsx (5), IdeaDetailView.test.tsx (7)
### File List
- aimpact-hub/src/server/api/routers/idea.ts (modifié - getById, updateScores)
- aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/ideas/[ideaId]/page.tsx (créé)
- aimpact-hub/src/components/idea/IdeaDetailView.tsx (créé)
- aimpact-hub/src/components/idea/ScoreSlider.tsx (créé)
- aimpact-hub/src/components/idea/IdeaAttachmentList.tsx (créé)
- aimpact-hub/src/server/api/routers/idea.getById.test.ts (créé)
- aimpact-hub/src/components/idea/ScoreSlider.test.tsx (créé)
- aimpact-hub/src/components/idea/IdeaDetailView.test.tsx (créé)
### Change Log
- 2026-02-28 : Story créée (create-story)
- 2026-02-28 : Implémentation complète Story 3.4 - fiche détaillée idée, 2 procédures tRPC, 4 composants, 22 tests