Upload

docs/dev-workflow.md

@@ -1,22 +1,22 @@
-# Dev Workflow
+# Dev-Workflow
 
-## Purpose
-How to start/stop the virtual box, how to access logs, and how to point the GUI to the API.
+## Zweck
+Start/Stop der virtuellen Box, Logs, und GUI-API-Konfiguration.
 
-## Prerequisites
+## Voraussetzungen
 - Python 3
 - Node.js + npm
-- Run from repo root
+- Aus dem Repo-Root ausfuehren
 
-## Step-by-step
-### Start everything (recommended)
+## Schritt-fuer-Schritt
+### Alles starten (empfohlen)
 ```
 ./dev.sh
 ```
-- GUI runs in the background
-- Box runs in the foreground (you can type CLI commands)
+- GUI laeuft im Hintergrund.
+- Box laeuft im Vordergrund und akzeptiert CLI-Kommandos.
 
-### Start separately
+### Komponenten separat starten
 Box only:
 ```
 python3 box/main.py run
@@ -28,34 +28,36 @@ npm run dev
 ```
 
 ## Ports / Hosts
+- Server API + GUI: `http://127.0.0.1:7000` (GUI unter `/ui`)
 - Box API: `http://127.0.0.1:8000`
 - Setup UI: `http://127.0.0.1:9000/setup`
 - GUI: `http://127.0.0.1:5174`
 
-## API URL for GUI
-Default is `http://localhost:8000`. Override with:
+## API-URL fuer die GUI
+Default ist `http://localhost:8000`. Override:
 ```
 VITE_BOX_API_URL=http://127.0.0.1:8000 npm run dev
 ```
 
-## Logs
-- Box logs appear in the same terminal where you run `python3 box/main.py run`.
-- GUI logs appear in the browser console.
+## Logs ansehen
+- Server-Logs: Terminal mit `python3 server/main.py`
+- Box-Logs: Terminal mit `python3 box/main.py run`
+- GUI-Logs: Browser-Konsole
 
-## Stop / Cleanup
-- Press `Ctrl+C` in the terminal where the box is running.
-- `dev.sh` will also stop the GUI process.
+## Sauber beenden
+- `Ctrl+C` im Box-Terminal.
+- `dev.sh` beendet die GUI automatisch.
 
-## Checklist
-- ✅ Run `./dev.sh`
-- ✅ Box shows interactive prompt
-- ✅ GUI loads in browser
-- ✅ `curl http://127.0.0.1:8000/status` returns JSON
+## Checkliste
+- ✅ `./dev.sh` gestartet
+- ✅ Box-CLI Prompt sichtbar
+- ✅ GUI im Browser erreichbar
+- ✅ `curl http://127.0.0.1:8000/status` liefert JSON
 
 ## Troubleshooting
-- Port already in use:
-  - 8000 or 9000: stop other processes, or change ports in `box/main.py`.
-- CORS error in browser:
-  - Ensure API is running; CORS is already enabled in the Box API.
-- GUI shows "Failed to fetch":
-  - Check `VITE_BOX_API_URL` and Box API port.
+- Port belegt:
+  - 8000/9000: andere Prozesse beenden oder Ports in `box/main.py` aendern.
+- CORS-Fehler:
+  - API muss laufen und erreichbar sein.
+- GUI zeigt "Failed to fetch":
+  - `VITE_BOX_API_URL` pruefen.