Stundenplan: Wochenraster, Wochennavigation, Ferien/Feiertage (Kapitel 4.3)

Neuer Stundenplan mit "Heute"-Standardansicht (Tagesliste unten angedockt,
gruppenübergreifendes Wochenraster mit Fach/Klasse/Raum/Thema, Vor-/Zurück-
Navigation zwischen Kalenderwochen) und separatem Bearbeiten-Raster für die
wöchentliche Zuordnung. Badges für Ferien-/Klausur-Nähe und ausgegraute
Ferientage direkt im Plan statt einer separaten Liste. Ferien-/Feiertage-
Pflege (Bundesland, Schulferien) sitzt jetzt in den Einstellungen statt im
Stundenplan selbst.

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

TODO.md

@@ -224,10 +224,10 @@ zusammenziehen, daraus die Halbjahresnote bilden":
 ## 4. Unterrichtsplanung
 
 Modelle `Unit` und `Lesson` existieren, `UnitRepository`/`LessonRepository` ebenfalls.
-Navigationspunkt "Unterrichtsplanung" ist weiterhin ein `PlaceholderViewModel`
-([MainWindowViewModel.cs](LehrerApp.Desktop/ViewModels/MainWindowViewModel.cs)) — er bleibt
-bewusst Platzhalter, bis die gruppenübergreifende Kalenderübersicht aus 4.4 steht. 4.1/4.2 leben
-stattdessen im gruppenspezifischen Tab "Planung" (`GroupDetailView`), siehe unten.
+Navigationspunkt "Unterrichtsplanung" zeigt seit 4.3 den Stundenplan (`TimetableView`,
+Standardtab "Heute" + Bearbeiten-Raster) statt eines `PlaceholderViewModel`. Eine
+gruppenübergreifende Wochenansicht fehlt noch, siehe 4.4. 4.1/4.2 leben unabhängig davon im
+gruppenspezifischen Tab "Planung" (`GroupDetailView`), siehe unten.
 
 ### 4.1 Unterrichtseinheiten (`Unit`)
 - [x] **4.1.1** Listenansicht der Einheiten je Gruppe mit Status und Zeitraum
@@ -366,16 +366,146 @@ Redesign:
   Hauptweg — deutlich einfacher und für den schnellen Überblick ausreichend.
 
 ### 4.3 Stundenplan
