Add AccompanyingCourseStepHistory counting capabilities

The newly created CountAccompanyingCourseStepHistory class counts changes in AccompanyingPeriod status. Corresponding test file ensures the correct functionality. Supporting translations and necessary export declarations have been added to facilitate this change.

exports_alias_conventions.md

@@ -6,7 +6,9 @@ Add condition with distinct alias on each export join clauses (Indicators + Filt
 These are alias conventions :
 
 | Entity                                  | Join                                    | Attribute                                  | Alias                                      |
-|:----------------------------------------|:----------------------------------------|:-------------------------------------------|:---------------------------------------|
+|:----------------------------------------|:----------------------------------------|:-------------------------------------------|:-------------------------------------------|
+| AccompanyingPeriodStepHistory::class    |                                         |                                            | acpstephistory (contexte ACP_STEP_HISTORY) |
+|                                         | AccompanyingPeriod::class               | acpstephistory.period                      | acp                                        |
 | AccompanyingPeriod::class               |                                         |                                            | acp                                        |
 |                                         | AccompanyingPeriodWork::class           | acp.works                                  | acpw                                       |
 |                                         | AccompanyingPeriodParticipation::class  | acp.participations                         | acppart                                    |

src/Bundle/ChillPersonBundle/Export/Declarations.php

@@ -18,6 +18,8 @@ abstract class Declarations
 {
     final public const ACP_TYPE = 'accompanying_period';
 
+    final public const ACP_STEP_HISTORY = 'accompanying_period_step_history';
+
     final public const EVAL_TYPE = 'evaluation';
 
     final public const HOUSEHOLD_TYPE = 'household';

src/Bundle/ChillPersonBundle/Export/Export/CountAccompanyingCourseStepHistory.php

@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Chill\PersonBundle\Export\Export;
+
+use Chill\MainBundle\Export\AccompanyingCourseExportHelper;
+use Chill\MainBundle\Export\ExportInterface;
+use Chill\MainBundle\Export\FormatterInterface;
+use Chill\MainBundle\Export\GroupedExportInterface;
+use Chill\PersonBundle\Entity\AccompanyingPeriod;
+use Chill\PersonBundle\Entity\Person\PersonCenterHistory;
+use Chill\PersonBundle\Export\Declarations;
+use Chill\PersonBundle\Security\Authorization\AccompanyingPeriodVoter;
+use Doctrine\ORM\EntityManagerInterface;
+use Doctrine\ORM\EntityRepository;
+use Doctrine\ORM\Query;
+use Doctrine\ORM\QueryBuilder;
+use Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface;
+use Symfony\Component\Form\FormBuilderInterface;
+
+class CountAccompanyingCourseStepHistory implements ExportInterface, GroupedExportInterface
+{
+    protected EntityRepository $repository;
+    private readonly bool $filterStatsByCenters;
+
+    public function __construct(
+        private readonly EntityManagerInterface $em,
+        ParameterBagInterface $parameterBag,
+    ) {
+        $this->repository = $em->getRepository(AccompanyingPeriod::class);
+        $this->filterStatsByCenters = $parameterBag->get('chill_main')['acl']['filter_stats_by_center'];
+    }
+
+    public function buildForm(FormBuilderInterface $builder): void
+    {
+        // Nothing to add here
+    }
+
+    public function getFormDefaultData(): array
+    {
+        return [];
+    }
+
+    public function getAllowedFormattersTypes(): array
+    {
+        return [FormatterInterface::TYPE_TABULAR];
+    }
+
+    public function getDescription(): string
+    {
+        return 'export.export.acp_closing.description';
+    }
+
+    public function getGroup(): string
+    {
+        return 'Exports of accompanying courses';
+    }
+
+    public function getLabels($key, array $values, $data)
+    {
+        if ('export_result' !== $key) {
+            throw new \LogicException("the key {$key} is not used by this export");
+        }
+
+        return fn ($value) => '_header' === $value ? $this->getTitle() : $value;
+    }
+
+    public function getQueryKeys($data): array
+    {
+        return ['export_result'];
+    }
+
+    public function getResult($query, $data)
+    {
+        return $query->getQuery()->getResult(Query::HYDRATE_SCALAR);
+    }
+
+    public function getTitle(): string
+    {
+        return 'export.export.acp_closing.title';
+    }
+
+    public function getType(): string
+    {
+        return Declarations::ACP_TYPE;
+    }
+
+    public function initiateQuery(array $requiredModifiers, array $acl, array $data = []): QueryBuilder
+    {
+        $centers = array_map(static fn ($el) => $el['center'], $acl);
+
+        $qb = $this->em->createQueryBuilder()
+            ->select('COUNT(DISTINCT acpstephistory.id) As export_result')
+            ->from(AccompanyingPeriod\AccompanyingPeriodStepHistory::class, 'acpstephistory')
+            ->join('acpstephistory.period', 'acp');
+
+        $qb
+            ->leftJoin('acp.participations', 'acppart')
+            ->leftJoin('acppart.person', 'person');
+
+        if ($this->filterStatsByCenters) {
+            $qb
+                ->andWhere(
+                    $qb->expr()->exists(
+                        'SELECT 1 FROM '.PersonCenterHistory::class.' acl_count_person_history WHERE acl_count_person_history.person = person
+                    AND acl_count_person_history.center IN (:authorized_centers)
+                    '
+                    )
+                )
+                ->setParameter('authorized_centers', $centers);
+        }
+
+        AccompanyingCourseExportHelper::addClosingMotiveExclusionClause($qb);
+
+        return $qb;
+    }
+
+    public function requiredRole(): string
+    {
+        return AccompanyingPeriodVoter::STATS;
+    }
+
+    public function supportsModifiers(): array
+    {
+        return [
+            Declarations::ACP_TYPE,
+            Declarations::PERSON_TYPE,
+            Declarations::ACP_STEP_HISTORY,
+        ];
+    }
+}

src/Bundle/ChillPersonBundle/Tests/Export/Export/CountAccompanyingCourseStepHistoryTest.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace src\Bundle\ChillPersonBundle\Tests\Export\Export;
+
+use Chill\MainBundle\Test\Export\AbstractExportTest;
+use Chill\PersonBundle\Export\Declarations;
+use Chill\PersonBundle\Export\Export\CountAccompanyingCourseStepHistory;
+use Doctrine\ORM\EntityManagerInterface;
+
+/**
+ * @internal
+ *
+ * @coversNothing
+ */
+final class CountAccompanyingCourseStepHistoryTest extends AbstractExportTest
+{
+    protected function setUp(): void
+    {
+        self::bootKernel();
+    }
+
+    public function getExport()
+    {
+        $em = self::$container->get(EntityManagerInterface::class);
+
+        yield new CountAccompanyingCourseStepHistory($em, $this->getParameters(true));
+        yield new CountAccompanyingCourseStepHistory($em, $this->getParameters(false));
+    }
+
+    public function getFormData(): array
+    {
+        return [[]];
+    }
+
+    public function getModifiersCombination()
+    {
+        return [[Declarations::ACP_TYPE], [Declarations::ACP_TYPE, Declarations::ACP_STEP_HISTORY]];
+    }
+}

src/Bundle/ChillPersonBundle/translations/messages.fr.yml

@@ -985,6 +985,9 @@ export:
             YYYY-MM: par mois
             YYYY: par année
     export:
+        acp_closing:
+            title: Nombre de changements de statuts de parcours
+            description: Compte le nombre de changements de statuts de parcours. Cet export est indiqué pour obtenir le nombre de parcours ouverts ou fermés pendant une période de temps (un parcours pouvant être clôturé, puis ré-ouvert pendant la période de temps indiquée)
         acp_stats:
             avg_duration: Moyenne de la durée de participation de chaque usager concerné
             count_participations: Nombre de participations distinctes