[person] Feature: add a person's center history

The association between Person and Center is now stored in a dedicated
Entity: `PersonCenterHistory`, which have a date interval (start date
and endDate). The SQL counterpart is a table, with a constraint which
ensure that no person might be associated with two center at the same time.

For ease, a view is created to get the current center associated with
the person.

The dedicated migration creates also:

* indexes for a rapid search for person at current date;
* and populate the table from current data, setting the startdate to the
  person's creation date and time if any, `NOW()` unless.

The `Person` entity is also updated to use the information from the
PersonCenterHistory classes, but this commit does not yet delete the
`Center` column.

src/Bundle/ChillPersonBundle/Entity/Person.php

@@ -27,6 +27,8 @@ use Chill\MainBundle\Validation\Constraint\PhonenumberConstraint;
 use Chill\PersonBundle\Entity\Household\Household;
 use Chill\PersonBundle\Entity\Household\HouseholdMember;
 use Chill\PersonBundle\Entity\Household\PersonHouseholdAddress;
+use Chill\PersonBundle\Entity\Person\PersonCenterCurrent;
+use Chill\PersonBundle\Entity\Person\PersonCenterHistory;
 use Chill\PersonBundle\Entity\Person\PersonCurrentAddress;
 use Chill\PersonBundle\Entity\Person\PersonResource;
 use Chill\PersonBundle\Validator\Constraints\Household\HouseholdMembershipSequential;
@@ -180,9 +182,21 @@ class Person implements HasCenterInterface, TrackCreationInterface, TrackUpdateI
      * The person's center.
      *
      * @ORM\ManyToOne(targetEntity="Chill\MainBundle\Entity\Center")
+     * @deprecated
      */
     private ?Center $center = null;
 
+    /**
+     * @ORM\OneToMany(targetEntity=PersonCenterHistory::class, mappedBy="person")
+     * @var Collection|PersonCenterHistory[]
+     */
+    private Collection $centerHistory;
+
+    /**
+     * @ORM\OneToOne(targetEntity=PersonCenterCurrent::class, mappedBy="person")
+     */
+    private ?PersonCenterCurrent $centerCurrent = null;
+
     /**
      * Array where customfield's data are stored.
      *
@@ -523,6 +537,7 @@ class Person implements HasCenterInterface, TrackCreationInterface, TrackUpdateI
         $this->budgetResources = new ArrayCollection();
         $this->budgetCharges = new ArrayCollection();
         $this->resources = new ArrayCollection();
+        $this->centerHistory = new ArrayCollection();
     }
 
     /**
@@ -897,7 +912,7 @@ class Person implements HasCenterInterface, TrackCreationInterface, TrackUpdateI
 
     public function getCenter(): ?Center
     {
-        return $this->center;
+        return null === $this->centerCurrent ? null : $this->centerCurrent->getCenter();
     }
 
     public function getCFData(): ?array
@@ -1510,17 +1525,60 @@ class Person implements HasCenterInterface, TrackCreationInterface, TrackUpdateI
         return $this;
     }
 
+    /**
+     * Associate the center with the person. The association start on 'now'.
+     *
+     * @param Center $center
+     * @return $this
+     */
     public function setCenter(Center $center): self
     {
         $this->center = $center;
 
+        $modification = new DateTimeImmutable('now');
+
+        foreach ($this->centerHistory as $centerHistory) {
+            if (null === $centerHistory->getEndDate()) {
+                $centerHistory->setEndDate($modification);
+            }
+        }
+
+        $this->centerHistory[] = $new = new PersonCenterHistory($this, $center, $modification);
+        $this->centerCurrent = new PersonCenterCurrent($new);
+
         return $this;
     }
 
     /**
-     * @return Report
+     * @return Collection
      */
-    public function setCFData(?array $cFData)
+    public function getCenterHistory(): Collection
+    {
+        return $this->centerHistory;
+    }
+
+    /**
+     * @param Collection $centerHistory
+     * @return Person
+     */
+    public function setCenterHistory(Collection $centerHistory): Person
+    {
+        $this->centerHistory = $centerHistory;
+        return $this;
+    }
+
+    /**
+     * @return PersonCenterCurrent|null
+     */
+    public function getCenterCurrent(): ?PersonCenterCurrent
+    {
+        return $this->centerCurrent;
+    }
+
+    /**
+     * @return Person
+     */
+    public function setCFData(?array $cFData): self
     {
         $this->cFData = $cFData;