WIP

CLAUDE.md

@@ -26,6 +26,7 @@ Voir `docs/GLOSSAIRE_METIER.md` — glossaire complet du domaine métier (concep
 ```
 Inventory/                      # Backend Symfony (repo principal)
 ├── src/Entity/                 # Entités Doctrine (annotations PHP 8 attributes)
+│   └── Trait/                  # CuidEntityTrait (génération d'ID CUID)
 ├── src/Controller/             # Controllers custom (session, comments, audit…)
 ├── src/EventSubscriber/        # Audit subscribers (onFlush)
 ├── src/Service/               # Services métier (sync, conversion, storage…)
@@ -148,6 +149,7 @@ Remplacent les anciennes colonnes JSON `structure` et `productIds` par des table
 - `DocumentServeController` — `/api/documents/{id}/file|download` (GET) : servir/télécharger fichiers.
 - `ModelTypeConversionController` — `/api/model_types/{id}/conversion-check|convert` : vérification et conversion de ModelType.
 - `ModelTypeSyncController` — `/api/model_types/{id}/sync-preview|sync-confirm` (POST) : prévisualisation et application de sync ModelType→Composants.
+- `EntityVersionController` — `/api/{entity}/{id}/versions` (GET), `/api/{entity}/{id}/versions/{version}/restore` (POST) : historique de versions numérotées et restauration.
 - `HealthCheckController` — `/api/health` (GET) : health check.
 
 ### Custom Fields — Architecture
@@ -165,6 +167,8 @@ Remplacent les anciennes colonnes JSON `structure` et `productIds` par des table
 - `SkeletonStructureService` — gestion de la structure skeleton (requirements)
 - `DocumentStorageService` — stockage et gestion des fichiers documents
 - `PdfCompressorService` — compression des PDFs uploadés
+- `EntityVersionService` — gestion des versions numérotées (snapshot, restore) pour machines, pièces, composants, produits
+- `ReferenceAutoGenerator` — génération automatique de références pour pièces et composants à partir de formules ModelType
 - `src/Service/Sync/` — stratégies de sync par type de slot (tagged `app.sync_strategy`)
 
 ### DTOs (`src/DTO/`)
@@ -176,6 +180,7 @@ Remplacent les anciennes colonnes JSON `structure` et `productIds` par des table
 ### EventSubscribers notables (non-audit)
 - `PieceProductSyncSubscriber` — sync automatique des PieceProductSlots
 - `UniqueConstraintSubscriber` — traduit les erreurs de contrainte unique PG en messages utilisateur lisibles
+- `ReferenceAutoSubscriber` — recalcule les références auto des pièces/composants quand les CustomFieldValues changent (onFlush)
 
 ### Rôles (hiérarchie)
 ```