From 9cae6725ef64fff47109b73f2f024ca1ad59ed92 Mon Sep 17 00:00:00 2001
From: Daniel Subiabre <daniel.subiabre@platoniq.net>
Date: Sat, 25 Jan 2025 12:33:36 +0100
Subject: [PATCH] Add territory data to project resources

---
 .../Project/ProjectApiResource.php            |  6 +++
 src/ApiResource/Project/ProjectTerritory.php  | 30 ++++++++++++++
 src/Entity/Project/Project.php                | 18 +++++++++
 src/Entity/Project/ProjectTerritory.php       | 39 +++++++++++++++++++
 4 files changed, 93 insertions(+)
 create mode 100644 src/ApiResource/Project/ProjectTerritory.php
 create mode 100644 src/Entity/Project/ProjectTerritory.php

diff --git a/src/ApiResource/Project/ProjectApiResource.php b/src/ApiResource/Project/ProjectApiResource.php
index aab7519..6633352 100644
--- a/src/ApiResource/Project/ProjectApiResource.php
+++ b/src/ApiResource/Project/ProjectApiResource.php
@@ -66,6 +66,12 @@ class ProjectApiResource
     #[Assert\NotBlank()]
     public string $subtitle;
 
+    /**
+     * ISO 3166 data about the Project's territory of interest.
+     */
+    #[Assert\Valid()]
+    public ProjectTerritory $territory;
+
     /**
      * Free-form rich text description for the Project.
      */
diff --git a/src/ApiResource/Project/ProjectTerritory.php b/src/ApiResource/Project/ProjectTerritory.php
new file mode 100644
index 0000000..1211d3e
--- /dev/null
+++ b/src/ApiResource/Project/ProjectTerritory.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace App\ApiResource\Project;
+
+use Symfony\Component\Validator\Constraints as Assert;
+
+/**
+ * ISO 3166 data about the Project's territory of interest.
+ */
+class ProjectTerritory
+{
+    /**
+     * ISO 3166-1 alpha-2 two-letter country code.
+     */
+    #[Assert\NotBlank()]
+    #[Assert\Country(alpha3: false)]
+    public string $country;
+
+    /**
+     * ISO 3166-2 first level subdivision code.\
+     * e.g: ES-AN (Andalucía, Spain)
+     */
+    public string $subLvl1;
+
+    /**
+     * ISO 3166-2 second level subdivision code.\
+     * e.g: ES-GR (Granada, Andalucía, Spain)
+     */
+    public string $subLvl2;
+}
diff --git a/src/Entity/Project/Project.php b/src/Entity/Project/Project.php
index 663b108..9742fa4 100644
--- a/src/Entity/Project/Project.php
+++ b/src/Entity/Project/Project.php
@@ -50,6 +50,12 @@ class Project implements UserOwnedInterface, AccountingOwnerInterface, Localized
     #[Gedmo\Translatable()]
     private ?string $subtitle = null;
 
+    /**
+     * Project's territory of interest.
+     */
+    #[ORM\Embedded(class: ProjectTerritory::class)]
+    private ?ProjectTerritory $territory;
+
     /**
      * The description body for the Project.
      */
@@ -125,6 +131,18 @@ class Project implements UserOwnedInterface, AccountingOwnerInterface, Localized
         return $this;
     }
 
+    public function getTerritory(): ?ProjectTerritory
+    {
+        return $this->territory;
+    }
+
+    public function setTerritory(ProjectTerritory $territory): static
+    {
+        $this->territory = $territory;
+
+        return $this;
+    }
+
     public function getDescription(): ?string
     {
         return $this->description;
diff --git a/src/Entity/Project/ProjectTerritory.php b/src/Entity/Project/ProjectTerritory.php
new file mode 100644
index 0000000..fd0f811
--- /dev/null
+++ b/src/Entity/Project/ProjectTerritory.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Entity\Project;
+
+use Doctrine\DBAL\Types\Types;
+use Doctrine\ORM\Mapping as ORM;
+
+/**
+ * Represents the territory of interest for a Project.
+ */
+#[ORM\Embeddable]
+class ProjectTerritory
+{
+    #[ORM\Column(type: Types::STRING, nullable: false)]
+    public readonly string $country;
+
+    /**
+     * First-level sub-division of the country.
+     */
+    #[ORM\Column(type: Types::STRING, nullable: true)]
+    public readonly ?string $subLvl1;
+
+    /**
+     * Second-level sub-division of the country.
+     */
+    #[ORM\Column(type: Types::STRING, nullable: true)]
+    public readonly ?string $subLvl2;
+
+    public function __construct(
+        string $country,
+        ?string $subLvl1 = null,
+        ?string $subLvl2 = null
+    )
+    {
+        $this->country = $country;
+        $this->subLvl1 = $subLvl1 ?? null;
+        $this->subLvl2 = $subLvl2 ?? null;
+    }
+}