fix person last address (from @loophp on old framagit repo)

See https://framagit.org/Chill-project/Chill-Person/-/merge_requests/13

src/Bundle/ChillMainBundle/DependencyInjection/ChillMainExtension.php

@@ -131,6 +131,7 @@ class ChillMainExtension extends Extension implements PrependExtensionInterface,
         $loader->load('services/templating.yaml');
         $loader->load('services/timeline.yaml');
         $loader->load('services/search.yaml');
+        $loader->load('services/serializer.yaml');
 
         $this->configureCruds($container, $config['cruds'], $loader);
     }

src/Bundle/ChillMainBundle/Serializer/Normalizer/CenterNormalizer.php

@@ -0,0 +1,44 @@
+<?php
+/*
+ * 
+ * Copyright (C) 2014-2021, Champs Libres Cooperative SCRLFS, <http://www.champs-libres.coop>
+ * 
+ * This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ *  License, or (at your option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+namespace Chill\MainBundle\Serializer\Normalizer;
+
+use Chill\MainBundle\Entity\Center;
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+
+/**
+ * 
+ *
+ */
+class CenterNormalizer implements NormalizerInterface
+{
+    public function normalize($center, string $format = null, array $context = array())
+    {
+        /** @var Center $center */
+        return [
+            'id' => $center->getId(),
+            'name' => $center->getName()
+        ];
+    }
+
+    public function supportsNormalization($data, string $format = null): bool
+    {
+        return $data instanceof Center;
+    }
+}

src/Bundle/ChillMainBundle/Serializer/Normalizer/DateNormalizer.php

@@ -0,0 +1,39 @@
+<?php
+/*
+ *
+ * Copyright (C) 2014-2021, Champs Libres Cooperative SCRLFS, <http://www.champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ *  License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+namespace Chill\MainBundle\Serializer\Normalizer;
+
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+
+class DateNormalizer implements NormalizerInterface
+{
+    public function normalize($date, string $format = null, array $context = array())
+    {
+        /** @var \DateTimeInterface $date */
+        return [
+            'datetime' => $date->format(\DateTimeInterface::ISO8601),
+            'u' => $date->getTimestamp()
+        ];
+    }
+
+    public function supportsNormalization($data, string $format = null): bool
+    {
+        return $data instanceof \DateTimeInterface;
+    }
+}

src/Bundle/ChillMainBundle/Serializer/Normalizer/UserNormalizer.php

@@ -0,0 +1,44 @@
+<?php
+/*
+ *
+ * Copyright (C) 2014-2021, Champs Libres Cooperative SCRLFS, <http://www.champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ *  License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+namespace Chill\MainBundle\Serializer\Normalizer;
+
+use Chill\MainBundle\Entity\User;
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+
+/**
+ *
+ *
+ */
+class UserNormalizer implements NormalizerInterface
+{
+    public function normalize($user, string $format = null, array $context = array())
+    {
+        /** @var User $user */
+        return [
+            'id' => $user->getId(),
+            'username' => $user->getUsername()
+        ];
+    }
+
+    public function supportsNormalization($data, string $format = null): bool
+    {
+        return $data instanceof User;
+    }
+}

src/Bundle/ChillMainBundle/config/services/serializer.yaml

@@ -0,0 +1,13 @@
+---
+services:
+    Chill\MainBundle\Serializer\Normalizer\CenterNormalizer:
+        tags:
+            - { name: 'serializer.normalizer', priority: 64 }
+
+    Chill\MainBundle\Serializer\Normalizer\DateNormalizer:
+        tags:
+            - { name: 'serializer.normalizer', priority: 64 }
+
+    Chill\MainBundle\Serializer\Normalizer\UserNormalizer:
+        tags:
+            - { name: 'serializer.normalizer', priority: 64 }

src/Bundle/ChillPersonBundle/Controller/AccompanyingCourseController.php

@@ -4,17 +4,21 @@ namespace Chill\PersonBundle\Controller;
 
 use Chill\PersonBundle\Entity\AccompanyingPeriod;
 use Chill\PersonBundle\Entity\AccompanyingPeriodParticipation;
