docs : update project documentation and frontend submodule pointer

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -49,13 +49,14 @@ Inventory/                      # Backend Symfony (repo principal)
 # Docker
 make start                    # Démarrer les containers
 make stop                     # Arrêter
-make shell                    # Shell dans le container PHP
+make shell                    # Shell interactif (nécessite un TTY)
 make install                  # Install complet (composer + npm + build)
 
 # Backend
-make test                     # PHPUnit
-docker compose exec php vendor/bin/php-cs-fixer fix   # Linter PHP
-docker compose exec php php bin/console doctrine:migrations:migrate
+make test                     # PHPUnit (tous les tests)
+make test FILES=tests/Api/Entity/MachineTest.php   # Un test spécifique
+make php-cs-fixer-allow-risky # Linter PHP (cs-fixer)
+docker exec -u www-data php-inventory-apache php bin/console doctrine:migrations:migrate
 
 # Frontend (dans Inventory_frontend/)
 npm run dev                   # Dev server (port 3001)
@@ -138,13 +139,18 @@ ROLE_ADMIN → ROLE_GESTIONNAIRE → ROLE_VIEWER → ROLE_USER
 
 ## Règles Importantes
 
+### CLAUDE.md — Maintenance obligatoire
+- **Toujours consulter** ce fichier en début de conversation pour respecter les conventions
+- **Mettre à jour** ce fichier quand une nouvelle convention, pattern ou décision architecturale est établie
+- **Utiliser comme source de vérité** pour les commandes, patterns et règles du projet
+
 ### Toujours faire AVANT de modifier du code
 1. **Lire le fichier** avant de l'éditer — ne jamais proposer de changements sur du code non lu
 2. **Comprendre le pattern existant** — reproduire le style du fichier (noms, indentation, structure)
 3. **Vérifier les deux repos** — un changement peut impacter backend ET frontend
 
 ### Après chaque modification
-1. Backend PHP : `docker compose exec php vendor/bin/php-cs-fixer fix`
+1. Backend PHP : `make php-cs-fixer-allow-risky`
 2. Frontend : `npm run lint:fix` puis `npx nuxi typecheck` si fichiers TS modifiés
 
 ### Ne jamais faire
@@ -161,6 +167,26 @@ Quand les branches `master` et `develop` divergent sur l'un des deux repos, **to
 - Main repo : `git checkout master && git merge develop && git push`
 - Frontend : `git checkout develop && git merge master && git push` (ou l'inverse selon le cas)
 
+## Tests
+
+### Stack de test
+- **PHPUnit 12** + **API Platform Test** (`ApiTestCase`)
+- **DAMA DoctrineTestBundle** — wrappe chaque test dans une transaction avec rollback automatique (pas de TRUNCATE)
+- Base de test : même PG, env `test`
+
+### Commandes
+```bash
+make test                     # Tous les tests
+make test FILES=tests/Api/Entity/MachineTest.php   # Un fichier spécifique
+make test-setup               # Créer/mettre à jour le schéma test
+```
+
+### Pattern de test
+- Hériter de `AbstractApiTestCase` (helpers auth + factories)
+- Ne PAS faire de TRUNCATE/cleanup dans tearDown — DAMA s'en occupe par rollback
+- Factories : `createProfile()`, `createMachine()`, `createSite()`, etc.
+- Auth : `createViewerClient()`, `createGestionnaireClient()`, `createAdminClient()`
+
 ## URLs Locales
 - API Symfony : `http://localhost:8081/api`
 - Nuxt dev : `http://localhost:3001`