From 817e558a6b9b2108fa8f78bee5239df82ae6073c Mon Sep 17 00:00:00 2001
From: Vincent <vincent@rigolet.tech>
Date: Sat, 21 Mar 2026 15:04:35 +0100
Subject: [PATCH] docs: update CLAUDE.md

---
 CLAUDE.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index e69de29..88e3eb7 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,60 @@
+# [NOM DU PROJET]
+
+## Projet
+[Une phrase : ce que fait l'app, pour qui, pourquoi.]
+
+## Stack
+- Runtime : Node 20 / Python 3.11 / ...
+- Framework : ...
+- Base de données : MariaDB / PostgreSQL / SQLite
+- Déploiement : Docker → Synology NAS (rigolet.tech)
+
+## Structure
+```
+src/
+  components/   # Exemple de composant : src/components/UserCard.tsx
+  api/          # Exemple de route : src/api/users/route.ts
+  stores/       # State management
+docker/
+  docker-compose.yml
+.gitea/
+  workflows/
+    deploy.yml
+```
+
+## Commandes
+```bash
+npm install       # Installer les dépendances
+npm run dev       # Lancer en développement
+npm run build     # Build production
+npm test          # Lancer UN test ciblé, pas toute la suite
+npm run typecheck # IMPORTANT : lancer après chaque série de modifications
+```
+
+## Code style
+- ES modules (import/export), jamais CommonJS (require)
+- Functional components + hooks uniquement, jamais de class components
+- TypeScript strict activé
+- Destructure les imports quand possible
+- IMPORTANT : ne jamais considérer une tâche terminée sans typecheck qui passe
+
+## Git
+- Branches : main (prod) → develop (dev) → feature/xxx
+- Commits : feat: / fix: / docs: / refactor: / chore:
+- IMPORTANT : toujours créer une nouvelle branche pour chaque tâche
+- IMPORTANT : ne jamais pusher directement sur main
+
+## Déploiement
+Pipeline automatique via Gitea Actions.
+Chaque push sur develop déclenche un déploiement sur le NAS.
+Voir @.gitea/workflows/deploy.yml pour le détail du pipeline.
+
+## Références
+- Vue d'ensemble du projet : @README.md
+- Variables d'environnement : @.env.example
+
+## Ce que Claude doit savoir sur CE projet
+- [Ajoute ici les erreurs que Claude répète spécifiquement sur ce projet]
+- [Ex : "ne pas utiliser axios, on utilise fetch natif"]
+- [Ex : "la BDD utilise snake_case, le code TypeScript utilise camelCase"]
+- [Ex : "les tests sont dans __tests__/, pas dans src/"]