DLRG Intranet

Diese Anwendung ist eine Eigenentwicklung der DLRG Ortsgruppe Durlach e.V. für Dinge, die leider nicht über andere, externe sowie interne Tools abgedeckt werden können.
Gerne kann die Anwendung aber auch von anderen Ortsgruppen oder Gliederungen genutzt werden, dazu einfach die entsprechenden Namen in der .env-Datei anpassen.

Features

• Ausbildungsverwaltung (Coming soon, wird portiert von: DLRG-Kursplanungstool/server)
• Ressourcen / Materialverwaltung inklusive Prüfzyklen und digitalen Prüfprotokollen, Reservierungen, Inventarisierungsfunktionen und Abschreibung, etc.
• feingranulare Berechtigungsverwaltung, auch für externe Systeme
• SSO-Provider für Anmeldung an externen Diensten (mittels OAuth 2.0 / OpenID-Connect)
• Spendenverwaltung (Generieren von Spendenbescheinigungen und Dokumentation)

... und viele weitere

Installation

Zum Installieren der Anwendung

git clone https://git.phsta.de/dlrg-durlach/intranet.git
cd intranet

composer install
npm install
npm run build

Jetzt muss die .env Datei (z.B. durch Kopie der .env.example) erstellt und angepasst werden.
Anschließend kann mit den folgenden Befehlen die Installation vollendet werden:

php artisan key:generate
php artisan config:cache
php artisan migrate

Jetzt kann die Anwendung vollständig genutzt werden.
Achte darauf, dass dein Webserver auf das Verzeichnis /public zeigt und NICHT AUF DAS WURZELVERZEICHNIS!

Feedback

Wir freuen uns jederzeit über Feedback per Mail an intranet@durlach.dlrg.de!

Authors

• Philipp Stappert @philippstappert

FAQ

Question 1

Answer 1

Question 2

Answer 2

Support

Wir freuen uns über eine Mail an intranet@durlach.dlrg.de!
Sofern du Zugriff darauf hast, erstelle bitte ein Ticket mithilfe der Vorlage!

Tech Stack

Client: Vue3, TypeScript, InertiaJS, TailwindCSS

Server: Laravel (PHP >= 8.3)

Running Tests

Um die Tests auszuführen, den folgenden Command im Root-Verzeichnis ausführen:

php artisan test

Vorschau einer Änderung

Im entsprechenden Merge Request den job deploy -> deploy-review starten.

License

MIT

Lokale Entwicklungsumgebung erstellen

Projekt clonen

git clone https://git.phsta.de/dlrg-durlach/intranet.git

In das Verzeichnis wechseln

cd intranet

Laravel initialisieren

php artisan key:generate
php artisan config:cache
php artisan migrate

Abhängigkeiten installieren

composer install
npm install

Entwicklungsserver starten (beide Kommandos parallel ausführen)

php artisan serve
npm run dev