KI-Feature 4.5.20: Medienvorschlag + Zwischenablage-Prompt für externe Erzeugung

Die KI liefert je Verlaufsplan-Phase optional einen kurzen Vorschlag, was ein
Medium/Material (z.B. Tafelbild) zeigen sollte (AiPhaseStep.MaterialSuggestion),
nur wenn das über das ohnehin genannte Material hinaus einen Mehrwert hätte.
Bewusst nicht ins Domänenmodell übernommen (keine Migration nötig) — nur für
die Review-Anzeige relevant.

AiPlanningService.BuildMaterialPrompt baut daraus rein lokal (kein weiterer
KI-Aufruf) einen vollständigen Prompt aus Fach/Stufe/Gruppe, Einheit, Stunde
und Phase. Im AiAssistDialog landet er per Klick in der Zwischenablage, zum
Einfügen in eine separate Claude-Sitzung für die eigentliche Materialerzeugung.

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

LehrerApp.Core/AiPlanning/AiPlanningDtos.cs

@@ -82,6 +82,12 @@ public class AiPhaseStep
     // Name statt Guid: LLMs erfinden/verändern Guids unzuverlässig, ein Name ist beim Import
     // gegen den Katalog abgleichbar (kein Treffer -> null = Hauptweg, kein Fehler).
     public string? AlternativePathName { get; set; }
+    // Kurzer Vorschlag für ein konkretes Medium/Material zu dieser Phase (z.B. Tafelbild,
+    // Arbeitsblatt), nur gesetzt, wenn eines wirklich sinnvoll wäre — nicht bei jeder Phase.
+    // Wird NICHT in Lesson.Phases übernommen (nur für die Review-Anzeige/Prompt-Erzeugung
+    // relevant, siehe AiPlanningService.BuildMaterialPrompt), daher kein Feld auf
+    // LessonPhaseStep nötig.
+    public string? MaterialSuggestion { get; set; }
 }
 
 public class AiPlanningResponse

LehrerApp.Desktop.Tests/AiPlanningServiceTests.cs

@@ -205,6 +205,50 @@ public sealed class AiPlanningServiceTests
         Assert.Contains(service.DescribeChanges(existing, proposed), d => d.Contains("Verlaufsplan"));
     }
 
