Vérifie si le linéaire est présent dans le pérmiètre de l'organisation

Author: mmarchois

docs/adr/011_administrative_boundaries.md

@@ -114,3 +114,14 @@ Cette approche permet de :
 - Conserver une précision élevée pour les communes
 - Réduire significativement le poids des géométries pour les grandes entités (comme les régions)
 - Maintenir un bon équilibre entre précision visuelle et performance
+
+## Règles de validation d'une localisation d'un arrêté
+
+Pour la validation d'une localisation d'un arrêté dans un périmètre géographique d'une organisation, nous avons défini les règles métiers suivantes :
+
+- Inclusion totale : Le linéaire est entièrement contenu dans le périmètre de l'organisation.
+- Inclusion partielle sortante : Le linéaire commence dans le périmètre de l'organisation puis se termine à l'extérieur.
+- Inclusion partielle entrante : Le linéaire commence à l'extérieur du périmètre de l'organisation puis se termine à l'intérieur.
+- Traversée multiple : Le linéaire traverse plusieurs fois les limites du périmètre de l'organisation (entrée-sortie-entrée...).
+
+Cette solution résout le problème de linéaires partagés entre plusieurs organisations tout en prenant en compte des scénarios plus complexes comme les traversées multiples. Elle permet d'associer de manière fiable les arrêtés aux organisations concernées en fonction de leur localisation géographique.

src/Domain/Organization/Exception/OrganizationDoesntHaveGeometryException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Organization\Exception;
+
+final class OrganizationDoesntHaveGeometryException extends \Exception
+{
+}

src/Domain/Regulation/Specification/CanOrganizationInterveneOnGeometry.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Regulation\Specification;
+
+use App\Domain\Organization\Exception\OrganizationDoesntHaveGeometryException;
+use App\Domain\User\Exception\OrganizationNotFoundException;
+use App\Domain\User\Repository\OrganizationRepositoryInterface;
+
+class CanOrganizationInterveneOnGeometry
+{
+    public function __construct(
+        private OrganizationRepositoryInterface $organizationRepository,
+    ) {
+    }
+
+    public function isSatisfiedBy(string $uuid, string $geometry): bool
+    {
+        $organization = $this->organizationRepository->findOneByUuid($uuid);
+        if (!$organization) {
+            return throw new OrganizationNotFoundException();
+        }
+
+        if (!$organization->getGeometry()) {
+            throw new OrganizationDoesntHaveGeometryException();
+        }
+
+        return $this->organizationRepository->canInterveneOnGeometry($uuid, $geometry);
+    }
+}

src/Domain/User/Repository/OrganizationRepositoryInterface.php

@@ -23,4 +23,6 @@ public function countOrganizations(): int;
     public function add(Organization $organization): void;
 
     public function flush(): void;
+
+    public function canInterveneOnGeometry(string $uuid, string $geometry): bool;
 }

src/Infrastructure/Persistence/Doctrine/Repository/Organization/OrganizationRepository.php

@@ -84,4 +84,22 @@ public function countOrganizations(): int
             ->getSingleScalarResult()
         ;
     }
+
+    public function canInterveneOnGeometry(string $uuid, string $geometry): bool
+    {
+        $result = $this->createQueryBuilder('o')
+            ->select('ST_Intersects(
+                ST_GeomFromGeoJSON(:geometry),
+                o.geometry
+            ) as has_intersection')
+            ->where('o.uuid = :uuid')
+            ->setParameters([
+                'uuid' => $uuid,
+                'geometry' => $geometry,
+            ])
+            ->getQuery()
+            ->getOneOrNullResult();
+
+        return (bool) ($result['has_intersection'] ?? false);
+    }
 }