LumaOps-Public/docs/VERIFICATION.md

Verificatierapport 0.1.0

Dit rapport beschrijft de lokale releasecontrole van LumaOps op 15 juli 2026. De geteste OCI-image is lumaops:0.1.0 voor x86_64 Linux.

Resultaten

• De volledige OpenRGB 1.0rc3 Core compileert in de multi-stage Docker-build.
• Een schone productiecontainer migreert SQLite naar 0001_initial en start gezond met een echte OpenRGB SDK-protocol-5-verbinding.
• De webinterface is op de host uitsluitend gepubliceerd als 1223:8080.
• De SDK-listener is uitsluitend 127.0.0.1:6742; poort 6742 is niet door Docker gepubliceerd. Een rauwe SDK-v5-handshake is succesvol uitgevoerd.
• Het rootfilesystem is read-only. Alleen /config, /data, /logs, /tmp en /run zijn schrijfbaar gemaakt.
• OpenRGB en de backend draaien na de entrypoint als UID 1000 in de rooktest. De runtime-image bevat geen gcc, g++, make, qmake of cmake.
• De ingebouwde container-healthcheck rapporteert healthy.
• Een opgeslagen instelling blijft na een containerrestart aanwezig.
• Na een geforceerde beëindiging van OpenRGB bleef /health/live HTTP 200 geven; de supervisor startte OpenRGB opnieuw en de connector herstelde.
• Een normale containerstop eindigde met exitcode 0 en stopte backend en OpenRGB gecontroleerd.
• Een schone testcontainer met de expliciete mockadapter vond twee apparaten. Set-state, inventarisverversing, scène capture/apply/duplicate/export en het auditlog zijn via de versie-API uitgevoerd.

Geautomatiseerde kwaliteitscontroles

Backend:

ruff format --check .       # 34 bestanden correct geformatteerd
ruff check .                # geslaagd
mypy src                    # 31 bronbestanden, geen fouten
pytest                      # 14 geslaagd

Frontend:

npm run lint                # geslaagd, nul waarschuwingen
npm test                    # 3 geslaagd
npm run build               # TypeScript en Vite geslaagd
npm audit                   # 0 kwetsbaarheden

De productiefrontend gaf HTTP 200. De componenttests dekken onder meer de genormaliseerde inventaris, filtering en de snelle kleuractie via de echte versie-API-contracten.

Compose- en templatecontrole

docker compose config is uitgevoerd voor de standaard-, host-network- en diagnostische varianten. Standaard is alleen hostpoort 1223 gepubliceerd. In host mode luistert de webapp rechtstreeks op 1223. De diagnostische override is bewust privileged en is niet de productieconfiguratie. Het Unraid XML-template is als XML geparseerd en verwijst eveneens naar poort 1223.

Grenzen van deze controle

Er zijn geen fysieke RGB-apparaten of Unraid-hostdevice-nodes aan deze ontwikkelmachine gekoppeld. De echte Core en SDK zijn met nul controllers getest; hardwarewrites zijn uitsluitend tegen de expliciete mockadapter gedaan. Volg daarom vóór productiegebruik de niet-destructieve inventariscontrole uit HARDWARE_ACCESS.md, en test daarna één ondersteund apparaat met een statische kleur en lage commandofrequentie.