feat: list and show submitted questionnaires to the office

src/Controller/Administrative/Questionnaire/DetailController.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Controller\Administrative\Questionnaire;
+
+use App\Config\QuestionnaireCatalog;
+use App\Controller\Traits\ReturnUrlTrait;
+use App\Entity\QuestionnaireResponse;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+/**
+ * One submitted questionnaire: what the disposition knew when it was submitted, then the answers,
+ * rendered with the definition version they were given under.
+ */
+class DetailController extends AbstractController
+{
+    use ReturnUrlTrait;
+
+    public function __construct(
+        private readonly QuestionnaireCatalog $catalog,
+    ) {
+    }
+
+    #[Route('/administrative/questionnaire/{uuid}', name: 'app_administrative_questionnaire_detail')]
+    #[IsGranted('ROLE_ADMINISTRATIVE')]
+    public function index(QuestionnaireResponse $response, Request $request): Response
+    {
+        // a draft is still the teamer's
+        if (false === $response->isSubmitted()) {
+            throw new NotFoundHttpException();
+        }
+
+        return $this->render('administrative/questionnaire/detail.html.twig', [
+            'definition' => $this->catalog->get($response->getQuestionnaire(), $response->getVersion()),
+            'response' => $response,
+            'returnUrl' => $this->getReturnUrl($request, 'app_administrative_questionnaire_index'),
+        ]);
+    }
+}

src/Controller/Administrative/Questionnaire/IndexController.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Controller\Administrative\Questionnaire;
+
+use App\Config\QuestionnaireCatalog;
+use App\Repository\QuestionnaireResponseRepository;
+use App\Service\Common\QuestionnaireResponseFilterHandler;
+use Knp\Component\Pager\PaginatorInterface;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+/**
+ * The submitted teamer questionnaires. Only administrative users read them: they rate the house
+ * manager among others, so house managers are deliberately not let in.
+ */
+class IndexController extends AbstractController
+{
+    public function __construct(
+        private readonly QuestionnaireResponseFilterHandler $filterHandler,
+        private readonly QuestionnaireResponseRepository $responseRepository,
+        private readonly QuestionnaireCatalog $catalog,
+        private readonly PaginatorInterface $paginator,
+    ) {
+    }
+
+    #[Route('/administrative/questionnaire', name: 'app_administrative_questionnaire_index')]
+    #[IsGranted('ROLE_ADMINISTRATIVE')]
+    public function index(Request $request): Response
+    {
+        $filterDto = $this->filterHandler->getFilterSettings();
+
+        $pagination = $this->paginator->paginate(
+            $this->responseRepository->getListQuery(QuestionnaireCatalog::TEAMER_ESCORT, $filterDto),
+            $request->query->getInt('page', 1),
+            $request->query->getInt('limit', 50),
+            [
+                'defaultSortFieldName' => 'response.submittedAt',
+                'defaultSortDirection' => 'desc',
+            ]
+        );
+
+        return $this->render('administrative/questionnaire/index.html.twig', [
+            'definition' => $this->catalog->get(QuestionnaireCatalog::TEAMER_ESCORT),
+            'pagination' => $pagination,
+            'filterDto' => $filterDto,
+        ]);
+    }
+}

src/Controller/Common/QuestionnaireResponseFilterController.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Controller\Common;
+
+use App\Form\QuestionnaireResponseFilterType;
+use App\Htmx\HxRedirectResponse;
+use App\Service\Common\QuestionnaireResponseFilterHandler;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+class QuestionnaireResponseFilterController extends AbstractController
+{
+    public function __construct(private readonly QuestionnaireResponseFilterHandler $filterHandler)
+    {
+    }
+
+    #[Route('/common/questionnaire-response/filter', name: 'app_common_questionnaire_response_filter')]
+    #[IsGranted('ROLE_ADMINISTRATIVE')]
+    public function index(Request $request): Response
+    {
+        $formData = $this->filterHandler->getFilterSettings();
+        $form = $this->createForm(QuestionnaireResponseFilterType::class, $formData);
+        $form->handleRequest($request);
+
+        if ($form->isSubmitted() && $form->isValid()) {
+            $this->filterHandler->handleRequest($form);
+
+            return new HxRedirectResponse($this->generateUrl('app_administrative_questionnaire_index'));
+        }
+
+        return $this->render('common/modal_questionnaire_response_filter.html.twig', [
+            'filterForm' => $form->createView(),
+            'filterDto' => $form->getData(),
+        ]);
+    }
+
+    #[Route('/common/questionnaire-response/filter/reset', name: 'app_common_questionnaire_response_filter_reset')]
+    #[IsGranted('ROLE_ADMINISTRATIVE')]
+    public function reset(): Response
+    {
+        $this->filterHandler->resetFilterSettings();
+
+        return $this->redirectToRoute('app_administrative_questionnaire_index');
+    }
+}

