Interne Dokumentation · Stand März 2026

PUPIL Stundenplan
Dokumentation

Vollständige Referenz für das PUPIL Stundenplan-Modul – für Selbststudium und Kundenpräsentationen. Zusammengestellt aus Confluence, GitHub und dokumentation.pupil.ch.

📘 Confluence 🐙 GitHub PUPILAG/PUPIL 📗 dokumentation.pupil.ch
Was ist der PUPIL Stundenplan?

Das Stundenplan-Modul ermöglicht die digitale Erstellung von Stundenplänen von A bis Z – basierend auf kantonalen Lehrplänen, unter Berücksichtigung von Teilzeitanstellungen und Raumzuweisungen.

🗂️

Kantonsbasiert

Stundenpläne werden auf Basis kantonaler Lektionentabellen erstellt. Jede Klasse erhält automatisch die korrekten Lektionen pro Fach und Stufe.

🔁

Automatische Synchronisation

Kantonstabelle → Lektioneneintrag → Stundenplaneintrag. Änderungen in der Stundentafel werden automatisch in offene Einträge synchronisiert.

🖱️

Drag & Drop

Lektionen werden per Drag & Drop aus dem Arbeitsvorrat in die Wochenübersicht gezogen. Konflikte werden automatisch erkannt und markiert.

👥

Gruppen & Klassen

Planung von Gruppenlektionen (Halbklassen, Niveaugruppen, Wahlfachgruppen) parallel zur normalen Klassenplanung.

📄

Publikation

PDF-Druck, Elternportal (PUPIL Connect), Schulplaner-Verknüpfung und Anonymisierung für datenschutzkonforme Veröffentlichung.

🤖

KI-Integration

Optionale Integration mit Royal Schedule (KI-Stundenplaner) für vollautomatische Stundenplanerstellung per KI-Algorithmus.

Stundenplan Bearbeitungsansicht
📸 Bearbeitungsansicht — Drag & Drop Interface mit Arbeitsvorrat und Wochengitter
Stundenplan PDF Ausgabe
📸 PDF-Ausgabe — Klassenstundenplan als druckfertiges PDF
Funktionen im Detail

Alle Kernfunktionen des PUPIL Stundenplan-Moduls im Überblick.

📐 Planungsfunktionen

Wiederkehrende LektionenIntervallbasierte Erstellung
Drag & DropManuelle Einplanung per Maus
Klassen-PerspektiveAnsicht pro Klasse
LP-PerspektiveAnsicht pro Lehrperson
Raum-PerspektiveAnsicht pro Zimmer
GruppenlektionenHalbklassen, Niveau, Wahlfach
Konflikt-ErkennungAutomatisch, farblich markiert
StatistikenLektionenanzahl pro LP/Klasse

📤 Publikationsoptionen

PDF-DruckKlasse, LP, Raum, Schule
PUPIL ConnectElternportal-Integration
SchulplanerVerknüpfung mit Schulplaner-Modul
AnonymisierungLP-Name ausblendbar
Freigabe-SteuerungPer Semester und Klasse
FächerstundenplanAnsicht nach Fach (geplant)
Mehrwochenpläne14-täglich, monatlich (geplant)
Schulleitung-AnsichtNur eigene Schuleinheiten
Neu (2025): Gruppenlektionen werden bei der Klassen-Planung angezeigt, auch ohne zugewiesene Stufe – vereinfacht die Planung für Wahlfach- und Mehrstufenklassen. Schulleitungen sehen nur noch ihre eigenen Schuleinheiten in der Bearbeitungsansicht.
Kantonale Stundentafel
📸 Kant. Stundentafel — Fächer × Stufen mit Lektionenanzahl
Klassenstundentafel
📸 Klassenstundentafel — Lektioneneinträge pro Klasse mit LP und Raum
Gruppentypen Übersicht
📸 Gruppentypen — Halbklasse, Niveaugruppe und Wahlfachgruppe im Überblick
Anonymisierungseinstellungen
📸 Anonymisierung — Datenschutz-Einstellungen für das Elternportal
Wer arbeitet mit dem Stundenplan?

Das Modul ist primär für die Schulleitung, aber Lehrpersonen und Eltern sind ebenfalls eingebunden.

🏫

Schulleitung Primär

Vollzugriff: Erstellt und publiziert Stundenpläne, konfiguriert Zeiten, verwaltet die Lektionentabelle, gibt Pläne frei. Sieht nur eigene Schuleinheiten.