-- [ ] **4.3.1** Neues Modell `TimetableSlot` (Gruppe, Wochentag, Stunde, Raum) + Repository.
-- [ ] **4.3.2** Wochenstundenplan-Ansicht als Raster mit Farbcodierung je Gruppe.
-- [ ] **4.3.3** Bearbeitung per Klick/Drag im Raster.
-- [ ] **4.3.4** Abgleich mit `LearningGroup.HoursPerWeek` (Warnung bei Abweichung).
-- [ ] **4.3.5** Schulferien und Feiertage hinterlegen (Bundesland wählbar) und aus der Planung ausnehmen.
+- [x] **4.3.1** Neues Modell `TimetableSlot` (Gruppe, Wochentag, Stunde, Raum) + Repository —
+      [Planning.cs](LehrerApp.Core/Models/Planning.cs),
+      [TimetableSlotRepository](LehrerApp.Data/Repositories/AllRepositories.cs). Wiederkehrendes
+      Muster (kein Datum) — für konkret gehaltene Stunden bleibt `Lesson` (4.2) zuständig. Pro
+      Wochentag/Stunde höchstens eine Gruppe (eindeutiger Index + freundliche Fehlermeldung im
+      Repository selbst, nicht erst über eine rohe `LiteException`): ein Lehrer kann nicht
+      gleichzeitig an zwei Orten unterrichten.
+- [x] **4.3.2** Wochenstundenplan-Ansicht als Raster mit Farbcodierung je Gruppe — neuer
+      Navigationspunkt "Unterrichtsplanung" (bisher `PlaceholderViewModel`) zeigt jetzt
+      [TimetableView.axaml](LehrerApp.Desktop/Views/Planning/TimetableView.axaml). Mo–Fr ×
+      1.–10. Stunde, Farbe deterministisch aus dem Gruppennamen (gleiches Hash-in-Palette-Muster
+      wie bei den alternativen Unterrichtsabläufen in 4.2.2).
+- [x] **4.3.3** Bearbeitung per Klick im Raster — Klick auf eine leere Zelle öffnet
+      `TimetableSlotDialog` zum Zuweisen (Gruppenauswahl + optionaler Raum), Klick auf eine
+      belegte Zelle öffnet denselben Dialog zum Ändern/Entfernen. **Drag bewusst nicht
+      umgesetzt:** Klick deckt die vollständige Bearbeitung (Zuweisen/Ändern/Entfernen) bereits
+      ab: Drag wäre nur eine schnellere Geste für "Zuordnung an eine andere Zelle verschieben",
+      kein zusätzlicher Funktionsumfang — bei Bedarf später ergänzbar.
+- [x] **4.3.4** Abgleich mit `LearningGroup.HoursPerWeek` — Seitenleiste "Abweichende
+      Wochenstunden" listet jede Gruppe der aktuellen Schuljahres, deren eingetragene
+      Slot-Anzahl nicht der hinterlegten Wochenstundenzahl entspricht.
+- [x] **4.3.5** Schulferien und Feiertage — gesetzliche Feiertage werden je Bundesland berechnet
+      ([PublicHolidayService.cs](LehrerApp.Core/Services/PublicHolidayService.cs), Gauß'sche
+      Osterformel + bundeslandspezifische Zusatzfeiertage, empirisch gegen bekannte
+      Ostersonntage 2023–2027 verifiziert) statt gespeichert — anders als Schulferien sind sie
+      algorithmisch herleitbar. Schulferien selbst sind **nicht** herleitbar (jährlich neu von
+      den Bundesländern festgelegt) und werden deshalb manuell gepflegt
+      (`SchoolHoliday`-Repository, CRUD in der Seitenleiste). Bundesland als persistente
+      Einstellung ([SchoolCalendarSettingsService.cs](LehrerApp.Core/Services/SchoolCalendarSettingsService.cs)).
+      "Aus der Planung ausnehmen" ist für dieses Kapitel als "nächste unterrichtsfreie Tage"
+      sichtbar (kombinierte, sortierte Liste aus beiden Quellen) — die eigentliche Ausnahme aus
+      generierten Stunden ist erst mit der (bewusst zurückgestellten) Serienerzeugung 4.2.5
+      relevant und verwendet dieselben zwei Datenquellen.
+
+**Nachtrag zu 4.3 (Nutzer-Feedback nach Erstumsetzung):**
+- **Ferien/Feiertage-Pflege verschoben:** Die Bundesland-Auswahl und das Schulferien-CRUD standen
+  ursprünglich in der Seitenleiste des Stundenplans selbst — das wirkte dort deplatziert, da es
+  eine einmalige Einstellung statt einer täglich genutzten Ansicht ist. Beides ist jetzt ein
+  eigener Tab "Ferien & Feiertage" in den Einstellungen
+  ([SettingsViewModel.cs](LehrerApp.Desktop/ViewModels/Settings/SettingsViewModel.cs),
+  [SettingsView.axaml](LehrerApp.Desktop/Views/Settings/SettingsView.axaml)). Der Stundenplan
+  selbst zeigt Bundesland und nächste unterrichtsfreie Tage nur noch lesend an
+  ([TimetableViewModel.cs](LehrerApp.Desktop/ViewModels/Planning/TimetableViewModel.cs)).
+- **Badge "1"/"2" vor Ferien:** Die letzte bzw. vorletzte Stunde eines Wochentags vor den nächsten
+  Schulferien wird im Bearbeiten-Raster mit einem kleinen Badge markiert — Erinnerung, rechtzeitig
+  abzuschließen. Berechnet pro (Wochentag, Gruppe) statt pro einzelnem `TimetableSlot`: eine
+  Doppelstunde besteht aus zwei Slots mit demselben Wochentag/derselben Gruppe und bekommt dadurch
+  automatisch dasselbe Badge, ohne gesonderte Blockerkennung. Gesetzliche Feiertage werden beim
+  Abzählen der verbleibenden Termine übersprungen. Bewusst nur an `SchoolHoliday` geknüpft, nicht
+  an einzelne `PublicHoliday`-Tage — es geht um das Vorbereiten auf eine längere Unterbrechung,
+  nicht um einen einzelnen freien Tag.
+- **"Heute" als neue Standardansicht:** Der Stundenplan öffnet jetzt auf einem
+  nicht-editierenden Tab "Heute" (heutige Stunden mit Gruppe, Raum, Thema aus `Lesson.Topic` falls
+  vorhanden, sowie ein Hinweis, wenn an dem Tag eine Klausur ansteht). Klick auf eine Stunde
+  navigiert in die Lerngruppe (Tab "Planung"). Das bisherige Bearbeiten-Raster aus 4.3.2/4.3.3
+  ist über einen Button ("Stundenplan bearbeiten") als zweiter Tab weiterhin erreichbar.
+
+**Nachtrag zu 4.3, zweite Iteration (Wochenraster in der "Heute"-Ansicht):** Die Tagesliste allein
+beantwortete nicht "was steht in der Woche noch an" bzw. "was macht der parallele Kurs" — beides
+Fragen, die nur ein Blick über alle Gruppen hinweg beantwortet. Der Tab "Heute" zeigt deshalb jetzt
+zusätzlich ein schreibgeschütztes Wochenraster (Mo–Fr × 1.–10. Stunde, wie das Bearbeiten-Raster,
+aber ohne Klick-zum-Bearbeiten). Jede Kachel zeigt Fach (`Subject.ShortName`), Klasse, Raum und
+– falls für den Tag hinterlegt – das Thema der Stunde, dazu Symbole für: Ferien-Badge ("1"/"2",
+wie im Bearbeiten-Raster), Klausur an dem Tag (📝), letzte Stunde vor der nächsten Klausur dieser
+Gruppe (⏰) und ein geplantes Experiment (🧪). Die Tagesliste ist per `DockPanel` unten an die
+Seite angedockt, das Wochenraster füllt den verbleibenden Platz darüber
+([TimetableViewModel.cs](LehrerApp.Desktop/ViewModels/Planning/TimetableViewModel.cs),
+[TimetableView.axaml](LehrerApp.Desktop/Views/Planning/TimetableView.axaml)). Klick auf eine
+Kachel navigiert wie in der Tagesliste zur Lerngruppe.
+  - **"Letzte Stunde vor Klausur"** wird wie das Ferien-Badge pro (Wochentag, Gruppe) berechnet,
+    aber am nächsten `Exam.Date` der jeweiligen Gruppe statt an einem gemeinsamen Ferientermin
+    ausgerichtet — beide Badges teilen sich denselben Zähl-Helfer (`CountOccurrences`).
+  - **"Experiment geplant"** hat kein eigenes Datenfeld — es ist eine Texterkennung über die
+    bereits im Verlaufsplan-Editor (4.2.2) gepflegten `LessonPhaseStep`-Felder (Name/Aktivität/
+    Material enthält "Experiment", ohne Groß-/Kleinschreibung). Bewusst kein neues Modellfeld:
+    die Information steckt in den meisten Fällen schon in der ohnehin gepflegten Phasenplanung.
+  - Das Wochenraster zeigt bewusst nur die laufende Kalenderwoche ohne Vor-/Zurück-Navigation —
+    für einen Blick auf zukünftige Wochen bleibt vorerst das Bearbeiten-Raster (zeigt das
+    wiederkehrende Muster unabhängig vom Datum).
+
+**Nachtrag zu 4.3, dritte Iteration (Ferientage im Wochenraster ausgegraut statt eigener Liste):**
+Die Box "Nächste unterrichtsfreie Tage" wirkte neben dem neuen Wochenraster redundant — welche
+Tage frei sind, sieht man dort jetzt direkt an den betroffenen Stunden. Die Box (samt
+`UpcomingFreeDayItem`, `UpcomingFreeDays`, `BuildUpcomingFreeDays`, `BundeslandLabel`) wurde
+entfernt. Stattdessen werden Wochenkacheln, deren Datum in Schulferien fällt oder ein gesetzlicher
+Feiertag ist, grau eingefärbt (`WeekCellItem.IsHoliday`, Prüfung gegen `SchoolHoliday`-Zeitraum und
+die bereits für die Badges berechneten `PublicHoliday`-Daten) und zeigen statt der Klausur-/
+Experiment-Symbole nur noch die Aufschrift "Ferien" — die Symbole wären an einem unterrichtsfreien
+Tag ohnehin nicht sinnvoll interpretierbar.
+
+**Nachtrag zu 4.3, vierte Iteration (Wochennavigation):** Schalter "‹"/"›" plus "Diese Woche"
+erlauben jetzt, im Wochenraster vor und zurück zu blättern (`TimetableViewModel.WeekOffset`,
+`PreviousWeekCommand`/`NextWeekCommand`/`CurrentWeekCommand`). Die Ferien-/Klausur-Nähe-Badges
+("1"/"2" vor Ferien, ⏰ vor Klausur) waren bis dahin an "heute" verankert und pro (Wochentag,
+Gruppe) einmalig berechnet — das wäre beim Blättern falsch geworden (ein Badge hätte in jeder
+angezeigten Woche geklebt, nicht nur in der einen Woche, zu der es gehört). Für das Wochenraster
+berechnen `HolidayBadgeFor`/`IsLastBeforeExamFor` die Badges deshalb jetzt je Zelle am dort
+gezeigten Datum statt an "heute" — das Bearbeiten-Raster (zeigt ohnehin nur das wiederkehrende
+Muster ohne Datum) behält die alte, "heute"-verankerte Berechnung. Beim erneuten Navigieren in den
+Stundenplan (Sidebar-Klick) springt die Ansicht wieder auf die laufende Woche zurück.
 
 ### 4.4 Wochen-/Tagesansicht