+use Chill\PersonBundle\Privacy\AccompanyingPeriodPrivacyEvent;
 use Chill\PersonBundle\Entity\Person;
 use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
 use Symfony\Bundle\FrameworkBundle\Controller\Controller;
 use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpFoundation\Exception\BadRequestException;
 use Symfony\Component\Routing\Annotation\Route;
 use Symfony\Component\Serializer\Encoder\JsonEncoder;
 use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
 use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-use Symfony\Component\Serializer\Serializer;
 use Symfony\Component\Serializer\SerializerInterface;
+use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\Validator\Validator\ValidatorInterface;
 
 /**
  * Class AccompanyingCourseController
@@ -23,6 +27,21 @@ use Symfony\Component\Serializer\SerializerInterface;
  */
 class AccompanyingCourseController extends Controller
 {
+    protected SerializerInterface $serializer;
+
+    protected EventDispatcherInterface $dispatcher;
+
+    protected ValidatorInterface $validator;
+
+    public function __construct(
+        SerializerInterface $serializer,
+        EventDispatcherInterface $dispatcher,
+        ValidatorInterface $validator
+    ) {
+        $this->serializer = $serializer;
+        $this->dispatcher = $dispatcher;
+        $this->validator = $validator;
+    }
     /**
      * Homepage of Accompanying Course section
      *
@@ -68,45 +87,75 @@ class AccompanyingCourseController extends Controller
     }
 
     /**
-     * Sérialise temporairement quelques données pour donner à manger au composant vuejs
+     * Get API Data for showing endpoint
+     *
      * @Route(
-     *     "/{_locale}/api/parcours/{accompanying_period_id}/show",
-     *     name="chill_person_accompanying_course_api_show")
+     *     "/{_locale}/person/api/1.0/accompanying-course/{accompanying_period_id}/show.{_format}",
+     *     name="chill_person_accompanying_course_api_show"
+     * )
      * @ParamConverter("accompanyingCourse", options={"id": "accompanying_period_id"})
-     * @param SerializerInterface $serializer
      */
-    public function showAPI(AccompanyingPeriod $accompanyingCourse): Response
+    public function showAPI(AccompanyingPeriod $accompanyingCourse, $_format): Response
     {
-        $persons = [];
-        foreach ($accompanyingCourse->getParticipations() as $k => $participation ) {
+        // TODO check ACL on AccompanyingPeriod
+
+        $this->dispatcher->dispatch(
+            AccompanyingPeriodPrivacyEvent::ACCOMPANYING_PERIOD_PRIVACY_EVENT,
+            new AccompanyingPeriodPrivacyEvent($accompanyingCourse, [
+            'action' => 'showApi'
+            ])
+        );
+
+        switch ($_format) {
+            case 'json':
+                return $this->json($accompanyingCourse);
+            default:
+                throw new BadRequestException('Unsupported format');
+        }
+
+    }
+
     /**
-             * @var AccompanyingPeriodParticipation $participation
-             * @var Person $person
+     * Get API Data for showing endpoint
+     *
+     * @Route(
+     *     "/{_locale}/person/api/1.0/accompanying-course/{accompanying_period_id}/participation.{_format}",
+     *     name="chill_person_accompanying_course_api_add_participation",
+     *     methods={"POST"},
+     *     format="json",
+     *     requirements={
+     *         "_format": "json",
+     *     }
+     * )
+     * @ParamConverter("accompanyingCourse", options={"id": "accompanying_period_id"})
      */
-            $person = $participation->getPerson();
-            $persons[$k] = [
-                'id' => $person->getId(),
-                'firstname' => $person->getFirstName(),
-                'lastname' => $person->getLastName(),
-                'email' => $person->getEmail(),
-                'phone' => $person->getPhonenumber(),
-                'startdate' => ($participation->getStartDate()) ? $participation->getStartDate()->format('Y-m-d') : null,
-                'enddate' => ($participation->getEndDate()) ? $participation->getEndDate()->format('Y-m-d') : null
-            ];
-        }
-        $data = [
-            'id' => $accompanyingCourse->getId(),
-            'remark' => $accompanyingCourse->getRemark(),
-            'closing_motive' => $accompanyingCourse->getClosingMotive() ? $accompanyingCourse->getClosingMotive()->getName()['fr'] : null,
-            'opening_date' => ($accompanyingCourse->getOpeningDate()) ? $accompanyingCourse->getOpeningDate()->format('Y-m-d') : null,
-            'closing_date' => ($accompanyingCourse->getClosingDate()) ? $accompanyingCourse->getClosingDate()->format('Y-m-d') : null,
-            'persons' => $persons
-        ];
+    public function addParticipationAPI(Request $request, AccompanyingPeriod $accompanyingCourse, $_format): Response
+    {
+        switch ($_format) {
+            case 'json':
+                $person = $this->serializer->deserialize($request->getContent(), Person::class, $_format, [
 
-        $serialized = \json_encode($data);
-        $response = new Response($serialized);
-        $response->headers->set('Content-Type', 'application/json');
-        return $response;
+                ]);
+                break;
+            default:
+                throw new BadRequestException('Unsupported format');
         }
 
+        if (NULL === $person) {
+            throw new BadRequestException('person id not found');
+        }
+
+        // TODO add acl
+        $accompanyingCourse->addPerson($person);
+        $errors = $this->validator->validate($accompanyingCourse);
+
+        if ($errors->count() > 0) {
+            // only format accepted
+            return $this->json($errors);
+        }
+
+        $this->getDoctrine()->getManager()->flush();
+
+        return new JsonResponse();
+    }
 }

