79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
# FF Admin
|
|
|
|
Administration für Feuerwehren und Vereine.
|
|
|
|
## Einleitung
|
|
|
|
Dieses Repository dient hauptsächlich zur Verwaltung der Mitgliederdaten, aber auch zur Verwaltung weiterer Daten der Feuerwehr oder eines Vereins. Es ist ein Frontend-Client, der auf die Daten des [ff-admin-server Backends](https://forgejo.jk-effects.cloud/Ehrenamt/ff-admin-server) zugreift. Die Webapp bietet eine Möglichkeit Mitgliederdaten zu verwalten, Protokolle zu schreiben und Kaledereinträge zu erstellen. Benutzer können eingeladen und Rollen zugewiesen werden.
|
|
|
|
Eine Demo dieser Seite finden Sie unter [https://ff-admin-demo.jk-effects.cloud](https://ff-admin-demo.jk-effects.cloud).
|
|
|
|
Für die Verwendung muss ein TOTP-Code eingegeben werden.
|
|
|
|
Die Zugangsdaten (Lesebeschränkt) sind:\
|
|
EMAIL: demo-besucher\
|
|
TOTP: \
|
|
TOTP-Code: FBMDAJKFOYQXM2DNH47GWWBGJ5KWOUCW
|
|
|
|
## Installation
|
|
|
|
### Docker Compose Setup
|
|
|
|
Um den Container hochzufahren, erstellen Sie eine `docker-compose.yml` Datei mit folgendem Inhalt:
|
|
|
|
```yaml
|
|
version: "3"
|
|
|
|
services:
|
|
ff-admin-app:
|
|
image: docker.registry.jk-effects.cloud/ehrenamt/ff-admin/app:latest
|
|
container_name: ff_admin
|
|
restart: unless-stopped
|
|
|
|
#environment:
|
|
# - SERVERADDRESS=<backend_url (https://... | http://...)> # wichtig: ohne pfad
|
|
# - IMPRINTLINK=https://mywebsite-imprint-url
|
|
# - PRIVACYLINK=https://mywebsite-privacy-url
|
|
# - CUSTOMLOGINMESSAGE=betrieben von xy
|
|
#volumes:
|
|
# - <volume|local path>/myfavicon.png:/usr/share/nginx/html/favicon.png
|
|
# - <volume|local path>/mylogo.png:/usr/share/nginx/html/Logo.png
|
|
```
|
|
|
|
Wenn keine Server-Adresse angegeben wird, wird versucht das Backend unter der URL des Frontends zu erreichen. Dazu muss das Backend auf der gleichen URL wie das Frontend laufen. Zur Unterscheidung von Frontend und Backend bei gleicher URL müssen alle Anfragen mit dem PathPrefix `/api` an das Backend weitergeleitet werden.
|
|
|
|
Führen Sie dann den folgenden Befehl im Verzeichnis der compose-Datei aus, um den Container zu starten:
|
|
|
|
```sh
|
|
docker-compose up -d
|
|
```
|
|
|
|
### Manuelle Installation
|
|
|
|
Klonen Sie dieses Repository und installieren Sie die Abhängigkeiten:
|
|
|
|
```sh
|
|
git clone https://forgejo.jk-effects.cloud/Ehrenamt/ff-admin.git
|
|
cd ff-admin
|
|
npm install
|
|
npm run build
|
|
npm run start
|
|
```
|
|
|
|
### Konfiguration
|
|
|
|
Ein eigenes favicon und Logo kann über ein volume ausgetauscht werden.
|
|
|
|
## Einrichtung
|
|
|
|
1. **Admin Benutzer erstellen**: Erstellen Sie einen Admin Benutzer unter dem Pfad /setup, um auf die Migliederverwaltung Zugriff zu erhalten. Nach der Erstellung des ersten Benutzers wird der Pfad automatisch geblockt.
|
|
|
|
2. **Rollen und Berechtigungen**: Unter `Benutzer > Rollen` können die Rollen und Berechtigungen für die Benutzer erstellt und angepasst werden.
|
|
|
|
3. **Nutzer einladen**: Unter `Benutzer > Benutzer` können weitere Nutzer eingeladen werden. Diese erhalten dann eine E-Mail mit einem Link, um ein TOTP zu erhalten.
|
|
|
|
## Fragen und Wünsche
|
|
|
|
Bei Fragen, Anregungen oder Wünschen können Sie sich gerne melden.\
|
|
Wir freuen uns über Ihr Feedback und helfen Ihnen gerne weiter.\
|
|
Schreiben Sie dafür eine Mail an julian.krauser@jk-effects.com.
|