Status: done
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.
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
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
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é
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)
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
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)
[x] Task 1 : Migration Prisma - ajouter lastVisitedAt à Workspace (AC: #2, #5)
prisma/schema.prisma, ajouter le champ lastVisitedAt DateTime? au modèle Workspace (après autoRelanceEnabled)pnpm prisma migrate dev --name add_last_visited_atpnpm 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)
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)src/app/(dashboard)/workspace/[workspaceId]/backlog/page.tsx - ajouter <ActivitySummaryBanner workspaceId={workspaceId} /> en tête de page, avant <BacklogListView> ou <KanbanView>workspaceId est correctement passé (params Next.js App Router : params.workspaceId)[x] Task 5 : Tests (AC: #1, #2, #3, #5, #6)
src/server/api/routers/workspace.getActivitySummary.test.ts (Vitest)lastVisitedAt null → { isFirstVisit: true, newIdeasCount: 0 }lastVisitedAt défini + 3 idées créées après → { isFirstVisit: false, newIdeasCount: 3 }lastVisitedAt défini + 0 idées après → { isFirstVisit: false, newIdeasCount: 0 }NOT_FOUNDsrc/server/api/routers/workspace.markVisited.test.ts (Vitest)markVisited : met à jour lastVisitedAt sur le workspacemarkVisited : ownership check - autre user → NOT_FOUNDsrc/components/workspace/ActivitySummaryBanner.test.tsx (Vitest + RTL)newIdeasCount > 0 → bandeau affiché avec le bon texteisFirstVisit === true → rien affichénewIdeasCount === 0 et isFirstVisit === false → rien affichédismissed)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 :
createWorkspaceProcedure (ctx.workspace déjà chargé)Alternative rejetée : stocker dans
localStoragecô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
WorkspaceVisitdé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
markVisiteddoit être appelée après ou en parallèle degetActivitySummary, jamais avant. Si appelée avant, le summary retournerait toujours 0. LeuseEffectavec[]garantit quemarkVisitedest 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>
);
}
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).
| 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 |
createWorkspaceProcedure : OBLIGATOIRE pour getActivitySummary et markVisited - ownership check automatique (NFR14)workspaceId : where: { workspaceId: workspace.id, ... } - jamais de requête sans workspacez.object({ workspaceId: z.string() }) - pattern identique à toutes les procédures workspacemarkVisited ne nécessite pas d'invalider getActivitySummary (le summary est affiché basé sur l'ancien timestamp, mis à jour une seule fois au montage)"use client" : obligatoire pour ActivitySummaryBanner (hooks React)*.test.ts / *.test.tsx à côté du fichier testéStory 3.6 (recherche backlog) :
createWorkspaceProcedure → ctx.workspace déjà validé et chargé, pas besoin de re-fetcher le workspace dans la procédurectx.workspace avec ownership checksrc/components/backlog/ (ou src/components/workspace/ pour ce cas) - nommage PascalCaseStory 3.2 (vue liste backlog) :
BacklogListView est le composant principal du backlog - le bandeau doit être injecté AVANT lui, pas dedans (séparation des concerns)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) :
markVisited (uniquement dashboard + backlog comme défini dans les AC)/workspace/[workspaceId]/ideas/[ideaId] ne devra PAS porter ActivitySummaryBannerStory 1.6 (tier) :
createWorkspaceProcedure - ctx.workspace est le workspace complet avec tous les champs, y compris lastVisitedAt après la migration| 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 |
COUNT simple sur index [workspaceId, createdAt] - très rapide)createWorkspaceProcedure garantit que seul le propriétaire accède aux donnéesComposer (Cursor)
lastVisitedAt DateTime? sur Workspace - migration 20260228161850_add_last_visited_at appliquéegetActivitySummary (query) et markVisited (mutation) ajoutées au workspaceRouter avec createWorkspaceProcedure