src/Bundle/ChillPersonBundle/Controller/ApiPersonController.php

@@ -0,0 +1,30 @@
+<?php
+/*
+ * Copyright (C) 2015-2021 Champs-Libres Coopérative <info@champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+namespace Chill\PersonBundle\Controller;
+
+use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+use Symfony\Component\HttpFoundation\JsonResponse;
+
+
+class ApiPersonController extends Controller
+{
+    public function viewAction($id, $_format) 
+    {
+        
+    }
+}

src/Bundle/ChillPersonBundle/Controller/PersonController.php

@@ -41,21 +41,14 @@ use Chill\PersonBundle\Config\ConfigPersonAltNamesHelper;
 use Symfony\Component\Validator\Validator\ValidatorInterface;
 use Doctrine\ORM\EntityManagerInterface;
 
-/**
- * Class PersonController
- *
- * @package Chill\PersonBundle\Controller
- */
-class PersonController extends AbstractController
+final class PersonController extends AbstractController
 {
     /**
-     *
      * @var SimilarPersonMatcher
      */
     protected $similarPersonMatcher;
 
     /**
-     *
      * @var TranslatorInterface
      */
     protected $translator;
@@ -66,22 +59,19 @@ class PersonController extends AbstractController
     protected $eventDispatcher;
 
     /**
-     *
      * @var PersonRepository;
      */
     protected $personRepository;
 
     /**
-     *
      * @var ConfigPersonAltNamesHelper
      */
     protected $configPersonAltNameHelper;
 
     /**
-     *
      * @var EntityManagerInterface
      */
-    protected $em;
+    private $em;
 
     /**
      * @var \Psr\Log\LoggerInterface
@@ -117,8 +107,7 @@ class PersonController extends AbstractController
     {
         $cFGroup = null;
 
-        $em  = $this->getDoctrine()->getManager();
-        $cFDefaultGroup  = $em->getRepository("ChillCustomFieldsBundle:CustomFieldsDefaultGroup")
+        $cFDefaultGroup  = $this->em->getRepository("ChillCustomFieldsBundle:CustomFieldsDefaultGroup")
             ->findOneByEntity("Chill\PersonBundle\Entity\Person");
 
         if($cFDefaultGroup) {
@@ -207,8 +196,7 @@ class PersonController extends AbstractController
                             ->trans('The person data has been updated')
                             );
 
-            $em = $this->getDoctrine()->getManager();
-            $em->flush();
+            $this->em->flush();
 
             $url = $this->generateUrl('chill_person_view', array(
                 'person_id' => $person->getId()
@@ -402,11 +390,9 @@ class PersonController extends AbstractController
                 'You are not allowed to create this person');
 
         if ($errors->count() ===  0) {
-            $em = $this->getDoctrine()->getManager();
+            $this->em->persist($person);
 
-            $em->persist($person);
-
-            $em->flush();
+            $this->em->flush();
 
             return $this->redirect($this->generateUrl('chill_person_general_edit',
                     array('person_id' => $person->getId())));

src/Bundle/ChillPersonBundle/DependencyInjection/ChillPersonExtension.php

@@ -75,6 +75,7 @@ class ChillPersonExtension extends Extension implements PrependExtensionInterfac
         $loader->load('services/repository.yaml');
         $loader->load('services/templating.yaml');
         $loader->load('services/alt_names.yaml');
+        $loader->load('services/serializer.yaml');
 
         // load service advanced search only if configure
         if ($config['search']['search_by_phone'] != 'never') {

src/Bundle/ChillPersonBundle/Entity/AccompanyingPeriod.php

@@ -629,4 +629,16 @@ class AccompanyingPeriod
     {
         $this->resources->removeElement($resource);
     }
+
+    /**
+     * Get a list of all persons which are participating to this course
+     */
+    public function getPersons(): Collection
+    {
+        return $this->participations->map(
+            function(AccompanyingPeriodParticipation $participation) {
+                return $participation->getPerson();
+            }
+        );
+    }
 }

