244 lines
6.7 KiB
Markdown
244 lines
6.7 KiB
Markdown
# 🚢 boWave - Schnellstart für Windows
|
||
|
||
## In 2 Schritten zum laufenden System
|
||
|
||
> **🎯 Ziel:** Komplett browser-basiertes Testing - keine zusätzliche Software nötig!
|
||
> Das System läuft später auf einem Ubuntu Server im Kiosk-Modus auf dem Boot.
|
||
|
||
### ✅ Schritt 1: System starten
|
||
|
||
```powershell
|
||
# Option A: Mit make (falls installiert)
|
||
make dev
|
||
|
||
# Option B: Ohne make
|
||
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d
|
||
```
|
||
|
||
**Das startet:**
|
||
- 🎵 Snapserver (Multiroom Audio auf Port 1704, 1705, 1780)
|
||
- 🧭 SignalK mit **Mock NMEA-Daten** (Navigation, GPS, Wetter, Motor, Batterien)
|
||
- 🎶 Mopidy (Musik-Player mit Iris UI)
|
||
- 📺 Dashboard mit Live-Reload auf http://localhost:8090
|
||
- 🔇 4 Boot-Zonen (Salon, Cockpit, Bug, Heck) - alle im Docker
|
||
|
||
**Wichtig:** Alle Services nutzen Mock-Daten - kein echtes Boot nötig!
|
||
|
||
---
|
||
|
||
### 🎵 Schritt 2: Browser öffnen & testen
|
||
|
||
**Alles läuft im Browser - keine Installation nötig!**
|
||
|
||
#### 1️⃣ **Hauptdashboard** (Haupt-UI fürs Boot)
|
||
```
|
||
http://localhost:8090
|
||
```
|
||
- Navigation mit Live-Daten (Kurs, Geschwindigkeit, Tiefe)
|
||
- Audio-Zonen Steuerung
|
||
- Alle Boat-Systeme auf einen Blick
|
||
- **Das ist die UI, die später im Kiosk-Modus auf dem Boot läuft!**
|
||
|
||
#### 2️⃣ **Snapcast Web UI** (Audio-Zonen & Browser-Playback)
|
||
```
|
||
http://localhost:1780
|
||
```
|
||
- Alle 4 Boot-Zonen sichtbar (Salon, Cockpit, Bug, Heck)
|
||
- Lautstärke-Kontrolle für jede Zone
|
||
- Source-Switching (Spotify/AirPlay/Mopidy)
|
||
- **🔊 Audio im Browser abspielen:** Klicke auf "🔊" Symbol → Audio über Web Audio API!
|
||
|
||
#### 3️⃣ **Mopidy Music Player** (Musik-Bibliothek)
|
||
```
|
||
http://localhost:6680/iris/
|
||
```
|
||
- Moderne Player-UI (Iris)
|
||
- Local Files durchsuchen
|
||
- TuneIn Radio (Tausende Sender)
|
||
- Play/Pause/Skip Controls
|
||
|
||
#### 4️⃣ **SignalK** (Navigation Backend)
|
||
```
|
||
http://localhost:3000
|
||
```
|
||
- Login: `admin` / `bordanlage`
|
||
- NMEA 2000 Stream Monitoring
|
||
- WebSocket Delta Stream
|
||
- Real-time Sensor Data
|
||
|
||
---
|
||
|
||
## 📊 Service Übersicht
|
||
|
||
| Service | URL | Beschreibung |
|
||
|---------|-----|--------------|
|
||
| **🎛️ Dashboard** | http://localhost:8090 | **Haupt-UI** - Navigation + Audio (Kiosk-Modus auf Boot) |
|
||
| **🔊 Snapcast Web** | http://localhost:1780 | Audio-Zonen + **Browser-Playback** (Web Audio API) |
|
||
| **🎵 Mopidy/Iris** | http://localhost:6680/iris/ | Musik-Player (Local Files + Radio) |
|
||
| **🧭 SignalK** | http://localhost:3000 | Navigation Backend (Login: admin / bordanlage) |
|
||
| **🎬 Jellyfin** | http://localhost:8096 | Mediathek (Videos, optional) |
|
||
| **🐳 Portainer** | http://localhost:9000 | Docker Management |
|
||
|
||
**💡 Tipp:** Das Dashboard (Port 8090) ist die Hauptoberfläche, die später auf dem Boot im Kiosk-Modus läuft!
|
||
|
||
---
|
||
|
||
## 🎭 Mock-Daten erklärt
|
||
|
||
Das System läuft komplett mit **realistischen Test-Daten**:
|
||
|
||
### 🧭 Navigation (SignalK)
|
||
- GPS Position: Ostsee bei Kiel
|
||
- Geschwindigkeit: 3,5-8 Knoten (schwankt realistisch)
|
||
- Kurs: 200-235°
|
||
- Wassertiefe: 6-25 Meter
|
||
- Windgeschwindigkeit: 8-22 Knoten
|
||
|
||
### ⚡ Elektrik
|
||
- Starterbatterie: 12,2-12,9V
|
||
- Hausbatterie: 24,5-25,6V (2x 12V)
|
||
- Lichtmaschine: 30-60A
|
||
|
||
### 🔧 Motor
|
||
- Drehzahl: 1500-2100 RPM
|
||
- Kraftstoffverbrauch: 10-15 L/h
|
||
- Betriebsstunden: läuft kontinuierlich hoch
|
||
|
||
### 🎵 Audio-Zonen
|
||
- 4 Boot-Zonen (Salon, Cockpit, Bug, Heck) - initial stumm
|
||
- Deine PC-Zone (windows-pc) - wenn du snapclient startest
|
||
- 3 Audio-Quellen: Spotify, AirPlay, Mopidy
|
||
|
||
**Alle Werte ändern sich in Echtzeit und verhalten sich realistisch!**
|
||
|
||
---
|
||
|
||
## 🛑 System stoppen
|
||
|
||
```powershell
|
||
make stop
|
||
```
|
||
|
||
---
|
||
|
||
## 🎧 Audio testen (komplett im Browser!)
|
||
|
||
### Im Browser Audio abspielen:
|
||
|
||
1. **Öffne Snapcast Web UI:** http://localhost:1780
|
||
2. **Wähle eine Zone** (z.B. "zone-salon")
|
||
3. **Klicke auf das 🔊 Symbol** (oben rechts)
|
||
4. **Aktiviere Browser Audio Playback**
|
||
5. **Spiele Musik in Mopidy** → Audio kommt über deinen Browser!
|
||
|
||
**Hinweis:** Das nutzt die Web Audio API - funktioniert in Chrome, Firefox, Edge.
|
||
|
||
### Musik starten:
|
||
|
||
1. **Öffne Mopidy:** http://localhost:6680/iris/
|
||
2. **Klicke auf "Browse"** → "TuneIn" oder "Local Files"
|
||
3. **Wähle einen Sender/Track** und klicke Play
|
||
4. **Audio läuft nun** über Snapcast → Browser Audio
|
||
|
||
---
|
||
|
||
## 🔧 Troubleshooting
|
||
|
||
### Problem: "make: Befehl nicht gefunden"
|
||
|
||
**Kein Problem!** Nutze einfach Docker Compose direkt:
|
||
|
||
```powershell
|
||
# Statt "make dev":
|
||
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d
|
||
|
||
# Statt "make stop":
|
||
docker compose -f docker-compose.yml -f docker-compose.dev.yml down
|
||
|
||
# Statt "make logs":
|
||
docker compose -f docker-compose.yml -f docker-compose.dev.yml logs -f
|
||
```
|
||
|
||
### Problem: Dashboard zeigt keine Daten
|
||
|
||
1. **Prüfe ob alle Container laufen:**
|
||
```powershell
|
||
docker compose -f docker-compose.yml -f docker-compose.dev.yml ps
|
||
```
|
||
|
||
2. **Alle Services sollten "Up" sein**
|
||
- Falls Mopidy restartet: `docker compose logs mopidy`
|
||
|
||
3. **Dashboard lädt Mock-Daten automatisch** (`VITE_USE_MOCK=true`)
|
||
|
||
### Problem: Port 8090 bereits belegt
|
||
|
||
Ändere den Port in `docker-compose.dev.yml`:
|
||
|
||
```yaml
|
||
# Zeile 49:
|
||
ports:
|
||
- "8091:8090" # Nutze 8091 statt 8090
|
||
```
|
||
|
||
Dann: http://localhost:8091
|
||
|
||
---
|
||
|
||
## 📖 Weitere Dokumentation
|
||
|
||
- **Ausführliche Windows-Anleitung:** [WINDOWS_AUDIO_SETUP.md](WINDOWS_AUDIO_SETUP.md)
|
||
- **Mock-Daten Details:** [MOCK_DATA_EXPLANATION.md](MOCK_DATA_EXPLANATION.md)
|
||
- **Projekt-Übersicht:** [README.md](README.md)
|
||
- **Schiffs-Routing:** [SHIP_ROUTING.md](SHIP_ROUTING.md)
|
||
|
||
---
|
||
|
||
## 🚀 Deployment auf Ubuntu Boot-Server (später)
|
||
|
||
Wenn du das System aufs Boot bringen willst:
|
||
|
||
### Ubuntu Kiosk-Modus Setup:
|
||
|
||
```bash
|
||
# 1. Docker installieren
|
||
curl -fsSL https://get.docker.com -o get-docker.sh
|
||
sudo sh get-docker.sh
|
||
|
||
# 2. Repository klonen
|
||
git clone <your-repo> /opt/boWave
|
||
cd /opt/boWave
|
||
|
||
# 3. Production Mode starten
|
||
make boot # Nutzt docker-compose.yml (ohne .dev overlay)
|
||
|
||
# 4. Chromium Kiosk Mode (autostart)
|
||
cat > ~/.config/autostart/kiosk.desktop << EOF
|
||
[Desktop Entry]
|
||
Type=Application
|
||
Name=Boat Dashboard Kiosk
|
||
Exec=chromium-browser --kiosk --noerrdialogs --disable-infobars --disable-session-crashed-bubble http://localhost:8080
|
||
EOF
|
||
```
|
||
|
||
**Unterschiede Boot vs. Dev:**
|
||
- Boot: Port 8080 (Production Build)
|
||
- Boot: Echte Audio-Hardware (`--player alsa --soundcard hw:0,0`)
|
||
- Boot: NMEA Hardware-Anschluss (USB/Serial)
|
||
- Boot: Spotify/AirPlay Discovery über `network_mode: host`
|
||
|
||
---
|
||
|
||
## 🎉 Viel Spaß!
|
||
|
||
Das System ist jetzt **komplett browser-basiert** zum Testen - keine zusätzliche Software nötig!
|
||
|
||
**Was du testen kannst:**
|
||
- ✅ Navigation Dashboard mit Live Mock-Daten
|
||
- ✅ Audio-Zonen Kontrolle (Browser-Playback)
|
||
- ✅ Musik Player (Mopidy/Iris)
|
||
- ✅ Multiroom Audio Synchronisation
|
||
- ✅ Alle UI-Komponenten die später auf dem Boot laufen
|
||
|
||
**Alles läuft wie auf dem Boot - nur ohne echte Hardware!** 🚢⚓
|