# 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) - [x] Subtask 1.1 : Dans `prisma/schema.prisma`, ajouter le champ `lastVisitedAt DateTime?` au modèle `Workspace` (après `autoRelanceEnabled`) - [x] Subtask 1.2 : Créer la migration : `pnpm prisma migrate dev --name add_last_visited_at` - [x] 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`) : ```typescript 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`) : ```typescript 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 : ```typescript 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` `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) - [x] Subtask 4.1 : Dans `src/app/(dashboard)/workspace/[workspaceId]/page.tsx` (dashboard workspace) - ajouter `` avant le contenu principal (nécessite que la page passe `workspaceId` comme prop ou le récupère via les params) - [x] Subtask 4.2 : Dans `src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx` - ajouter `` en tête de page, avant `` ou `` - [x] 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) - [x] Subtask 5.1 : Créer `src/server/api/routers/workspace.getActivitySummary.test.ts` (Vitest) - [x] Subtask 5.2 : Test : `lastVisitedAt` null → `{ isFirstVisit: true, newIdeasCount: 0 }` - [x] Subtask 5.3 : Test : `lastVisitedAt` défini + 3 idées créées après → `{ isFirstVisit: false, newIdeasCount: 3 }` - [x] Subtask 5.4 : Test : `lastVisitedAt` défini + 0 idées après → `{ isFirstVisit: false, newIdeasCount: 0 }` - [x] Subtask 5.5 : Test : ownership check - workspace appartenant à un autre user → `NOT_FOUND` - [x] Subtask 5.6 : Créer `src/server/api/routers/workspace.markVisited.test.ts` (Vitest) - [x] Subtask 5.7 : Test `markVisited` : met à jour `lastVisitedAt` sur le workspace - [x] Subtask 5.8 : Test `markVisited` : ownership check - autre user → `NOT_FOUND` - [x] Subtask 5.9 : Créer `src/components/workspace/ActivitySummaryBanner.test.tsx` (Vitest + RTL) - [x] Subtask 5.10 : Test : `newIdeasCount > 0` → bandeau affiché avec le bon texte - [x] Subtask 5.11 : Test : `isFirstVisit === true` → rien affiché - [x] Subtask 5.12 : Test : `newIdeasCount === 0` et `isFirstVisit === false` → rien affiché - [x] 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 : ```typescript // 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 :** ```typescript "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 (
{label} Voir dans le backlog
); } ``` ### Migration Prisma **Champ à ajouter sur `Workspace` :** ```prisma // 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` ```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 `` | | `src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx` | Modifier - intégrer `` | | `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.