👩‍🏫

Lehrperson Sekundär

Kann zugewiesene Lektionen nach 2024-03 Update bearbeiten. Sieht eigenen Stundenplan, kann PDF drucken. Kein Zugriff auf die gesamte Konfiguration.

👨‍👩‍👧

Eltern Read-only

Lesezugriff via PUPIL Connect (Elternportal). Sehen freigegebene Stundenpläne mit konfigurierbaren Datenschutzeinstellungen (Vollansicht, Raumangabe, Vorlage).

Lehrpersonenansicht
📸 LP-Ansicht — Lehrperson sieht eigenen Stundenplan mit Semester- und Klassenfilter
Elternportal Freigabe
📸 Elternportal — Aktivierung der Stundenplan-Freigabe via PUPIL Connect
Stundenplan erstellen – Schritt für Schritt

Von der Datenvorbereitung bis zur Publikation – der vollständige Ablauf für die Schulleitung.

1

Datenvorbereitung

Grunddaten prüfen und einrichten, bevor der Stundenplan erstellt werden kann:

  • Semester anlegen und aktivieren
  • Klassendaten prüfen (Stufe, Klassenschlüssel)
  • Räume mit Abkürzung anlegen
  • Lehrpersonencodes vergeben
  • Klassenzimmer zuweisen
  • Fächer mit Farbe und Code definieren
  • Klassenlehrpersonen zuweisen
Semester definieren
📸 Klassen & Semester — Klassen pro Semester definieren
Raum erstellen
📸 Raum erstellen — Gebäude, Abkürzung und Anzeige-Optionen
LP Kürzel
📸 LP-Kürzel — Abkürzung für Lehrpersonen erfassen
Fach erstellen
📸 Fach erstellen — Name, Kürzel und Farbe definieren
2

Lektionentabelle konfigurieren

Kantonale Stundentafel definieren: Welche Klassen erhalten wie viele Lektionen pro Fach?

  • Kantonseintrag setzen (Fach × Stufe → Anzahl Lektionen)
  • Gruppen-Lektionen spezifizieren (Halbklassen, Niveaus)
  • Synchronisation auslösen → Lektionseinträge werden automatisch erstellt oder aktualisiert
Kantonale Stundentafel bearbeiten
📸 Kant. Stundentafel — Inline-Bearbeitung der Lektionenanzahl
Lektionseintrag bearbeiten
📸 Lektionseintrag — LP und Raum pro Lektion zuweisen
3

Systemkonfiguration

Zeitraster und Sonderregeln definieren:

  • Lektionszeiten festlegen (Start/Ende pro Zeile)
  • Anzahl Lektionen pro Stufe/Klasse konfigurieren
  • Gesperrte Zeiten / freie Zeiten festlegen
  • Mittagspausen markieren
  • Schulbus / Schulplaner-Anbindung konfigurieren
Einstellungen Stundenplan
📸 Einstellungen — Semester, Stufe und Zeitkonfiguration
Lektionszeiten konfigurieren
📸 Lektionszeiten — Start- und Endzeiten pro Zeile definieren
4

Stundenplan erstellen

Lektionen aus dem Arbeitsvorrat in das Wochengitter einplanen:

  • Drag & Drop: Lektionen in Zeitslots ziehen
  • Konflikte werden sofort farblich markiert
  • Perspektivwechsel: Klasse / LP / Raum
  • Fixe Lektionen setzen (z.B. Sport, TTG)
  • Gruppenverknüpfungen beachten (parallele Gruppen)
Drag & Drop Animation
🎬 Drag & Drop — Lektionen aus dem Arbeitsvorrat ins Wochengitter ziehen
Lektion bearbeiten Animation
🎬 Lektion bearbeiten — Zahnrad-Icon für Detailanpassungen
Lektionskarten
📸 Arbeitsvorrat — Lektionskarten mit Fach, LP und verbleibende Anzahl
Konflikt-Erkennung
📸 Konflikte — Automatische Erkennung von Doppelbelegungen
5

Freigabe & Publikation

Fertige Stundenpläne publizieren:

  • Stundenplan sperren (schützt gegen versehentliche Änderungen)
  • PDF-Druck für Verteilung
  • Freigabe im Elternportal (PUPIL Connect)
  • LP-Zugriff aktivieren
  • Anonymisierungsoptionen setzen
