WebUntis: Browser-Header gegen HTTP 403, Klassenlehrer-Reports on-demand

Fehlzeiten-/Klassenbuch-Reports (reports.do, api/polling/REPORT) sowie
der JSON-RPC-Login schickten bisher keinen User-Agent, Referer oder die
übrigen Header, die WebUntis' eigene WebApp immer mitsendet - führte zu
HTTP 403. Header 1:1 aus einem echten Browser-Request übernommen und
zusätzliche Set-Cookie-Werte (z.B. Tenant-Id) aus der Login-Antwort
eingesammelt statt nur JSESSIONID/schoolname. Zusätzlich eine feste
kurze Pause zwischen Login und erstem Report-Request.

Die Klassenlehrer-Übersicht holt WebUntis-Daten jetzt nicht mehr eager
beim Navigieren oder bei jedem Sync-Ereignis, sondern nur noch über den
bestehenden "Aktualisieren"-Button - vermeidet spürbare Startlatenz und
unnötige WebUntis-Last. Eingehende Sync-Ereignisse (z.B. ein auf einem
anderen Gerät geschlossener Vorgang) bauen die Ansicht per
RefreshFromLocalDataOnly() weiterhin sofort neu auf, aber ausschließlich
aus den zuletzt geholten WebUntis-Daten plus aktuellen lokalen Daten -
ohne selbst je einen WebUntis-Request auszulösen.

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

LehrerApp.Desktop/ViewModels/ClassTeacher/ClassTeacherOverviewViewModel.cs

@@ -445,6 +445,13 @@ public partial class ClassTeacherOverviewViewModel : ObservableObject
     [ObservableProperty] private int _ownDocumentationFollowUpCount;
     [ObservableProperty] private int _ownDocumentationCriticalCount;
 
+    // Zuletzt per Load() geholte WebUntis-Rohdaten, für RefreshFromLocalDataOnly() - damit ein
+    // eingehendes Sync-Ereignis die Ansicht neu aufbauen kann, ohne selbst WebUntis anzufragen.
+    private IReadOnlyList<UntisStudentRosterCacheEntry>? _lastStudents;
+    private IReadOnlyList<UntisClassAbsenceEntryDto>? _lastAbsences;
+    private IReadOnlyList<UntisForeignClassRegisterEventDto>? _lastClassRegisterEvents;
+    private IReadOnlyList<CachedUntisHoliday>? _lastHolidays;
+
     public bool HomeroomClassConfigured => !string.IsNullOrWhiteSpace(HomeroomClassName);
     public bool HasPrimaryRoster => PrimaryRoster.Count > 0;
     public bool HasSecondaryRoster => SecondaryRoster.Count > 0;
@@ -526,13 +533,41 @@ public partial class ClassTeacherOverviewViewModel : ObservableObject
         ApplyRosterFilter();
     }
 