src/Bundle/ChillPersonBundle/Entity/Person.php

@@ -1022,18 +1022,20 @@ class Person implements HasCenterInterface
      */
     public function getLastAddress(\DateTime $date = null)
     {
-        if ($date === null) {
-            $date = new \DateTime('now');
-        }
+        $from ??= new DateTime('now');
 
-        $addresses = $this->getAddresses();
+        /** @var ArrayIterator $addressesIterator */
+        $addressesIterator = $this->getAddresses()
+            ->filter(static fn (Address $address): bool => $address->getValidFrom() <= $from)
+            ->getIterator();
 
-        if ($addresses == null) {
+        $addressesIterator->uasort(
+            static fn (Address $left, Address $right): int => $right->getValidFrom() <=> $left->getValidFrom()
+        );
 
-            return null;
-        }
-
-        return $addresses->first();
+        return [] === ($addresses = iterator_to_array($addressesIterator)) ?
+            null :
+            current($addresses);
     }
 
     /**

src/Bundle/ChillPersonBundle/Privacy/AccompanyingPeriodPrivacyEvent.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace Chill\PersonBundle\Privacy;
+
+/*
+ * Chill is a software for social workers
+ *
+ * Copyright (C) 2014-2015, Champs Libres Cooperative SCRLFS,
+ * <http://www.champs-libres.coop>, <info@champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+use Symfony\Component\EventDispatcher\Event;
+use Chill\PersonBundle\Entity\Person;
+use Chill\PersonBundle\Entity\AccompanyingPeriod;
+
+class AccompanyingPeriodPrivacyEvent extends Event
+{
+    public const ACCOMPANYING_PERIOD_PRIVACY_EVENT = 'chill_person.accompanying_period_privacy_event';
+
+    protected AccompanyingPeriod $period;
+
+    protected array $args;
+
+    public function __construct($period, $args = [])
+    {
+        $this->period = $period;
+        $this->args = $args;
+    }
+
+    public function getPeriod(): AccompanyingPeriod
+    {
+        return $this->period;
+    }
+
+    public function getArgs(): array
+    {
+        return $this->args;
+    }
+}

src/Bundle/ChillPersonBundle/Privacy/PrivacyEventSubscriber.php

@@ -26,6 +26,7 @@ use Psr\Log\LoggerInterface;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
 use Chill\PersonBundle\Entity\Person;
+use Chill\PersonBundle\Privacy\AccompanyingPeriodPrivacyEvent;
 
 class PrivacyEventSubscriber implements EventSubscriberInterface
 {
@@ -53,14 +54,33 @@ class PrivacyEventSubscriber implements EventSubscriberInterface
 
     public static function getSubscribedEvents()
     {
-        return array(PrivacyEvent::PERSON_PRIVACY_EVENT => array(
-            array('onPrivacyEvent')
-        ));
+        return [
+            PrivacyEvent::PERSON_PRIVACY_EVENT => [
+                ['onPrivacyEvent']
+            ],
+            AccompanyingPeriodPrivacyEvent::ACCOMPANYING_PERIOD_PRIVACY_EVENT => [
+                ['onAccompanyingPeriodPrivacyEvent']
+            ]
+        ];
+    }
+
+    public function onAccompanyingPeriodPrivacyEvent(AccompanyingPeriodPrivacyEvent $event)
+    {
+        $involved = $this->getInvolved();
+        $involved['period_id'] = $event->getPeriod()->getId();
+        $involved['persons'] = $event->getPeriod()->getPersons()
+            ->map(function(Person $p) { return $p->getId(); })
+            ->toArray();
+
+        $this->logger->notice(
+            "[Privacy Event] An accompanying period has been viewed",
+            array_merge($involved, $event->getArgs())
+        );
     }
 
     public function onPrivacyEvent(PrivacyEvent $event)
     {
-        $persons = array();
+        $persons = [];
 
         if ($event->hasPersons() === true) {
             foreach ($event->getPersons() as $person) {
@@ -68,11 +88,8 @@ class PrivacyEventSubscriber implements EventSubscriberInterface
             }
         }
 
-        $involved = array(
-            'by_user' => $this->token->getToken()->getUser()->getUsername(),
-            'by_user_id' => $this->token->getToken()->getUser()->getId(),
-            'person_id' => $event->getPerson()->getId(),
-        );
+        $involved = $this->getInvolved();
+        $involved['person_id'] = $event->getPerson()->getId();
 
         if ($event->hasPersons()) {
             $involved['persons'] = \array_map(
@@ -86,4 +103,12 @@ class PrivacyEventSubscriber implements EventSubscriberInterface
             array_merge($involved, $event->getArgs())
         );
     }
+
+    protected function getInvolved(): array
+    {
+        return [
+            'by_user' => $this->token->getToken()->getUser()->getUsername(),
+            'by_user_id' => $this->token->getToken()->getUser()->getId(),
+        ];
+    }
 }

src/Bundle/ChillPersonBundle/Repository/AccompanyingPeriodRepository.php

@@ -38,5 +38,4 @@ class AccompanyingPeriodRepository extends ServiceEntityRepository
     {
         parent::__construct($registry, AccompanyingPeriod::class);
     }
-
 }

src/Bundle/ChillPersonBundle/Serializer/Normalizer/AccompanyingPeriodNormalizer.php

@@ -0,0 +1,59 @@
+<?php
+/*
+ *
+ * Copyright (C) 2014-2021, Champs Libres Cooperative SCRLFS, <http://www.champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ *  License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+namespace Chill\PersonBundle\Serializer\Normalizer;
+
+use Chill\PersonBundle\Entity\AccompanyingPeriod;
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface;
+use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+
+
+class AccompanyingPeriodNormalizer implements NormalizerInterface, NormalizerAwareInterface {
+
+    protected ?NormalizerInterface $normalizer = null;
+
+    public function normalize($period, string $format = null, array $context = array())
+    {
+        /** @var AccompanyingPeriod $period */
+        return [
+            'id' => $period->getId(),
+            'openingDate' => $this->normalizer->normalize($period->getOpeningDate(), $format),
+            'closingDate' => $this->normalizer->normalize($period->getClosingDate(), $format),
+            'remark' => $period->getRemark(),
+            'participations' => $this->normalizer->normalize($period->getParticipations(), $format),
+            'closingMotive' => $this->normalizer->normalize($period->getClosingMotive(), $format),
+            'user' => $period->getUser() ? $this->normalize($period->getUser(), $format) : null,
+            'step' => $period->getStep(),
+            'origin' => $this->normalizer->normalize($period->getOrigin(), $format),
+            'intensity' => $period->getIntensity(),
+            'emergency' => $period->isEmergency(),
+            'confidential' => $period->isConfidential()
+        ];
+    }
+
+    public function supportsNormalization($data, string $format = null): bool
+    {
+        return $data instanceof AccompanyingPeriod;
+    }
+
+    public function setNormalizer(NormalizerInterface $normalizer)
+    {
+        $this->normalizer = $normalizer;
+    }
+}

