Was ist Scholar?​

Scholar ist ein modernes Schulverwaltungssystem auf Basis von Laravel, das sämtliche Prozesse rund um die Schüleradministration abdeckt – von der Aufnahme neuer Schüler über die Notenverwaltung bis hin zur Geräteverwaltung und Bibliotheksverwaltung.

Was dokumentieren wir?​

In dieser Dokumentation werden wir schrittweise alle Bereiche von Scholar erfassen:

• Schülerverwaltung – Stammdaten, Klassen, Laufbahnen
• Notenverwaltung & Zeugnisse – Berechnung und PDF-Ausgabe
• Bibliothek – Ausleihe, Rückgabe und Bestandsverwaltung
• Geräteverwaltung – Zuweisung und Tracking von Schulgeräten
• WLAN-Zugang – RADIUS-Integration und Benutzerverwaltung
• Finanzen – Lernmittel, Zahlungen und Transaktionen

Warum eine Dokumentation?​

Eine klare und gepflegte Dokumentation hilft dem Team, neue Funktionen konsistent umzusetzen, Einarbeitungszeiten zu verkürzen und das System langfristig wartbar zu halten.

Wir freuen uns auf diesen Prozess und werden die Dokumentation kontinuierlich erweitern.

• Lizenz & Update-Server: Neuer Admin-Bereich unter /admin/license zur Verwaltung des Scholar-Lizenzschlüssels und der Update-Server-URL (Standard: crm.scholar.schule)
• Lizenz & Update-Server: Verbindungstest prüft Lizenzstatus live (Edition, Ablaufdatum, Update-Gruppe, Max. Schüler) und zeigt verfügbare Versionen
• Telemetrie: Schüler-/Lehrerzahl, installierte Version und PHP-Version werden täglich automatisch an den Update-Server gesendet (06:00 Uhr, Artisan-Befehl license:send-telemetry)
• Telemetrie: Manuelle Übertragung über den Admin-Bereich möglich – Rückmeldung enthält neueste Version der zugewiesenen Update-Gruppe sowie Warnungen bei Überschreitung des Lizenzlimits
• Update-Check: Wenn ein Lizenzschlüssel hinterlegt ist, werden Updates über das CRM (crm.scholar.schule/api/v1/latest) abgefragt statt über entwurf.io

Bugfixes​

• Lernmittel /learning-materials: Klassen ohne Bücher werden nicht mehr angezeigt – leere Klassenstufen-Gruppen werden jetzt immer herausgefiltert, nicht nur beim aktiven Klassenstufen-Filter
• Lernmittel /learning-materials: Jahrgänge 1–4 in allen Validierungen, Filter-Dropdowns, Create/Edit-Formularen und der fklview ergänzt – Bücher für Klassen 1–4 konnten bisher nicht korrekt angelegt oder bearbeitet werden
• Lernmittel /learning-materials: Löschen-Button entfernt nur den aktuellen Jahrgang aus dem Buch – ist ein Buch mehreren Jahrgängen zugeordnet, wird nur der angeklickte Jahrgang aus grade_levels entfernt; Soft Delete erfolgt nur noch wenn keine weiteren Jahrgänge vorhanden sind
• AdminTools Seitentitel von 'ADMIN' zu 'Administration' umbenannt

2026.03.16-001​

Bugfixes​

• Lernmittel bearbeiten: Berechtigungspruefung verwendet wieder die korrekten Permission-Keys lm_edit/lm_admin

Neu​

• Lernmittel Buchauswertung: Farbige Gruppen-Titel (Grundausstattung, Fremdsprachen, Religion/WN) analog zum digitalen Lernmittel-Report ergänzt
• Lernmittel Übersicht: Verlag-Spalte in der Übersichtstabelle mit Inline-Bearbeitung und Autocomplete ergänzt
• Lernmittel Bearbeiten: Verlag-Feld mit Autocomplete-Vorschlägen aus der Verlags-Datenbank hinzugefügt
• Lernmittel Fehlende Preise: Verlag-Spalte mit Inline-Bearbeitung ergänzt
• Lernmittel Buchauswertung und Digitale Lernmittel Auswertung: Druckoptimierung mit Kopfzeile, Seitenumbrüchen und druckfreundlichem Layout

Bugfixes​

• Lernmittel Buchauswertung und Digitale Lernmittel Auswertung: Ungültige Jahrgänge werden jetzt herausgefiltert, nur Jahrgang 5-13 wird berücksichtigt

2026.03.12-001​

Neu​

