# Stundenplaner

Schulweiter Stundenplan-Generator fuer den Rektor. Erfasst Klassen, Lehrer,
Faecher, Raeume + Constraints und ruft einen Timefold-basierten Solver auf,
um einen konfliktfreien Wochenplan zu produzieren.

## Architektur auf einen Blick

```
studio-v2 /stundenplan  (Next.js)
        │  HTTP über Next.js Proxy /api/school/*
        ▼
school-service  (Go/Gin, :8084)
        │  ─ CRUD Stammdaten + Constraints + Solutions in PostgreSQL
        │  ─ Fire-and-forget Trigger an Solver
        ▼
timetable-solver-service  (Python/FastAPI + Timefold, :8095)
        │  ─ Liest Problem aus PG, rechnet im Worker-Thread
        │  ─ Schreibt Lessons direkt nach tt_lesson
        ▼
PostgreSQL  (Schema `public` in `breakpilot_db`)
        24 Tabellen: 7 Stammdaten + 15 Constraints + tt_solution + tt_lesson
```

## Module

| Bereich | Doku |
|---------|------|
| [Architektur + Datenmodell](architecture.md) | DB-Schema, Ownership-Modell |
| [Constraints](constraints.md) | 15 Constraint-Typen, hard/soft Semantik |
| [Solver-Tuning](solver-tuning.md) | Timefold-Konfiguration, Zeit-Budgets |
| [Export](export.md) | CSV, ICS, Drucken |

## Status

**Phasen 1-3 + 5-8 fertig** (Stand 2026-05-22, Phase 4 Untis übersprungen).

- 24 DB-Tabellen, alle 22 CRUD-Endpoints + Solve + Export-Endpoints live
- Frontend: 9 Tabs (Plan + 7 Stammdaten + Regeln), 15 Constraint-Editoren,
  Wochengrid mit Pin-Funktion, 3 Perspektiven (Klasse/Lehrer/Raum)
- Tests: 73 Go + 36 Playwright + 4 Export-Unit-Tests

## Offene Punkte

- Phase 4 (Untis-Import) — verschoben, kein Kunde fordert es aktuell
- Seed-Daten fuer Demo-Schule
- Echte Auth-Integration ablöst Dev-Bypass