# Schulkalender

Bundeslandweit kalibrierter Schulkalender mit Ferien, Feiertagen, Schul-
Events, Eltern-Sicht und mehrsprachigen Benachrichtigungen.

## Auf einen Blick

```
studio-v2 /schulkalender   →  Lehrer-Sicht (CRUD Events, Eltern einladen, Rollover)
studio-v2 /eltern          →  Eltern-Sicht (Wochengrid des Kindes in eigener Sprache)
        │
        │ HTTP /api/school/* und /api/parent/* (zwei separate Auth-Gruppen)
        ▼
school-service (Go, :8084)
        ├── cal_public_event       — Ferien/Feiertage-Snapshot (OpenHolidaysAPI)
        ├── cal_school_config      — Bundesland pro Rektor
        ├── cal_school_event       — Schulfeier, Fortbildung, Klassenfahrt etc.
        ├── parent_account/_child/_magic_link/_session  — Eltern-Auth
        └── notification_log       — Idempotenter Versand-Log
        │
        ▼ POST DispatchPayload
Matrix-Bridge + Email-Gateway (vom Kollegen gepflegt, nicht in diesem Repo)
```

## Module

| Bereich | Doku |
|---------|------|
| [Architektur](architecture.md) | DB-Modell, Auth-Ablauf, Phase-Reihenfolge |
| [Ferien-Snapshot](holidays.md) | OpenHolidaysAPI-Pipeline, jaehrliche Aktualisierung |
| [Eltern-Workflow](parent-flow.md) | Magic-Link, Cookie-Session, i18n-Fachnamen |
| [Notifications](notifications.md) | Cron, Templates, Dispatcher-Vertrag |

## Phasen-Stand

**Alle vier Phasen abgeschlossen (2026-05-22):**

- 9a — Bundesland-Wizard + Monatsansicht
- 9b — Schul-Events + Schuljahres-Rollover
- 9c — Parent-Accounts + Magic-Link + Wochengrid in 8 Sprachen
- 9d — Notification-Cron + Templates + Status-Badges

**Offen:** Vollschuljahr-ICS, Seed-Daten fuer Demo-Schule.

## Test-Status

| Suite | Tests |
|------|-------|
| Go (services + notifications) | 89 / 89 |
| Playwright Schulkalender | 16 / 16 |
| Playwright Eltern | 7 / 7 |