• Lernmittel Fehlende Preise: Gesamtzähler für aktuell gelistete Bücher ohne Preis sowie neuer Button 'Nur gelistete Preise abfragen' ergänzt
• Lernmittel Übersicht und Fehlende Preise: Preisabfrage gegen isbn.de mit Pausen, Timeouts und Retry-Backoff stabilisiert

Bugfixes​

• Gerätereservierungen: Parallele Kategorien-Reservierungen führen bei bereits belegten Slots nicht mehr zu einem kritischen SQL-Fehler, sondern geben eine saubere Fehlermeldung zurück
• Lernmittel Fehlende Preise: Button 'Alle gedruckten Preise abfragen' klar von der neuen Listen-Aktion getrennt, damit nicht versehentlich nur die sichtbare Tabelle gemeint ist

• Schulanmeldungen /student_registrations/{id}/edit: Einwilligungs-Checkboxen speichern und laden wieder korrekt mit den String-Werten 'einverstanden' / 'nicht einverstanden' statt als boolesche Werte
• Schulanmeldungen /student_registrations/{id}/edit: Validierung fuer 'first_choice_profile' akzeptiert das Feld wieder als String und verlangt es nur noch bei gewuenschter Profilklasse
• Schulanmeldungen /student_registrations/{id}/edit + PDF: Bezeichnung fuer 'parent1_sole_custody' auf 'Allein erziehungsberechtigt' korrigiert, PDF-Label 'EP::' auf 'EP:' bereinigt
• Schulanmeldungen /student_registrations/{id}/edit: Bereich 'Einwilligungen' mit erklaerenden Beschreibungen fuer unklare Punkte wie Austauschprogramme, Nutzungsrechte und Pressefreigaben erweitert
• Geraetewartung /maintenance/devices: Schnelles mehrfaches Scannen loest keine konkurrierenden Mehrfach-Submits mit Browser-Umleitungsfehler mehr aus

Bugfixes​

• Self-Service /self-service/moinschule: Zugangsdaten werden nicht mehr angezeigt, Hinweis auf E-Mail-Versand ergänzt

2026.03.06-006​

Neu​

• Magellan Import /magellanimport: Student-Import umbenannt (nur Studenten) und Dateiupload akzeptiert jetzt XLS/XLSX/CSV/TXT

Bugfixes​

• Magellan Import /magellanimport: XLS/XLSX wird direkt eingelesen, Encoding-Probleme durch UTF-8 Normalisierung reduziert

2026.03.06-005​

Neu​

• Schulanmeldungen /student_registrations: Soft-Delete für Einträge (Löschen entfernt nur aus der Liste, Daten bleiben erhalten)
• Schulanmeldungen /student_registrations: Checkbox 'Gelöschte anzeigen' zum Einblenden soft-gelöschter Einträge
• Lernmittel /learning-materials: Hinweise (Notes) inline anlegen, bearbeiten und löschen mit Sofort-Feedback
• Lernmittel /learning-materials: Hinweise (Notes) werden in PDF-Listen angezeigt

Bugfixes​

• Schulanmeldungen /student_registrations: Ausblenden/Einblenden aktualisiert die Liste ohne Reload
• Schulanmeldungen /student_registrations: Ausgeblendet-Status und Filter bleiben konsistent bei Umschalten

• Schulanmeldungen /student_registrations: 'Ausblenden'-Button funktioniert jetzt korrekt (PATCH statt POST, JSON-Response)
• Schulanmeldungen /student_registrations: Ausblenden/Einblenden-Button nur noch für Benutzer mit 'edit_register_student' Berechtigung sichtbar
• Schulanmeldungen /student_registrations: Import/Export-Buttons nur für berechtigte Benutzer sichtbar
• Schulanmeldungen /student_registrations/edit: Feld 'Bewerbungsgrund' entfernt (existiert nicht mehr)
• Schulanmeldungen /student_registrations/edit: Validierung - 'first_choice_profile' ist Pflichtfeld wenn 'wants_profile_class' = yes

Neu​

• Lernmittel /learning-materials: Titel inline bearbeitbar - Klick auf Stift-Icon öffnet Eingabefeld mit Speichern/Abbrechen-Buttons, Enter speichert
• Lernmittel /learning-materials: Kopieren-Funktion bleibt erhalten - Klick auf Titel kopiert den Buchtitel mit visuellem Feedback (grün + ✓ Kopiert!)

2026.03.04-002​

Neu​

• Lernmittel /learning-materials: Inline-Toggle für 'Im Elternportal' (showEP) - Admin kann per Klick auf das Badge den Status ändern

Bugfixes​