Druckansicht
📸 Druck & PDF — Semester wählen, Filter setzen und als PDF herunterladen
Anonymisierung Einstellungen
📸 Anonymisierung — LP-Namen pro Schuljahr und Stufe konfigurierbar
Freigabe gesperrt
📸 Gesperrt — Rotes Schloss: Stundenplan noch nicht freigegeben
Freigabe offen
📸 Freigegeben — Grünes Schloss: LP und Eltern haben Zugriff
Backend-Prozess: Datenfluss

Wie der PUPIL Stundenplan intern funktioniert – von der Kantonstabelle bis zum sichtbaren Eintrag. Quelle: CODEFELLAS Confluence.

Schritt 1

🗃️ Kantonseintrag

Admin definiert Fach × Stufe → Anzahl Lektionen. Tabellenansicht, inline editierbar.

Schritt 2

📋 Lektionseintrag

Pro Klasse/Gruppe wird automatisch ein Lektionseintrag (Fach + LP + Raum + Anzahl) generiert oder aktualisiert.

Schritt 3

📅 Stundenplaneintrag

Pro Lektionsanzahl werden entsprechend viele offene Stundenplaneinträge erstellt (z.B. 4 Lektionen Mathe → 4 Einträge).

🔁 Klassen-Synchronisation

  • 1. Alle Klassen der Stufe finden
  • 2. Existierenden Lektionseintrag prüfen
  • 3. Erstellen oder aktualisieren (LP, Raum)
  • 4. Hauptlehrperson nach Fachzuweisung bestimmen

📊 Stundenplan-Prozessor

  • = Gleich: nur offene Einträge aktualisieren
  • > Mehr: offene löschen, neu erstellen
  • < Weniger: neue offene erstellen
  • 🔒 Geplante Einträge werden nie verändert
⚠️ Wichtig: Geplante (scheduled) Stundenplaneinträge werden durch die Synchronisation nie überschrieben. Nur offene (open) Einträge werden bei Änderungen aktualisiert. Wenn mehr geplante Einträge existieren als die neue Lektionenzahl erlaubt, wird die Lektion gar nicht verarbeitet.
Aktionen Synchronisation
📸 Aktionen-Menü — Klasse synchronisieren und Fachzuweisungen aktualisieren
Sync Bestätigung
📸 Sync-Dialog — Bestätigung vor dem Aktualisieren der Klassenstundentafel
Sync Erfolg
📸 Erfolg — Bestätigung der erfolgreichen Synchronisation

📦 Technische Modulstruktur (GitHub: PUPILAG/PUPIL)

🧩

Model

TimetableEntry, TimetableSettings, SettingHourConfig, TimetableSemesterRelease, BlockedCells u.a.

⚙️

Processor

TimetableProcessor, SchoolplanerProcessor, UpdateLessonsProcessor, Print-Prozessoren (PDF/ZIP)

🔌

API

REST-Endpunkte für Stundenplan-Einträge, Einstellungen, anonymisierte Ausgabe (für PUPIL Connect)

🔒

Anonymous

Anonymisierungs-Handler für LP-Daten im Elternportal. Konfigurierbar pro Semester.

Validity

Konflikt-Validierung: Raum-Doppelbelegung, LP-Überschneidung, Zeit-Konflikte.

🖨️

PdfGenerator / Print

PDF-Ausgabe pro Klasse/LP/Raum. Druck-Filter, ZIP-Erstellung für Massendownload.

Royal Schedule – KI-Stundenplaner

Royal Schedule ist eine externe KI-basierte Stundenplanungslösung, die über Import/Export mit PUPIL integriert ist. Aktuell laufen Pilotprojekte an Schweizer Schulen.

🏫 PUPIL Stundenplan (nativ)

  • Vollständig in PUPIL integriert
  • Direkte Verknüpfung mit Stammdaten (LP, Räume, Fächer)
  • Sofort-Synchronisation mit Lektionentabelle
  • Elternportal-Freigabe direkt in PUPIL
  • Kostenlos im PUPIL-Paket inbegriffen
  • · Manuelles Drag & Drop (kein KI-Algorithmus)
  • · Zeitkonflikte manuell lösen

⚙️ Royal Schedule – Onboarding-Prozess

1

Zugangsdaten & Aktivierung

Schule erhält persönlichen Aktivierungslink. Einmalige Registrierung, dann direkter Zugang zu planner.sdui.app.

2

Stammdaten eingeben