src/Form/QuestionnaireResponseFilterType.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Form;
+
+use App\Entity\Teamer;
+use App\Model\QuestionnaireResponseFilterDto;
+use Symfony\Component\Form\AbstractType;
+use Symfony\Component\Form\Extension\Core\Type\SubmitType;
+use Symfony\Component\Form\Extension\Core\Type\TextType;
+use Symfony\Component\Form\FormBuilderInterface;
+use Symfony\Component\OptionsResolver\OptionsResolver;
+
+class QuestionnaireResponseFilterType extends AbstractType
+{
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder
+            ->add('teamer', AutocompleteEntityType::class, [
+                'label' => 'Teamer',
+                'required' => false,
+                'class' => Teamer::class,
+                'label_property' => 'name',
+                'label_function' => fn (Teamer $teamer) => (string) $teamer,
+                'endpoint_route' => 'app_admin_autocomplete_teamer',
+            ])
+            ->add('hotel', TextType::class, [
+                'label' => 'Haus',
+                'required' => false,
+            ])
+            ->add('dateFrom', DatepickerType::class, [
+                'label' => 'Einsatzende von',
+                'required' => false,
+            ])
+            ->add('dateTo', DatepickerType::class, [
+                'label' => 'Einsatzende bis',
+                'required' => false,
+            ])
+            ->add('apply', SubmitType::class, [
+                'label' => 'filtern',
+            ])
+            ->add('reset', SubmitType::class, [
+                'label' => 'reset',
+            ])
+        ;
+    }
+
+    public function configureOptions(OptionsResolver $resolver): void
+    {
+        $resolver->setDefaults([
+            'data_class' => QuestionnaireResponseFilterDto::class,
+        ]);
+    }
+}

src/Menu/AdminMenuBuilder.php

@@ -109,6 +109,18 @@ class AdminMenuBuilder extends AbstractMenuBuilder
                 ],
             ],
         ]);
+        $menu->addChild('Fragebögen', [
+            'route' => 'app_administrative_questionnaire_index',
+            'linkAttributes' => [
+                'title' => 'Fragebögen der Busbegleitungen',
+            ],
+            'extras' => [
+                'icon' => 'bus',
+                'routes' => [
+                    ['pattern' => '/^app_administrative_questionnaire_/'],
+                ],
+            ],
+        ]);
 
         $menu->addChild('Teamübersicht', [
             'route' => 'app_administrative_teamer_index',

src/Menu/ManagerMenuBuilder.php

@@ -118,6 +118,18 @@ class ManagerMenuBuilder extends AbstractMenuBuilder
                 ],
             ],
         ]);
