KI-gestützte Planungsunterstützung (4.5.9) + Kompetenzkatalog-Import (8.1.2)

KI-Unterstützung: neuer Einstellungen-Tab (Anmeldung, Guthaben) und Button im
Planungs-Tab, der Einheiten+Stunden als JSON an ein neues PHP-Backend (ai-backend/)
sendet und die Antwort als prüfbare Vorschlagsliste zurückbringt. Provider-Aufruf,
Guthabenverwaltung und Abrechnung nach echten Token-Kosten laufen serverseitig, der
Desktop-Client sieht nie einen LLM-API-Key. Zentral abgesichert: eine von der KI
zurückgegebene Stunden-Id, die zu keiner echten Lesson der Einheit passt, wird nie
als Update übernommen, sondern immer als neue Stunde behandelt.

Kompetenzkatalog-Import (8.1.2): JSON-Export/Import für Kompetenzkataloge.

ai-backend/db.php

@@ -0,0 +1,50 @@
+<?php
+declare(strict_types=1);
+
+/** Baut eine PDO-Verbindung aus config.php auf. */
+function ai_backend_db(array $config): PDO
+{
+    $db = $config['db'];
+    $dsn = "mysql:host={$db['host']};dbname={$db['name']};charset=utf8mb4";
+    return new PDO($dsn, $db['user'], $db['pass'], [
+        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
+        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
+        PDO::ATTR_EMULATE_PREPARES   => false,
+    ]);
+}
+
+/**
+ * Bearer-Token aus dem Authorization-Header lesen, gegen tokens.token_hash prüfen
+ * (SHA-256, der Klartext wird nie gespeichert) und den zugehörigen aktiven User zurückgeben.
+ * Sendet bei fehlendem/ungültigem/abgelaufenem Token selbst eine 401-Antwort und beendet das Skript.
+ */
+function ai_backend_authenticate(PDO $pdo): array
+{
+    $header = $_SERVER['HTTP_AUTHORIZATION'] ?? '';
+    if (!preg_match('/^Bearer\s+(.+)$/i', $header, $m)) {
+        ai_backend_fail(401, 'Kein gültiges Token übermittelt.');
+    }
+    $tokenHash = hash('sha256', $m[1]);
+
+    $stmt = $pdo->prepare(
+        'SELECT u.* FROM users u
+         JOIN tokens t ON t.user_id = u.id
+         WHERE t.token_hash = ? AND t.expires_at > NOW() AND u.is_active = 1
+         LIMIT 1'
+    );
+    $stmt->execute([$tokenHash]);
+    $user = $stmt->fetch();
+    if (!$user) {
+        ai_backend_fail(401, 'Ungültiges oder abgelaufenes Token.');
+    }
+    return $user;
+}
+
+/** Einheitliche Fehlerantwort als JSON, beendet danach das Skript. */
+function ai_backend_fail(int $httpStatus, string $message): never
+{
+    http_response_code($httpStatus);
+    header('Content-Type: application/json');
+    echo json_encode(['error' => $message]);
+    exit;
+}