Klassen, Lehrpersonen, Räume und Kurse in Royal Schedule erfassen. Verbotene Zeiten, Pausenzeiten und LP-Wünsche definieren.

  • Lehrpersonen: erlaubte Tage, verbotene Zeiten, Zeitrahmen
  • Räume: erlaubte Tage, verbotene Zeiten
  • Kurse: Standard-Lektionszeiten erfassen (via Kalender-Icon)
3

Kurse konfigurieren

Parallele Kurse verknüpfen, Farben setzen, LP zuweisen (i.d.R. 1 LP pro Gruppe), Räume festlegen, fixe Lektionen setzen.

4

KI-Stundenplan erstellen

Royal Schedule berechnet automatisch einen konfliktfreien Stundenplan. Ergebnis prüfen, bei Bedarf manuell anpassen.

5

Export nach PUPIL

Fertiger Stundenplan wird aus Royal Schedule exportiert und in PUPIL importiert. Wichtig: Klassenschlüssel für jedes Semester korrekt setzen.

🏫 Pilotschulen

SchuleStatusNotizen
Kloten SekundarPilot abgeschlossenRS-Pilot 2025, Feedback von Bettina Petralli (Kloten)
BSK Immensee/KüssnachtPilot läuftSamuele Simonetto testet für Immensee
WartauPlanungGeplant für Schuljahr 2026/27
UrdorfInteressiertVerzögert auf 2026/27 (Personalwechsel)
GaiserwaldWartendStartet nach erfolgreichem RS-Test, via Bettina Wagner
Geplante Verbesserungen

Bekannte Bugs, UI-Verbesserungen und funktionale Erweiterungen aus der Confluence-Roadmap. Stand: März 2026.

🐛 Bekannte Bugs

  • Timeout bei Synchronisation /synchronize_all_entries
  • Alte Lektionen/LP vom Vorjahr werden beim Semesterwechsel kopiert → betrifft Kloten, Oberengstringen, Nollen
  • Lektionen werden erstellt auch wenn Stundenzahl = 0

🎨 UI-Verbesserungen

  • Zeitkonfiguration: Zeilen im UI hinzufügen/entfernen (statt neuen Eintrag erstellen)
  • Mehrere Klassen gleichzeitig anpassen
  • Standardwerte zurücksetzen
  • Farben aufhellen (PUPIL-Blau für Gruppenlektionen)
  • Tabellenansicht mit Pagination (Ladezeiten)

🚀 Funktionale Erweiterungen

  • Lektionen nach Zeiten planen (statt nach Zeilennummer) → wie Royal Schedule
  • Fächerstundenplan (Turnen, TTG, …) nach Fach darstellen
  • Mehrere Lehrpersonen pro Lektion (>3, Co-Teaching)
  • Mehrere Räume pro Lektion
  • Synchronisation sperren (manuelle Änderungen schützen)
  • Elternportal: Anonymisierung nur im Portal, LP kann trotzdem drucken
  • Mehrwochenstundenplan (14-täglich, monatlich)

🖨️ Druck-Verbesserungen

  • Footer "Erstellt mit PUPIL"
  • Dynamische Tabelle (mehr als 2 Lektionen pro Zelle)
  • Schriftgrösse im Druckdialog anpassen
  • Legende ja/nein, Raumname ja/nein, LP-Name ja/nein
  • Schulhaus-Info aus LP-Druck entfernen
Strategische Ausrichtung

Zusammenfassung des Strategie-Meetings vom 13. März 2026 (Arvo Wagner, Sebastian, Lukas Lehmann).

⚠️

Aktuelles Problem: Skalierung

Fast alle Stundenplan-Arbeit hängt an einer Person (Lukas Lehmann). Das limitiert Wachstum. Aktuell nur ca. 1–2 neue Schulen pro Jahr.

🎯

Ziel: Skalierung

Strukturierter Onboarding-Prozess, Wissensverteilung, klare Rollenverteilung. Präsentation der aktuellen Fähigkeiten für interne Transparenz.

🤔

Offene Frage: KI-Lösung

Strategische Entscheidung ausstehend: Royal Schedule (bestehend) oder Educa AI Timetable (neu, KI-basiert)? Klare Richtung für weitere Entwicklung nötig.

Nächste Schritte (aus Confluence, Stand 13. März 2026):
Timetable-Fähigkeiten-Präsentation organisieren (Lukas Lehmann) · Ressourcenplanung mit Lucas Wunderling besprechen · Skalierbaren Onboarding-Prozess definieren · Royal Schedule vs. Educa AI evaluieren.