lehrr Dokumentation

planr

Planungswerkzeug für den eigenen Unterricht - Jahresplanung, Stundenplanung und Rückmeldung an einer Stelle.

Lehrkräfte Für Lehrkräfte Was planr ist, die vier Grundsätze, die Planungsebenen, alle Funktionen, die Kopplungen, Datenschutz und häufige Fragen. Entwickler Für Entwickler Tech-Stack, lokales Setup, Projektstruktur, Datenmodell, API-Referenz, MCP-Server, Deployment und Mitarbeit. MCP planr als MCP-Server Einrichtung, die 27 Werkzeuge im Einzelnen und der Weg vom Rahmenplan zur fertigen Stundenliste. Entwurf Entwurf und Begründung Entstehungsgeschichte, Architektur-Entscheidungen mit Begründung, verworfene Wege, Philosophie und offene Fragen.

planr ist ein Planungswerkzeug für den eigenen Unterricht: Jahresplanung, Stundenplanung und Rückmeldung an einer Stelle. Gebaut von einer Lehrkraft für Mathematik und Physik an einem Gymnasium in Mecklenburg-Vorpommern - und deshalb mit einer Meinung. planr rechnet in Doppelstunden, kennt den Schulkalender des Landes und behauptet nichts, wofür es keine Daten hat.

Bereich	Für wen	Was drinsteht
Nutzer	Lehrkräfte, die damit planen	Was planr ist, die vier Grundsätze, die Planungsebenen, alle Funktionen, die Kopplungen an andere Programme, Datenschutz, FAQ
Entwickler	Wer Code anfassen will	Tech-Stack, lokales Setup, Projektstruktur, Datenmodell, API-Referenz, MCP-Server, Deployment, Mitarbeit
Design	Wer wissen will, warum es so ist	Entstehungsgeschichte aus der Git-Historie, Architektur-Entscheidungen mit Begründung, verworfene Wege, Philosophie, offene Fragen

Kurz gefasst#

Zwei Kernprozesse. Die Jahres- und Einheitenplanung (welche Einheit wann, wie viele Doppelstunden, wo liegen die Arbeiten) und die Planung der einzelnen Doppelstunde (Ziel, Verlauf, Material, Hausaufgabe).
Die Reihenfolge ist didaktisch fix, das Datum nicht. Fällt eine Stunde aus, schiebt die Engine den Stoff nach. Klassenarbeiten bleiben auf ihrem Termin.
Keine Schülerdaten. Es gibt keine Schülertabelle, und für fremde Konten gibt es die Felder mit möglichem Personenbezug gar nicht erst.
Bedienbar ohne Oberfläche. 27 MCP-Werkzeuge über POST /api/mcp oder einen lokalen stdio-Server, dazu 21 HTTP-Routen.

Weitere Dokumente in diesem Ordner#

Datei	Inhalt
`mcp.md`	Einrichtung des MCP-Servers, vollständige Werkzeugliste, der Weg vom Rahmenplan zur Stundenliste
`mail.md`	Mailversand über eigene Domain, Prüfskripte, Webhook scharf schalten
`zettel-nachtlauf.md`	Der nächtliche Lauf, der offene Fehlerberichte selbst behebt
`verarbeitungsverzeichnis.md`	Verzeichnis der Verarbeitungstätigkeiten nach Art. 30 DSGVO
`superpowers/plans/`	Die Etappenpläne, nach denen gebaut wurde - Fahrplan der Öffnung, Kalender, Konten, Regionswechsel, Rahmenplan
`folien-vorlagen/`	Design-Vorlagen für die Foliengestaltung

Stand#

Diese Dokumentation beschreibt den Stand vom 26.08.2026 (280 Commits, erster Commit am 29.06.2026). Der laufende Projektkontext steht in der CLAUDE.md im Wurzelverzeichnis - dort wird nach jeder größeren Änderung nachgezogen, hier nicht täglich.