Veröffentlicht unter MIT-Lizenz, Copyright © 2022 Lukas Mateffy
Software um Anträge auf Semesterticket-Rückerstattungen aufgrund des 9€-Tickets anzunehmen und zu verarbeiten. Erstellt für den AStA der Universität Lüneburg.
Screenshots
- Demo
- Features
- Installation
- Anpassung an deine Universität
- Admin Dashboard
- Anleitungen zur Nutzung
- Changelog
- Studierende an der Leuphana haben alle eine E-Mail Adresse, die mit
@stud.leuphana.deendet. - Um Studierende zu verifizieren, wird eine E-Mail an diese Adresse geschickt, die einen MagicLink enthält.
- Mit diesem Link kann sich in das System angemeldet werden. Jede/r Studierende/r kann sich damit klar identifizieren, ohne das Passwörter gespeichert werden müssen.
Damit wird ausgeschlossen, dass Studierende mehrere Anträge abgeben.
- Im Antrag mussder Name und die IBAN angegeben werden.
- Die Matrikelnummer wird dem Studierenden zur Bestätigung angezeigt
- Name und IBAN können auch nach der Einreichung solange geändert werden, bis die Anträge vom Administrator exportiert wurden
Die eingegebene Matrikelnummer wird aus dem Datensatz der berechtigten Studierenden übernommen, damit sichergestellt wird, dass der Antrag auch berechtigt ist.
- Die Software ist mit PHP und MySQL aufgebaut
- Dadurch ist einfache Datenbankeinrichtung via phpMyAdmin möglich (je nach Webhost)
- Nutzt das Laravel Framework, ist damit leicht modifizierbar
- Bankdaten können im Admin Interface als JSON oder CSV exportiert werden
- Software ist sowohl auf Deutsch, als auch auf Englisch verfügbar
- PHP >= 8
- MySQL-Datenbank
- Webspace mit SSH-Zugang und Composer installiert
Melde dich über SSH auf deinem Webspace an und navigiere zu dem Ordner, in dem die Software liegen soll.
Du kannst sie dann mit git clone herunterladen.
git clone https://github.com/asta-luneburg/asta-ticket-refund
cd asta-ticket-refund
# Du bist jetzt im Ordner der InstallationDu muss nun ein paar Variablen konfigurieren, damit die Software richtig laufen kann.
Erstelle eine neue Datei (entweder über FTP oder via SSH z.B. nano .env) und füge folgenden Inhalt hinein:
# Laravel Einstellungen
APP_ENV=production
APP_KEY=
APP_DEBUG=false
# Software Optionen
APP_NAME="AStA Rückerstattung"
APP_URL=https://asta-ticket-refund.test
ADMIN_EMAILS="[email protected]"
ASTA_NAME="AStA Universität Musterstadt"
UNIVERSITY_NAME="Beispiel Universität"
UNIVERSITY_NAME_FULL="Beispiel Universität Musterstadt"
SUPPORT_MAIL="[email protected]"
# Footer
HOMEPAGE_URL="https://example.com/"
PRIVACY_URL="https://example.com/datenschutzerklaerung/"
IMPRESSUM_URL="https://example.com/impressum/"
FAQ_URL="https://example.com/faq/"
FOOTER_ADDRESS="<strong>Allgemeiner Student*innenausschuss</strong><br>Gebäude A1.001<br>Musterstraße 12345<br>Musterstadt"
# Email-Verifizierung
MAIL_ENDING="@students.example.com"
EXAMPLE_MAIL="[email protected]"
# E-Mail Versand
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
# MAIL_PORT=1025
MAIL_USERNAME=username
MAIL_PASSWORD=password
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="AStA Universität Musterstadt"
# Datenbank Optionen
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=8889
DB_DATABASE=asta-ticket-refunds
DB_USERNAME=root
DB_PASSWORD=rootErsetze die Variablen mit Werten, die für deine Universität sinn machen.
E-Mail Versand und die Datenbank müssen konfiguriert werden, bevor die Software richtig funktionieren kann. Du musst also die DB_ und MAIL_ Variablen überprüfen. Richte dich hier nach der Laravel Dokumentation.
Wenn Datenbank und co. richtig konfiguriert sind, müssen erforderliche Tabellen erstellt werden.
Dafür müssen im Ordner der Software (asta-ticket-refund/) folgende Kommandos ausgeführt werden:
# Dependencies installieren
composer install
# Laravel vorbereiten
php artisan key:generate
php artisan migrateDie Tabellen werden nun erstellt, und die Software ist konfiguriert.
Verbinde dich nun manuell mit der MySQL-Datenbank. Das geht am besten mit einem Tool wie phpMyAdmin. Dies ist bei vielen Webhostern bereits vorinstalliert.
Navigiere dort in deine Datenbank und wähle die Tabelle users aus. Du kannst über den Import-Reiter Daten aus verschiedenen Formaten importieren (z.B. XLSX, SQL, ODS oder CSV), allerdings müssen diese in folgendem Spalten-Format sein:
Die Software ist nun fertig installiert und konfiguriert.
Um sie aus dem Internet erreichbar zu machen, musst du deine Domain auf den public/-Ordner richten. Siehe Laravel Deployment.
Die Software kann an deine Universität angepasst werden.
In der .env-Datei kannst du mit den Variablen ASTA_NAME, UNIVERSITY_NAME etc. eine Personalisierung auf deine Universität festlegen.
Außerdem sind folgende Anpassungen einfach machbar:
Du kannst ein Logo als SVG oder JPEG/PNG einbinden, indem du sie in folgenden Dateien hinterlegst:
resources/views/components/application-logo-colored.blade.phpresources/views/components/application-logo.blade.php
Falls du die Texte ändern willst, kannst du das in den Views und den Übersetzungen tun.
lang/deundlang/enresources/views
Detailliertere Anpassungen können mithilfe des Codes entwickelt werden.
Die Software ist auf Laravel aufgebaut und nutzt dessen best-practices. Daher kannst du in der Laravel Dokumentation herausfinden, wie man damit arbeitet.
Du kannst die Admin-UI über diese URL erreichen: 9-euro.example.com/admin
Du kannst eine oder mehrere valide Admin-Email mithilfe der ADMIN_EMAILS Variable festlegen. Du kannst mehrere E-Mails angeben, indem du sie mit , trennst.
Zusätzlich müssen für diese E-Mails Nutzereinträge in der users-Tabelle existieren.
Du musst dich dann über die Studierenden-Verifizierung mit diesern Mails angemeldet haben, um auf das Dashboard zuzugreifen.
ADMIN_EMAILS="[email protected]"
# oder
ADMIN_EMAILS="[email protected],[email protected],..."Im Wiki sind mehrere Anleitungen zur Nutzung verfügbar.
- Neue Admin UI
- Excel Export
- Format passend für Import in SEPAapp
- Deprecation: Die
ADMIN_EMAILEnv-Variable ist deprecated, und wird in der Zukunft entfernt.- Stattdessen kann die
ADMIN_EMAILSVariable benutzt werden - Diese unterstützt mehrere E-Mails, die mit
,getrennt werden können
- Stattdessen kann die
- Der erste Release