feat: let teamers fill in and read their questionnaire

src/Config/QuestionnaireCatalog.php

@@ -25,6 +25,11 @@ use Symfony\Component\Yaml\Yaml;
  */
 class QuestionnaireCatalog
 {
+    /**
+     * The questionnaire a teamer fills in after a bus escort; see DispositionVoter::QUESTIONNAIRE.
+     */
+    public const string TEAMER_ESCORT = 'teamer_escort';
+
     private const array ROOT_FIELDS = ['key', 'version', 'title', 'description', 'sections'];
     private const array SECTION_FIELDS = ['key', 'title', 'questions'];
     private const array QUESTION_FIELDS = ['key', 'label', 'type', 'required', 'help', 'widget', 'options', 'show_if'];

src/Controller/Teamer/Questionnaire/DetailController.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Controller\Teamer\Questionnaire;
+
+use App\Config\QuestionnaireCatalog;
+use App\Entity\Disposition;
+use App\Repository\QuestionnaireResponseRepository;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+/**
+ * The teamer's own submitted questionnaire, read-only, rendered with the definition version it
+ * was submitted under.
+ */
+class DetailController extends AbstractController
+{
+    public function __construct(
+        private readonly QuestionnaireCatalog $catalog,
+        private readonly QuestionnaireResponseRepository $responseRepository,
+    ) {
+    }
+
+    #[Route('/teamer/questionnaire/{uuid}/detail', name: 'app_teamer_questionnaire_detail')]
+    #[IsGranted('ROLE_TEAMER')]
+    #[IsGranted('QUESTIONNAIRE', subject: 'disposition')]
+    public function index(Disposition $disposition): Response
+    {
+        $response = $this->responseRepository->findOneByDisposition(QuestionnaireCatalog::TEAMER_ESCORT, $disposition);
+
+        if (true !== $response?->isSubmitted()) {
+            return $this->redirectToRoute('app_teamer_questionnaire_edit', ['uuid' => $disposition->getUuid()]);
+        }
+
+        return $this->render('teamer/questionnaire/detail.html.twig', [
+            'disposition' => $disposition,
+            'definition' => $this->catalog->get($response->getQuestionnaire(), $response->getVersion()),
+            'response' => $response,
+        ]);
+    }
+}

src/Controller/Teamer/Questionnaire/EditController.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Controller\Teamer\Questionnaire;
+
+use App\Config\QuestionnaireCatalog;
+use App\Entity\Disposition;
+use App\Entity\QuestionnaireResponse;
+use App\Form\QuestionnaireType;
+use App\Repository\QuestionnaireResponseRepository;
+use App\Service\Questionnaire\DispositionContext;
+use Doctrine\ORM\EntityManagerInterface;
+use Psr\Log\LoggerInterface;
+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 teamer's questionnaire after a bus escort, saved as a draft until it is submitted. A
+ * submitted one is final and only shown read-only (DetailController).
+ */
+class EditController extends AbstractController
+{
+    public function __construct(
+        private readonly QuestionnaireCatalog $catalog,
+        private readonly QuestionnaireResponseRepository $responseRepository,
+        private readonly EntityManagerInterface $entityManager,
+        private readonly LoggerInterface $logger,
+    ) {
+    }
+
+    #[Route('/teamer/questionnaire/{uuid}', name: 'app_teamer_questionnaire_edit')]
+    #[IsGranted('ROLE_TEAMER')]
+    #[IsGranted('QUESTIONNAIRE', subject: 'disposition')]
+    public function index(Disposition $disposition, Request $request): Response
+    {
+        $response = $this->responseRepository->findOneByDisposition(QuestionnaireCatalog::TEAMER_ESCORT, $disposition);
+
+        if (true === $response?->isSubmitted()) {
+            return $this->redirectToRoute('app_teamer_questionnaire_detail', ['uuid' => $disposition->getUuid()]);
+        }
+
+        $definition = $this->catalog->get(QuestionnaireCatalog::TEAMER_ESCORT);
+
+        $form = $this->createForm(QuestionnaireType::class, $response?->getAnswers() ?? [], [
+            'definition' => $definition,
+        ]);
+        $form->handleRequest($request);
+
+        if ($form->isSubmitted() && $form->isValid()) {
+            if (null === $response) {
+                $response = QuestionnaireResponse::forDisposition($definition, $disposition);
+                $this->entityManager->persist($response);
+            }
+
+            $context = DispositionContext::build($disposition);
+            $final = QuestionnaireType::isFinal($form);
+
+            if (true === $final) {
+                $response->submit($definition, $form->getData(), $context, new \DateTimeImmutable());
+            } else {
+                $response->saveDraft($form->getData(), $context);
+            }
+
+            $this->entityManager->flush();
+
+            $this->logger->info($final ? 'Submit questionnaire' : 'Save questionnaire draft', [
+                'questionnaire' => $response->getQuestionnaire(),
+                'questionnaire_response_id' => $response->getId(),
+                'disposition_id' => $disposition->getId(),
+                'teamer_id' => $disposition->getTeamer()->getId(),
+            ]);
+
+            if (true === $final) {
+                $this->addFlash('success', 'Danke! Dein Fragebogen wurde abgeschickt.');
+
+                return $this->redirectToRoute('app_teamer_questionnaire_detail', ['uuid' => $disposition->getUuid()]);
+            }
+
+            $this->addFlash('success', 'Dein Entwurf wurde gespeichert.');
+
+            return $this->redirectToRoute('app_teamer_questionnaire_edit', ['uuid' => $disposition->getUuid()]);
+        }
+
+        return $this->render('teamer/questionnaire/edit.html.twig', [
+            'disposition' => $disposition,
+            'definition' => $definition,
+            'response' => $response,
+            'form' => $form,
+        ]);
+    }
+}

src/Form/QuestionnaireType.php

@@ -120,13 +120,14 @@ class QuestionnaireType extends AbstractType
             'label' => $question->label,
             'help' => $question->help,
             'required' => false,
-            'row_attr' => null === $question->showIf ? [] : [
+            // read by assets/controllers/questionnaire_controller.js
+            'row_attr' => ['data-question-key' => $question->key] + (null === $question->showIf ? [] : [
                 'data-show-if' => json_encode([
                     'question' => $question->showIf->question,
                     'operator' => $question->showIf->operator->value,
                     'value' => $question->showIf->value,
                 ], JSON_THROW_ON_ERROR),
-            ],
+            ]),
         ];
 
         return match ($question->type) {

src/Menu/TeamerMenuBuilder.php

@@ -134,6 +134,12 @@ class TeamerMenuBuilder extends AbstractMenuBuilder
             'linkAttributes' => [
                 'title' => 'Letzte Einsätze',
             ],
+            // the questionnaire after a past bus escort
+            'extras' => [
+                'routes' => [
+                    ['pattern' => '/^app_teamer_questionnaire_/'],
+                ],
+            ],
         ]);
 
         $menu->addChild('Dokumente', [