LOAN

Allgemeines/ General

Über

Willkommen be LOAN, dem System zur Geräteausleihe für wissenschaftliche und medienpädagogische Einrichtungen. Das System läuft auf einer LNPP-Struktur:

• Ubuntu 24.04
• Nginx
• Postgres
• PHP 8.3

und wurde mit Laravel sowie TailwindCSS programmiert. Es ist unter einer CC BY-NC-SA 4.0 verfügbar. Um Zugang zu einem Testaccount unter http://loan.vdus.de zu erhalten, kontaktieren Sie mich bitte unter vincent.dusanek[at]gmail.com.

About

Welcome to LOAN, a loan management system for scientific and media education institutions. The system runs on an LNPP structure:

• Ubuntu 24.04
• Nginx
• Postgres
• PHP 8.3

and was programmed using Laravel and TailwindCSS. It is available under a <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/"target=“_blank”>CC BY-NC-SA 4.0. To get access to a test account at http://loan.vdus.de, please contact me at vincent.dusanek[at]gmail.com.

LOAN | A free loan management system is made with Laravel and TailwindCSS. Content Language: lang="de".

Lizenz/ License

CC-BY-NC-SA-4.0 Lizenz

Dieses Projekt unterliegt der Creative Commons Attribution–NonCommercial–ShareAlike 4.0 International (CC BY-NC-SA 4.0) Lizenz.

• Erlaubt: Nutzung, Vervielfältigung, Änderung und Weitergabe für nichtkommerzielle Zwecke, sofern Sie die Quelle angemessen angeben und abgeleitete Werke unter derselben Lizenz verbreiten.
• Nicht erlaubt: kommerzielle Nutzung dieses Projekts oder abgeleiteter Werke ohne vorherige Genehmigung. SPDX-License-Identifier: CC-BY-NC-SA-4.0

Für Anfragen zu kommerziellen Lizenzen eröffnen Sie bitte ein Ticket auf GitHub.

CC-BY-NC-SA-4.0 License

This project is licensed under the **Creative Commons Attribution–NonCommercial–ShareAlike 4.0 International** (CC BY-NC-SA 4.0) license.

• Allowed: use, copy, modify, and share for non-commercial purposes, provided you give appropriate credit and distribute derivative works under the same license.
• Not allowed: commercial use of this project or any derivative works without prior permission.

SPDX-License-Identifier: CC-BY-NC-SA-4.0

For commercial licensing inquiries, please open an issue on GitHub.

Preview

Verleihprozess/ Loan process

Anmeldung/ Login

Geräte/ Devices

Detailansicht: Gerät/ Details: Device

Lokale Installation ohne Docker/ Run locally without Docker

# Installation der Abhängigkeiten
composer install
# Anlegen der .env
copy .env.example .env
# Setzung des App-Keys
php artisan key:generate
# Erstellung der DB
New-Item -ItemType File .\database\database.sqlite -Force | Out-Null
# (Aus-)kommentieren der (ir-)relevanten DB-Parameter in der .env
DB_CONNECTION=sqlite
DB_DATABASE="ABSOLUTER_PFAD_ZUR_DB"
# Ausführen der Migrationen
php artisan migrate
# Ausführen des Seeds für den ersten Admin: admin@test.com mit geheimespasswort
php artisan db:seed
# Starten des Servers unter 127.0.0.1:8000
php artisan serve
# Setzung des Storage-Links
php artisan storage:link

Lokale Installation mit Docker/ Run locally with Docker

Using docker, one can run this app locally using php-fpm, redis and mariadb.

APP_KEY creation

The laravel app needs an APP_KEY which can be created like that:

echo "APP_KEY=base64:$(openssl rand -base64 32)" >> .env and should be added to the compose.yml

Setup service

The service can be set up using

docker compose up -d

Run the migrations and seed the database (to create the first admin user):

docker compose run loan php artisan migrate --seed

Login

Go to http://localhost:8080/ and login with the seeded user.

You can then start using the app.