Usage de

Sprache: Deutsch | English

Verwendung

Shot-Archiv

1. Add-on starten und Dashboard über Web-Oberfläche öffnen aufrufen
2. Shots erscheinen nach dem ersten Sync in der Seitenleiste
3. Shot anklicken → Profil-Ansicht mit Chart und allen Messwerten
4. ⇄-Button → Vergleichsmodus (Shot B aus der Sidebar wählen)
5. Notizen-Panel unterhalb des Charts → Daten eingeben und Speichern klicken
6. ⤢-Button → Vollbild-Chart (dreht automatisch auf Querformat auf Mobile)
7. ‹-Button → Sidebar einklappen für mehr Chart-Platz (Desktop)

Live-Modus

1. Tab Live oben im Dashboard anklicken
2. Sobald der Brew-Switch aktiv ist, startet die Echtzeit-Anzeige automatisch
3. Stat-Boxen und Chart aktualisieren sich sekündlich direkt vom Controller
4. Shot-Timer tickt smooth alle 100ms (client-seitig, re-synchronisiert mit Maschinendaten pro Poll)
5. Nach Ende des Bezugs wird der vollständige Shot automatisch synchronisiert

Der Live-Modus fragt /api/system/status direkt ab — nicht über HA-Sensoren. Brew-Start-Erkennung ist sofort.

Datenquellen Live-Modus

Feld	Quelle	Endpunkt
Brew-Switch	Gaggiuino direkt	/api/system/status → brewSwitchState
Druck	Gaggiuino direkt	/api/system/status → pressure
Temperatur	Gaggiuino direkt	/api/system/status → temperature
Gewicht / Fluss	Gaggiuino direkt	/api/system/status → weight
Auto-Sync	HA-Sensor (optional)	sensor.gaggiuino_latest_shot_id

Notizen

Feld	Hinweis
Kaffee / Bohne	Autocomplete aus der Kaffee-Bibliothek
Mühle	Autocomplete aus der Kaffee-Bibliothek
Dosis (g)	Erforderlich für Ratio- und EY-Berechnung
Röstdatum	Automatisch aus Bibliothek; für Frische-Badge
TDS %	Erforderlich für EY-Berechnung

Extraction Yield (EY)

EY = (Bezugsgewicht × TDS %) / Dosis

Farbe	Bereich	Bedeutung
Grün	18–22 %	Optimale Extraktion
Gelb	16–17 % oder 23–24 %	Leichte Unter-/Überextraktion
Rot	< 16 % oder > 24 %	Deutliche Unter-/Überextraktion

Shots löschen

Was gelöscht wird	Ergebnis
Älterer Shot (nicht der neueste)	Sicher — bleibt gelöscht
Neuester Shot (höchste ID)	Kommt beim nächsten Sync zurück