Files
breakpilot-lehrer/docs-src/services/schulkalender/index.md
T
Benjamin Admin 77c720e2df
CI / go-lint (push) Has been skipped
CI / python-lint (push) Has been skipped
CI / nodejs-lint (push) Has been skipped
CI / test-go-school (push) Successful in 50s
CI / test-go-edu-search (push) Successful in 45s
CI / test-python-klausur (push) Failing after 3m50s
CI / test-python-agent-core (push) Successful in 36s
CI / test-nodejs-website (push) Successful in 49s
Document Stundenplan + Schulkalender end-of-session state
- CLAUDE.md gets a new section summarising the two feature strands,
  pitfalls (Timefold name, JSX quotes, LOC budget), the auth/messaging
  outsourcing, and pointers to the three memory files for next session.
- docs-src/services/schulkalender/ — 5 MkDocs pages mirroring the
  stundenplan structure: index, architecture, holidays, parent-flow,
  notifications. Each with DB tables, endpoints, and the dispatch
  payload contract for the colleague's Matrix/Email services.
- mkdocs.yml gains the Schulkalender nav entry under Services.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 18:41:31 +02:00

1.8 KiB

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 DB-Modell, Auth-Ablauf, Phase-Reihenfolge
Ferien-Snapshot OpenHolidaysAPI-Pipeline, jaehrliche Aktualisierung
Eltern-Workflow Magic-Link, Cookie-Session, i18n-Fachnamen
Notifications 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