• Lernmittel /learning-materials: 'Sp' (Sport) im Fach-Select hinzugefügt
• Lernmittel /learning-materials: PDF-Sortierung und Preisübersicht - 'Sp' (Sport) in Fachreihenfolge integriert

2026.03.04-001​

Neu​

• Schulanmeldungen /student_registrations: Live-Suche mit JavaScript (filtert client-seitig nach Name/Stadt, 3+ Zeichen, 300ms Debounce)
• Schulanmeldungen /student_registrations: Inline Status-Änderung per AJAX (Dropdown: Offen, In Bearbeitung, Abgeschlossen, Abgelehnt)
• Schulanmeldungen /student_registrations: Inline Ein-/Ausblenden-Button per AJAX
• Schulanmeldungen /student_registrations: Profilklassen-Übersetzung (Französischklasse statt 'French', Bläserklasse, Theaterklasse)
• AG-Auswahl: Null-Check für classNumber verhindert Fehler wenn kein Schüler ausgewählt ist

Bugfixes​

• Schülerprofil /students/{id}/show: AG-Dopplung behoben - zugeordnete AGs werden jetzt nach aktuellem Schuljahr gefiltert (vorher wurden alle AG-Zuweisungen ohne Schuljahr-Filter angezeigt)

• Lernmittel /lm_books/books/fklview: Druckfunktion für ausgewählte Fächer - neuer Button 'Ausgewählte drucken' öffnet PDF mit nur den selektierten Fächern (nur lm_admin)
• Lernmittel /lm_books/books/fklview: PDF-Druckansicht überarbeitet - mehrere Klassen pro Seite, Schriftgröße 12px
• Lernmittel /lm_books/books/fklview: PDF-Coverseite mit neuen Hinweistexten - Regelungen zu neuen Lernmitteln, Konferenzbeschlüsse bis Dezember, Einführung nur für einen Jahrgang
• Lernmittel /lm_books/books/fklview: PDF-Coverseite mit Jahresablauf - Änderungen bis 1. Dezember möglich, Berücksichtigung im folgenden Schuljahr
• Lernmittel /lm_books/books/fklview: Unterschriftenfeld auf PDF-Coverseite - Bestätigung der Richtigkeit (Titel, Fach, ISBN, Klassenstufe), Hinweis zu Preisen und Änderungen nach Bestandsaufbau

• Lernmittel /create: Gelber Info-Hinweis unter 'Lernmittel erfassen' - weist auf weitere Informationen unten links im I-Menü hin
• Lernmittel /ep-settings: Neue Option 'FKL Lernmittel-Erstellung sperren' - wenn aktiviert, dürfen nur lm_admin neue Lernmittel anlegen (FKL ausgeschlossen)
• Schülerprofil /students/{id}/show: Schließfach-Anzeige im Tutor-Bereich - zeigt aktives Schließfach mit Link zur Detailseite (nur klickbar mit locker_manage Berechtigung)
• Küchenreservierungen /kitchen-reservations: Bestätigungsberechtigung erweitert - Koordinatoren und Verwaltung können jetzt ebenfalls Reservierungen bestätigen/stornieren
• Transaktionen /transactions/guthaben: Neue Seite für Guthaben-Übersicht - zeigt alle Schüler mit positivem oder negativem Guthaben, nur für lm_admin sichtbar
• Transaktionen /transactions/guthaben: Reset-Funktion für Lernmittel-Status - setzt accept_lm, lm_payed, lm_payed_digital, lernmittel_digital für alle Schüler zurück (mit Bestätigung)

Bugfixes​

• Sicherheit: Zugriff auf Schülerprofile wird nun korrekt auf die eigenen Klassen bzw. berechtigte Rollen beschränkt
• Sicherheit: Transaktionszuweisungen können nur noch von Nutzern mit Lernmittel-Berechtigung vorgenommen werden
• Sicherheit: Benutzeranlage durch die Verwaltung schränkt Admin-Felder (E-Mail, Rollen) serverseitig zuverlässig ein
• Sicherheit: Quittungs-PDF-Generierung verwendet einen sichereren Rendering-Modus
• Sicherheit: Geräteverwaltung akzeptiert beim Speichern nur die vorgesehenen Felder
• Bibliothek: Klassifikations-Datensätze sind gegen unerwünschte Massenänderungen geschützt
• Bibliothek /lib/scanner: Statusmeldungen im Buchscanner werden korrekt als Klartext dargestellt
• Self-Service: Statusmeldungen in den Self-Service-Bereichen (IServ, WLAN, Untis, Office, Moin.Schule, Lernmittel digital) werden korrekt als Klartext dargestellt
• Sicherheitsmonitoring: Letzte Anmeldungen, fehlgeschlagene Login-Versuche und auffällige IP-Adressen werden jetzt korrekt aus der Datenbank ausgelesen und im Dashboard angezeigt
• Sicherheitsmonitoring: System stabilitätsprüfung schlägt bei leerer Datenbankabfrage nicht mehr fehl
• Schülerdokumente: Upload-Verzeichnisse werden mit eingeschränkten Zugriffsrechten angelegt