+    [Fact]
+    public void BuildMaterialPrompt_EnthaeltKontextUndVorschlag()
+    {
+        var subject = new Subject { Name = "Chemie" };
+        var group = new LearningGroup { Name = "9c", SubjectId = subject.Id, GradeLevel = 9 };
+        var unit = new Unit { GroupId = group.Id, Title = "Redoxreaktionen" };
+        var lesson = new AiLesson { Topic = "Elektrolyse", Date = new DateOnly(2026, 3, 17), Phases = [] };
+        var phase = new AiPhaseStep
+        {
+            Name = "Erarbeitung", DurationMinutes = 20, Activity = "Experiment auswerten",
+            Material = "AB003", MaterialSuggestion = "Tafelbild mit dem Aufbau der Elektrolysezelle.",
+        };
+
+        var service = Build(new FakeLessons(), new FakeGroups([group]), new FakeSubjects([subject]),
+            new FakeCompetencyDomains(), new FakeAlternativeLessonPaths([]));
+
+        var prompt = service.BuildMaterialPrompt(unit, lesson, phase);
+
+        Assert.Contains("Chemie", prompt);
+        Assert.Contains("9c", prompt);
+        Assert.Contains("Redoxreaktionen", prompt);
+        Assert.Contains("Elektrolyse", prompt);
+        Assert.Contains("Erarbeitung", prompt);
+        Assert.Contains("AB003", prompt);
+        Assert.Contains("Tafelbild mit dem Aufbau der Elektrolysezelle.", prompt);
+    }
+
+    [Fact]
+    public void BuildMaterialPrompt_OhneBisherigesMaterial_LaesstZeileWeg()
+    {
+        var group = new LearningGroup();
+        var unit = new Unit { GroupId = group.Id, Title = "T" };
+        var lesson = new AiLesson { Topic = "Stunde", Phases = [] };
+        var phase = new AiPhaseStep { Name = "Einstieg", MaterialSuggestion = "Kurzer Impuls per Bild." };
+
+        var service = Build(new FakeLessons(), new FakeGroups([group]), new FakeSubjects([]),
+            new FakeCompetencyDomains(), new FakeAlternativeLessonPaths([]));
+
+        var prompt = service.BuildMaterialPrompt(unit, lesson, phase);
+
+        Assert.DoesNotContain("Bisheriges Material", prompt);
+        Assert.Contains("Kurzer Impuls per Bild.", prompt);
+    }
+
     [Fact]
     public void ApplyResponse_BekannteId_WirdAlsUpdateBehandelt()
     {

LehrerApp.Desktop/Services/AiPlanningService.cs

@@ -249,6 +249,39 @@ public class AiPlanningService(HttpClient http, ILessonRepository lessons,
         return diffs;
     }
 
+    /// <summary>
+    /// Baut aus Einheit/Stunde/Phase und dem KI-Medienvorschlag (<see cref="AiPhaseStep.MaterialSuggestion"/>)
+    /// einen vollständigen, eigenständigen Prompt zum Einfügen in eine separate Claude-Sitzung —
+    /// die Lehrkraft kann sich das eigentliche Material (Tafelbild, Arbeitsblatt, ...) dort selbst
+    /// erzeugen lassen, ohne dass das über das eigene (kostenpflichtige) KI-Backend laufen muss.
+    /// Nur der kurze Vorschlagstext kommt von der KI, der restliche Kontext wird rein lokal aus
+    /// bereits vorhandenen Daten zusammengesetzt. Rein, ohne I/O.
+    /// </summary>
+    public string BuildMaterialPrompt(Unit unit, AiLesson lesson, AiPhaseStep phase)
+    {
+        var group = groups.GetById(unit.GroupId);
+        var subject = group?.SubjectId is { } subjectId ? subjects.GetById(subjectId) : null;
+        var dateText = lesson.Date?.ToString("dd.MM.yyyy", CultureInfo.InvariantCulture) ?? "noch offen";
+
+        var lines = new List<string>
+        {
+            $"Ich unterrichte {subject?.Name ?? "unbekanntes Fach"}, Klassenstufe {group?.GradeLevel ?? 0}, Gruppe {group?.Name ?? "-"}.",
+            $"Einheit: „{unit.Title}“",
+            $"Stunde: „{lesson.Topic}“ (Datum: {dateText})",
+            $"Phase: „{phase.Name}“, {phase.DurationMinutes} Min., Tätigkeit: {phase.Activity}",
+        };
+        if (!string.IsNullOrWhiteSpace(phase.Material))
+            lines.Add($"Bisheriges Material laut Planung: {phase.Material}");
+        lines.Add("");
+        lines.Add("Empfehlung aus der Unterrichtsplanung, was das Material zeigen/enthalten sollte:");
+        lines.Add(phase.MaterialSuggestion ?? "");
+        lines.Add("");
+        lines.Add("Bitte erstelle mir auf dieser Grundlage ein passendes Material für diese Phase " +
+                   "(z.B. Tafelbild, Arbeitsblatt oder Visualisierung).");
+
+        return string.Join("\n", lines);
+    }
+
     /// <summary>
     /// Ersetzt in <paramref name="saved"/> (dem tatsächlichen Datenbankstand) jede Lesson, deren Id
     /// auch in <paramref name="draft"/> vorkommt, durch die Entwurfsversion, und hängt Entwürfe ohne

LehrerApp.Desktop/ViewModels/Groups/PlanningViewModels.cs

@@ -1085,6 +1085,11 @@ public partial class GenerateLessonSeriesDialogViewModel : ObservableObject
 
 // ── Dialog: KI-gestützte Planungsunterstützung (4.5.9) ───────────────────────
 
+/// Ein kopierbarer Prompt für ein von der KI vorgeschlagenes Material/Medium zu einer Phase (siehe
+/// AiPlanningService.BuildMaterialPrompt) — gedacht zum Einfügen in eine separate Claude-Sitzung,
+/// nicht über das eigene KI-Backend erzeugt.
+public record MaterialPromptItem(string PhaseName, string SuggestionText, string PromptText);
+
 /// Eine von der KI vorgeschlagene Stunde in der Prüfliste des Dialogs — angehakt = wird beim
 /// "Übernehmen" mit übertragen. <see cref="AiLesson.Id"/> unterscheidet neu/geändert (siehe
 /// AiPlanningDtos.cs), <see cref="IsNew"/> steuert hier nur die Anzeige ("Neu"/"Geändert").
@@ -1098,15 +1103,21 @@ public partial class AiLessonReviewItem : ObservableObject
     /// Aufzählung fürs UI — leer bei neuen Vorschlägen, da es dort nichts zu vergleichen gibt.
     public string DiffText { get; }
 
+    /// Medienvorschläge je Phase dieser Lesson (nur Phasen mit gesetztem
+    /// AiPhaseStep.MaterialSuggestion) — leer, wenn die KI für keine Phase einen Vorschlag hatte.
+    public IReadOnlyList<MaterialPromptItem> MaterialPrompts { get; }
+
     [ObservableProperty] private bool _accepted = true;
 
-    public AiLessonReviewItem(AiLesson source, bool isNew, List<string>? fieldDiffs = null)
+    public AiLessonReviewItem(AiLesson source, bool isNew, List<string>? fieldDiffs = null,
+        List<MaterialPromptItem>? materialPrompts = null)
     {
         Source = source;
         IsNew = isNew;
         var dateText = source.Date?.ToString("dd.MM.yyyy", CultureInfo.InvariantCulture) ?? "kein Datum";
         DisplayLabel = isNew ? $"Neu: {source.Topic} ({dateText})" : $"Geändert: {source.Topic} ({dateText})";
         DiffText = fieldDiffs is { Count: > 0 } ? string.Join("\n", fieldDiffs.Select(d => "• " + d)) : "";
+        MaterialPrompts = materialPrompts ?? [];
     }
 }
 
