92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
# ff-admin-server
|
|
|
|
Administration für Feuerwehren und Vereine (Backend).
|
|
|
|
## Einleitung
|
|
|
|
Dieses Projekt, `ff-admin-server`, ist das Backend zur Verwaltung von Mitgliederdaten. Die zugehörige Webapp ist im Repository [ff-admin-ui](https://forgejo.jk-effects.cloud/Ehrenamt/ff-admin) zu finden.
|
|
|
|
Eine Demo zusammen mit der `ff-admin` finden Sie unter [ff-admin-demo.jk-effects.cloud](ff-admin-demo.jk-effects.cloud).
|
|
|
|
## Installation
|
|
|
|
Das Image exposed nur den Port 5000. Die Env-Variable SERVER_PORT kann nur im lokal ausführenden dev-Kontext verwendet werden.
|
|
|
|
### Docker Compose Setup
|
|
|
|
Um den Container hochzufahren, erstellen Sie eine `docker-compose.yml` Datei mit folgendem Inhalt:
|
|
|
|
```yaml
|
|
version: "3"
|
|
|
|
services:
|
|
ff-ff-admin-server:
|
|
image: docker.registry.jk-effects.cloud/ehrenamt/ff-admin/server:latest
|
|
container_name: ff_member_administration_server
|
|
restart: unless-stopped
|
|
environment:
|
|
- DB_TYPE=<mysql|sqlite> # default ist auf mysql gesetzt
|
|
- DB_HOST=ffm-db
|
|
- DB_PORT=<number> # default ist auf 3306 gesetzt
|
|
- DB_NAME=ffadmin
|
|
- DB_USERNAME=administration_backend
|
|
- DB_PASSWORD=<dbuserpasswd>
|
|
- JWT_SECRET=<tobemodified>
|
|
- JWT_EXPIRATION=<number[m|d] - bsp.:15m> # default ist auf 15m gesetzt
|
|
- REFRESH_EXPIRATION=<number[m|d] - bsp.:1d> # default ist auf 1d gesetzt
|
|
- PWA_REFRESH_EXPIRATION=<number[m|d] - bsp.:5d> # default ist auf 5d gesetzt
|
|
- MAIL_USERNAME=<mailadress|username>
|
|
- MAIL_PASSWORD=<password>
|
|
- MAIL_HOST=<url>
|
|
- MAIL_PORT=<port> # default ist auf 578 gesetzt
|
|
- MAIL_SECURE=<boolean> # default ist auf false gesetzt
|
|
- CLUB_NAME=<tobemodified>
|
|
- CLUB_WEBSITE=<tobemodified>
|
|
volumes:
|
|
- <volume|local path>:/app/files
|
|
networks:
|
|
- ff_internal
|
|
depends_on:
|
|
- ff-db
|
|
|
|
ff-db:
|
|
image: mariadb:11.2
|
|
container_name: ff_db
|
|
restart: unless-stopped
|
|
environment:
|
|
- MYSQL_DATABASE=ffadmin
|
|
- MYSQL_USER=administration_backend
|
|
- MYSQL_PASSWORD=<dbuserpasswd>
|
|
- MYSQL_ROOT_PASSWORD=<dbrootpasswd>
|
|
volumes:
|
|
- <volume|local path>:/var/lib/mysql
|
|
networks:
|
|
- ff_internal
|
|
|
|
networks:
|
|
ff_internal:
|
|
```
|
|
|
|
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-server.git
|
|
cd ff-admin-server
|
|
npm install
|
|
npm run build
|
|
npm run start
|
|
```
|
|
|
|
## 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.
|