+    private void ResetRosterState()
+    {
+        ActiveTabIndex = 0;
+        Roster.Clear(); PrimaryRoster.Clear(); SecondaryRoster.Clear(); TrendDays.Clear(); PatternNotices.Clear();
+        OpenExcuses.Clear(); OpenExcuseOverflowCount = 0;
+    }
+
+    // Wird beim Navigieren auf diese Seite aufgerufen statt LoadCommand: baut nur den lokalen
+    // Grundzustand auf (keine WebUntis-Anfrage), damit Öffnen der Ansicht nicht auf einen
+    // WebUntis-Login+Report-Abruf wartet. Die eigentlichen Fehlzeiten/Klassenbuch-Daten holt sich
+    // die Nutzerin bewusst über den "Aktualisieren"-Button (LoadCommand).
+    public void PrepareForDisplay()
+    {
+        if (Busy) return;
+        HomeroomClassName = _settings.HomeroomClassName;
+        ResetRosterState();
+        if (!HomeroomClassConfigured)
+        {
+            Status = "Noch keine Klasse ausgewählt.";
+        }
+        else
+        {
+            DetailsTab.Initialize(HomeroomClassName!);
+            CasesTab.Initialize(HomeroomClassName!);
+            if (StudentCount == 0)
+                Status = "Noch nicht geladen – auf „Aktualisieren“ klicken, um aktuelle WebUntis-Daten zu holen.";
+        }
+        NotifyRosterState();
+    }
+
     [RelayCommand]
     private async Task Load()
     {
         HomeroomClassName = _settings.HomeroomClassName;
-        ActiveTabIndex = 0;
-        Roster.Clear(); PrimaryRoster.Clear(); SecondaryRoster.Clear(); TrendDays.Clear(); PatternNotices.Clear();
-        OpenExcuses.Clear(); OpenExcuseOverflowCount = 0;
+        ResetRosterState();
         if (!HomeroomClassConfigured)
         {
             Status = "Noch keine Klasse ausgewählt.";
@@ -547,14 +582,11 @@ public partial class ClassTeacherOverviewViewModel : ObservableObject
         NotifyRosterState();
         try
         {
-            var today = DateOnly.FromDateTime(DateTime.Today);
-            var sevenDayStart = today.AddDays(-6);
-            var trendDays = LastSchoolDays(today, 7);
             // Fehlzeiten seit Schuljahresbeginn statt nur der letzten 7 Tage: liefert die
             // Kennzahl unten (YearSummaryLabel) und den Nenner für die Fehlquote in einem Abruf.
             // UntisReportCacheService cached diesen "kalten" Bereich dauerhaft (siehe dort) —
             // teuer ist nur der erste Abruf pro Schuljahr, nicht jedes Öffnen der Ansicht.
-            var yearStart = _schoolYear.SchoolYearStart(_schoolYear.CurrentSchoolYear(today));
+            var (today, yearStart, sevenDayStart, trendDays) = RosterDateWindow();
             var studentsTask = _cache.GetStudentRosterAsync(className);
             var absencesTask = _cache.GetAbsencesAsync(className, yearStart, today);
             // Seit Schuljahresbeginn statt nur die letzte Woche (Nutzer-Feedback: Klassenbucheinträge
@@ -568,54 +600,93 @@ public partial class ClassTeacherOverviewViewModel : ObservableObject
             var holidaysTask = GetHolidaysAsync();
             await Task.WhenAll(studentsTask, absencesTask, classRegisterTask, holidaysTask);
 
-            var absenceDaysYear = ClassAbsenceDaySummaryRow.GroupByStudentAndDay(absencesTask.Result);
-            var todayAbsences = absenceDaysYear.Where(a => a.Date == today).ToList();
-            var termStart = EstimateTermStart(absenceDaysYear, yearStart);
-            var rawWeekdaysElapsed = CountSchoolWeekdays(termStart, today, []);
-            var schoolDaysElapsed = CountSchoolWeekdays(termStart, today, holidaysTask.Result);
-            var holidayWeekdaysExcluded = rawWeekdaysElapsed - schoolDaysElapsed;
-            var recentRegisterEntries = classRegisterTask.Result
-                .Where(e => TryDate(e.Date, out var d) && d >= sevenDayStart).ToList();
-            // Geschlossene Vorgänge je Klassen-Roster-Namen (für die bereichsbezogene Score-Dämpfung/
-            // Rückfall-Erkennung in Build) — gleicher Namensabgleich wie bei den übrigen Build*-Methoden
-            // dieser Klasse (z.B. BuildAttendanceParticipationNotices).
-            var localStudents = _students.GetAll();
-            var closedVorgaengeByNameKey = studentsTask.Result
-                .Select(r => (Roster: r, Student: MatchStudent(r.DisplayName, localStudents)))
-                .Where(x => x.Student is not null)
-                .ToDictionary(
-                    x => UntisNameMatching.NameKey(x.Roster.DisplayName),
-                    x => (IReadOnlyList<Vorgang>)_vorgaenge.GetByStudent(x.Student!.Id)
-                        .Where(v => v.Status == VorgangStatus.Closed).ToList());
-            foreach (var row in ClassTeacherRosterRow.Build(studentsTask.Result, todayAbsences,
-                         recentRegisterEntries, today, absenceDaysYear, schoolDaysElapsed,
-                         holidayWeekdaysExcluded, termStart, classRegisterTask.Result,
-                         _patternScoreSettings.Load(), closedVorgaengeByNameKey)) Roster.Add(row);
-
-            StudentCount = Roster.Count;
-            TodayAlertCount = Roster.Count(r => r.HasAbsenceToday);
-            TodayUnexcusedCount = Roster.Count(r => r.IsUnexcused);
-            LateCount = Roster.Count(r => r.IsLate);
-            PresentCount = Roster.Count(r => !r.HasAbsenceToday);
-            ExcusedAbsenceCount = Roster.Count(r => r.HasAbsenceToday && !r.IsLate && !r.IsUnexcused);
-            UnexcusedAbsenceCount = Roster.Count(r => r.HasAbsenceToday && !r.IsLate && r.IsUnexcused);
-            RecentClassRegisterCount = recentRegisterEntries.Count;
-            BuildTrend(absenceDaysYear, trendDays);
-            BuildPatternNotices(absenceDaysYear, sevenDayStart);
-            BuildWeekdayPatternNotices(absenceDaysYear);
-            BuildAttendanceParticipationNotices();
-            BuildVorgangRegressionNotices();
-            BuildOwnDocumentationCounts();
-            BuildOpenExcuses(absenceDaysYear, today);
+            _lastStudents = studentsTask.Result;
+            _lastAbsences = absencesTask.Result;
+            _lastClassRegisterEvents = classRegisterTask.Result;
+            _lastHolidays = holidaysTask.Result;
+            BuildRosterFromCachedData(studentsTask.Result, absencesTask.Result, classRegisterTask.Result,
+                holidaysTask.Result, today, yearStart, sevenDayStart, trendDays);
             LastUpdatedLabel = $"Zuletzt aktualisiert: Heute, {DateTime.Now:HH:mm}";
-            Status = $"{StudentCount} Schüler*innen · {TodayAlertCount} heute auffällig";
-            ApplyRosterFilter();
-            NotifySummary();
         }
         catch (WebUntisIntegrationException ex) { Status = ex.Message; NotifyRosterState(); }
         finally { Busy = false; NotifyRosterState(); }
     }
 
+    // Baut die Ansicht ausschließlich aus den zuletzt per Load() geholten WebUntis-Daten plus
+    // aktuellen lokalen Daten (Vorgänge/Dokumentation) neu auf - löst NIE einen WebUntis-Request
+    // aus, auch nicht über UntisReportCacheService' stündliches Hot-Window-Refresh. Wird bei
+    // eingehenden Sync-Ereignissen aufgerufen (siehe MainWindowViewModel.RefreshCurrentPage);
+    // echte WebUntis-Daten holt bewusst ausschließlich der "Aktualisieren"-Button (LoadCommand),
+    // wenn die Nutzerin sich dafür entscheidet.
+    public void RefreshFromLocalDataOnly()
+    {
+        if (Busy || _lastStudents is null || _lastAbsences is null ||
+            _lastClassRegisterEvents is null || _lastHolidays is null) return;
+        var (today, yearStart, sevenDayStart, trendDays) = RosterDateWindow();
+        ResetRosterState();
+        BuildRosterFromCachedData(_lastStudents, _lastAbsences, _lastClassRegisterEvents, _lastHolidays,
+            today, yearStart, sevenDayStart, trendDays);
+        NotifyRosterState();
+    }
+
+    private (DateOnly Today, DateOnly YearStart, DateOnly SevenDayStart, IReadOnlyList<DateOnly> TrendDays) RosterDateWindow()
+    {
+        var today = DateOnly.FromDateTime(DateTime.Today);
+        var yearStart = _schoolYear.SchoolYearStart(_schoolYear.CurrentSchoolYear(today));
+        return (today, yearStart, today.AddDays(-6), LastSchoolDays(today, 7));
+    }
+
+    private void BuildRosterFromCachedData(
+        IReadOnlyList<UntisStudentRosterCacheEntry> students,
+        IReadOnlyList<UntisClassAbsenceEntryDto> absences,
+        IReadOnlyList<UntisForeignClassRegisterEventDto> classRegisterEvents,
+        IReadOnlyList<CachedUntisHoliday> holidays,
+        DateOnly today, DateOnly yearStart, DateOnly sevenDayStart, IReadOnlyList<DateOnly> trendDays)
+    {
+        var absenceDaysYear = ClassAbsenceDaySummaryRow.GroupByStudentAndDay(absences);
+        var todayAbsences = absenceDaysYear.Where(a => a.Date == today).ToList();
+        var termStart = EstimateTermStart(absenceDaysYear, yearStart);
+        var rawWeekdaysElapsed = CountSchoolWeekdays(termStart, today, []);
+        var schoolDaysElapsed = CountSchoolWeekdays(termStart, today, holidays);
+        var holidayWeekdaysExcluded = rawWeekdaysElapsed - schoolDaysElapsed;
+        var recentRegisterEntries = classRegisterEvents
+            .Where(e => TryDate(e.Date, out var d) && d >= sevenDayStart).ToList();
+        // Geschlossene Vorgänge je Klassen-Roster-Namen (für die bereichsbezogene Score-Dämpfung/
+        // Rückfall-Erkennung in Build) — gleicher Namensabgleich wie bei den übrigen Build*-Methoden
+        // dieser Klasse (z.B. BuildAttendanceParticipationNotices).
+        var localStudents = _students.GetAll();
+        var closedVorgaengeByNameKey = students
+            .Select(r => (Roster: r, Student: MatchStudent(r.DisplayName, localStudents)))
+            .Where(x => x.Student is not null)
+            .ToDictionary(
+                x => UntisNameMatching.NameKey(x.Roster.DisplayName),
+                x => (IReadOnlyList<Vorgang>)_vorgaenge.GetByStudent(x.Student!.Id)
+                    .Where(v => v.Status == VorgangStatus.Closed).ToList());
+        foreach (var row in ClassTeacherRosterRow.Build(students, todayAbsences,
+                     recentRegisterEntries, today, absenceDaysYear, schoolDaysElapsed,
+                     holidayWeekdaysExcluded, termStart, classRegisterEvents,
+                     _patternScoreSettings.Load(), closedVorgaengeByNameKey)) Roster.Add(row);
+
+        StudentCount = Roster.Count;
+        TodayAlertCount = Roster.Count(r => r.HasAbsenceToday);
+        TodayUnexcusedCount = Roster.Count(r => r.IsUnexcused);
+        LateCount = Roster.Count(r => r.IsLate);
+        PresentCount = Roster.Count(r => !r.HasAbsenceToday);
+        ExcusedAbsenceCount = Roster.Count(r => r.HasAbsenceToday && !r.IsLate && !r.IsUnexcused);
+        UnexcusedAbsenceCount = Roster.Count(r => r.HasAbsenceToday && !r.IsLate && r.IsUnexcused);
+        RecentClassRegisterCount = recentRegisterEntries.Count;
+        BuildTrend(absenceDaysYear, trendDays);
+        BuildPatternNotices(absenceDaysYear, sevenDayStart);
+        BuildWeekdayPatternNotices(absenceDaysYear);
+        BuildAttendanceParticipationNotices();
+        BuildVorgangRegressionNotices();
+        BuildOwnDocumentationCounts();
+        BuildOpenExcuses(absenceDaysYear, today);
+        Status = $"{StudentCount} Schüler*innen · {TodayAlertCount} heute auffällig";
+        ApplyRosterFilter();
+        NotifySummary();
+    }
+
     [RelayCommand] private void ShowAlerts() => SelectedRosterFilter = 0;
     [RelayCommand] private void ShowClassRegister() => SelectedRosterFilter = 1;
     [RelayCommand] private void ShowAll() => SelectedRosterFilter = 2;

LehrerApp.Desktop/ViewModels/MainWindowViewModel.cs

@@ -90,7 +90,10 @@ public partial class MainWindowViewModel : ObservableObject
             case TimetableViewModel vm: vm.Load(); break;
             case WorkloadViewModel vm:
                 vm.Tasks.Load(); vm.TimeTracking.Load(); vm.Evaluation.Load(); break;
-            case ClassTeacherOverviewViewModel vm: vm.LoadCommand.Execute(null); break;
+            // RefreshFromLocalDataOnly() statt LoadCommand: baut die Ansicht aus den zuletzt
+            // geholten WebUntis-Daten + aktuellen lokalen Daten neu auf, löst aber selbst nie einen
+            // WebUntis-Request aus - den holt bewusst ausschließlich der "Aktualisieren"-Button.
+            case ClassTeacherOverviewViewModel vm: vm.RefreshFromLocalDataOnly(); break;
             case ExamsOverviewViewModel vm: vm.LoadCommand.Execute(null); break;
             case GroupDetailViewModel { Group: { } group } vm: vm.LoadGroup(group.Id); break;
             // Inline-Bearbeitung (IsEditing) nicht überschreiben - anders als die Gruppenansicht
@@ -176,7 +179,11 @@ public partial class MainWindowViewModel : ObservableObject
         var vm = _services.GetRequiredService<ClassTeacherOverviewViewModel>();
         vm.OnNavigateToSettings = () => { NavigateToSettings(SettingsTab.WebUntis); return Task.CompletedTask; };
         vm.OnNavigateToWorkload = () => { NavigateToWorkload(); return Task.CompletedTask; };
-        vm.LoadCommand.Execute(null);
+        // Kein automatischer WebUntis-Abruf beim Navigieren: PrepareForDisplay() baut nur den
+        // lokalen Grundzustand auf, die eigentlichen Report-Daten holt die Nutzerin bewusst über
+        // den "Aktualisieren"-Button (LoadCommand) - vermeidet WebUntis-Login+Report-Latenz beim
+        // bloßen Öffnen der Seite.
+        vm.PrepareForDisplay();
         return vm;
     }