-- [ ] **4.4.1** Kalenderansicht über alle Gruppen: Woche und Tag.
-- [ ] **4.4.2** Sprung von einer Stunde direkt in die Mitarbeitserfassung dieser Gruppe.
-- [ ] **4.4.3** Anzeige anstehender Klausurtermine und Abgabefristen im Kalender.
+- [x] **4.4.1** Kalenderansicht über alle Gruppen: Woche und Tag — siehe Nachtrag zu 4.3
+      ("Heute"-Tab: Tagesliste unten angedockt, gruppenübergreifendes Wochenraster darüber, inkl.
+      Vor-/Zurück-Navigation zwischen Kalenderwochen seit der vierten Iteration).
+      **Nicht enthalten:** ein eigenständiger Kalendermonat-Überblick — bei Bedarf später
+      ergänzbar.
+- [x] **4.4.2** Sprung von einer Stunde direkt in die Lerngruppe — siehe Nachtrag zu 4.3
+      ("Heute"-Tab, Klick navigiert zur Planung der Gruppe statt direkt in die
+      Mitarbeitserfassung, da das für den Vorbereitungs-Kontext des Tages passender ist).
+- [ ] **4.4.3** Anzeige anstehender Klausurtermine und Abgabefristen im Kalender. *(Heutige
+      Klausuren bereits im "Heute"-Tab sichtbar — mehrtägiger Vorausblick fehlt noch.)*
+
+### 4.5 Vernetzung Stundenplan ↔ Unterrichtsplanung (zurückgestellt)
+
+Nutzer-Feedback nach der 4.3-Iterationen: Stundenplan (4.3, wiederkehrendes Muster) und
+Unterrichtsplanung (4.1/4.2, `Unit`/`Lesson` je Gruppe) laufen bisher zu getrennt nebeneinander.
+Ausdrücklich als Idee für später festgehalten, **nicht** jetzt umsetzen:
+
+- [ ] **4.5.1** Terminvorschlag beim Anlegen einer `Lesson`: Tag/Stunde anhand des Stundenplans
+      vorschlagen, an dem die betroffene Gruppe laut `TimetableSlot` tatsächlich Unterricht hat,
+      statt Datum/Stunde komplett frei einzutragen.
+- [ ] **4.5.2** Vom Stundenplan (Wochenraster oder Bearbeiten-Raster) direkt in einen
+      "Viewer" der zugehörigen `Lesson` springen können — und von dort auch eine neue `Lesson`
+      anlegen können. **Offene Frage, vor Umsetzung zu klären:** `Lesson` hängt an einer
+      übergeordneten `Unit` (4.1) — beim Anlegen direkt aus dem Stundenplan heraus ist unklar,
+      welcher `Unit` die neue Lesson zugeordnet werden soll (aktuellste offene Einheit der Gruppe?
+      Rückfrage an die Lehrkraft?). Muss überdacht werden, bevor das gebaut wird.
+- [ ] **4.5.3** Aus diesem Lesson-Viewer heraus weiter verzweigen können: in die Zeugnisnote/
+      Bewertung der Gruppe, und in die Schnelldialoge für Mitarbeit sowie Anwesenheit/Hausaufgaben.
+- [ ] **4.5.4** Badges am Stundenplan/Lesson-Viewer, die anzeigen, ob eine Stunde bereits
+      "kontrolliert" ist — u.a. ob in der vorherigen Stunde Hausaufgaben erteilt wurden und ob
+      diese noch nicht kontrolliert sind. Muss sich pro Fall abschalten lassen: manchmal wird eine
+      Hausaufgabe bewusst nicht kontrolliert, ohne dass bis Schuljahresende ständig daran erinnert
+      werden soll.
+- [ ] **4.5.5** Stunden aus dieser Ansicht heraus verschieben können, wenn kurzfristig etwas
+      dazwischenkommt.
+- [ ] **4.5.6** Bei Doppelstunden (90-Minuten-Planung laut Verlaufsplan, 4.2.2) den Inhalt
+      sinnvoll auf die beiden Kacheln/Perioden aufteilen, damit z.B. gezielt nur die zweite Stunde
+      eines Blocks verschoben werden kann, ohne den ganzen Block anzufassen.
 
 ---
 
