feat(sites) : brique fondatrice du module Sites (ticket 1/4)

Module Sites optionnel et desactivable via config/modules.php. Entite Site (nom unique, ville, CP FR, couleur hex, adresse), repository + impl Doctrine, migration racine (namespace DoctrineMigrations conforme exception CLAUDE.md), fixtures idempotentes (Chatellerault, Saint-Jean, Pommevic), permissions RBAC sites.view/sites.manage. Tests unitaires + validation via KernelTestCase (UniqueEntity, regex hex et CP, NotBlank, Length). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 15:45:33 +02:00
parent 6b4868b261
commit 8590e3e850
11 changed files with 829 additions and 0 deletions
--- a/migrations/Version20260417120000.php
+++ b/migrations/Version20260417120000.php
@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+/**
+ * Module Sites - Ticket 1/4 : brique fondatrice de donnees.
+ *
+ * Cree la table `site` qui porte les etablissements physiques de l'instance
+ * Coltura. La table est creee inconditionnellement : meme si SitesModule est
+ * desactive dans `config/modules.php`, la structure DB existe (pas de
+ * dependance dure depuis Core, mais pas de coin d'ombre schema non plus).
+ *
+ * Note sur l'emplacement du fichier :
+ *  Par convention projet les migrations vivent dans
+ *  `src/Module/{Module}/Infrastructure/Doctrine/Migrations/`, sauf pour les
+ *  initialisations critiques. Cf. CLAUDE.md (section "Regles d'architecture")
+ *  qui documente le bug de tri alphabetique de Doctrine Migrations 3.x avec
+ *  plusieurs `migrations_paths` : tant que ce n'est pas corrige, toute
+ *  migration d'initialisation (creation de table sur base vide) reste au
+ *  namespace racine `DoctrineMigrations` dans `migrations/`.
+ */
+final class Version20260417120000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Module Sites : creation de la table site (nom, ville, cp, couleur, adresse complete, timestamps).';
+    }
+
+    public function up(Schema $schema): void
+    {
+        // Creation de la table site. Toutes les colonnes sont NOT NULL :
+        //  - le champ `color` est contraint cote applicatif au format #RRGGBB
+        //    (7 caracteres), la longueur DB est dimensionnee en consequence ;
+        //  - `postal_code` est limite a 10 caracteres pour laisser marge a
+        //    d'eventuels formats etrangers plus tard, tout en le validant
+        //    strictement en 5 chiffres cote applicatif (format FR).
+        $this->addSql(<<<'SQL'
+                CREATE TABLE site (
+                  id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL,
+                  name VARCHAR(100) NOT NULL,
+                  city VARCHAR(100) NOT NULL,
+                  postal_code VARCHAR(10) NOT NULL,
+                  color VARCHAR(7) NOT NULL,
+                  full_address TEXT NOT NULL,
+                  created_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL,
+                  updated_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL,
+                  PRIMARY KEY (id)
+                )
+            SQL);
+
+        // Index unique sur le nom : garantit l'invariant metier "un site porte
+        // un nom unique" et permet a la contrainte UniqueEntity cote Symfony
+        // de s'appuyer sur une erreur DB en cas de race condition.
+        $this->addSql('CREATE UNIQUE INDEX uniq_site_name ON site (name)');
+    }
+
+    public function down(Schema $schema): void
+    {
+        // Drop direct : aucune FK depuis/vers la table dans ce ticket.
+        $this->addSql('DROP TABLE site');
+    }
+}