feat: Untis-Hub für WebUntis-Sync-Gesundheitsstatus

Zeigt die Fälligkeit der vier bestehenden, manuell ausgelösten WebUntis-Abgleiche (Fehlzeiten je Lerngruppe, offene Stunden, Klassenbuch-, Hausaufgabenabgleich) in einem neuen Hub-Fenster, ohne selbst WebUntis anzufragen - nur gespeicherte Zeitstempel werden ausgewertet. Konsolidiert die bisher verstreuten Einstiegspunkte (Sidebar-Button, Dashboard-Buttons) in ein neues WebUntis-Menü plus einen kompakten Gesundheits-Indikator auf dem Dashboard. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-10 23:41:12 +02:00
parent bd0d7e47ea
commit ba52109eaa
20 changed files with 660 additions and 44 deletions
@@ -0,0 +1,88 @@
+using Avalonia.Controls;
+using CommunityToolkit.Mvvm.ComponentModel;
+using LehrerApp.Core.Interfaces;
+using LehrerApp.Core.Models;
+using LehrerApp.Core.Services;
+using LehrerApp.Desktop.ViewModels.Groups;
+using LehrerApp.Desktop.ViewModels.Students;
+using LehrerApp.Desktop.Views;
+using LehrerApp.Desktop.Views.Groups;
+using LehrerApp.Desktop.Views.Students;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace LehrerApp.Desktop.Services;
+
+/// <summary>Führt einen der vier bestehenden WebUntis-Abgleiche (unverändert, über ihre bestehenden
+/// Dialoge) aus und vermerkt das Ergebnis im <see cref="UntisHubService"/> - genutzt sowohl vom
+/// Untis-Hub-Dialog ("Jetzt prüfen" je Zeile) als auch von den WebUntis-Menüpunkten in
+/// <c>MainWindow</c>, damit beide Einstiegspunkte denselben Fälligkeitsstand pflegen.</summary>
+public static class UntisHubActions
+{
+    public static async Task RunFehlzeitenAsync(Window owner, LearningGroup group, UntisHubJobKind kind,
+        DateOnly start, DateOnly end, UntisHubService hub)
+    {
+        var vm = new WebUntisLessonAbsenceComparisonViewModel(group,
+            App.Services.GetRequiredService<WebUntisIntegrationService>(),
+            App.Services.GetRequiredService<IStudentRepository>(),
+            App.Services.GetRequiredService<IParticipationSessionRepository>(),
+            App.Services.GetRequiredService<IParticipationRepository>())
+        { StartDate = start.ToDateTime(TimeOnly.MinValue), EndDate = end.ToDateTime(TimeOnly.MinValue) };
+        var loaded = TrackLoad(vm, v => v.Busy);
+        await new WebUntisLessonAbsenceComparisonDialog { DataContext = vm }.ShowDialog(owner);
+        if (loaded()) hub.RecordRun(kind, group.Id, vm.Status);
+    }
+
+    public static async Task RunKlassenbuchAsync(Window owner, UntisHubService hub)
+    {
+        var vm = new WebUntisDocumentationComparisonViewModel(
+            App.Services.GetRequiredService<WebUntisIntegrationService>(),
+            App.Services.GetRequiredService<IStudentRepository>(),
+            App.Services.GetRequiredService<IGroupRepository>(),
+            App.Services.GetRequiredService<IDocumentationRepository>(),
+            App.Services.GetRequiredService<SchoolYearService>());
+        var loaded = TrackLoad(vm, v => v.Busy);
+        await new WebUntisDocumentationComparisonDialog { DataContext = vm }.ShowDialog(owner);
+        if (loaded()) hub.RecordRun(UntisHubJobKind.Klassenbuchabgleich, null, vm.Status);
+    }
+
+    public static async Task RunHausaufgabenAsync(Window owner, UntisHubService hub)
+    {
+        var vm = new WebUntisHomeworkComparisonViewModel(
+            App.Services.GetRequiredService<WebUntisIntegrationService>(),
+            App.Services.GetRequiredService<IStudentRepository>(),
+            App.Services.GetRequiredService<IGroupRepository>(),
+            App.Services.GetRequiredService<ISubjectRepository>(),
+            App.Services.GetRequiredService<IGroupMembershipRepository>(),
+            App.Services.GetRequiredService<IParticipationSessionRepository>(),
+            App.Services.GetRequiredService<IParticipationRepository>(),
+            App.Services.GetRequiredService<SchoolYearService>());
+        var loaded = TrackLoad(vm, v => v.Busy);
+        await new WebUntisHomeworkComparisonDialog { DataContext = vm }.ShowDialog(owner);
+        if (loaded()) hub.RecordRun(UntisHubJobKind.Hausaufgabenabgleich, null, vm.Status);
+    }
+
+    public static async Task RunOffenePeriodsAsync(Window owner, UntisHubService hub)
+    {
+        var dialog = new OpenUntisPeriodsDialog();
+        await dialog.ShowDialog(owner);
+        hub.RecordRun(UntisHubJobKind.OffenePeriods, null, dialog.LastStatus);
+    }
+
+    /// <summary>Erkennt nicht-invasiv (ohne die Vergleichs-ViewModels zu ändern), ob im Dialog
+    /// tatsächlich ein Ladeversuch stattfand: <c>Busy</c> wechselt in <c>Load()</c> immer erst auf
+    /// true und im <c>finally</c>-Block zurück auf false, egal ob erfolgreich oder mit Fehler
+    /// abgebrochen - genau dieser Übergang wird hier beobachtet.</summary>
+    private static Func<bool> TrackLoad<T>(T vm, Func<T, bool> isBusy) where T : ObservableObject
+    {
+        var loaded = false;
+        var wasBusy = false;
+        vm.PropertyChanged += (_, e) =>
+        {
+            if (e.PropertyName != "Busy") return;
+            var busy = isBusy(vm);
+            if (wasBusy && !busy) loaded = true;
+            wasBusy = busy;
+        };
+        return () => loaded;
+    }
+}