+        $menu->addChild('Fragebögen', [
+            'route' => 'app_administrative_questionnaire_index',
+            'linkAttributes' => [
+                'title' => 'Fragebögen der Busbegleitungen',
+            ],
+            'extras' => [
+                'icon' => 'bus',
+                'routes' => [
+                    ['pattern' => '/^app_administrative_questionnaire_/'],
+                ],
+            ],
+        ]);
         $statisticsMenu = $menu->addChild('Statistiken', [
             'extras' => [
                 'icon' => 'chart',

src/Model/QuestionnaireResponseFilterDto.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace App\Model;
+
+use App\Entity\Teamer;
+
+class QuestionnaireResponseFilterDto extends AbstractFilterDto
+{
+    protected ?Teamer $teamer = null;
+    protected ?string $hotel = null;
+    protected ?\DateTimeImmutable $dateFrom = null;
+    protected ?\DateTimeImmutable $dateTo = null;
+
+    public function getTeamer(): ?Teamer
+    {
+        return $this->teamer;
+    }
+
+    public function setTeamer(?Teamer $teamer): static
+    {
+        $this->teamer = $teamer;
+
+        return $this;
+    }
+
+    public function getHotel(): ?string
+    {
+        return $this->hotel;
+    }
+
+    public function setHotel(?string $hotel): static
+    {
+        $this->hotel = $hotel;
+
+        return $this;
+    }
+
+    public function getDateFrom(): ?\DateTimeImmutable
+    {
+        return $this->dateFrom;
+    }
+
+    public function setDateFrom(?\DateTimeImmutable $dateFrom): static
+    {
+        $this->dateFrom = $dateFrom;
+
+        return $this;
+    }
+
+    public function getDateTo(): ?\DateTimeImmutable
+    {
+        return $this->dateTo;
+    }
+
+    public function setDateTo(?\DateTimeImmutable $dateTo): static
+    {
+        $this->dateTo = $dateTo;
+
+        return $this;
+    }
+}

src/Repository/QuestionnaireResponseRepository.php

@@ -4,7 +4,11 @@ namespace App\Repository;
 
 use App\Entity\Disposition;
 use App\Entity\QuestionnaireResponse;
+use App\Enum\QuestionnaireResponseStatus;
+use App\Model\QuestionnaireResponseFilterDto;
 use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\DBAL\Types\Types;
+use Doctrine\ORM\Query;
 use Doctrine\Persistence\ManagerRegistry;
 
 /**
@@ -22,6 +26,60 @@ class QuestionnaireResponseRepository extends ServiceEntityRepository
         parent::__construct($registry, QuestionnaireResponse::class);
     }
 
+    /**
+     * Submitted responses to one questionnaire for the office's list. Drafts stay out: until the
+     * teamer submits, a response is theirs. Filtered and sorted on the live disposition rather
+     * than the snapshot in `context`, which JSON would make neither sortable nor indexable.
+     */
+    public function getListQuery(string $questionnaire, QuestionnaireResponseFilterDto $filterDto): Query
+    {
+        $qb = $this->createQueryBuilder('response');
+
+        $qb
+            ->select('response', 'disposition', 'teamer', 'assignment', 'destination')
+            ->innerJoin('response.disposition', 'disposition')
+            ->innerJoin('disposition.teamer', 'teamer')
+            ->innerJoin('disposition.assignment', 'assignment')
+            ->innerJoin('assignment.destination', 'destination')
+            ->where($qb->expr()->andX(
+                $qb->expr()->eq('response.questionnaire', ':questionnaire'),
+                $qb->expr()->eq('response.status', ':submitted')
+            ))
+            ->setParameter('questionnaire', $questionnaire)
+            ->setParameter('submitted', QuestionnaireResponseStatus::SUBMITTED)
+        ;
+
+        if (null !== $teamer = $filterDto->getTeamer()) {
+            $qb
+                ->andWhere($qb->expr()->eq('disposition.teamer', ':teamer'))
+                ->setParameter('teamer', $teamer)
+            ;
+        }
+
+        if (null !== $hotel = $filterDto->getHotel()) {
+            $qb
+                ->andWhere($qb->expr()->like('destination.hotel', ':hotel'))
+                ->setParameter('hotel', '%'.addcslashes($hotel, '%_').'%')
+            ;
+        }
+
+        if (null !== $dateFrom = $filterDto->getDateFrom()) {
+            $qb
+                ->andWhere($qb->expr()->gte('destination.dateTo', ':dateFrom'))
+                ->setParameter('dateFrom', $dateFrom, Types::DATE_IMMUTABLE)
+            ;
+        }
+
+        if (null !== $dateTo = $filterDto->getDateTo()) {
+            $qb
+                ->andWhere($qb->expr()->lte('destination.dateTo', ':dateTo'))
+                ->setParameter('dateTo', $dateTo, Types::DATE_IMMUTABLE)
+            ;
+        }
+
+        return $qb->getQuery();
+    }
+
     public function findOneByDisposition(string $questionnaire, Disposition $disposition): ?QuestionnaireResponse
     {
         return $this->findOneBy(['questionnaire' => $questionnaire, 'disposition' => $disposition]);

src/Service/Common/QuestionnaireResponseFilterHandler.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Service\Common;
+
+use App\Entity\Teamer;
+use App\Model\AbstractFilterDto;
+use App\Model\QuestionnaireResponseFilterDto;
+
+class QuestionnaireResponseFilterHandler extends AbstractFilterHandler
+{
+    protected string $namespace = 'filter:questionnaire_response';
+    protected string $modelClass = QuestionnaireResponseFilterDto::class;
+
+    public function getFilterSettings(): QuestionnaireResponseFilterDto
+    {
+        $filterDto = new $this->modelClass();
+
+        if (null === $data = $this->getSession()->get($this->namespace)) {
+            return $filterDto;
+        }
+
+        if (isset($data['teamer_id'])) {
+            $filterDto->setTeamer($this->entityManager->getRepository(Teamer::class)->find($data['teamer_id']));
+        }
+        if (isset($data['hotel'])) {
+            $filterDto->setHotel($data['hotel']);
+        }
+        if (isset($data['date_from'])) {
+            $filterDto->setDateFrom($data['date_from']);
+        }
+        if (isset($data['date_to'])) {
+            $filterDto->setDateTo($data['date_to']);
+        }
+
+        return $filterDto;
+    }
+
+    protected function saveFilterSettings(AbstractFilterDto $filterDto): void
+    {
+        /* @var QuestionnaireResponseFilterDto $filterDto */
+        $this->getSession()->set($this->namespace, [
+            'teamer_id' => $filterDto->getTeamer()?->getId(),
+            'hotel' => $filterDto->getHotel(),
+            'date_from' => $filterDto->getDateFrom(),
+            'date_to' => $filterDto->getDateTo(),
+        ]);
+    }
+}