src/Bundle/ChillPersonBundle/Serializer/Normalizer/AccompanyingPeriodParticipationNormalizer.php

@@ -0,0 +1,51 @@
+<?php
+/*
+ *
+ * Copyright (C) 2014-2021, Champs Libres Cooperative SCRLFS, <http://www.champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ *  License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+namespace Chill\PersonBundle\Serializer\Normalizer;
+
+use Chill\PersonBundle\Entity\AccompanyingPeriodParticipation;
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface;
+use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+
+
+class AccompanyingPeriodParticipationNormalizer implements NormalizerInterface, NormalizerAwareInterface {
+
+    protected ?NormalizerInterface $normalizer = null;
+
+    public function normalize($participation, string $format = null, array $context = array())
+    {
+        /** @var AccompanyingPeriodParticipation $participation */
+        return [
+            'id' => $participation->getId(),
+            'startDate' => $this->normalizer->normalize($participation->getStartDate(), $format),
+            'endDate' => $this->normalizer->normalize($participation->getEndDate(), $format),
+            'person' => $this->normalizer->normalize($participation->getPerson(), $format)
+        ];
+    }
+
+    public function supportsNormalization($data, string $format = null): bool
+    {
+        return $data instanceof AccompanyingPeriodParticipation;
+    }
+
+    public function setNormalizer(NormalizerInterface $normalizer)
+    {
+        $this->normalizer = $normalizer;
+    }
+}

