Add documentation, manual and screenshots preview

TROUBLESHOOTING.md

@@ -0,0 +1,74 @@
+# Troubleshooting
+
+All rights reserved - Thomas / TuxiNet
+
+## OLA kan ikke se USB
+
+- Bekræft `lsusb`, `systemctl status olad` og at korrekt OLA-plugin er aktivt.
+- Genstart OLA før du genpatcher porten i UI.
+
+## Permission denied på `/dev/ttyUSB*`
+
+- Sørg for at `tuxdmx` er medlem af `dialout` og `plugdev`.
+- Bekræft udev-rettigheder eller device-ejerskab.
+
+## Ingen DMX-output
+
+- Bekræft universe, port og fixtureaddress.
+- Kontroller, at blackout ikke er aktiv.
+- Se DMX monitor for current/target/source.
+
+## Flimren
+
+- Reducér frame rate til 25 eller 30 fps.
+- Kontroller at ingen overliggende effekt skriver LTP/HTP utilsigtet.
+
+## Web UI virker ikke
+
+- Kontroller `tuxdmx.service`.
+- Brug `/api/v1/health` og se browser-konsol for WebSocket-fejl.
+- Kør `systemctl status tuxdmx.service --no-pager --full`.
+- Kør `journalctl -u tuxdmx.service -n 200 --no-pager`.
+
+## Frontend-build eller pnpm fejler
+
+- Kontroller `node --version` og bekræft Node 20.
+- Kontroller `pnpm --version` og bekræft `10.28.2`.
+- Kontroller at `package.json` har `packageManager: pnpm@10.28.2`.
+- Hvis build skal genbruges fra en CI-artefakt, brug `--skip-frontend-build` kun naar `frontend/dist/index.html` allerede findes.
+
+## No module named `app`
+
+- Kontroller at backend er landet som `/opt/tuxdmx/backend/app`.
+- Kontroller `test -f /opt/tuxdmx/backend/app/main.py`.
+- Kør importtesten som servicebrugeren:
+  `sudo -u tuxdmx /opt/tuxdmx/.venv/bin/python -c "import sys; sys.path.insert(0, '/opt/tuxdmx/backend'); import app.main"`
+
+## PermissionError på `frontend/dist` eller `data/backups`
+
+- Installeren normaliserer rettigheder til `root:tuxdmx` for appkode og `tuxdmx:tuxdmx` for runtime-data.
+- Kontroller `sudo -u tuxdmx test -r /opt/tuxdmx/frontend/dist/index.html`.
+- Kontroller `namei -l /opt/tuxdmx/frontend/dist/index.html`.
+
+## MixItUp timeout
+
+- Bekræft at endpointet returnerer `202 Accepted`.
+- Kontroller rate limiting, token og netværksrute.
+
+## BPM finder forkert tempo
+
+- Justér BPM-range og half/double.
+- Brug syntetiske click tracks for at isolere lydinputproblemer.
+
+## Databasefejl
+
+- Kontroller diskplads og SQLite WAL-filer.
+- Kør backup før restore eller manuel reparation.
+- Kontroller at `tuxdmx` kan skrive til `/var/lib/tuxdmx`.
+- Kontroller `sqlite3 /var/lib/tuxdmx/tuxdmx.db "PRAGMA integrity_check;"`.
+
+## OLA kan ikke importeres i virtualenv
+
+- Virtualenv skal oprettes med `python3 -m venv --system-site-packages /opt/tuxdmx/.venv`.
+- Kontroller:
+  `sudo -u tuxdmx /opt/tuxdmx/.venv/bin/python -c "import ola; print(ola.__file__)"`