Files
Coltura/migrations/Version20260417120000.php
tristan 8590e3e850 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

68 lines
2.8 KiB
PHP

<?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');
}
}