init import projet

2026-05-03 21:58:59 +02:00
parent f3756fdf8d
commit 8d3df9bbbb
179 changed files with 37694 additions and 132 deletions
@@ -0,0 +1,125 @@
+# 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:
+
+```bash
+npm install
+```
+
+Lancer toute la stack:
+
+```bash
+docker compose up --build
+```
+
+Build API + Web:
+
+```bash
+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
+
+```text
+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.
+```