src/Bundle/ChillPersonBundle/Serializer/Normalizer/PersonNormalizer.php

@@ -0,0 +1,95 @@
+<?php
+/*
+ *
+ * Copyright (C) 2014-2021, Champs Libres Cooperative SCRLFS, <http://www.champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ *  License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+namespace Chill\PersonBundle\Serializer\Normalizer;
+
+use Chill\PersonBundle\Entity\Person;
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
+use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface;
+use Chill\PersonBundle\Repository\PersonRepository;
+use Symfony\Component\Serializer\Exception\RuntimeException;
+use Symfony\Component\Serializer\Exception\UnexpectedValueException;
+
+
+/**
+ * Serialize a Person entity
+ *
+ */
+class PersonNormalizer implements
+    NormalizerInterface,
+    NormalizerAwareInterface,
+    DenormalizerInterface
+{
+
+    protected NormalizerInterface $normalizer;
+
+    protected PersonRepository $repository;
+
+    public const GET_PERSON = 'get_person';
+
+    public function __construct(PersonRepository $repository)
+    {
+        $this->repository = $repository;
+    }
+
+    public function normalize($person, string $format = null, array $context = array())
+    {
+        /** @var Person $person */
+        return [
+            'id' => $person->getId(),
+            'firstName' => $person->getFirstName(),
+            'lastName' => $person->getLastName(),
+            'birthdate' => $person->getBirthdate(),
+            'center' => $this->normalizer->normalize($person->getCenter())
+        ];
+    }
+
+    public function denormalize($data, string $type, string $format = null, array $context = []): Person
+    {
+        if ($context[self::GET_PERSON] ?? true) {
+            $id = $data['id'] ?? null;
+            if (NULL === $id) {
+                throw new RuntimeException("missing id into person object");
+            }
+        }
+        /** var Person $person */
+        $person = $this->repository->findOneById($id);
+
+        if (NULL === $person) {
+            return UnexpectedValueException("person id not found");
+        }
+
+        return $person;
+    }
+
+    public function supportsNormalization($data, string $format = null): bool
+    {
+        return $data instanceof Person;
+    }
+
+    public function supportsDenormalization($data, string $type, ?string $format = NULL): bool
+    {
+        return Person::class === $type;
+    }
+
+    public function setNormalizer(NormalizerInterface $normalizer)
+    {
+        $this->normalizer = $normalizer;
+    }
+}

src/Bundle/ChillPersonBundle/Tests/Controller/AccompanyingCourseControllerTest.php

