Files
workshop-manager/openspec/changes/perf-realtime-scale/tasks.md
Froidefond Julien 3d4803f975
All checks were successful
Deploy with Docker Compose / deploy (push) Successful in 3m33s
perf(realtime+data): implement perf-data-optimization and perf-realtime-scale
## perf-data-optimization
- Add @@index([name]) on User model (migration)
- Add WEATHER_HISTORY_LIMIT=90 constant, apply take/orderBy on weather history queries
- Replace deep includes with explicit select on all 6 list service queries
- Add unstable_cache layer with revalidateTag on all list service functions
- Add cache-tags.ts helpers (sessionTag, sessionsListTag, userStatsTag)
- Invalidate sessionsListTag in all create/delete Server Actions

## perf-realtime-scale
- Create src/lib/broadcast.ts: generic createBroadcaster factory with shared polling
  (one interval per active session, starts on first subscriber, stops on last)
- Migrate all 6 SSE routes to use createBroadcaster — removes per-connection setInterval
- Add broadcastToXxx() calls in all Server Actions after mutations for immediate push
- Add SESSIONS_PAGE_SIZE=20, pagination on sessions page with loadMoreSessions action
- Add "Charger plus" button with loading state and "X sur Y" counter in WorkshopTabs

## Tests
- Add 19 unit tests for broadcast.ts (polling lifecycle, userId filtering,
  formatEvent, error resilience, session isolation)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-10 15:30:54 +01:00

2.4 KiB

1. Module broadcast.ts

  • 1.1 Créer src/lib/broadcast.ts avec une Map<string, Set<(event: unknown) => void>> et les fonctions subscribe(sessionId, cb) et broadcast(sessionId, event)
  • 1.2 Ajouter la logique de polling mutualisé : startPolling(sessionId) / stopPolling(sessionId) avec compteur de subscribers
  • 1.3 Écrire un test manuel : ouvrir 2 onglets sur la même session, vérifier qu'un seul interval tourne (log côté serveur)

2. Migration des routes SSE

  • 2.1 Lire toutes les routes src/app/api/*/subscribe/route.ts pour inventorier le pattern actuel
  • 2.2 Migrer la route weather en premier (elle a déjà un pattern partiel) pour valider l'approche
  • 2.3 Migrer les routes swot, motivators, year-review, weekly-checkin une par une
  • 2.4 Vérifier que le cleanup SSE (abort signal) appelle bien unsubscribe() dans chaque route migrée

3. revalidateTag dans les Server Actions

  • 3.1 Définir la convention de tags dans src/lib/cache-tags.ts (ex: session(id), sessionsList(userId))
  • 3.2 Ajouter cacheTag / unstable_cache aux queries de services correspondantes
  • 3.3 Remplacer revalidatePath par revalidateTag dans src/actions/swot.ts
  • 3.4 Remplacer revalidatePath par revalidateTag dans src/actions/motivators.ts
  • 3.5 Remplacer revalidatePath par revalidateTag dans src/actions/year-review.ts
  • 3.6 Remplacer revalidatePath par revalidateTag dans src/actions/weekly-checkin.ts
  • 3.7 Remplacer revalidatePath par revalidateTag dans src/actions/weather.ts
  • 3.8 Vérifier que les mutations se reflètent correctement dans l'UI après revalidation

4. Broadcast depuis les Server Actions

  • 4.1 Ajouter l'appel broadcast(sessionId, { type: 'update' }) dans chaque Server Action de mutation (après revalidateTag)
  • 4.2 Vérifier que les mises à jour collaboratives fonctionnent (ouvrir 2 onglets, muter depuis l'un, voir la mise à jour dans l'autre)

5. Pagination sessions page

  • 5.1 Modifier les queries dans src/services/ pour accepter cursor et limit (défaut: 20)
  • 5.2 Mettre à jour src/app/sessions/page.tsx pour charger la première page + afficher le total
  • 5.3 Créer un Server Action loadMoreSessions(type, cursor) pour la pagination
  • 5.4 Ajouter le bouton "Charger plus" avec état loading dans le composant sessions list
  • 5.5 Vérifier l'affichage "X sur Y sessions" pour chaque type de workshop