2026.02.27-002​

Neu​

• Lernmittel /learning-materials: Neuer Filter 'Ohne Klasse' in Klassenstufen-Dropdown – zeigt Bücher ohne Klassenzuordnung in eigener Gruppe 'Ohne Klassenzuordnung' (nur lm_admin)
• Lernmittel /learning-materials: Neuer Filter 'Gelöschte anzeigen' (Checkbox) – blendet soft-gelöschte Bücher ein, mit roter Zeile und 'Gelöscht'-Badge beim Titel (nur lm_admin)

2026.02.27-001​

Neu​

• Bestandsübersicht /books/inventory/overview: Button 'Exemplare' pro Textbook-Zeile wechselt direkt in den Exemplar-Modus und filtert auf die Exemplare des gewählten Buches (filterBookId) – ersetzt das umständliche Inline-Dropdown
• Bestandsübersicht /books/inventory/overview: Aktiver Buch-Filter wird als Chip mit Buchtitel und ISBN angezeigt, mit 'Buch-Filter aufheben'-Button

Bugfixes​

• Benutzerverwaltung /UserManagment/users: 'There is no permission named FL-Rk for guard web' – Permission war in der DB als FL-RK (Großbuchstabe) gespeichert, per Migration auf FL-Rk (korrektes Casing laut Config) umbenannt
• Bestandsübersicht /books/inventory/overview: Exemplare des gewählten Buches werden korrekt per filterBookId gefiltert (zuvor keine Filterung aktiv)

Bugfixes​

• Klassifikation bearbeiten: Fehlende Closing-Tags in edit.blade.php (</script></x-app-layout>) behoben - verursachte PHP Syntax Error auf Production

2026.02.25-002​

Bugfixes​

• SelfService /selfservice-pickup/books/scanner: Rk-Bücher wurden nicht angezeigt – Religionsfilter in freeAccess.php (load-books Route) normalisiert RK/Re/WN jetzt case-insensitiv via strtoupper() + match(), analog zu SelfServiceBookController
• SelfService /self-service/digital-book: Gleicher Religionsfilter-Fehler in SelfServiceDigitalBookController behoben – in_array ohne Normalisierung schloss Rk-Bücher aus wenn religion_type_select als 'RK' gespeichert war

2026.02.25-001​

Neu​

• Fachleitung Religion Katholisch (Rk / FL-Rk) systemweit ergänzt – SubjectService, Berechtigungen, GradeSystemController, StudentInterimGradesController, RolePermissionController, UserManagement-Anzeige und Lernmittel-Berechtigungen
• Lernmittel /learning-materials: Erstellungsdatum (Erstellt am) in der Bestand-Spalte – sichtbar nur für Benutzer mit lm_admin-Berechtigung (Admin, Schulleitung)
• Lernmittel /learning-materials: Erstellungsdatum per Klick inline editierbar – Änderung wird per PATCH-Request gespeichert, nur für lm_admin
• Lernmittel /learning-materials: Datumsfilter (Monat/Jahr) in der Suche – Filteroptionen: Genau am, Ab dem, Bis zum; Firefox-kompatibel via zwei Select-Dropdowns, nur für lm_admin

Neu​

• AGS /ags: Teilnehmer-Übernahme ins neue Halbjahr – bestätigte AG-Teilnehmer vom vorherigen Halbjahr können per Klick ins aktive Halbjahr übernommen werden (Bestätigungsseite mit Vorschau, automatischer Warnhinweis auf Index-Seite wenn noch keine Teilnehmer vorhanden)

Bugfixes​

• AGS /ags: Chronologische Erkennung des vorherigen Halbjahres basiert jetzt auf Schuljahr-String und Halbjahr-Nummer statt auf der DB-ID – verhindert falsche Zuordnung wenn zukünftige Schuljahre bereits angelegt sind

2026.02.24-001​

Neu​

