From 7ccc91386202656411507d0d38100e6f765cec79 Mon Sep 17 00:00:00 2001 From: Matthieu Date: Tue, 14 Apr 2026 17:25:26 +0200 Subject: [PATCH] docs : exception CLAUDE.md pour les migrations multi-namespace Documente le bug Doctrine Migrations 3.x (tri par FQCN au lieu de version timestamp avec plusieurs migrations_paths) et la regle provisoire : migrations d'init au namespace racine, namespace modulaire reserve aux migrations applicatives. Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CLAUDE.md b/CLAUDE.md index 030a208..4c80457 100644 --- a/CLAUDE.md +++ b/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)