3-7-resume-des-nouvelles-activites-fr28.md 19 KB

Story 3.7 : Résumé des nouvelles activités (FR28)

Status: done

Story

En tant que Transformateur, je veux voir un résumé des nouvelles activités depuis ma dernière visite (nouvelles idées), afin de savoir immédiatement ce qui a changé dans mon workspace sans parcourir tout le backlog.

Acceptance Criteria

  1. Given je reviens sur le dashboard ou la page backlog de mon workspace (session authentifiée) When des idées ont été soumises depuis ma dernière visite (lastVisitedAt enregistré côté serveur) Then un bandeau de résumé s'affiche en haut de la page : « X nouvelle(s) idée(s) soumise(s) depuis votre dernière visite » And le bandeau est visible aussi bien sur le dashboard workspace que sur la page backlog

  2. Given c'est ma première visite (aucun lastVisitedAt enregistré) When j'accède au dashboard ou au backlog Then aucun bandeau de résumé n'est affiché (pas de notion de "nouveau" sans référence temporelle) And lastVisitedAt est initialisé à now() pour la prochaine visite

  3. Given aucune nouvelle idée n'a été soumise depuis ma dernière visite When j'accède au dashboard ou au backlog Then aucun bandeau de résumé n'est affiché

  4. Given le bandeau de résumé est affiché When je consulte la page Then le bandeau contient un lien ou CTA « Voir les nouvelles idées » qui filtre le backlog pour afficher uniquement les idées récentes (ou redirige vers le backlog) And le bandeau est dismissable (bouton ×) — le dismiss est côté client uniquement (pas de persistance serveur du dismiss)

  5. Given je suis sur le dashboard ou le backlog When la page se charge (et le bandeau s'affiche ou non) Then lastVisitedAt est mis à jour à now() côté serveur (appel markVisited) And la prochaine visite utilise ce nouveau timestamp comme référence

  6. Given un utilisateur non propriétaire du workspace appelle workspace.getActivitySummary ou workspace.markVisited When la procédure tRPC est exécutée Then une erreur UNAUTHORIZED est retournée (ownership check via createWorkspaceProcedure)

Tasks / Subtasks

  • [x] Task 1 : Migration Prisma — ajouter lastVisitedAt à Workspace (AC: #2, #5)

    • Subtask 1.1 : Dans prisma/schema.prisma, ajouter le champ lastVisitedAt DateTime? au modèle Workspace (après autoRelanceEnabled)
    • Subtask 1.2 : Créer la migration : pnpm prisma migrate dev --name add_last_visited_at
    • Subtask 1.3 : Vérifier que pnpm prisma generate s'exécute sans erreur et que le type Prisma est mis à jour
  • [x] Task 2 : Ajouter les procédures tRPC dans src/server/api/routers/workspace.ts (AC: #1, #2, #3, #5, #6)

    • [x] Subtask 2.1 : Ajouter la procédure getActivitySummary (query, createWorkspaceProcedure) :

      getActivitySummary: createWorkspaceProcedure.query(async ({ ctx }) => {
      const workspace = ctx.workspace;
      if (!workspace.lastVisitedAt) {
      return { newIdeasCount: 0, lastVisitedAt: null, isFirstVisit: true };
      }
      const newIdeasCount = await db.idea.count({
      where: {
        workspaceId: workspace.id,
        createdAt: { gt: workspace.lastVisitedAt },
      },
      });
      return { newIdeasCount, lastVisitedAt: workspace.lastVisitedAt, isFirstVisit: false };
      }),
      
    • [x] Subtask 2.2 : Ajouter la procédure markVisited (mutation, createWorkspaceProcedure) :

      markVisited: createWorkspaceProcedure.mutation(async ({ ctx }) => {
      await db.workspace.update({
      where: { id: ctx.workspace.id },
      data: { lastVisitedAt: new Date() },
      });
      return { ok: true };
      }),
      
    • [x] Subtask 2.3 : Vérifier que les deux procédures sont bien exportées via le workspaceRouter

  • [x] Task 3 : Créer le composant ActivitySummaryBanner dans src/components/workspace/ActivitySummaryBanner.tsx (AC: #1, #3, #4)

    • [x] Subtask 3.1 : Composant "use client" avec props :

      interface ActivitySummaryBannerProps {
      workspaceId: string;
      }
      
    • [x] Subtask 3.2 : Le composant appelle api.workspace.getActivitySummary.useQuery({ workspaceId }) pour récupérer newIdeasCount et isFirstVisit

    • [x] Subtask 3.3 : Le composant appelle api.workspace.markVisited.useMutation() et déclenche la mutation au montage (useEffect avec []) — après récupération du summary

    • [x] Subtask 3.4 : Logique d'affichage :

    • Si isFirstVisit === true ou newIdeasCount === 0 → ne rien rendre (return null)

    • Si newIdeasCount > 0 → afficher le bandeau (shadcn Alert ou div stylisée)

    • [x] Subtask 3.5 : Contenu du bandeau :

    • Icône Bell (lucide-react)

    • Texte : "X nouvelle(s) idée(s) soumise(s) depuis votre dernière visite"

    • Pluriel : "1 nouvelle idée" vs "X nouvelles idées" (gestion i18n simple)

    • Lien/CTA "Voir dans le backlog" → href="/workspace/{workspaceId}/backlog"

    • Bouton × (dismiss) : useState<boolean> dismissed, si dismissed → return null

    • [x] Subtask 3.6 : Appliquer les styles : bg-violet-50 border border-violet-200 text-violet-900 rounded-lg p-3 flex items-center gap-3 text-sm (design tokens Livinia Chaleureux)

  • [x] Task 4 : Intégrer ActivitySummaryBanner dans les pages dashboard et backlog (AC: #1)

    • Subtask 4.1 : Dans src/app/(dashboard)/workspace/[workspaceId]/page.tsx (dashboard workspace) — ajouter <ActivitySummaryBanner workspaceId={workspaceId} /> avant le contenu principal (nécessite que la page passe workspaceId comme prop ou le récupère via les params)
    • Subtask 4.2 : Dans src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx — ajouter <ActivitySummaryBanner workspaceId={workspaceId} /> en tête de page, avant <BacklogListView> ou <KanbanView>
    • Subtask 4.3 : Vérifier que le workspaceId est correctement passé (params Next.js App Router : params.workspaceId)
  • [x] Task 5 : Tests (AC: #1, #2, #3, #5, #6)

    • Subtask 5.1 : Créer src/server/api/routers/workspace.getActivitySummary.test.ts (Vitest)
    • Subtask 5.2 : Test : lastVisitedAt null → { isFirstVisit: true, newIdeasCount: 0 }
    • Subtask 5.3 : Test : lastVisitedAt défini + 3 idées créées après → { isFirstVisit: false, newIdeasCount: 3 }
    • Subtask 5.4 : Test : lastVisitedAt défini + 0 idées après → { isFirstVisit: false, newIdeasCount: 0 }
    • Subtask 5.5 : Test : ownership check — workspace appartenant à un autre user → NOT_FOUND
    • Subtask 5.6 : Créer src/server/api/routers/workspace.markVisited.test.ts (Vitest)
    • Subtask 5.7 : Test markVisited : met à jour lastVisitedAt sur le workspace
    • Subtask 5.8 : Test markVisited : ownership check — autre user → NOT_FOUND
    • Subtask 5.9 : Créer src/components/workspace/ActivitySummaryBanner.test.tsx (Vitest + RTL)
    • Subtask 5.10 : Test : newIdeasCount > 0 → bandeau affiché avec le bon texte
    • Subtask 5.11 : Test : isFirstVisit === true → rien affiché
    • Subtask 5.12 : Test : newIdeasCount === 0 et isFirstVisit === false → rien affiché
    • Subtask 5.13 : Test : clic sur × → bandeau masqué (state dismissed)

Dev Notes

Architecture & Décisions techniques

Approche retenue : lastVisitedAt sur le modèle Workspace

Depuis le MVP impose 1 user = 1 workspace, stocker lastVisitedAt directement sur Workspace est la solution la plus simple et la moins coûteuse :

  • Pas de modèle supplémentaire
  • Accès direct via createWorkspaceProcedure (ctx.workspace déjà chargé)
  • Aucune complexité de jointure ou de mapping

Alternative rejetée : stocker dans localStorage côté client. Fragile (effacé si l'utilisateur change de navigateur/appareil), non compatible avec le principe de vérité serveur.

Alternative rejetée : modèle WorkspaceVisit dédié. Surengineering pour MVP.

Séquence d'appels côté client :

1. Page monte
2. useQuery getActivitySummary → récupère newIdeasCount / isFirstVisit (basé sur lastVisitedAt AVANT mise à jour)
3. Si newIdeasCount > 0 → affiche bandeau
4. useEffect [] → appelle markVisited (mutation) → lastVisitedAt = now()
5. Prochaine visite : compte les idées soumises après ce timestamp

Important : La mutation markVisited doit être appelée après ou en parallèle de getActivitySummary, jamais avant. Si appelée avant, le summary retournerait toujours 0. Le useEffect avec [] garantit que markVisited est appelé une seule fois au montage, après le render initial.

Pattern createWorkspaceProcedure :

Utilisé de manière identique aux Stories 1.6, 3.2, 3.5, 3.6 :

// workspace.ts
getActivitySummary: createWorkspaceProcedure.query(async ({ ctx }) => {
  const workspace = ctx.workspace; // ownership déjà vérifié par createWorkspaceProcedure
  // ...
}),

Pattern mutation markVisited avec useEffect dans le composant :

"use client";

import { useEffect, useState } from "react";
import { Bell, X } from "lucide-react";
import Link from "next/link";
import { api } from "~/trpc/react";

interface ActivitySummaryBannerProps {
  workspaceId: string;
}

export function ActivitySummaryBanner({ workspaceId }: ActivitySummaryBannerProps) {
  const [dismissed, setDismissed] = useState(false);

  const { data: summary } = api.workspace.getActivitySummary.useQuery({ workspaceId });
  const markVisited = api.workspace.markVisited.useMutation();

  useEffect(() => {
    if (summary !== undefined) {
      markVisited.mutate({ workspaceId });
    }
  // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [summary !== undefined]); // déclenche une seule fois quand summary est chargé

  if (!summary || summary.isFirstVisit || summary.newIdeasCount === 0 || dismissed) {
    return null;
  }

  const label =
    summary.newIdeasCount === 1
      ? "1 nouvelle idée soumise depuis votre dernière visite"
      : `${summary.newIdeasCount} nouvelles idées soumises depuis votre dernière visite`;

  return (
    <div className="mb-4 flex items-center gap-3 rounded-lg border border-violet-200 bg-violet-50 px-4 py-3 text-sm text-violet-900">
      <Bell className="h-4 w-4 shrink-0 text-violet-600" />
      <span className="flex-1">{label}</span>
      <Link
        href={`/workspace/${workspaceId}/backlog`}
        className="font-medium underline hover:no-underline"
      >
        Voir dans le backlog
      </Link>
      <button
        onClick={() => setDismissed(true)}
        className="ml-2 text-violet-400 hover:text-violet-700"
        aria-label="Fermer le résumé"
        type="button"
      >
        <X className="h-4 w-4" />
      </button>
    </div>
  );
}

Migration Prisma

Champ à ajouter sur Workspace :

// Dans model Workspace — après autoRelanceEnabled
lastVisitedAt DateTime? // Story 3.7 : résumé nouvelles activités (FR28)

Fichier migration : prisma/migrations/YYYYMMDDHHMMSS_add_last_visited_at/migration.sql

ALTER TABLE "Workspace" ADD COLUMN "lastVisitedAt" TIMESTAMP(3);

Le champ est nullable (DateTime?) — null = première visite, pas de summary à afficher.

Aucune migration de données existantes requise — les workspaces existants auront lastVisitedAt = null jusqu'à la prochaine visite du Transformateur, ce qui est le comportement attendu (AC #2 : première visite → pas de bandeau).

Structure des fichiers

Fichier Action
prisma/schema.prisma Modifier — ajouter lastVisitedAt DateTime? au modèle Workspace
prisma/migrations/YYYYMMDD_add_last_visited_at/migration.sql Créer — migration SQL
src/server/api/routers/workspace.ts Modifier — ajouter getActivitySummary (query) et markVisited (mutation)
src/components/workspace/ActivitySummaryBanner.tsx Créer — bandeau résumé nouvelles activités
src/app/(dashboard)/workspace/[workspaceId]/page.tsx Modifier — intégrer <ActivitySummaryBanner>
src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx Modifier — intégrer <ActivitySummaryBanner>
src/server/api/routers/workspace.getActivitySummary.test.ts Créer — tests Vitest
src/server/api/routers/workspace.markVisited.test.ts Créer — tests Vitest
src/components/workspace/ActivitySummaryBanner.test.tsx Créer — tests Vitest + RTL

Conventions architecture à respecter

  • createWorkspaceProcedure : OBLIGATOIRE pour getActivitySummary et markVisited — ownership check automatique (NFR14)
  • Filtrer par workspaceId : where: { workspaceId: workspace.id, ... } — jamais de requête sans workspace
  • Zod input : z.object({ workspaceId: z.string() }) — pattern identique à toutes les procédures workspace
  • React Query invalidation : markVisited ne nécessite pas d'invalider getActivitySummary (le summary est affiché basé sur l'ancien timestamp, mis à jour une seule fois au montage)
  • Composant "use client" : obligatoire pour ActivitySummaryBanner (hooks React)
  • Tests co-localisés : *.test.ts / *.test.tsx à côté du fichier testé
  • Pas de toast : action silencieuse (markVisited est un tracking côté serveur, pas une action utilisateur visible)
  • shadcn/ui : utiliser les tokens Tailwind du design system Livinia (violet-50, violet-200, violet-600, violet-900)

Apprentissages des stories précédentes

Story 3.6 (recherche backlog) :

  • Pattern createWorkspaceProcedure → ctx.workspace déjà validé et chargé, pas besoin de re-fetcher le workspace dans la procédure
  • Pattern test Vitest pour procédures workspace : mocker ctx.workspace avec ownership check
  • Composants dans src/components/backlog/ (ou src/components/workspace/ pour ce cas) — nommage PascalCase

Story 3.2 (vue liste backlog) :

  • Le BacklogListView est le composant principal du backlog — le bandeau doit être injecté AVANT lui, pas dedans (séparation des concerns)
  • React Query re-fetch automatique : getActivitySummary sera invalidé si on invalide tout le workspace (pas pertinent ici)

Story 3.5 (gestion statuts) :

  • utils.idea.getBacklog.invalidate() sans paramètres invalide toutes les queries du workspace — si le Transformateur change un statut puis revient sur la page, le count getActivitySummary n'est pas re-fetchable (ce n'est pas un problème : le summary est affiché une seule fois par visite, pas réactif aux changements de statut)

Story 3.4 (fiche détaillée) :

  • La navigation vers la fiche détaillée ne doit PAS déclencher markVisited (uniquement dashboard + backlog comme défini dans les AC)
  • L'URL /workspace/[workspaceId]/ideas/[ideaId] ne devra PAS porter ActivitySummaryBanner

Story 1.6 (tier) :

  • Pattern createWorkspaceProcedure — ctx.workspace est le workspace complet avec tous les champs, y compris lastVisitedAt après la migration

Cas limites et comportements attendus

Cas Comportement
Première visite (lastVisitedAt null) Pas de bandeau ; markVisited initialise lastVisitedAt
0 nouvelles idées depuis la dernière visite Pas de bandeau
1 nouvelle idée Bandeau : "1 nouvelle idée soumise depuis votre dernière visite"
N nouvelles idées (N > 1) Bandeau : "N nouvelles idées soumises depuis votre dernière visite"
Idées avec llmEnrichFailed: true Comptées comme nouvelles idées (enrichissement != existence)
Dismiss du bandeau Masqué côté client uniquement (state React), pas de persistance
Navigation dashboard → backlog dans la même session Le dismiss est réinitialisé (nouveau montage du composant)
Visiteur accédant au formulaire /submit/[slug] Pas de markVisited — contributeur sans session Transformateur

NFR concernés

  • NFR5 : pas d'impact (nouvelle requête COUNT simple sur index [workspaceId, createdAt] — très rapide)
  • NFR14 : isolation workspace — createWorkspaceProcedure garantit que seul le propriétaire accède aux données

References

  • [Source: epics.md#Story 3.7 — Résumé des nouvelles activités (FR28)]
  • [Source: prd.md#FR28 — résumé nouvelles activités depuis dernière visite]
  • [Source: architecture.md#Implementation Patterns — createWorkspaceProcedure, protectedProcedure, ownership check]
  • [Source: architecture.md#Pattern Examples — procédure tRPC avec workspaceId filter]
  • [Source: architecture.md#Project Structure — components/workspace/, app/(dashboard)/workspace/[workspaceId]/]
  • [Source: prisma/schema.prisma — model Workspace (champs existants, pattern DateTime?)]
  • [Source: src/server/api/routers/workspace.ts — workspaceRouter existant, createWorkspaceProcedure usage, getTierInfo pattern]
  • [Source: implementation-artifacts/3-6-recherche-dans-le-backlog-fr27.md — patterns tests Vitest, SearchInput "use client", useEffect debounce]
  • [Source: implementation-artifacts/3-2-vue-liste-du-backlog-fr22-fr24.md — BacklogListView structure, React Query useQuery pattern]

Dev Agent Record

Agent Model Used

Composer (Cursor)

Debug Log References

Completion Notes List

  • ✅ Task 1 : Migration Prisma lastVisitedAt DateTime? sur Workspace — migration 20260228161850_add_last_visited_at appliquée
  • ✅ Task 2 : Procédures getActivitySummary (query) et markVisited (mutation) ajoutées au workspaceRouter avec createWorkspaceProcedure
  • ✅ Task 3 : Composant ActivitySummaryBanner créé — useQuery getActivitySummary, useMutation markVisited, useEffect au montage, dismiss client-side
  • ✅ Task 4 : ActivitySummaryBanner intégré sur dashboard workspace et page backlog
  • ✅ Task 5 : 5 tests getActivitySummary + 3 tests markVisited + 6 tests ActivitySummaryBanner (RTL)
  • Tous les 339 tests passent, aucune régression

File List

  • aimpact-hub/prisma/schema.prisma (modifié)
  • aimpact-hub/prisma/migrations/20260228161850_add_last_visited_at/migration.sql (créé)
  • aimpact-hub/src/server/api/routers/workspace.ts (modifié)
  • aimpact-hub/src/components/workspace/ActivitySummaryBanner.tsx (créé)
  • aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/page.tsx (modifié)
  • aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx (modifié)
  • aimpact-hub/src/server/api/routers/workspace.getActivitySummary.test.ts (créé)
  • aimpact-hub/src/server/api/routers/workspace.markVisited.test.ts (créé)
  • aimpact-hub/src/components/workspace/ActivitySummaryBanner.test.tsx (créé)

Change Log

  • 2026-02-28 : Implémentation complète Story 3.7 (FR28) — résumé des nouvelles activités depuis la dernière visite. Migration Prisma lastVisitedAt, procédures getActivitySummary + markVisited, composant ActivitySummaryBanner sur dashboard et backlog. 14 tests ajoutés.