@@ -892,8 +1022,12 @@ Die Abschnitte sind thematisch, nicht chronologisch nummeriert. Sinnvolle Bearbe
    erledigt (13.1–13.4 vollständig; 13.4.2 bewusst zurückgestellt, siehe dort).
 5. ~~**Kapitel 5** (Schülerdokumentation)~~ — erledigt (5.2 als Auswertung des bestehenden
    Anwesenheits-Trackings statt zweiter Erfassung, siehe dort).
-6. ~~**Kapitel 4.1 + 4.2** (Unterrichtsplanung: Einheiten & Einzelstunden)~~ — erledigt.
-   **Kapitel 4.3** (Stundenplan, neues Modell `TimetableSlot` + Ferien/Feiertage) und **4.4**
-   (Wochen-/Tageskalender über alle Gruppen) bewusst zurückgestellt — eigenständige neue
-   Subsysteme, kein Ausbau der bestehenden Unit/Lesson-UI. **→ nächster sinnvoller Schritt.**
+6. ~~**Kapitel 4.1 + 4.2 + 4.3** (Unterrichtsplanung: Einheiten, Einzelstunden, Stundenplan)~~ —
+   erledigt, inkl. mehrerer Nachtrag-Iterationen aus Nutzer-Feedback (Ferien-Pflege in den
+   Einstellungen, Wochenraster mit Wochennavigation, Ferientage ausgegraut). ~~**Kapitel 4.4.1/
+   4.4.2**~~ — erledigt (im Zuge der 4.3-Nachträge miterledigt). Offen bleiben **4.4.3**
+   (Abgabefristen im Kalender), **4.2.5** (Serienerzeugung von Stunden aus dem Stundenplan) und
+   **4.5** (engere Vernetzung Stundenplan ↔ Lesson-Planung — ausdrücklich vom Nutzer
+   zurückgestellt, nicht aus Unklarheit).
+   **→ nächster sinnvoller Schritt: 4.4.3 oder 4.2.5, je nach Bedarf.**
 7. **Kapitel 6** (Arbeitszeit), **11** (Export), **10** (Sync) — danach.