Frontend
Das Frontend der CoSy-Webanwendung ist eine Vue.js-Anwendung, die mit Node.js und npm gebaut wird.
Installation und Start (Node.js)
Für die Weiterentwicklung des CoSy-Backends wird empfohlen, das Projekt von GitHub zu klonen und lokal zu starten.
Projekt von GitHub klonen
Projekt von GitHub klonen:
git clone git@github.com:uzl-cosy/cosy-frontend.git
cd cosy-frontend
Abhängigkeiten installieren
Im Projektverzeichnis müssen die Abhängigkeiten mit npm installiert werden:
npm install
Entwicklungsserver starten
npm run dev
Der Entwicklungsserver ist unter http://localhost:3000 erreichbar.
Installation und Start (Docker)
Für das Deployment der CoSy-Webanwendung wird empfohlen, die Docker-Images zu verwenden.
Projekt von GitHub klonen
Projekt von GitHub klonen:
git clone git@github.com:uzl-cosy/cosy-frontend.git
cd cosy-frontend
Docker-Image bauen
docker build -t cosy-frontend . --build-arg BACKEND_URL=http://localhost:8080 --build-arg COSY_DEVICE_LABEL_1=CoSy-Koffer-1 --build-arg COSY_DEVICE_URL_1=http://localhost:8000
Docker-Container starten
docker run -p 80:80 cosy-frontend
Der Docker-Container ist unter http://localhost erreichbar.
Konfiguration
Zu Build-Zeit können verschiedene Umgebungsvariablen gesetzt werden, um das Verhalten des Frontends zu beeinflussen.
Backend-URL
Die URL des Backends kann über die Umgebungsvariable VUE_APP_BACKEND_URL gesetzt werden.
Standardmäßig ist die URL auf http://localhost:8080 gesetzt.
Beispiel
VITE_APP_BACKEND_URL=http://localhost:8080
Koffer-Name und Koffer-URL
Die Namen und URLs der Geräte/Koffer können über die Umgebungsvariablen VITE_COSY_DEVICE_LABEL_N und VITE_COSY_DEVICE_URL_N gesetzt werden.
Beispiel
VITE_COSY_DEVICE_LABEL_1=CoSy-Koffer-1
VITE_COSY_DEVICE_URL_1=http://cosy1.example.com
VITE_COSY_DEVICE_LABEL_2=CoSy-Koffer-2
VITE_COSY_DEVICE_URL_2=http://cosy2.example.com