📗 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 du même contenu. Elles disent la même chose : l'une énonce la décision et sa conséquence, l'autre y ajoute le détail d'implémentation.

👔 / 🛠️ Le sélecteur en haut de page change le document entier

En haut à droite de la barre de navigation, un sélecteur bascule entre :

Mode	Pour qui	Ce que vous voyez
👔 Consultant (par défaut)	client, MOA, chef de projet, testeur	Le fil fonctionnel seul : objectifs, règles, décisions, conséquences. Aucun nom de table, de fonction ni de contrainte technique.
🛠️ Technique	équipe de développement, intégrateur	Le même document, plus le schéma de données, les fonctions serveur, les index, les limites de plateforme et les références au code source

Trois choses à savoir :

• Le choix est mémorisé : vous ne le refaites pas à chaque page.
• Là où une précision technique est masquée, une mention discrète le signale et permet de l'afficher d'un clic — vous savez toujours qu'il existe un niveau de détail supplémentaire, et où.
• Pour partager un lien dans un mode donné, ajoutez ?vue=dev ou ?vue=metier à l'URL. À l'impression, tout est affiché, quel que soit le mode.

Aucune décision n'est visible uniquement en mode Technique. Si une information change ce qu'il faut arbitrer, elle est dans les deux lectures.

👔 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

En mode Consultant, les précisions techniques sont déjà masquées pour vous : vous n'avez rien à ignorer manuellement.

🛠️ 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.