📗 Cahier des Charges — Recette ERP

Document de référence du périmètre existant — établi par rétro-ingénierie du code source, dans le cadre de la réécriture complète de l'application.

⚠️ Nature du document : ce cahier des charges documente le périmètre fonctionnel de l'existant (recette-erp v1), y compris ses parties incomplètes ou incohérentes. Il constitue la source de vérité fonctionnelle pour la refonte.

🔀 Changement de stack (v2) : la réécriture (recette-erp-v2) réimplémente ce périmètre sur une stack entièrement différente — TypeScript, Next.js 16, Convex, Better Auth, Tailwind 4, monorepo feature-first. Le comportement métier est conservé ; les couches techniques changent. Voir Architecture technique (v2) et convex-helpers.

🔎 Méthode : chaque affirmation fonctionnelle est dérivée du code v1 (routes, services, composants, migrations SQL, RLS). Les correspondances techniques v2 s'appuient sur le monorepo (packages/backend, CLAUDE.md, package.json). Toute information non déductible est marquée ❓ À CLARIFIER et reportée dans Questions pour l'atelier de cadrage.

🗂️ Métadonnées

Champ	Valeur
Application	Recette ERP (nom technique du dépôt : recette-erp-next)
Projet fonctionnel de référence	TRIMET — IFS Cloud v12 (données observées dans le code)
Version applicative	0.1.0 (package.json)
Version du présent document	v1.0 — établi par analyse du dépôt
Statut	🟢 Périmètre fonctionnel figé (v1) · 🔨 réimplémentation v2 en cours
Stack v1 (existant documenté)	Next.js 14 (App Router), React 18, Tailwind CSS 3, Zustand 5, Supabase (PostgreSQL + Auth + Storage), ExcelJS. JavaScript (pas de TypeScript).
Stack v2 (cible)	TypeScript, Next.js 16 / React 19, Tailwind 4 (@recette/ui), Convex, Better Auth, Zod (@recette/validators), convex-helpers, monorepo Turbo/pnpm feature-first. → détail
Hébergement	v1 : Vercel + Supabase · v2 : Vercel (front) + déploiement Convex (backend)
Confidentialité	Interne — l'environnement backend (v2 : déploiement Convex) reste temporaire (pré-test), à provisionner par l'intégrateur avant production ; ne pas y charger de données réelles

Journal des révisions

Version	Date	Auteur	Nature
v1.0	2026-07-15	Analyse du dépôt	Rédaction initiale du périmètre existant

Comment lire — selon votre profil

Ce document sert deux lectures. Les détails techniques (noms de fonctions, Convex, etc.) sont soit regroupés dans des sections identifiées, soit repliés dans des blocs « 🛠️ Détails techniques » à dérouler à la demande.

👔 Vous êtes côté métier / client (MOA, sponsor, testeur)

Suivez le fil fonctionnel, sans jargon :

1. Contexte · Vision · Périmètre
2. Référentiel & Snapshots — le concept clé, expliqué simplement
3. Fiches fonctionnelles (lisez Objectif + Critères d'acceptation) · Workflows (schémas)
4. Questions pour l'atelier de cadrage — les décisions à prendre ensemble
5. En cas de doute sur un mot : Glossaire

Les blocs « 🛠️ Détails techniques (v2) » sont facultatifs pour vous — vous pouvez les ignorer.

🛠️ Vous êtes côté équipe technique

En plus du fonctionnel : Architecture v2 · convex-helpers · Modèle de données · Sécurité · API & fonctions · colonne Source (v2) des Règles métier · Dette technique.