README.md aktualisiert

README.md

@@ -127,48 +127,64 @@ Wichtig: Die API laeuft im Container intern auf Port `8080`, wird aber nach auss
 
 ## Schnellstart mit Docker Compose
 
+Du solltest WSL installiert haben. 
+Falls du das nicht hast:
+```powershell
+ wsl --install Ubuntu 
+```
+Dann kannst du Docker Desktop installieren:
+    https://docs.docker.com/desktop/setup/install/windows-install/
+Die Installation einfach durchklicken und wenn du gefragt wirst ob du Hyper-V oder WSL verwenden möchtest, wähle WSL.
+
+
 ### 1. Repository vorbereiten
 
+Wenn du git auf deinem rechner installiert hast, dann öffne eine Powershell in dem Ordner, in dem du das LTD-System haben willst.
+(rechtsklick im Windowsexplorer ins leere --> "In Terminal öffnen")
 ```powershell
-cd C:\Projects\SeLTD
+git clone https://git.portal.se-cloud.de/Hannes/SE-LTD
-copy .env.example .env
+cd ./SeLTD
 ```
+Powershell nicht schließen, brauchst du gleich noch.
 
-Passe danach mindestens diese Werte an:
-
-```env
-JWT_SECRET=bitte-langen-zufaelligen-wert-setzen
-ADMIN_USERNAME=admin
-ADMIN_PASSWORD=ChangeMe123!
-MARIADB_ROOT_PASSWORD=SE3112
-CORS_ORIGIN=http://localhost:5173
-VITE_API_PORT=18080
-```
 
 ### 2. Stack bauen und starten
 
-```powershell
+Falls du Powershell geschlossen hast:
-docker compose up -d --build
+(rechtsklick im Windowsexplorer ins leere --> "In Terminal öffnen")
-```
-
-Bei groesseren Aenderungen am Code oder wenn der Browser alten Code anzeigt:
 
 ```powershell
-docker compose down
 docker compose build --no-cache web api collector
-docker compose up -d
+docker compose up -d --force-recreate
 ```
+Die lokalen Images werden jetzt gebaut und die Onlineimages werden heruntrergeladen.
+Wenn das fertig ist müssen alle 7 Container gestartet sein.
+
+Im Nachgang kannst du dies in der Powershell mit...
+```powershell
+docker ps -a
+```
+...überprüfen
 
 ### 3. Aufrufen
-
+Nun stehen dir mehrere Tools zur Verfügung:
-| Anwendung | URL |
-| --- | --- |
 | Frontend | `http://localhost:5173` |
-| API Healthcheck | `http://localhost:18080/api/health` |
+--> Das ist die normale Weboberfläche zum anschauen, editieren und anpassen von Trends.
-| Collector Healthcheck | `http://localhost:18110/health` |
-| Dockhand | `http://localhost:3000` |
-| cAdvisor | `http://localhost:9090` |
 
+| API Healthcheck | `http://localhost:18080/api/health` |
+--> hier kannst du schauen ob die API läuft
+
+| Collector Healthcheck | `http://localhost:18110/health` |
+--> hier kannst du schauen ob der Collector läuft, was nur wichtig ist, wenn du Datenpunkte per OPC,KNX, Modbus oder Bacnet angebunden hast.
+
+| Dockhand | `http://localhost:3000` |
+--> Dockhand ist Container verwaltungstool, dass es dir ermöglicht, auch grafisch den Zustand deiner Container und deines Stacks zu sehen.
+    Der Vorteil hier, im Gegensatz zur normalen Docker Desktopoberfläche: Du kannst es auf jedem beliebigen anderen Rechner, der auf dein Netzwerk zugriff hat, öffnen.
+    
+| cAdvisor | `http://localhost:9090` |
+--> Cadvisor stellt alle Containerdaten für Monitoring und Analyticprogramme bereit. 
+    So kann bei einer größeren Anlage, das Dockersystem mitr Prometheus oder ähnlichem überwacht werden.
+    Cadvisor stellt di Daten per html bereit, kannst du dir gern anschauen, ist aber ziemlich unübersichtlich.
 ### 4. Standard-Login
 
 ```text