• Lernmittel /learning-materials: Bücher mit showEP=false werden gelb hervorgehoben und mit Badge "Nicht im Elternportal" markiert
• Lernmittel /learning-materials: Ausstehende Änderungen (Changelog-Einträge) pro Buch als ausklappbares Panel direkt in der Übersicht – Inline-Akzeptieren ohne Seitenwechsel
• Lernmittel /learning-materials: Bestätigte Bücher für das nächste Schuljahr (book_school_year_confirmations) mit grünem Badge am Buchtitel
• Lernmittel /learning-materials: Buchhinweise (notes/Bemerkung) werden unterhalb des Titels angezeigt
• Lernmittel /learning-materials: Neuer PDF-Export "Bestätigte Lernmittel" – listet bestätigte analoge und digitale Bücher je Klassenstufe sowie Fächer ohne Bestätigung
• Lernmittel /learning-materials/ep-settings: FKL-relevante Einstellungen (Bestellsystem, Bücher-Synchronisation, FKL Lernmittel-Bearbeitung) in separater Box mit Workflow-Hinweis

Bugfixes​

• SchoolYearSettings: setActive() deaktiviert jetzt alle anderen Schuljahre – verhindert doppelt aktive Einträge beim Schuljahrwechsel

2026.02.23-004​

2026.02.23-003​

2026.02.23-002​

Neu​

• Planora API-Integration: SelfService-Vorgänge (Buch, DigitalBuch, Bildungslogin, Untis) erstellen automatisch Planora-Tasks per API
• Planora-Konfiguration: PLANORA_API_TOKEN und PLANORA_SELFSERVICE_PROJECT_ID in config/services.php und .env.example ergänzt

Bugfixes​

• Kiosk: Gelöschte Nachrichten erschienen nach Rotation erneut – kioskMessages-Array wird jetzt sofort bereinigt und Rotation neu aufgesetzt

2026.02.23-001​

• Manuelle iServ/O365-Zuordnung mit reaktivem UI und iserv_mail-Spalte
• WiFi SSID Display Update

Bugfixes​

• Microsoft 365 Benutzer-Validierung berücksichtigt jetzt userPrincipalName
• Falscher Namespace für Microsoft365Controller in Password-Reset behoben (Admin\ fehlte)
• Queue-Worker für Password-Reset eingerichtet (Supervisor in Docker)

• Microsoft 365 Benutzer-Validierung: userPrincipalName wird jetzt berücksichtigt — Benutzer ohne 'mail'-Feld aber mit 'userPrincipalName' werden nicht mehr fälschlicherweise als 'nicht in Office 365 gefunden' markiert
• Microsoft 365 Benutzer-Validierung: Email-Map berücksichtigt jetzt sowohl 'mail' als auch 'userPrincipalName' für zuverlässigere Benutzer-Zuordnung

Neu​

• Docker: Supervisor-basierter Queue-Worker startet automatisch mit dem Container (default + covers Queue)

Bugfixes​

• Password Reset: Queue-Worker eingerichtet — O365/IServ/WLAN-Passwort-Resets liefen in Zeitüberschreitung weil kein Worker lief

2026.02.17-001​

Neu​

• iServ Löschanalyse: Manuelle Zuordnung von nicht erkannten Personen zu Schülern oder Benutzern
• iServ Löschanalyse: Live-Suche (AJAX) zum Finden von Schülern und Benutzern im Zuordnungs-Modal
• iServ Löschanalyse: Nach Zuordnung wird student_iserv_mail (Schüler) oder iserv_mail (Benutzer) automatisch gesetzt
• iServ Löschanalyse: Neue Datenbankspalte iserv_mail in der users-Tabelle für separate iServ-E-Mail bei Benutzern
• Microsoft 365 Benutzer-Validierung: Manuelle Zuordnung von Benutzern ohne oder mit falscher O365-E-Mail
• Microsoft 365 Benutzer-Validierung: Korrigieren-Funktion für ungültige Office 365 E-Mail-Adressen

Bugfixes​

• iServ Löschanalyse: Tab-Wechsel-Bug behoben (zwei getrennte Alpine.js x-data-Scopes wurden zusammengeführt)
• iServ Löschanalyse: Statistikkarten und Tab-Zähler aktualisieren sich reaktiv nach manuellen Zuordnungen

2026.02.17-000​

2026.02.16-001​

Neu​

• Admin-Tools: Neues Modul 'Kopiercodes' mit Livewire-Verwaltung
• Kopiercodes: Neue Datenbanktabelle mit Zuordnung zu Benutzern und Aktiv-Status
• Benutzer: 1:1 Beziehung zu Kopiercodes für aktuelle Zuweisung

• DoorView: Leerer Banner bei inaktivem Planora behoben — normale Startseite mit IT-Service-Infos und Aufgaben wird wieder korrekt angezeigt