Display-Seiten: Gäste holen sich den Zugang selbst

Für Empfang, Lobby oder Tagungsraum lässt sich je Site eine öffentliche
Seite anlegen (kiosk.php), die auf einem Bildschirm oder Tablet läuft:
ein großer Knopf, ein Klick, ein Zugangscode mit QR-Code. Nach einer
einstellbaren Anzeigedauer springt der Bildschirm zurück, damit der
nächste Gast nicht den Code seines Vorgängers sieht.

Verwaltung unter Administration → Display-Seiten:
- Site und optionales Voucher-Profil (bestimmt Laufzeit, Geräte, QoS)
- eigene Überschrift und Text für den Bildschirm
- Codes pro Tag, Wartezeit zwischen zwei Codes, Anzeigedauer
- geheimer Link zum Kopieren, als QR-Code anzeigbar und jederzeit
  erneuerbar (der alte Link gilt dann sofort nicht mehr)

Absicherung: der Link ist der Zugang, deshalb Tageslimit und Wartezeit
je Display, CSRF-Token am Formular, `noindex` im Kopf und ein Eintrag im
Audit-Log für jeden ausgegebenen Code. Webhooks werden für Kiosk-Codes
bewusst nicht ausgelöst – ein Empfangsdisplay würde den Kanal fluten.

Technik:
- neue Tabelle `kiosks`, `vouchers.kiosk_id` hält die Herkunft fest
  (Migration 0005, database.sql nachgezogen)
- includes/Kiosk.php kapselt Token, Limits und Profil-Auflösung
- includes/VoucherService.php bündelt die Voucher-Erstellung, die vorher
  in index.php lag und für den Kiosk ein zweites Mal nötig gewesen wäre
- Startbildschirm zeigt zusätzlich einen QR auf sich selbst, damit Gäste
  die Seite am eigenen Handy öffnen können

Tests: 9 neue Fälle für Token-Prüfung, Wartezeit, Tageslimit und
Profil-Auflösung (38 Tests gesamt), PHPStan deckt Kiosk.php mit ab.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

includes/VoucherService.php

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Erstellt Voucher im UniFi-Controller und schreibt sie in die Datenbank.
+ *
+ * Bis hierher lag diese Logik doppelt in index.php und der REST-API; mit der
+ * Kiosk-Seite waere sie ein drittes Mal noetig gewesen.
+ */
+require_once __DIR__ . '/UniFiController.php';
+require_once __DIR__ . '/Crypto.php';
+
+class VoucherService
+{
+    /**
+     * @param array      $site   Zeile aus `sites`
+     * @param array      $qos    ['down' => kbit, 'up' => kbit, 'quota_mb' => MB]
+     * @param int|null   $userId angemeldeter Benutzer, sonst null
+     * @param int|null   $kioskId Herkunft, falls ueber eine Display-Seite geholt
+     *
+     * @return array{code:string,site_name:string,max_uses:int,expire_min:int,expiry_date:string,expiry_time:string}
+     * @throws Exception wenn der Controller keinen gueltigen Voucher liefert
+     */
+    public static function create(
+        $db,
+        array $site,
+        string $voucherName,
+        int $maxUses,
+        int $expireMinutes,
+        ?int $userId = null,
+        array $qos = [],
+        ?int $kioskId = null
+    ): array {
+        $fullName = date('Y-m-d') . '_' . $voucherName;
+
+        $controller = new UniFiController(
+            $site['unifi_controller_url'],
+            $site['unifi_username'],
+            Crypto::decrypt($site['unifi_password']),
+            $site['site_id']
+        );
+
+        $voucher = $controller->createVoucher($fullName, $maxUses, $expireMinutes, $qos);
+        if (!is_array($voucher) || empty($voucher['formatted_code'])) {
+            throw new Exception(function_exists('__') ? __('error_voucher_invalid') : 'Ungueltige Antwort des Controllers');
+        }
+
+        $db->execute(
+            "INSERT INTO vouchers (site_id, user_id, kiosk_id, voucher_code, voucher_name, max_uses, expire_minutes, unifi_voucher_id)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
+            [$site['id'], $userId, $kioskId, $voucher['code'], $fullName, $maxUses, $expireMinutes, $voucher['unifi_id'] ?? null]
+        );
+
+        $expiryTs = time() + ($expireMinutes * 60);
+
+        return [
+            'code'        => $voucher['formatted_code'],
+            'site_name'   => $site['name'],
+            'max_uses'    => $maxUses,
+            'expire_min'  => $expireMinutes,
+            'expiry_date' => date('d.m.Y', $expiryTs),
+            'expiry_time' => date('H:i', $expiryTs),
+        ];
+    }
+}