mybabyguess/PROJECT_CONTEXT.md

Project Context - Le Juste Poids

Ce fichier sert de handoff rapide pour reprendre le projet dans une nouvelle conversation Copilot.

Specification metier complete:

• SPEC_FONCTIONNELLE.md

1) Stack et structure

• Monorepo npm workspaces
• API: NestJS + Prisma + PostgreSQL
• Front: Next.js (App Router)
• DB locale: Docker Compose

Arborescence utile:

• apps/api - backend NestJS
• apps/web - frontend Next.js
• docker-compose.yml - stack locale (web/api/db)

2) Commandes utiles

Installer:

npm install

Lancer toute la stack:

docker compose up --build

Build API + Web:

npm run build -w apps/api ; npm run build -w apps/web

URLs locales attendues:

• Web: http://localhost:3002
• API: http://localhost:3001
• DB: localhost:5432

3) Auth et rôles

• Rôles: ADMIN, FAMILY
• Login JWT + refresh token
• ADMIN redirigé vers /admin
• FAMILY redirigé vers /predictions

4) Workflow concours (état actuel)

Le concours suit un flux en 3 phases:

1. OPEN

• Les participants peuvent saisir/modifier leurs pronostics.
• L'admin peut saisir/modifier les valeurs finales (outcomes).

2. CLOSED (après clôture)

• Les pronostics participants sont verrouillés.
• Les outcomes sont verrouillés.
• L'admin passe sur un wizard de scoring par catégorie:
  • suggestions auto
  • comparaison réponse finale vs réponses candidats
  • validation des points étape par étape

3. finalized = true (validation définitive)

• Le concours est validé définitivement.
• Plus de reouverture possible.
• Côté participants, la page /predictions affiche:
  • gagnant
  • classement final
  • rappel de "vos réponses"

5) Endpoints pronostics clés

Public authentifié:

• GET /predictions/cards
• GET /predictions/board
• GET /predictions/activity
• GET /predictions/scoreboard
• GET /predictions/my-entries
• PUT /predictions/cards/:cardId/my-entry

Admin:

• POST /predictions/game/close
• POST /predictions/game/open
• POST /predictions/game/finalize
• POST /predictions/cards/:cardId/outcomes
• POST /predictions/cards/:cardId/suggest-scores
• PATCH /predictions/entries/:entryId/scores

6) Fichiers clés à lire en priorité

Backend:

• apps/api/src/predictions/predictions.controller.ts
• apps/api/src/predictions/predictions.service.ts
• apps/api/prisma/schema.prisma

Frontend:

• apps/web/src/app/admin/page.tsx
• apps/web/src/app/predictions/page.tsx
• apps/web/src/lib/predictions-client.ts
• apps/web/src/types/predictions.ts

7) Vérifications rapides après modif

1. Build API + web.
2. Parcours manuel:

• Admin: outcomes en OPEN, puis clôture, wizard de scoring, finalisation.
• Family: après finalisation, vérifier affichage gagnant + vos réponses.

8) Prompt de reprise prêt à coller

Contexte projet: monorepo Le Juste Poids (NestJS API + Next.js web + Postgres). Lis PROJECT_CONTEXT.md puis inspecte les fichiers clés listés. Je veux que tu poursuives le workflow de fin de concours sans casser l’existant. Commence par vérifier l’état actuel (API + front), puis propose et implémente les changements avec build de validation.