# Story 3.5 : Gestion des statuts et statut Non prioritaire (FR26) Status: done ## Story En tant que Transformateur, je veux changer le statut d'une idée directement depuis le backlog (Envoyé → En traitement → Mis à l'ordre du jour → En cours → Non prioritaire), afin de structurer mon pipeline et de marquer les idées non prioritaires sans les perdre. ## Acceptance Criteria 1. **Given** je suis sur la vue liste du backlog (Story 3.2) **When** je consulte la colonne "Statut" d'une idée **Then** le statut s'affiche comme un sélecteur interactif (au lieu d'un badge statique) **And** je peux ouvrir le sélecteur et voir les 5 options : Envoyé, En traitement, Mis à l'ordre du jour, En cours, Non prioritaire **And** chaque option affiche sa couleur sémantique (gray / blue / violet / green / yellow) 2. **Given** je sélectionne un nouveau statut dans le sélecteur **When** la mutation `api.idea.updateStatus` réussit **Then** un toast de confirmation s'affiche : "Statut mis à jour" **And** le backlog se rafraîchit (invalidation React Query) et la ligne affiche le nouveau statut **And** pendant la mise à jour le sélecteur est désactivé (indicateur visuel) 3. **Given** je change le statut d'une idée en "Non prioritaire" **When** la liste se rafraîchit (filtre par défaut : `includeNotPriority = false`) **Then** l'idée disparaît de la vue active **And** un toast spécifique indique : "Idée déplacée dans les non-prioritaires — utilisez le filtre pour la retrouver." **And** aucune idée n'est supprimée de la base de données (vérifiable via le filtre) 4. **Given** le filtre "Afficher les non-prioritaires" est activé (Story 3.2) **When** je consulte le backlog **Then** les idées Non prioritaire sont visibles **And** le sélecteur de statut est disponible sur ces idées pour les reclasser dans un autre statut 5. **Given** une erreur réseau ou serveur survient pendant la mutation **When** la mutation échoue **Then** un toast d'erreur s'affiche : "Impossible de modifier le statut. Veuillez réessayer." **And** le sélecteur revient à l'état précédent (rollback optimiste) 6. **Given** un utilisateur non authentifié ou non propriétaire du workspace appelle `idea.updateStatus` **When** la procédure tRPC est appelée **Then** une erreur `UNAUTHORIZED` est retournée **And** si l'idée n'appartient pas au workspace → `NOT_FOUND` ## Tasks / Subtasks - [x] Task 1 : Procédure tRPC `idea.updateStatus` dans `src/server/api/routers/idea.ts` (AC: #2, #6) - [x] Subtask 1.1 : Ajouter `updateStatus` comme `protectedProcedure` avec input Zod : ```typescript z.object({ ideaId: z.string().cuid(), workspaceId: z.string().cuid(), status: z.enum(IDEA_STATUS_VALUES), // IDEA_STATUS_VALUES déjà exporté depuis Story 3.2 }) ``` - [x] Subtask 1.2 : Vérifier ownership workspace EN PREMIER (pattern établi Stories 3.2, 3.4) → UNAUTHORIZED si non propriétaire - [x] Subtask 1.3 : Vérifier que l'idée existe ET appartient au workspace → NOT_FOUND si non - [x] Subtask 1.4 : Appeler `ctx.db.idea.update({ where: { id: ideaId }, data: { status } })` - [x] Subtask 1.5 : Retourner `{ id: idea.id, status: updatedIdea.status }` - [x] Task 2 : Composant `StatusSelect` dans `src/components/backlog/StatusSelect.tsx` (AC: #1, #2, #3, #4, #5) - [x] Subtask 2.1 : Composant `"use client"` — props : `ideaId: string`, `workspaceId: string`, `currentStatus: IdeaStatusValue` - [x] Subtask 2.2 : État local `optimisticStatus` initialisé à `currentStatus` (rollback en cas d'erreur — AC #5) - [x] Subtask 2.3 : Utiliser `api.idea.updateStatus.useMutation` avec : - `onSuccess` : `utils.idea.getBacklog.invalidate()` + toast adapté (NOT_PRIORITY vs. autre statut — AC #2, #3) - `onError` : revert `optimisticStatus` + toast erreur (AC #5) - [x] Subtask 2.4 : Utiliser le composant shadcn ` {ORDERED_STATUSES.map(({ value, label }) => ( {label} ))} ``` > Note : le `SelectTrigger` shadcn affiche une flèche chevron par défaut via `SelectIcon`. Pour un look badge, on peut supprimer l'icône avec `` ou l'accepter comme affordance de clic. **`ORDERED_STATUSES` constant suggérée :** ```typescript const ORDERED_STATUSES: Array<{ value: IdeaStatusValue; label: string }> = [ { value: "SUBMITTED", label: "Envoyé" }, { value: "IN_REVIEW", label: "En traitement" }, { value: "ON_AGENDA", label: "Mis à l'ordre du jour" }, { value: "IN_PROGRESS", label: "En cours" }, { value: "NOT_PRIORITY", label: "Non prioritaire" }, ]; ``` ### Schéma Prisma — aucune migration requise Le champ `status: IdeaStatus @default(SUBMITTED)` et l'enum `IdeaStatus` sont déjà en place : ```prisma enum IdeaStatus { SUBMITTED // Envoyé (statut initial) IN_REVIEW // En traitement ON_AGENDA // Mis à l'ordre du jour IN_PROGRESS // En cours NOT_PRIORITY // Non prioritaire (filtrable, non supprimé — FR26) } ``` L'index `@@index([workspaceId, status])` est déjà présent → la mutation `idea.update` est performante. **Aucun `prisma migrate` requis pour cette story.** ### Structure des fichiers | Fichier | Action | |---------|--------| | `src/server/api/routers/idea.ts` | Modifier — ajouter `updateStatus` procedure | | `src/components/backlog/StatusSelect.tsx` | Créer — sélecteur statut interactif | | `src/components/backlog/IdeaRow.tsx` | Modifier — intégrer `StatusSelect`, exporter constants | | `src/server/api/routers/idea.updateStatus.test.ts` | Créer — tests Vitest procédure | | `src/components/backlog/StatusSelect.test.tsx` | Créer — tests RTL composant | ### Conventions architecture à respecter - **Ownership check AVANT toute opération** : `workspace.ownerId === ctx.session.user.id` → UNAUTHORIZED - **Filtrer par `workspaceId`** : toutes les requêtes Prisma sur `Idea` incluent `workspaceId` - **Toast via Sonner** : `import { toast } from "sonner"` — déjà installé (Story 2.2, `providers.tsx`) - **Invalidation React Query** : `utils.idea.getBacklog.invalidate()` après mutation réussie - **`protectedProcedure`** pour `updateStatus` — le Transformateur doit être authentifié - **Tests co-localisés** : `*.test.ts` ou `*.test.tsx` à côté du fichier testé ### Apprentissages des stories précédentes **Story 3.2 (vue liste backlog) :** - `IDEA_STATUS_VALUES` et `IdeaStatusValue` sont exportés depuis `idea.ts` — réutiliser directement - `STATUS_LABELS` et `STATUS_CLASSES` sont dans `IdeaRow.tsx` — à migrer vers `StatusSelect.tsx` - Le toggle `includeNotPriority` est déjà géré dans `BacklogFilters` → après changement vers NOT_PRIORITY + invalidation React Query, l'idée disparaît automatiquement de la liste si le filtre est désactivé - `IdeaRowData` = `RouterOutputs["idea"]["getBacklog"][number]` — le champ `status` est bien inclus **Story 3.4 (fiche détaillée — ready-for-dev) :** - La fiche détaillée aura aussi besoin du changement de statut (AC #4 de Story 3.4 : statut courant affiché + modifiable) - `StatusSelect` pourra être réutilisé dans la fiche détaillée Story 3.4 sans modification - Le composant doit donc être générique (pas de dépendance au contexte "backlog" spécifiquement) **Story 3.1 (enrichissement LLM) :** - Pattern `retryEnrich` pour la vérification d'appartenance : `idea.workspaceId !== input.workspaceId → NOT_FOUND` - Ordre recommandé : ownership check AVANT idea lookup (Story 3.2) — à suivre dans `updateStatus` **Story 3.2 code review (après corrections) :** - `STATUS_CLASSES` dans `IdeaRow.tsx` utilise `NOT_PRIORITY: "bg-gray-50 text-gray-400 border-gray-100"` — mais UX spec suggère yellow (`#fef9c3 / #a16207`) pour Non prioritaire. **Profiter de cette story pour aligner `NOT_PRIORITY` sur la spec UX** : `bg-yellow-50 text-yellow-700 border-yellow-200`. ### Pattern de test recommandé ```typescript // idea.updateStatus.test.ts const mockIdeaFindUnique = vi.fn(); const mockIdeaUpdate = vi.fn(); const mockWorkspaceFindUnique = vi.fn(); vi.mock("~/server/db", () => ({ db: { idea: { findUnique: mockIdeaFindUnique, update: mockIdeaUpdate }, workspace: { findUnique: mockWorkspaceFindUnique }, }, })); const IDEA_BASE = { id: "clxyz123456789012345678910", workspaceId: WORKSPACE_ID, }; // Test 4.7 : changement de statut valide it("met à jour le statut de l'idée", async () => { mockWorkspaceFindUnique.mockResolvedValue({ ownerId: OWNER_ID }); mockIdeaFindUnique.mockResolvedValue(IDEA_BASE); mockIdeaUpdate.mockResolvedValue({ id: IDEA_BASE.id, status: "IN_REVIEW" }); const caller = await buildCaller(OWNER_ID); const result = await caller.idea.updateStatus({ ideaId: IDEA_BASE.id, workspaceId: WORKSPACE_ID, status: "IN_REVIEW", }); expect(result.status).toBe("IN_REVIEW"); expect(mockIdeaUpdate).toHaveBeenCalledWith({ where: { id: IDEA_BASE.id }, data: { status: "IN_REVIEW" }, select: { id: true, status: true }, }); }); ``` ### NFR concernés - **NFR14** : isolation workspace — vérification `idea.workspaceId === input.workspaceId` + ownership check - **FR26** : les idées Non prioritaire ne sont PAS supprimées, seulement filtrées côté vue - **UX** : retour visuel immédiat (toast + invalidation React Query) — conforme au principe "Confirmer chaque action" (UX spec § Emotional Design Principles) ### References - [Source: epics.md#Story 3.5 — Gestion des statuts et statut Non prioritaire (FR26)] - [Source: prd.md#FR26 — statuts Envoyé / En traitement / Mis à l'ordre du jour / En cours / Non prioritaire] - [Source: architecture.md#Implementation Patterns — protectedProcedure, ownership check, tRPC errors, invalidation React Query] - [Source: architecture.md#Pattern Examples — updateIdeaStatus comme exemple de procédure tRPC] - [Source: ux-design-specification.md#Couleurs statuts — bg-yellow-50 text-yellow-700 pour Non prioritaire] - [Source: ux-design-specification.md#Emotional Design Principles — "Confirmer chaque action"] - [Source: ux-design-specification.md#StatusStepper — progression statuts visible côté contributeur] - [Source: prisma/schema.prisma — enum IdeaStatus, @@index([workspaceId, status])] - [Source: src/server/api/routers/idea.ts — IDEA_STATUS_VALUES, IdeaStatusValue exportés (Story 3.2)] - [Source: src/components/backlog/IdeaRow.tsx — STATUS_LABELS, STATUS_CLASSES (à migrer vers StatusSelect.tsx)] - [Source: src/components/backlog/BacklogFilters.tsx — includeNotPriority toggle déjà implémenté (Story 3.2)] - [Source: implementation-artifacts/3-2-vue-liste-du-backlog-fr22-fr24.md — patterns table, invalidation, IdeaRowData type] - [Source: implementation-artifacts/3-4-fiche-detaillee-dune-idee-fr25-fr19-fr20.md — StatusSelect sera réutilisé en Story 3.4] ## Dev Agent Record ### Agent Model Used claude-4.6-sonnet-medium-thinking (Cursor) ### Debug Log References ### Completion Notes List - ✅ Task 1 : `idea.updateStatus` — ownership check, NOT_FOUND, mutation avec select `{ id, status }` - ✅ Task 2 : `StatusSelect.tsx` — rollback optimiste via `useState` + `useEffect` sync, toast différencié NOT_PRIORITY, invalidation React Query - ✅ Task 3 : `IdeaRow.tsx` — badge statique remplacé par ``, dépendance circulaire résolue dans `ideaStatus.ts` (générique `T extends { status: string }`) - ✅ Correction UX : `NOT_PRIORITY` → `bg-yellow-50 text-yellow-700 border-yellow-200` (spec UX alignée) - ✅ Task 4 : 12 tests (7 tRPC + 5 composant) — 316/316 tests totaux verts, 0 régression - ✅ Mock `StatusSelect` dans `IdeaRow.test.tsx` pour éviter la chaîne next-auth via tRPC ### File List - aimpact-hub/src/server/api/routers/idea.ts (modifié — updateStatus ajouté) - aimpact-hub/src/components/backlog/StatusSelect.tsx (créé) - aimpact-hub/src/components/backlog/IdeaRow.tsx (modifié — StatusSelect intégré, Badge statique supprimé) - aimpact-hub/src/lib/ideaStatus.ts (modifié — couleur NOT_PRIORITY yellow, générique groupByStatus, import circulaire supprimé) - aimpact-hub/src/components/backlog/IdeaRow.test.tsx (modifié — mock StatusSelect ajouté) - aimpact-hub/src/server/api/routers/idea.updateStatus.test.ts (créé) - aimpact-hub/src/components/backlog/StatusSelect.test.tsx (créé) ### Change Log - 2026-02-28 : Story créée (create-story) - 2026-02-28 : Implémentation complète Story 3.5 — updateStatus tRPC, StatusSelect, intégration IdeaRow, 12 tests, correction couleur NOT_PRIORITY