Claude: Dokumentation

2026-06-06 13:12:18 +02:00
parent 2997fb67f7
commit 92b17b18be
6 changed files with 351 additions and 287 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,65 @@
+# AppRobotWebcam
+
+Webcam-Service für den AppRobot. Liefert Live-MJPEG-Streams und HD-Standbilder
+über einen einzelnen HTTP-Port — als Docker-Container, ohne externe Streaming-Server.
+
+## Was es tut
+
+| | |
+|---|---|
+| **Live-Stream** | MJPEG multipart im Browser `<img>`, ~139 ms Latenz |
+| **HD-Snapshot** | Ein JPEG pro Kamera auf Knopfdruck oder per HTTP GET |
+| **Snapshot alle** | Alle Kameras parallel in einem Schritt |
+| **REST-API** | Kameraliste, Snapshots, Streams — für andere Container nutzbar |
+
+## Kameras (aktuell)
+
+| ID | Modell | Live | HD-Grab |
+|---|---|---|---|
+| cam0 | Logitech C270 | 640×480 | 1280×960 |
+| cam1 | Logitech C270 | 640×480 | 1280×960 |
+| cam2 | Logitech C920 | 640×480 | 1920×1080 |
+
+Konfiguration ausschliesslich über `cameras.json` — kein Redeploy bei Kamera-Änderungen.
+
+## Zugriff
+
+```
+http://<host>:8444/                          Viewer
+http://<host>:8444/api/stream/cam0           Live-MJPEG
+http://<host>:8444/api/snapshot/cam0         640er JPEG
+http://<host>:8444/api/snapshot/cam0/hires   HD-JPEG
+http://<host>:8444/api/cameras               Kamera-Metadaten (JSON)
+http://<host>:8444/health                    Status
+```
+
+## Deploy (Portainer)
+
+1. Portainer → Stacks → Web editor → `docker-compose.yaml` einfügen
+2. `APP_PATH` auf den absoluten Pfad des Projektverzeichnisses setzen
+3. Deploy — der Container baut sich selbst (Node + FFmpeg)
+
+```yaml
+# Minimal-Konfiguration:
+APP_PATH=/home/user/appRobotWebcam
+```
+
+## Architektur
+
+```
+cameras.json → server.js → CameraSwitch (/dev/videoN)
+                                ├── Live: ffmpeg → MJPEG → Browser
+                                └── Grab: Live stoppen → hires → zurück
+```
+
+Ein FFmpeg pro Kamera, nie zwei gleichzeitig. Das `close`-Event ist der harte Beweis
+„Gerät frei" — kein Race, kein 106%-CPU-Bug (der mit go2rtc aufgetreten war).
+
+## Dokumentation
+
+| Datei | Inhalt |
+|---|---|
+| `doc/01_WebcamRoadmap.md` | Ziel, Architektur, Entwicklungsgeschichte |
+| `doc/05_screenShot_roadmap.md` | HD-Grab, Encode-Qualität, Kamera-Eigenheiten |
+| `doc/07_multipleCam_roadmap.md` | cameras.json-Referenz, Multi-Kamera-Setup |
+| `doc/09_Bug_reports.md` | Bug-Dokumentation |