3-5-gestion-des-statuts-et-statut-non-prioritaire-fr26.md 19 KB

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 :

      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)

    • Subtask 2.1 : Composant "use client" - props : ideaId: string, workspaceId: string, currentStatus: IdeaStatusValue
    • Subtask 2.2 : État local optimisticStatus initialisé à currentStatus (rollback en cas d'erreur - AC #5)
    • 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)
    • Subtask 2.4 : Utiliser le composant shadcn <Select> (déjà installé, utilisé dans BacklogFilters) avec SelectTrigger stylé pour imiter un badge coloré (h-auto w-fit text-xs border px-2 py-0.5)
    • Subtask 2.5 : Appliquer la couleur sémantique du statut sur le SelectTrigger (classes du STATUS_CLASSES à importer ou redéfinir)
    • Subtask 2.6 : Désactiver le Select pendant isPending (AC #2)
    • Subtask 2.7 : Les 5 options affichent leur label français et couleur sémantique (AC #1)
  • [x] Task 3 : Intégrer StatusSelect dans IdeaRow.tsx (AC: #1, #2, #3, #4)

    • Subtask 3.1 : Remplacer le <Badge> statique dans la TableCell "Statut" par <StatusSelect ideaId={idea.id} workspaceId={workspaceId} currentStatus={idea.status as IdeaStatusValue} />
    • Subtask 3.2 : Supprimer les constantes locales STATUS_LABELS et STATUS_CLASSES de IdeaRow.tsx si elles sont déplacées dans StatusSelect.tsx (ou les exporter/partager - voir Dev Notes)
    • Subtask 3.3 : Vérifier que IdeaRowData (RouterOutputs["idea"]["getBacklog"][number]) contient bien le champ status correctement typé
  • [x] Task 4 : Tests (AC: #2, #3, #5, #6)

    • Subtask 4.1 : Créer src/server/api/routers/idea.updateStatus.test.ts avec Vitest
    • Subtask 4.2 : Test : sans auth → UNAUTHORIZED
    • Subtask 4.3 : Test : workspace non propriétaire → UNAUTHORIZED
    • Subtask 4.4 : Test : workspace null (introuvable) → UNAUTHORIZED
    • Subtask 4.5 : Test : idée n'appartient pas au workspace → NOT_FOUND
    • Subtask 4.6 : Test : idée introuvable → NOT_FOUND
    • Subtask 4.7 : Test : changement de statut valide → retourne { id, status: "IN_REVIEW" }
    • Subtask 4.8 : Test : changement vers NOT_PRIORITY → retourne { id, status: "NOT_PRIORITY" }
    • Subtask 4.9 : Créer src/components/backlog/StatusSelect.test.tsx avec Vitest + React Testing Library
    • Subtask 4.10 : Test : affiche le statut courant dans le trigger
    • Subtask 4.11 : Test : désactivé pendant isPending (mock mutation)

Dev Notes

Architecture & Décisions techniques

Procédure tRPC idea.updateStatus - pattern ownership (Story 3.2, 3.4) :

updateStatus: protectedProcedure
  .input(
    z.object({
      ideaId: z.string().cuid(),
      workspaceId: z.string().cuid(),
      status: z.enum(IDEA_STATUS_VALUES),
    })
  )
  .mutation(async ({ ctx, input }) => {
    // 1. Ownership check EN PREMIER (anti information disclosure)
    const workspace = await ctx.db.workspace.findUnique({
      where: { id: input.workspaceId },
      select: { ownerId: true },
    });
    if (!workspace || workspace.ownerId !== ctx.session.user.id) {
      throw new TRPCError({ code: "UNAUTHORIZED", message: "Vous n'êtes pas propriétaire de ce workspace." });
    }

    // 2. Vérifier que l'idée appartient au workspace
    const idea = await ctx.db.idea.findUnique({
      where: { id: input.ideaId },
      select: { id: true, workspaceId: true },
    });
    if (!idea || idea.workspaceId !== input.workspaceId) {
      throw new TRPCError({ code: "NOT_FOUND", message: "Idée non trouvée ou n'appartient pas à ce workspace." });
    }

    // 3. Mise à jour du statut
    const updated = await ctx.db.idea.update({
      where: { id: input.ideaId },
      data: { status: input.status },
      select: { id: true, status: true },
    });

    return updated;
  }),

Réutilisation de IDEA_STATUS_VALUES :

  • Déjà exporté depuis ~/server/api/routers/idea.ts (Story 3.2 + code review)
  • Import : import { IDEA_STATUS_VALUES, type IdeaStatusValue } from "~/server/api/routers/idea"

Composant StatusSelect - rollback optimiste :

const [optimisticStatus, setOptimisticStatus] = useState<IdeaStatusValue>(currentStatus);

const { mutate, isPending } = api.idea.updateStatus.useMutation({
  onMutate: ({ status }) => {
    setOptimisticStatus(status); // Update immédiate
  },
  onSuccess: () => {
    void utils.idea.getBacklog.invalidate();
    if (optimisticStatus === "NOT_PRIORITY") {
      toast.success("Idée déplacée dans les non-prioritaires - utilisez le filtre pour la retrouver.");
    } else {
      toast.success("Statut mis à jour.");
    }
  },
  onError: () => {
    setOptimisticStatus(currentStatus); // Revert
    toast.error("Impossible de modifier le statut. Veuillez réessayer.");
  },
});

⚠️ IMPORTANT - synchronisation optimisticStatus avec currentStatus :

  • Si le parent IdeaRow reçoit un nouveau idea.status après refetch, il faut que StatusSelect se synchronise.
  • Solution : utiliser useEffect(() => { setOptimisticStatus(currentStatus); }, [currentStatus]) pour rester en sync avec les données React Query.

Toast NOT_PRIORITY vs. toast générique :

  • Détecter dans onSuccess si le statut cible (celui de optimisticStatus APRÈS onMutate) est "NOT_PRIORITY"
  • Alternative plus propre : capturer la valeur dans la closure de onSuccess via le data retourné par la mutation : onSuccess: (data) => { if (data.status === "NOT_PRIORITY") { ... } }

Invalidation React Query :

// Invalider TOUTES les requêtes getBacklog du workspace (tous paramètres de tri/filtre)
void utils.idea.getBacklog.invalidate();
// Note : invalidate() sans paramètres invalide toutes les queries getBacklog
// Si besoin de cibler ce workspace uniquement :
// void utils.idea.getBacklog.invalidate({ workspaceId });

Partage des constantes STATUS_LABELS / STATUS_CLASSES :

  • Actuellement dans IdeaRow.tsx (Story 3.2) : STATUS_LABELS et STATUS_CLASSES
  • Ces constantes seront aussi nécessaires dans StatusSelect.tsx
  • Décision : déplacer STATUS_LABELS et STATUS_CLASSES dans StatusSelect.tsx et les exporter
  • Puis dans IdeaRow.tsx : importer depuis StatusSelect.tsx ou supprimer si plus utilisées

Composant Select shadcn pour le trigger badge :

<Select value={optimisticStatus} onValueChange={handleChange} disabled={isPending}>
  <SelectTrigger
    className={`h-auto w-fit gap-1 border px-2 py-0.5 text-xs font-medium focus:ring-0 focus:ring-offset-0 ${STATUS_CLASSES[optimisticStatus]}`}
  >
    <SelectValue />
  </SelectTrigger>
  <SelectContent>
    {ORDERED_STATUSES.map(({ value, label }) => (
      <SelectItem key={value} value={value} className="text-xs">
        <span className={`inline-block rounded px-1.5 py-0.5 ${STATUS_CLASSES[value]}`}>
          {label}
        </span>
      </SelectItem>
    ))}
  </SelectContent>
</Select>

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 <SelectTrigger className="... [&>svg]:hidden ..."> ou l'accepter comme affordance de clic.

ORDERED_STATUSES constant suggérée :

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 :

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é

// 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 <StatusSelect>, 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