feat: add booking time ranges and repeating series

src/Controller/DashboardController.php

@@ -6,6 +6,7 @@ namespace App\Controller;
 
 use App\Booking\BoardPresenter;
 use App\Booking\DateParam;
+use App\Booking\TimeRange;
 use App\Htmx\HxTrait;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 use Symfony\Component\HttpFoundation\Request;
@@ -13,7 +14,7 @@ use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;
 
 /**
- * The booking board: a month calendar next to the floor plan for the selected day.
+ * The booking board: a month calendar next to the floor plan for the selected day and span.
  */
 final class DashboardController extends AbstractController
 {
@@ -29,11 +30,12 @@ final class DashboardController extends AbstractController
     {
         $date = DateParam::parseOrToday($request->query->getString('tag'));
 
-        return $this->render('dashboard/index.html.twig', $this->board->context($date, $this->currentUser()));
+        return $this->render('dashboard/index.html.twig', $this->board->context($date, self::timeOf($request), $this->currentUser()));
     }
 
     /**
-     * Picking a day swaps the calendar and the floor plan in one response.
+     * Picking a day -- or narrowing the span -- swaps the calendar and the floor plan in one
+     * response.
      *
      * This is the whole reason htmxOobResponse exists: two regions, one round trip, no
      * client-side event choreography. Requests without the htmx header get a plain redirect
@@ -43,16 +45,27 @@ final class DashboardController extends AbstractController
     public function day(Request $request, string $date): Response
     {
         $selected = DateParam::parseOrToday($date);
+        $time = self::timeOf($request);
 
         if (!$request->headers->has('HX-Request')) {
-            return $this->redirectToRoute('app_dashboard', ['tag' => $selected->format('Y-m-d')]);
+            return $this->redirectToRoute('app_dashboard', BoardPresenter::urlParameters($selected, $time));
         }
 
         return $this->htmxOobResponse(
             'dashboard/index.html.twig',
             ['calendar', 'floorplan'],
-            $this->board->context($selected, $this->currentUser()),
-            $this->generateUrl('app_dashboard', ['tag' => $selected->format('Y-m-d')]),
+            $this->board->context($selected, $time, $this->currentUser()),
+            $this->generateUrl('app_dashboard', BoardPresenter::urlParameters($selected, $time)),
         );
     }
+
+    /**
+     * A malformed or missing span falls back to the whole day rather than erroring: these are
+     * hand-editable query parameters, not route requirements.
+     */
+    public static function timeOf(Request $request): TimeRange
+    {
+        return TimeRange::parse($request->query->getString('von'), $request->query->getString('bis'))
+            ?? TimeRange::wholeDay();
+    }
 }