@@ -0,0 +1,174 @@
+<?php
+
+/*
+ * Chill is a software for social workers
+ * 
+ * Copyright (C) 2014-2015, Champs Libres Cooperative SCRLFS, 
+ * <http://www.champs-libres.coop>, <info@champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+namespace Chill\PersonBundle\Tests\Controller;
+
+
+use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+use Chill\PersonBundle\Entity\AccompanyingPeriod;
+use Chill\PersonBundle\Entity\AccompanyingPeriodParticipation;
+use Chill\PersonBundle\Entity\Person;
+use Chill\MainBundle\Entity\User;
+use Chill\MainBundle\Entity\Center;
+use Doctrine\Common\Collections\Criteria;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Component\HttpFoundation\Request;
+
+/**
+ * Test api for AccompanyingCourseControllerTest
+ */
+class AccompanyingCourseControllerTest extends WebTestCase
+{
+    protected static EntityManagerInterface $em;
+
+    /**
+     * Setup before the first test of this class (see phpunit doc)
+     */
+    public static function setUpBeforeClass()
+    {
+        static::bootKernel();
+    }
+    
+    /**
+     * Setup before each test method (see phpunit doc)
+     */
+    public function setUp()
+    {
+        $this->client = static::createClient(array(), array(
+           'PHP_AUTH_USER' => 'center a_social',
+           'PHP_AUTH_PW'   => 'password',
+        ));
+    }
+
+    /**
+     *
+     * @dataProvider dataGenerateRandomAccompanyingCourse
+     */
+    public function testAccompanyingCourseShow(int $personId, AccompanyingPeriod $period)
+    {
+        $this->client->request(Request::METHOD_GET, sprintf('/fr/person/api/1.0/accompanying-course/%d/show.json', $period->getId()));
+        $response = $this->client->getResponse();
+
+        $this->assertEquals(200, $response->getStatusCode(), "Test that the response of rest api has a status code ok (200)");
+        
+        $data = \json_decode($response->getContent());
+        $this->assertEquals($data->id, $period->getId(),
+            "test that the response's data contains the id of the period"
+        ); 
+        $this->assertGreaterThan(0, $data->participations);
+    }
+
+    /**
+     *
+     * @dataProvider dataGenerateRandomAccompanyingCourse
+     */
+    public function testAccompanyingCourseAddParticipation(int $personId, AccompanyingPeriod $period)
+    {
+        $this->client->request(
+            Request::METHOD_POST,
+            sprintf('/fr/person/api/1.0/accompanying-course/%d/participation.json', $period->getId()),
+            [], // parameters
+            [], // files
+            [], // server parameters
+            \json_encode([ 'id' => $personId ])
+        );
+        $response = $this->client->getResponse();
+
+        $this->assertEquals(200, $response->getStatusCode(), "Test that the response of rest api has a status code ok (200)");
+        $this->client->request(Request::METHOD_GET, sprintf('/fr/person/api/1.0/accompanying-course/%d/show.json', $period->getId()));
+        
+        $response = $this->client->getResponse();
+        $data = \json_decode($response->getContent());
+
+        $participationsPersonsIds = \array_map(
+            function($participation) { return $participation->person->id; },
+            $data->participations);
+
+        $this->assertContains($personId, $participationsPersonsIds);
+
+        $this->personId = $personId;
+        $this->period = $period;
+    }
+
+    protected function tearDown()
+    {
+        // remove participation created during test 'testAccompanyingCourseAddParticipation'
+
+        $testAddParticipationName = 'testAccompanyingCourseAddParticipation';
+
+        if ($testAddParticipationName !== \substr($this->getName(), 0, \strlen($testAddParticipationName))) {
+            return;
+        }
+
+        $em = static::$container->get(EntityManagerInterface::class);
+
+        $participation = $em
+            ->getRepository(AccompanyingPeriodParticipation::class)
+            ->findOneBy(['person' => $this->personId, 'accompanyingPeriod' => $this->period])
+            ;
+
+        $em->remove($participation);
+        $em->flush();
+    }
+
+    public function dataGenerateRandomAccompanyingCourse()
+    {
+        // note about max result for person query, and maxGenerated:
+        // 
+        // in the final loop, an id is popped out of the personIds array twice:
+        // 
+        // * one for getting the person, which will in turn provide his accompanying period;
+        // * one for getting the personId to populate to the data manager
+        //
+        // Ensure to keep always $maxGenerated to the double of $maxResults
+        $maxGenerated = 1;
+        $maxResults = 15 * 8;
+
+        static::bootKernel();
+        $em = static::$container->get(EntityManagerInterface::class);
+        $center = $em->getRepository(Center::class)
+            ->findOneBy(array('name' => 'Center A'));
+
+        $personIds = $em->createQuery("SELECT p.id FROM ".
+            Person::class." p ".
+            " WHERE p.center = :center")
+            ->setParameter('center', $center)
+            ->setMaxResults($maxResults)
+            ->getScalarResult();
+        
+        // create a random order
+        shuffle($personIds);
+
+        $nbGenerated = 0;
+        while ($nbGenerated < $maxGenerated) {
+            $id = \array_pop($personIds)["id"];
+
+            $person = $em->getRepository(Person::class)
+                ->find($id);
+            $periods = $person->getAccompanyingPeriods();
+
+            yield [\array_pop($personIds)["id"], $periods[\array_rand($periods)] ];
+
+            $nbGenerated++;
+        }
+    }
+}

src/Bundle/ChillPersonBundle/Tests/Entity/PersonTest.php

@@ -24,6 +24,11 @@ namespace Chill\PersonBundle\Tests\Entity;
 
 use Chill\PersonBundle\Entity\Person;
 use Chill\PersonBundle\Entity\AccompanyingPeriod;
