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>
2026-08-16 22:32:36 +02:00
parent f703fe7b66
commit 364df378f0
11 changed files with 333 additions and 79 deletions
@@ -0,0 +1,52 @@
+using LehrerApp.Core.AiPlanning;
+using LehrerApp.Desktop.Services;
+using LehrerApp.Desktop.ViewModels.Groups;
+using Xunit;
+
+namespace LehrerApp.Desktop.Tests;
+
+/// Tests für das "Schattenfeld" (4.5.21): didaktischer Hintergrund zu einer KI-Stunde, nur auf
+/// Klick nachgeladen. Die eigentliche HTTP-Abfrage (AiPlanningService.RequestExplanationAsync)
+/// wird hier per Delegate ersetzt, da RequestExplanationCommand rein davon abhängt.
+public sealed class AiLessonReviewItemTests
+{
+    private static AiLesson Lesson() => new() { Topic = "Elektrolyse", Phases = [] };
+
+    [Fact]
+    public async Task RequestExplanation_SetztText_UndVerbirgtButtonDanach()
+    {
+        var item = new AiLessonReviewItem(Lesson(), isNew: true,
+            requestExplanation: _ => Task.FromResult("Didaktischer Hintergrund..."));
+
+        Assert.True(item.ShowExplanationButton);
+
+        await item.RequestExplanationCommand.ExecuteAsync(null);
+
+        Assert.Equal("Didaktischer Hintergrund...", item.Explanation);
+        Assert.False(item.ShowExplanationButton);
+        Assert.False(item.IsLoadingExplanation);
+        Assert.Equal("", item.ExplanationError);
+    }
+
+    [Fact]
+    public async Task RequestExplanation_BeiFehler_SetztExplanationErrorUndBehaeltButton()
+    {
+        var item = new AiLessonReviewItem(Lesson(), isNew: true,
+            requestExplanation: _ => throw new AiBackendException("Nicht genügend KI-Guthaben."));
+
+        await item.RequestExplanationCommand.ExecuteAsync(null);
+
+        Assert.Equal("Nicht genügend KI-Guthaben.", item.ExplanationError);
+        Assert.Equal("", item.Explanation);
+        Assert.True(item.ShowExplanationButton);
+    }
+
+    [Fact]
+    public void OhneAbfragefunktion_WirdKeinButtonAngeboten()
+    {
+        var item = new AiLessonReviewItem(Lesson(), isNew: true);
+
+        Assert.False(item.CanRequestExplanation);
+        Assert.False(item.ShowExplanationButton);
+    }
+}