<?php

declare(strict_types=1);

namespace DoctrineMigrations;

use Doctrine\DBAL\Schema\Schema;
use Doctrine\Migrations\AbstractMigration;

/**
 * Commercial — geolocalisation des adresses Tiers (M6.1 / ERP-122, spec M6
 * § 3.2 / § 4.1).
 *
 * Ajoute sur `client_address` ET `supplier_address` :
 *  - latitude / longitude NUMERIC(10,7) null : coordonnees WGS84, alimentees
 *    par le geocodage BAN automatique ou par le pin manuel ;
 *  - geo_manual BOOLEAN default false : RG-6.08, un pin corrige a la main fige
 *    les coordonnees (le geocodage auto ne reecrit plus) ;
 *  - geocoded_at TIMESTAMPTZ null : date du dernier geocodage auto reussi.
 *
 * Migration au namespace racine `DoctrineMigrations` (pratique effective du
 * projet : le namespace modulaire Commercial n'est pas enregistre dans
 * doctrine_migrations.yaml et souffrirait du tri FQCN inter-namespaces sur
 * base vide — cf. regle ABSOLUE n°11 / architecture.md § Migrations).
 */
final class Version20260611130000 extends AbstractMigration
{
    private const array TABLES = ['client_address', 'supplier_address'];

    public function getDescription(): string
    {
        return 'Commercial : geolocalisation des adresses Tiers (latitude/longitude/geo_manual/geocoded_at sur client_address et supplier_address).';
    }

    public function up(Schema $schema): void
    {
        foreach (self::TABLES as $table) {
            $this->addSql(sprintf('ALTER TABLE %s ADD COLUMN latitude NUMERIC(10, 7) DEFAULT NULL', $table));
            $this->addSql(sprintf('ALTER TABLE %s ADD COLUMN longitude NUMERIC(10, 7) DEFAULT NULL', $table));
            $this->addSql(sprintf('ALTER TABLE %s ADD COLUMN geo_manual BOOLEAN DEFAULT false NOT NULL', $table));
            $this->addSql(sprintf('ALTER TABLE %s ADD COLUMN geocoded_at TIMESTAMP(0) WITH TIME ZONE DEFAULT NULL', $table));

            $this->comment($table, 'latitude', 'Latitude WGS84 de l adresse (geocodage BAN ou pin manuel). NULL = non geolocalisee, exclue du calcul de tournee (RG-6.05).');
            $this->comment($table, 'longitude', 'Longitude WGS84 de l adresse (geocodage BAN ou pin manuel). NULL = non geolocalisee.');
            $this->comment($table, 'geo_manual', 'Pin positionne/corrige a la main : si vrai, le geocodage auto ne reecrit plus les coordonnees (RG-6.08). Faux par defaut.');
            $this->comment($table, 'geocoded_at', 'Date du dernier geocodage automatique reussi (NULL si jamais geocode ou pin 100% manuel).');
        }
    }

    public function down(Schema $schema): void
    {
        foreach (self::TABLES as $table) {
            $this->addSql(sprintf('ALTER TABLE %s DROP COLUMN latitude', $table));
            $this->addSql(sprintf('ALTER TABLE %s DROP COLUMN longitude', $table));
            $this->addSql(sprintf('ALTER TABLE %s DROP COLUMN geo_manual', $table));
            $this->addSql(sprintf('ALTER TABLE %s DROP COLUMN geocoded_at', $table));
        }
    }

    /**
     * Emet un `COMMENT ON COLUMN` en dollar-quoting Postgres ($_$...$_$) pour
     * eviter tout echappement.
     */
    private function comment(string $table, string $column, string $description): void
    {
        $this->addSql(sprintf(
            'COMMENT ON COLUMN %s.%s IS $_$%s$_$',
            '"'.str_replace('"', '""', $table).'"',
            '"'.str_replace('"', '""', $column).'"',
            $description,
        ));
    }
}