Document Stundenplan + Schulkalender end-of-session state
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
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>
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
# 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 |
|
||||
Reference in New Issue
Block a user