CLAUDE.md

@@ -140,6 +140,7 @@ Le code du module Commercial n'est pas touche.
 - `config/modules.php` = seule source de verite pour l'activation
 - `config/sidebar.php` = seule source de verite pour l'organisation de la sidebar (chaque item reference son module owner via la cle `module`)
 - Migrations par module dans `src/Module/{Module}/Infrastructure/Doctrine/Migrations/`
+- **Exception connue** : avec plusieurs `migrations_paths` configures, Doctrine Migrations 3.x trie les migrations par FQCN alphabetique et non par version timestamp → ordre d'execution incorrect entre namespaces sur une base vide. Tant que ce n'est pas resolu (via un `MigrationsComparator` custom ou un upgrade), les migrations d'initialisation critiques (setup user, RBAC, etc.) vivent au namespace racine `DoctrineMigrations` dans `migrations/`. Le namespace modulaire reste configure pour les futures migrations applicatives (qui dependent d'un schema deja cree).
 
 **Frontend :**
 - Chaque module est un layer Nuxt auto-detecte (`modules/*/nuxt.config.ts` minimal)