KI-Feature 4.5.21: didaktischer Hintergrund je Stunde, nur auf Nachfrage

Neuer Endpunkt ai-backend/explain.php mit eigenem statischen Systemprompt
(Begründung des Phasenaufbaus, mögliche Stolpersteine, Differenzierungsideen).
Bewusst als separater Endpunkt statt Zusatzfeld in jeder plan.php-Antwort,
damit die Erklärung nur bei tatsächlicher Nutzung abgerechnet wird statt bei
jeder Planungsanfrage mitgeneriert zu werden.

Die Guthaben-Abrechnung (SELECT-FOR-UPDATE, Transaktions-Insert) wurde aus
plan.php nach ai_backend_call_and_charge in db.php ausgelagert, damit sie
nicht an zwei Stellen gepflegt werden muss. Kein neues DB-Schema nötig.

Im AiAssistDialog erscheint je Stunde ein Button "Didaktischen Hintergrund
erklären", der nach dem Laden durch den Text ersetzt wird.

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

ai-backend/plan.php

@@ -2,8 +2,6 @@
 declare(strict_types=1);
 
 require_once __DIR__ . '/db.php';
-require_once __DIR__ . '/providers/AnthropicProvider.php';
-require_once __DIR__ . '/providers/FakeProvider.php';
 
 header('Content-Type: application/json');
 
@@ -152,70 +150,7 @@ deine Annahme kurz im "summary"-Feld.
 PROMPT;
 
 $userContent = json_encode($body);
-
-$useFake = getenv('AI_BACKEND_FAKE_PROVIDER') === '1'; // nur für lokale Smoke-Tests, siehe README.md
-if ($useFake) {
-    $provider = new FakeProvider();
-    $modelKey = 'fake';
-} else {
-    $providerName = $config['llm_provider'];
-    if ($providerName !== 'anthropic') {
-        ai_backend_fail(500, "Provider '$providerName' ist nicht implementiert.");
-    }
-    $modelKey = $config['anthropic']['model'];
-    $provider = new AnthropicProvider($config['anthropic']['api_key'], $modelKey);
-}
-
-try {
-    $result = $provider->sendMessage($systemPrompt, $userContent, $config['max_output_tokens']);
-} catch (RuntimeException $e) {
-    ai_backend_fail(502, $e->getMessage());
-}
-
-$defaultPricing = ['input' => 0, 'output' => 0, 'cache_write' => 0, 'cache_read' => 0];
-$pricing = $config['pricing'][$modelKey] ?? ($useFake ? $defaultPricing : null);
-if ($pricing === null) {
-    ai_backend_fail(500, "Kein Preis für Modell '$modelKey' konfiguriert.");
-}
-$pricing += $defaultPricing; // fehlende cache_write/cache_read in älteren config.php-Einträgen -> 0
-
-$cacheCreationTokens = $result['cacheCreationInputTokens'] ?? 0;
-$cacheReadTokens = $result['cacheReadInputTokens'] ?? 0;
-$cost = ($result['inputTokens'] / 1_000_000 * $pricing['input'])
-      + ($result['outputTokens'] / 1_000_000 * $pricing['output'])
-      + ($cacheCreationTokens / 1_000_000 * $pricing['cache_write'])
-      + ($cacheReadTokens / 1_000_000 * $pricing['cache_read']);
-
-// Guthaben abziehen und Transaktion protokollieren — mit Zeilensperre, damit zwei gleichzeitige
-// Anfragen desselben Nutzers das Guthaben nicht versehentlich unter 0 drücken können.
-$pdo->beginTransaction();
-try {
-    $stmt = $pdo->prepare('SELECT balance_usd FROM users WHERE id = ? FOR UPDATE');
-    $stmt->execute([$user['id']]);
-    $currentBalance = (float) $stmt->fetchColumn();
-
-    if ($currentBalance - $cost < 0) {
-        $pdo->rollBack();
-        ai_backend_fail(402, 'Guthaben würde durch diese Anfrage negativ werden.');
-    }
-
-    $newBalance = $currentBalance - $cost;
-    $pdo->prepare('UPDATE users SET balance_usd = ? WHERE id = ?')->execute([$newBalance, $user['id']]);
-    $pdo->prepare(
-        'INSERT INTO transactions
-             (user_id, type, model, input_tokens, output_tokens,
-              cache_creation_input_tokens, cache_read_input_tokens, cost_usd, balance_after)
-         VALUES (?, "usage", ?, ?, ?, ?, ?, ?, ?)'
-    )->execute([
-        $user['id'], $modelKey, $result['inputTokens'], $result['outputTokens'],
-        $cacheCreationTokens, $cacheReadTokens, $cost, $newBalance,
-    ]);
-
-    $pdo->commit();
-} catch (Throwable $e) {
-    $pdo->rollBack();
-    throw $e;
-}
+$result = ai_backend_call_and_charge($pdo, $config, $user, $systemPrompt, $userContent);
 
 // Erst NACH der Abrechnung validieren: die Token wurden real verbraucht, das wird auch dann
 // verrechnet, wenn die KI kein valides JSON geliefert hat (siehe Planungsdokument).