@@ -1168,7 +1179,11 @@ public partial class AiAssistDialogViewModel : ObservableObject
                 // dem Nutzer eine Auswahl zu zeigen, die ApplyResponse ohnehin verwerfen würde.
                 if (isExisting && !AllowModifyingExisting) continue;
                 var fieldDiffs = isExisting ? _aiPlanning.DescribeChanges(existingLessons[l.Id!.Value], l) : null;
-                ReviewItems.Add(new AiLessonReviewItem(l, isNew: !isExisting, fieldDiffs));
+                var materialPrompts = l.Phases
+                    .Where(p => !string.IsNullOrWhiteSpace(p.MaterialSuggestion))
+                    .Select(p => new MaterialPromptItem(p.Name, p.MaterialSuggestion!, _aiPlanning.BuildMaterialPrompt(_unit, l, p)))
+                    .ToList();
+                ReviewItems.Add(new AiLessonReviewItem(l, isNew: !isExisting, fieldDiffs, materialPrompts));
             }
             Summary = response.Summary;
             HasResults = true;

LehrerApp.Desktop/Views/Groups/AiAssistDialog.axaml

@@ -25,6 +25,19 @@
                   <TextBlock Text="{Binding DiffText}" FontSize="11" Opacity="0.6" TextWrapping="Wrap"
                              Margin="24,0,0,0"
                              IsVisible="{Binding DiffText, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/>
+                  <ItemsControl ItemsSource="{Binding MaterialPrompts}" Margin="24,2,0,0">
+                    <ItemsControl.ItemTemplate>
+                      <DataTemplate x:DataType="vm:MaterialPromptItem">
+                        <Border Background="#14000000" CornerRadius="4" Padding="6" Margin="0,2">
+                          <StackPanel Spacing="4">
+                            <TextBlock Text="{Binding SuggestionText}" FontSize="11" TextWrapping="Wrap"/>
+                            <Button Content="📋 Prompt kopieren (extern erzeugen)" FontSize="11"
+                                    Click="OnCopyMaterialPrompt"/>
+                          </StackPanel>
+                        </Border>
+                      </DataTemplate>
+                    </ItemsControl.ItemTemplate>
+                  </ItemsControl>
                 </StackPanel>
               </DataTemplate>
             </ItemsControl.ItemTemplate>

LehrerApp.Desktop/Views/Groups/AiAssistDialog.axaml.cs

@@ -1,6 +1,9 @@
 using Avalonia.Controls;
+using Avalonia.Input.Platform;
 using Avalonia.Interactivity;
+using LehrerApp.Desktop.Services;
 using LehrerApp.Desktop.ViewModels.Groups;
+using Microsoft.Extensions.DependencyInjection;
 
 namespace LehrerApp.Desktop.Views.Groups;
 
