ha-ninlight/docs/acceptance.md

Abnahme an echten Lampen

Datum: 2026-09-16. Dev-HA ha-klyqa-pet-dev (HA 2026.9.0), Integration aus ~/workspace/ha-ninlight gemountet, Stand 1026f42. Geprüft an der G95 CW (ninlight-0a16, 192.168.2.122, wifi.source: compiled). Ausgangs-Firmware 0.3.8-36-gca9bb. Sichtprüfungen durch Michael, alle Werte zusätzlich per GET device/state / system/info direkt an der Lampe gegengeprüft.

#	Schritt	Erwartung	Ergebnis
1	Lampe per IP einrichten	Gerätename, Modell, Firmware korrekt	✅ „Klyqa G95 Vintage CW/WW 0a16“, g95_cw, 0.3.8-36-gca9bb, MAC-Verknüpfung; Token-Feld vorbelegt; Reparaturhinweis default_token erscheint
2	GU10 RGB: Farbe, Farbtemperatur	Lampe folgt	⏸ nicht geprüft – keine GU10 zur Hand; RGB-Pfad durch Tests abgedeckt
3	G95: an/aus, Helligkeit, 2000/5000 K, Übergang	kein Farbmodus, Grenzen stimmen	✅ nur color_temp, 2000–5000 K; HA 1 → Lampe 1 % („leuchtet sehr schwach“); 2000 → 5000 K deutlich sichtbar; 5-s-Übergang weich mit ganz leichten Stufen (Fade-Engine der Firmware)
4	Jede Konfigurations-Entität schreiben	Lampe zeigt den Wert	✅ fade_in, fade_out, transition_default, power_on_behaviour, wake_on_change geschrieben und zurückgesetzt; ein POST lief in einen Timeout und wurde als Fehler gemeldet (nicht verschluckt), Wiederholung erfolgreich
5	Neustart-Taste	Lampe startet neu, kommt zurück	✅ uptime 22583 → 3; nach ~4 s zurück; in HA durchgehend verfügbar (Toleranz, siehe unten)
6	Lampe stromlos, dann wieder an	nicht verfügbar, kommt zurück	✅ „nicht verfügbar“ nach 110 s (3 Abfragen), genau eine Fehlerzeile im Log; nach Strom an in 18 s zurück
7	Token an der Lampe ändern	Neuanmeldung erscheint	✅ über Neustart-Taste ausgelöst (401 → „Die Lampe hat das Token abgelehnt“, kein Neustart); Flow weist falsches Token ab (invalid_auth), mit richtigem reauth_successful; Token zurückgesetzt
8	Nur Image ohne Zugangsdaten (0.3.8-38-gd3cc9)	kein Angebot, Hinweis	✅ nicht angeboten; Hinweis wifi_guard mit version/device_type/ssid; verschwindet, wenn die Datei entfernt wird
9	Image mit Zugangsdaten 0.3.8-47-g71a57	Update, Lampe bleibt im WLAN	✅ nach Freigabe durch Michael installiert; 16 s bis zur neuen Version; gleiche IP, Einstellungen erhalten, schaltbar; Geräteregister aktualisiert; URL mit Port (:8124) von der Lampe akzeptiert
10	Neueres GU10-Image im Ordner	nicht angeboten	✅ weder Angebot noch Hinweis

Befunde der Abnahme

1. Ein einzelner Poll-Timeout machte die Lampe bis zu 30 s unbedienbar, HA verwarf Schaltbefehle nur mit Log-Warnung (REST 200). Behoben in 1026f42: erst 3 Fehlschläge in Folge → nicht verfügbar; erfolgreiche Schreibvorgänge machen sofort wieder verfügbar; fehlschlagende Schreibvorgänge melden einen Fehler.
2. Spec §2 lag beim Auth-Verhalten falsch: device/state (GET und POST) ist ohne auth_all offen (gemessen, nl_api.c:395-402). Token verlangen nur system/settings und system/command. Das Token schützt also vor Umkonfigurieren/Neustart/Umflashen, nicht vor Schalten. Reparaturhinweis-Text und README behaupten mehr → Korrektur ausstehend.
3. Übergänge zeigen bei niedriger Helligkeit ganz leichte Stufen – Fade-Engine der Firmware, nicht die Integration.
4. Testumgebung: Docker Desktop leitete Port 8123 nach einem Container-Neustart nur noch über IPv6 (localhost) weiter, nicht über 127.0.0.1 oder die LAN-IP. Für Schritt 9 lief eine Test-Weiterleitung 192.168.1.131:8124. Die Timeouts traten bei Lastmittel 300–550 auf dem Mac auf (auch bei einem Klyqa-Gerät zeitgleich).
5. last_ota_error ohne Fehler wird als „unbekannt“ angezeigt (Ruling: HA-üblich).