❗ Diese App ist nicht offiziell vom dem Domgymnaisum Naumburg entwickelt wurden. Die App steht in keinerlei Verbindung mit dem Domgymnasium Naumburg oder dem Schulträger Burgenlandkreis.
❗ Gegenwärtig ist die App nur für die Noten der 10. Klassenstufe kompatibel. Gerne kannst du dieses Repo forken und die Notenübersicht für deine eigene Klassenstufe implementieren.
Diese App ermöglicht den einfacheren Zugriff auf die Notenübersicht für die Schüler des Domgymnasium Naumburgs. Endlich ist es möglich, seine Noten auch (richtig formatiert) am Smartphone anzusehen. Außerdem gibt es die Möglichkeit, einen Darkmode zu aktivieren (ist ganz nice für die Augen hab ich gehört). Die Nutzung der App ist vollkommen kostenlos. Die Anmeldedaten werden nur lokal auf deinem Gerät gespeichert und nicht auf dem Server der App. Außerdem wird dein Passwort verschlüsselt und kann nur mit einer PIN wieder entschlüsselt werden. Solltest du der ganzen Sache trotzdem nicht vertrauen, kannst du die App natürlich auch auf deinem eigenen Server installieren.
Wegen Bildungsauftrag und so versuche ich euch mal zu erklären, wie diese App so ungefähr funktioniert und an eure Noten kommt. Eigentlich kann man alles in einem Satz erklären: Der Server der App ist ein Proxy zwischen dem Schüler und der Schulwebsite. Nach dem Anmelden parset er die Noten in eine angenehmere Übersicht. Naja, da es jetzt eh zwei Sätze waren, kann ich auch ins Detail gehen und alles nochmal für Leute erklären, welche ein Sozialleben haben und nicht 24/7 vor ihrem PC sitzen und irgend nen Müll programmieren... Wenn du dich bei dieser App anmeldest, werden deine Anmeldedaten an den Server der App gesendet. Sobald die Daten am Server angekommen sind, versucht dieser sich mit deinen Anmeldedaten auf der Schulwebsite anzumelden. Stell dir das vor, wie ein Roboter der in das Anmelde-Formular deine Anmeldedaten einträgt und dieses dann absendet. Als Antwort erhält der App-Server von der Schulwebsite einen Sitzungs-Token. Das ist sowas, wie ein Passwort, mit dem sich der App-Server für dich anmelden kann. Danach öffnet der App-Server die Noten-Seite der Schule und schickt den Sitzungs-Token mit. Somit denkt die Schulseite, dass du gerade auf deine Noten zugreifst. Der App-Server kopiert sich danach deine Notentabelle und versucht diese auszuwerten. Mit den ausgewerteten Daten werden dann deine Noten in der App angezeigt. Keine Sorge, deine Noten werden zu keinem Zeitpunkt permanent auf dem Server gespeichert und außer dir hat keiner die Möglichkeit deine Noten auszulesen. Gerne kannst du alles selbst im Quellcode nachlesen und versuchen nachzuvollziehen, was ich hier erzählt habe.
Es gibt drei Möglichkeiten die App zu installieren. Ich gehe hier auf jede dieser Möglichkeiten ein und zeige dir, auf welchen Geräten was am besten läuft und wo nicht.
Warum gibt es die App nicht im App Store oder Play Store? Da diese App nur eine sehr kleine Zielgruppe anspricht, sind die Kosten für die Veröffentlichung in den Stores zu teuer. Außerdem besteht eine hohe Chance, dass die App abgelehnt wird, da diese zu irrelevant für die Allgemeinheit ist.
Du kannst die Releases-Seite besuchen und die neuste Version der App als .apk-Datei herunterladen und auf deinem Android-Handy installieren indem du die Datei öffnest. Möglicherweise musst du erst "Installation aus unbekannten Quellen" in deinen Einstellungen aktivieren.
Du kannst dgn-app.kurtiii.de/install öffnen und den Anweisungen auf dieser Seite folgen. Somit kannst du die App ohne den Download einer Datei installieren. Bitte beachte, dass nicht alle Browser dieses Feature unterstützen. Verwende auf Android am besten Google Chrome und auf iOS Safari.
Natürlich kannst du die App auch auf deinem Laptop im Browser nutzen. Das geht selbstverständlich auch auf deinem Handy, wenn du nichts installieren kannst/darfst. I mean es ist eine PWA, warum sollte es nicht gehen? Besuche dafür einfach dgn-app.kurtiii.de/web und melde dich an.
Natürlich kannst du dieses Repo klonen und dann lokal testen oder auf deinem eigenen Server installieren. Vorraussetzungen sind:
- PHP 8.1
- Apache
- SSL-Zertifikat (nur für Installation der PWA benötigt)
Wenn du auf die Live-Daten vom Domgymnasium zugreifen möchtest, musst du in der assets/config.php die Zeile $_CONFIG['production] = false; zu $_CONFIG['production] = true; ändern. Sollte der Production-Mode auf false stehen, wird eine lokale Simulation der Schulseite verwendet welche sind in demo/ befindet. Die Anmeldedaten im Demo-Modus sind:
- Benutzername:
admin - Passwort:
admin
Sollte die App lokal getestet werden, müssen die entsprechenden localhost-URLs in der Config ebenfalls angepasst werden.
Vielen Dank fürs lesen. Sollte es Probleme geben, kannst du gerne ein Issue aufmachen oder mir über Instagram (@kurtiii06) eine Nachricht schreiben. In diesem Sinne, guten Morgen 💩✨