@@ -8,6 +11,16 @@ public partial class AiAssistDialog : Window
 {
     public AiAssistDialog() => InitializeComponent();
 
+    private async void OnCopyMaterialPrompt(object? s, RoutedEventArgs e)
+    {
+        if (s is not Button { DataContext: MaterialPromptItem item }) return;
+        var clipboard = TopLevel.GetTopLevel(this)?.Clipboard;
+        if (clipboard is null) return;
+
+        await clipboard.SetTextAsync(item.PromptText);
+        App.Services.GetRequiredService<NotificationService>().ShowSuccess("Prompt in die Zwischenablage kopiert.");
+    }
+
     private async void OnSend(object? s, RoutedEventArgs e)
     {
         if (DataContext is AiAssistDialogViewModel vm && vm.SendCommand.CanExecute(null))

TODO.md

@@ -806,6 +806,32 @@ folgenden Punkte gehören direkt in `LehrerApp.Desktop`:
       durch eine übernommene KI-Antwort überschreiben, falls sich die Einheit seit dem Absenden
       der Anfrage schon geändert hat (aktuell nicht erkannt/abgesichert). Größerer Umbau als
       4.5.14 (Teil-Merge-UI je Phase, Änderungszeitpunkt-Vergleich) — deshalb zurückgestellt.
+- [x] **4.5.20** Material-/Medienvorschlag mit Zwischenablage-Prompt für externe Erzeugung
+      (Nutzer-Feedback nach erstem echten Einsatz: eine KI-Stunde ist "nicht die eigene Idee",
+      Material/Medien wie Tafelbilder sollen die KI zumindest vorschlagen können, ohne dass die
+      eigentliche Erzeugung über das eigene, kostenpflichtige Backend laufen muss).
+      **Umsetzung:** `AiPhaseStep` bekommt ein neues optionales Feld `MaterialSuggestion` (kurzer,
+      konkreter Vorschlag, was ein Medium zu dieser Phase zeigen/enthalten sollte, z.B. Aufbau
+      eines Tafelbilds) — der Systemprompt in `plan.php` weist die KI an, das nur zu füllen, wenn
+      ein Medium über das ohnehin genannte `material`/`shorthand` hinaus wirklich einen Mehrwert
+      hätte. Bewusst **kein** neues Feld auf dem Domänenmodell `LessonPhaseStep`: der Vorschlag ist
+      nur für die Review-Anzeige/Prompt-Erzeugung relevant, keine Migration nötig, geht beim
+      "Übernehmen" bewusst nicht in die gespeicherte Lesson ein (siehe 4.5.21 für dauerhaftes
+      Speichern als mögliche spätere Erweiterung). `AiPlanningService.BuildMaterialPrompt` baut
+      daraus rein lokal (kein weiterer KI-Aufruf) einen vollständigen, eigenständigen Prompt aus
+      Fach/Stufe/Gruppe, Einheit, Stunde und Phase plus dem KI-Vorschlag; im `AiAssistDialog`
+      erscheint dieser als Kasten unter der jeweiligen Stunde mit Button "📋 Prompt kopieren
+      (extern erzeugen)" (Avalonia-`IClipboard`, erste Zwischenablage-Nutzung in der App), den die
+      Lehrkraft in eine eigene Claude-Sitzung einfügt. Kein neuer Server-Roundtrip: nur ein kurzer
+      zusätzlicher Textabschnitt je Phase in der ohnehin laufenden Planungsantwort.
+- [ ] **4.5.21** (Zurückgestellt, Nutzer-Idee neben 4.5.20) "Schattenfeld" mit didaktischem
+      Hintergrund/Begründung je KI-Stunde bzw. -Phase, einklappbar/auf Nachfrage sichtbar — bei
+      einer KI-generierten Stunde fehlt anders als bei einer selbst geschriebenen das eigene
+      Vorwissen zum "Warum", das für einen sicheren Unterrichtseinsatz hilft. Zwei Bauweisen
+      abzuwägen: immer mitgeneriert (höhere Kosten bei jeder Anfrage, auch wenn ungenutzt) vs. nur
+      auf Klick nachgeladen (wiederverwendet den Nachfassen-Mechanismus aus 4.5.17, kostet nur bei
+      tatsächlicher Nutzung) — Letzteres passt besser zum bestehenden Guthabenmodell. Noch nicht
+      entschieden/umgesetzt.
 
 ---
 

ai-backend/plan.php

@@ -106,6 +106,13 @@ Das Feld "allowModifyingExistingLessons" in der Eingabe legt fest, was du vorsch
   "AB" Arbeitsblatt) — kein Fließtext.
 - "durationMinutes" je Phase sollte in Summe zur für die Stunde realistischen Zeit passen
   (i.d.R. rund 45 Minuten je Einzelstunde, abzüglich organisatorischer Zeit).
+- "materialSuggestion" je Phase (nur in deiner Antwort, nicht in der Eingabe): ein kurzer Vorschlag
+  (1-2 Sätze), WAS ein zu dieser Phase passendes Medium/Material konkret zeigen oder enthalten
+  sollte (z.B. Aufbau eines Tafelbilds, Inhalt eines Arbeitsblatts) — nicht nur "ein Tafelbild
+  wäre hilfreich", sondern was darauf stehen sollte. Nur setzen, wenn ein Medium über das bereits
+  in "material"/"shorthand" Genannte hinaus wirklich einen Mehrwert hätte, sonst weglassen (null).
+  Die Lehrkraft erzeugt das Medium separat selbst mit diesem Vorschlag als Grundlage — plane hier
+  keine Umsetzungsdetails wie Layout oder Werkzeug.
 
 ## Antwortformat
 
@@ -125,7 +132,8 @@ Antworte AUSSCHLIESSLICH mit gültigem JSON (kein Freitext davor/danach) in gena
           "activity": "<Tätigkeit>",
           "material": "<Material>",
           "shorthand": "<Kurzsymbol>",
-          "alternativePathName": "<Name aus dem übergebenen Katalog oder null für den Hauptweg>"
+          "alternativePathName": "<Name aus dem übergebenen Katalog oder null für den Hauptweg>",
+          "materialSuggestion": "<konkreter Medienvorschlag oder null, siehe oben>"
         }
       ],
       "homework": "<Hausaufgabe oder null>",