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
- 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>
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# 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 |
|