docs: update CLAUDE.md

This commit is contained in:
2026-03-21 15:04:35 +01:00
parent e0a13dc2ff
commit 817e558a6b

View File

@@ -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/"]