+use Chill\MainBundle\Entity\Address;
+use DateInterval;
+use DateTime;
+use Generator;
+
 
 /**
  * Unit tests for the person Entity
@@ -151,4 +156,53 @@ class PersonTest extends \PHPUnit\Framework\TestCase
         
         $this->assertEquals($r['result'], Person::ERROR_ADDIND_PERIOD_AFTER_AN_OPEN_PERIOD);
     }
+
+    public function dateProvider(): Generator
+    {
+        yield [(DateTime::createFromFormat('Y-m-d', '2021-01-05'))->settime(0, 0)];
+        yield [(DateTime::createFromFormat('Y-m-d', '2021-02-05'))->settime(0, 0)];
+        yield [(DateTime::createFromFormat('Y-m-d', '2021-03-05'))->settime(0, 0)];
+    }
+
+    /**
+     * @dataProvider dateProvider
+     */
+    public function testGetLastAddress(DateTime $date)
+    {
+        $p = new Person($date);
+
+        // Make sure that there is no last address.
+        $this::assertNull($p->getLastAddress());
+
+        // Take an arbitrary date before the $date in parameter.
+        $addressDate = clone $date;
+
+        // 1. Smoke test: Test that the first address added is the last one.
+        $address1 = (new Address())->setValidFrom($addressDate->sub(new DateInterval('PT180M')));
+        $p->addAddress($address1);
+
+        $this::assertCount(1, $p->getAddresses());
+        $this::assertSame($address1, $p->getLastAddress());
+
+        // 2. Add an older address, which should not be the last address.
+        $addressDate2 = clone $addressDate;
+        $address2 = (new Address())->setValidFrom($addressDate2->sub(new DateInterval('PT30M')));
+        $p->addAddress($address2);
+
+        $this::assertCount(2, $p->getAddresses());
+        $this::assertSame($address1, $p->getLastAddress());
+
+        // 3. Add a newer address, which should be the last address.
+        $addressDate3 = clone $addressDate;
+        $address3 = (new Address())->setValidFrom($addressDate3->add(new DateInterval('PT30M')));
+        $p->addAddress($address3);
+
+        $this::assertCount(3, $p->getAddresses());
+        $this::assertSame($address3, $p->getLastAddress());
+
+        // 4. Get the last address from a specific date.
+        $this::assertEquals($address1, $p->getLastAddress($addressDate));
+        $this::assertEquals($address2, $p->getLastAddress($addressDate2));
+        $this::assertEquals($address3, $p->getLastAddress($addressDate3));
+    }
 }

src/Bundle/ChillPersonBundle/config/services/controller.yaml

@@ -41,4 +41,8 @@ services:
         tags: ['controller.service_arguments']
 
     Chill\PersonBundle\Controller\AccompanyingCourseController:
+        arguments:
+            $serializer: '@Symfony\Component\Serializer\SerializerInterface'
+            $dispatcher: '@Symfony\Contracts\EventDispatcher\EventDispatcherInterface'
+            $validator: '@Symfony\Component\Validator\Validator\ValidatorInterface'
         tags: ['controller.service_arguments']

src/Bundle/ChillPersonBundle/config/services/repository.yaml

@@ -18,3 +18,8 @@ services:
         tags: [ doctrine.repository_service ]
         arguments:
             - '@Doctrine\Persistence\ManagerRegistry'
+
+    Chill\PersonBundle\Repository\AccompanyingPeriodParticipationRepository:
+        arguments:
+            - '@Doctrine\Persistence\ManagerRegistry'
+        tags: [ doctrine.repository_service ]

src/Bundle/ChillPersonBundle/config/services/serializer.yaml

@@ -0,0 +1,15 @@
+---
+services:
+    Chill\PersonBundle\Serializer\Normalizer\PersonNormalizer:
+        arguments:
+            $repository: '@Chill\PersonBundle\Repository\PersonRepository'
+        tags:
+            - { name: 'serializer.normalizer', priority: 64 }
+
+    Chill\PersonBundle\Serializer\Normalizer\AccompanyingPeriodNormalizer:
+        tags:
+            - { name: 'serializer.normalizer', priority: 64 }
+
+    Chill\PersonBundle\Serializer\Normalizer\AccompanyingPeriodParticipationNormalizer:
+        tags:
+            - { name: 'serializer.normalizer', priority: 64 }