58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
# GUI Control Panel
|
|
|
|
## Zweck
|
|
Nutzung des Frontend Control Panels zur Steuerung und Beobachtung der Boxen ueber das Backend.
|
|
|
|
## Voraussetzungen
|
|
- Backend laeuft auf `http://127.0.0.1:5001`
|
|
- Frontend gestartet (`cd gui/frontend && npm run dev` oder `./dev.sh`)
|
|
- Box laeuft und meldet sich per Announce beim Backend
|
|
|
|
## Schritt-fuer-Schritt
|
|
1) GUI oeffnen:
|
|
```
|
|
http://127.0.0.1:5174
|
|
```
|
|
2) In "Neue Boxen" die Box auswaehlen und "Pairen" klicken.
|
|
3) In "Gepairte Boxen" eine Box anklicken.
|
|
4) Status und Commands nutzen.
|
|
|
|
## Controls (im GUI vorhanden)
|
|
- Pairen (Button in "Neue Boxen")
|
|
- Statusanzeige (automatisch)
|
|
- Play/Pause, Next, Prev, Vol +/-, Stop
|
|
- NFC on/off (UID eingeben)
|
|
- Unpair (Button in "Gepairte Boxen")
|
|
- Medienkatalog (Explorer-Ansicht, nur Lesen)
|
|
- Neuer Tag erkannt (Panel) mit ID-Zuweisung und Zuordnung
|
|
- Tags werden nur nach NFC-Erkennung erstellt und zugeordnet.
|
|
|
|
## Controls (nur Backend/API)
|
|
- WiFi add/reset
|
|
- Spotify set/clear
|
|
|
|
Beispiel via Backend-API (weitergeleitet an die Box):
|
|
```
|
|
curl -X POST http://127.0.0.1:5001/api/boxes/<box_id>/command \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"command":"wifi_add_profile","payload":{"ssid":"HomeWiFi","password":"secret","priority":10}}'
|
|
```
|
|
|
|
## Erwartete Ergebnisse
|
|
- Nach jedem Klick wird der Status innerhalb von 1s aktualisiert.
|
|
- Fehler werden im GUI angezeigt.
|
|
|
|
## Checkliste
|
|
- ✅ GUI laedt und zeigt Backend-URL
|
|
- ✅ Neue Boxen erscheinen unter "Neue Boxen"
|
|
- ✅ Pairing verschiebt die Box in die gepaarte Liste
|
|
- ✅ Buttons aendern den `/status`
|
|
|
|
## Troubleshooting
|
|
- GUI zeigt "Failed to fetch":
|
|
- Backend erreichbar? `http://127.0.0.1:5001/api/boxes`
|
|
- Browser-Konsole pruefen.
|
|
- Buttons ohne Wirkung:
|
|
- Box gepairt?
|
|
- Backend-Logs pruefen.
|