kamera geht

halloween/instructions.md

@@ -35,3 +35,21 @@ Hier liegt die erste Pi-WebUI. `run.py` im Projektstamm startet sie.
 
 Bei Änderungen an Zustandsübergängen oder Endpunkten die zugehörigen Tests
 unter `tests/` und die Bedienhinweise in `SOFTWARE.md` prüfen.
+
+## Personendetektion
+
+- `detection.py` wertet den gemeinsamen Kamerastream mit OpenCV DNN/NanoDet aus.
+  Optionales Modell und OpenCV fehlen im Demo-Grundsetup bewusst. Kein Download
+  im Server; geprüfte Modellmetadaten in `nanodet-model.json`.
+- Nur neue, zeitlich gültige Frames auswerten. Hintergrundinferenz hält keine
+  UI-/Zustandssperre; separater Watchdog sperrt aktivierte Automatik nach zwei
+  Sekunden ohne gültiges Ergebnis. Fehler verlangen bewusstes Rücksetzen.
+- Linienüberquerung nutzt bestätigte flüchtige Tracks und Fußpunkte, Richtung,
+  endliches Segment und 3-%-Hysterese. Gruppen verlangen freien Bereich und
+  Sperrzeit; Konfigurations-/Controllerwechsel verwerfen alte Beobachtungen.
+- `/api/detection` liefert synchrones Bild und Rahmen; `/api/detection/config`
+  speichert normierte Geometrie und Aktivierung unter `data/`. Erste Aktivierung
+  ist bewusst, nach Neustart immer neue Bereichsfreigabe. UI zeichnet/editiert
+  mit Canvas; keine Tracking-ID als Besucherprofil verwenden.
+- Automatische Ereignisse tragen `person_line_crossing`, ohne Profilzuordnung.
+  Die vorhandene Steuerung bleibt ausschließlich simuliert.