Konfiguration

GISELA kann über eine .env-Datei im Haupt-Verzeichnis konfiguriert werden.

Datenbank

MariaDB und MySQL werden von GISELA unterstützt. Die Zugangsdaten zur Datenbank können in der .env-Datei eingetragen werden. Mehr Informationen zur Konfiguration sind in der Laravel-Dokumentation zu finden.

.env
DB_CONNECTION="mariadb"
DB_HOST="127.0.0.1"
DB_PORT=3306
DB_DATABASE="gisela"
DB_USERNAME="gisela"
DB_PASSWORD=""

E-Mail

Hauptsächlich wird der Versand von E-Mails per SMTP verwendet und getestet. Grundsätzlich sind aber auch andere Methoden des E-Mail-Versands möglich. Mehr Informationen dazu sind in der Laravel-Dokumentation zu finden.

.env
MAIL_MAILER="smtp"
MAIL_HOST="mail.gisela-inventory.org"
MAIL_PORT=587
MAIL_USERNAME="gisela@gisela-inventory.org"
MAIL_PASSWORD=""
MAIL_FROM_ADDRESS="gisela@gisela-inventory.org"
MAIL_FROM_NAME="${APP_NAME}"

Benutzerverwaltung

Für die Benutzerverwaltung wird auf Keycloak als externen Identity Provider gesetzt. Die Authentifikation läuft dabei über OpenID Connect ab. Keycloak wird mittels Laravel Socialite und Socialite Providers angebunden.

.env
KEYCLOAK_CLIENT_ID="gisela"
KEYCLOAK_CLIENT_SECRET=""
KEYCLOAK_REDIRECT_URI="${APP_URL}/auth/callback"
KEYCLOAK_BASE_URL=""
KEYCLOAK_REALM=""

Gruppen

Über OpenID Connect werden von Keycloak die Gruppen übermittelt, denen ein:e Benutzer:in angehört. In der .env-Datei kann angegeben werden, welche Gruppen Benutzer:innen zu welchen Rollen in GISELA hinzufügen sollen. Dadurch kann beeinflusst werden, welche Berechtigungen ein:e Benutzer:in in GISELA hat.

.env
GROUP_AB="ausleihe"
GROUP_HV="ref-finanzen-hv"
GROUP_KV="ref-finanzen-kv"
GROUP_ADMIN="admin"

Karten

Für die Anzeige des genauen Standortes eines Lagerortes wird eine Karte mittels Leaflet eingebunden. Es kann konfiguriert werden, welcher Tile-Server genutzt und welche Hinweise (Copyright, Datenschutz, etc.) an der Karte angezeigt werden sollen.

.env
MAP_TILES="https://tile.openstreetmap.org/{z}/{x}/{y}.png"
MAP_NOTICE="&copy; <a href='https://www.openstreetmap.org/copyright' target='_blank'>OpenStreetMap</a>"