feat(catalog) : add stable auto-generated code to Category

Nouvelle colonne Category.code (NOT NULL, unique partiel uq_category_code),
slug MAJUSCULE du nom genere par CategoryCodeGenerator et fige a la creation,
expose en lecture seule. CategoryInterface::getCode() ajoute au contrat Shared.
Retrofit COMMENT (Version20260528120000) rendu conscient des colonnes pour
tolerer l'ajout de code au catalogue.

migrations/Version20260528120000.php

@@ -39,20 +39,40 @@ final class Version20260528120000 extends AbstractMigration
 
     public function up(Schema $schema): void
     {
-        // Ne commente que les tables deja presentes a ce stade de la chaine de
-        // migrations. Les modules crees plus tard (ex: M1 Commercial, 06-01)
-        // figurent desormais dans le catalogue partage mais leurs tables
-        // n'existent pas encore ici : elles posent leurs propres COMMENT dans
-        // leur migration dediee (regle ABSOLUE n°12). Garde-fou indispensable,
-        // sinon l'ajout d'un module au catalogue casse ce retrofit avec un
-        // "relation X does not exist".
-        $existingTables = array_values(array_filter(
-            array_keys(ColumnCommentsCatalog::comments()),
-            static fn (string $table): bool => $schema->hasTable($table),
-        ));
+        // Ne commente que les tables ET colonnes deja presentes a ce stade de la
+        // chaine de migrations. Les tables des modules crees plus tard (M1
+        // Commercial, 06-01) ET les colonnes ajoutees ensuite sur une table
+        // existante (ex: category.code, ERP-78 06-02) figurent desormais dans le
+        // catalogue partage mais n'existent pas encore ici : elles posent leur
+        // propre COMMENT dans leur migration dediee (regle ABSOLUE n°12). Garde-fou
+        // indispensable (table + colonne), sinon enrichir le catalogue casse ce
+        // retrofit avec un "relation/column X does not exist".
+        foreach (ColumnCommentsCatalog::comments() as $table => $entries) {
+            if (!$schema->hasTable($table)) {
+                continue;
+            }
 
-        foreach (ColumnCommentsCatalog::toSqlStatements($existingTables) as $sql) {
-            $this->addSql($sql);
+            $dbTable     = $schema->getTable($table);
+            $quotedTable = '"'.str_replace('"', '""', $table).'"';
+
+            foreach ($entries as $column => $description) {
+                if ('_table' === $column) {
+                    $this->addSql(sprintf('COMMENT ON TABLE %s IS $_$%s$_$', $quotedTable, $description));
+
+                    continue;
+                }
+
+                if (!$dbTable->hasColumn($column)) {
+                    continue;
+                }
+
+                $this->addSql(sprintf(
+                    'COMMENT ON COLUMN %s.%s IS $_$%s$_$',
+                    $quotedTable,
+                    '"'.str_replace('"', '""', $column).'"',
+                    $description,
+                ));
+            }
         }
     }