using LehrerApp.Core.Models; namespace LehrerApp.Core.Services; public sealed class UntisDiffResult { /// SubstitutionEntry-Kandidaten (Id ist immer neu vergeben — der Aufrufer entscheidet über /// ISubstitutionEntryRepository.GetByExternalId, ob ein vorhandener Eintrag aktualisiert /// statt dupliziert werden muss; siehe UntisSyncService). public List SubstitutionsToSave { get; init; } = []; public List SnapshotToSave { get; init; } = []; /// Verschwundene, bereits als Ausfall verarbeitete Zeilen — werden aus dem Snapshot entfernt, /// damit derselbe Ausfall nicht bei jedem weiteren Poll erneut erkannt wird. public List SnapshotIdsToDelete { get; init; } = []; } /// /// Stufe 2 des WebUntis-Abgleichs: ein neuer iCal-Abruf gegen den zuletzt gespeicherten /// Schnappschuss (Nutzer-Feedback: "Abgleich mit einem lokalen Backup, um Änderungen zu finden"). /// Framework-frei wie — nimmt nur einfache Objekte/Listen /// entgegen, kein Datenbankzugriff. /// public class UntisDiffService { public const int DefaultLookaheadDays = 14; public UntisDiffResult Diff(List newEvents, List previousSnapshot, List confirmedMappings, DateOnly today, int lookaheadDays = DefaultLookaheadDays, List? existingSupervisionDuties = null, HashSet? freeDates = null) { var previousByUid = previousSnapshot.ToDictionary(s => s.Uid); // GroupBy statt direktem ToDictionary: robust gegen mehrere Mappings für denselben Slot // (z.B. Altdaten vor einem Bugfix) - die zuletzt angelegte gewinnt, statt mit einer // ArgumentException abzubrechen und dadurch den gesamten Poll (Timer-Callback) zu killen. var mappingByWeekdayStart = confirmedMappings .Where(m => m.Confirmed && (m.Kind == SubstitutionKind.Lesson ? m.PeriodNumber is not null : m.AfterPeriod is not null)) .GroupBy(m => (m.Weekday, m.StartTime)) .ToDictionary(g => g.Key, g => g.OrderByDescending(m => m.CreatedAt).First()); // Regelmäßige, ohnehin schon jede Woche im Stundenplan sichtbare Aufsichten (siehe // SupervisionDuty/Einstellungen "Aufsichten") - eine bestätigte Supervision-Zuordnung, die // KEINER davon entspricht, ist per Definition eine zusätzliche/Vertretungsaufsicht und soll // deshalb selbst als reguläres Vorkommnis (nicht erst bei Abweichung) im Plan auftauchen. var regularDutyKeys = (existingSupervisionDuties ?? []) .Select(d => (d.Weekday, d.AfterPeriod)) .ToHashSet(); var substitutions = new List(); var snapshotToSave = new List(); var newEventsByUid = newEvents.ToDictionary(e => e.Uid); foreach (var evt in newEvents) { snapshotToSave.Add(new UntisSnapshotEntry { Id = previousByUid.TryGetValue(evt.Uid, out var existing) ? existing.Id : Guid.NewGuid(), Uid = evt.Uid, Date = evt.Date, StartTime = evt.StartTime, EndTime = evt.EndTime, Summary = evt.Summary, Location = evt.Location, Description = evt.Description, Status = evt.Status, LastSeenAt = DateTime.UtcNow, }); if (!mappingByWeekdayStart.TryGetValue((evt.Weekday, evt.StartTime), out var mapping)) continue; if (string.Equals(evt.Status, "CANCELLED", StringComparison.OrdinalIgnoreCase)) { substitutions.Add(mapping.Kind == SubstitutionKind.Lesson ? BuildCancelledLesson(evt.Date, mapping, evt.Uid) : BuildSupervisionNote(evt.Date, mapping, evt.Uid, "Laut WebUntis abgesagt.")); continue; } if (mapping.Kind == SubstitutionKind.Lesson) { if (HasDeviated(evt, mapping)) substitutions.Add(BuildChangedLesson(evt, mapping)); } else if (!regularDutyKeys.Contains((mapping.Weekday, mapping.AfterPeriod!.Value))) { // Nutzer-Feedback: "Auch die Extra-Aufsicht ist dann nicht im Plan [...] So macht // doch der Sync nur so halb Sinn" - ohne passende reguläre Aufsicht IST dieses // Vorkommnis selbst schon die meldenswerte Vertretung, nicht erst eine Abweichung // davon. substitutions.Add(BuildSupervisionNote(evt.Date, mapping, evt.Uid, "Zusätzliche Aufsicht laut WebUntis.")); } } // Aufsichten: weiterhin rein reaktiv gegen den letzten Snapshot (kein fester wöchentlicher // Anspruch, siehe "Zusätzliche Aufsicht" oben - ein Verschwinden ist nur meldenswert, wenn // die Aufsicht vorher tatsächlich einmal gesehen wurde). var snapshotIdsToDelete = new List(); foreach (var previous in previousSnapshot) { if (newEventsByUid.ContainsKey(previous.Uid)) continue; if (previous.Date < today || previous.Date > today.AddDays(lookaheadDays)) continue; if (!mappingByWeekdayStart.TryGetValue((previous.Date.DayOfWeek, previous.StartTime), out var mapping)) continue; if (mapping.Kind != SubstitutionKind.Supervision) continue; var vanishedId = BuildVanishedExternalId(previous.Date, mapping); substitutions.Add(BuildSupervisionNote(previous.Date, mapping, vanishedId, "Laut WebUntis entfallen oder übernommen.")); snapshotIdsToDelete.Add(previous.Id); } // Unterrichtsstunden: zusätzlich AKTIV prüfen, ob für jedes vom Feed bereits abgedeckte // künftige Datum dieses Wochentags ein passender Termin existiert - rein reaktives // Schnappschuss-Diffing (oben) erkennt nur Termine, die zwischen zwei Abrufen // VERSCHWINDEN, nicht solche, die schon beim allerersten Abruf nie im Feed auftauchten // (Nutzer-Feedback: "Am 27.08. fällt eine Stunde NAT in der 8c aus. Dieser Ausfall steht // nicht im Plan [...] die Klasse ist dort weg, der Unterricht wird definitiv nicht // stattfinden" - WebUntis hatte diesen Ausfall von Anfang an nie als Termin gelistet, es // gab also nie einen Schnappschuss-Eintrag, der hätte "verschwinden" können). Begrenzt auf // das vom Feed tatsächlich abgedeckte Zeitfenster (jüngstes gesehenes Datum), damit nicht // Tage jenseits des vom Feed veröffentlichten Horizonts fälschlich als Ausfall gelten, und // um Ferien/Feiertage bereinigt (freeDates), an denen WebUntis ohnehin keinen Termin führt. if (newEvents.Count > 0) { var maxKnownDate = newEvents.Max(e => e.Date); var horizonEnd = maxKnownDate < today.AddDays(lookaheadDays) ? maxKnownDate : today.AddDays(lookaheadDays); var eventDates = newEvents.Select(e => (e.Date, e.StartTime)).ToHashSet(); var freeDateSet = freeDates ?? []; foreach (var mapping in mappingByWeekdayStart.Values.Where(m => m.Kind == SubstitutionKind.Lesson)) { for (var date = today; date <= horizonEnd; date = date.AddDays(1)) { if (date.DayOfWeek != mapping.Weekday) continue; if (freeDateSet.Contains(date)) continue; if (eventDates.Contains((date, mapping.StartTime))) continue; substitutions.Add(BuildCancelledLesson(date, mapping, BuildMissingExternalId(date, mapping))); } } } return new UntisDiffResult { SubstitutionsToSave = substitutions, SnapshotToSave = snapshotToSave, SnapshotIdsToDelete = snapshotIdsToDelete, }; } // Nutzer-Feedback: "Ich habe das aufgelöst und den Mathematik E-Kurs ausgewählt [...] Diese // manuelle Verknüpfung ist aber jetzt scheinbar vergessen" — Ursache: ClassToken wird beim // Bestätigen kompakt ohne Leerzeichen gespeichert ("10a;10b;10c"), WebUntis trennt die // Klassen in DESCRIPTION aber mit "; " (Semikolon + Leerzeichen), z.B. "10a; 10b; 10c; // Gastro HED" — ein reiner Teilstring-Vergleich schlug für JEDE kombinierte/differenzierte // Gruppe (mehr als ein Klassen-Token) strukturell fehl, unabhängig von der tatsächlich // gewählten Gruppe. Fix: beide Seiten vor dem Vergleich von Leerzeichen befreien (gleiches // Prinzip wie UntisMatchingService.Normalize für den Gruppennamen-Abgleich). private static bool HasDeviated(UntisIcsEvent evt, UntisSlotMapping mapping) => evt.Summary != mapping.Summary || !RemoveWhitespace(evt.Description).Contains(mapping.ClassToken); private static string RemoveWhitespace(string value) => new(value.Where(c => !char.IsWhiteSpace(c)).ToArray()); private static SubstitutionEntry BuildCancelledLesson(DateOnly date, UntisSlotMapping mapping, string externalId) => new() { Date = date, Kind = SubstitutionKind.Cancelled, PeriodNumber = mapping.PeriodNumber, Description = "Automatisch über WebUntis-Abgleich erkannt.", ExternalId = externalId, }; private static SubstitutionEntry BuildChangedLesson(UntisIcsEvent evt, UntisSlotMapping mapping) => new() { Date = evt.Date, Kind = SubstitutionKind.Lesson, PeriodNumber = mapping.PeriodNumber, GroupId = mapping.GroupId, GroupLabel = mapping.ClassToken, Description = $"WebUntis: {evt.Summary ?? "?"} · {evt.Location} (regulär: {mapping.Summary ?? "?"})", ExternalId = evt.Uid, }; // Aufsichten haben keinen TimetableSlot im Hintergrund (siehe SubstitutionEntry.Kind-Doc) - // deshalb Kind=Supervision statt Cancelled, auch wenn der Termin verschwunden ist. private static SubstitutionEntry BuildSupervisionNote(DateOnly date, UntisSlotMapping mapping, string externalId, string reason) => new() { Date = date, Kind = SubstitutionKind.Supervision, AfterPeriod = mapping.AfterPeriod, Description = $"Automatisch über WebUntis-Abgleich erkannt: {reason}", ExternalId = externalId, }; // Ein verschwundener Termin hat keine eigene UID mehr im neuen Fetch - ein aus Slot+Datum // abgeleiteter Ersatzschlüssel dient weiter als Idempotenz-Schlüssel für spätere Polls. private static string BuildVanishedExternalId(DateOnly date, UntisSlotMapping mapping) => $"vanished-{mapping.Id}-{date:yyyyMMdd}"; // Für eine von Anfang an fehlende Stunde gibt es nie eine echte iCal-UID - ein aus // Slot+Datum abgeleiteter Schlüssel macht wiederholte Polls trotzdem idempotent (Update // statt Duplikat), unabhängig vom Snapshot-Stand. private static string BuildMissingExternalId(DateOnly date, UntisSlotMapping mapping) => $"missing-{mapping.Id}-{date:yyyyMMdd}"; }