Halloween/tests/instructions.md

Modul tests/

Automatische Tests prüfen die aktuelle Software ohne Pi-Hardware.

• test_controller.py prüft Zustandswechsel, Stopp, Neustartvoraussetzungen und gespeicherten Modus mit kontrollierter Uhr und temporären Daten.

• test_web.py prüft Demo-Bild und Webendpunkte über einen ASGI-Client.

• test_event_store.py prüft dauerhafte Ereignisse, Profilzuordnung, Profil-Löschen, 30-Tage-Ablauf und die Erweiterung einer älteren Ereignistabelle.

• Lokal ausführen: python3 -m unittest discover -s tests -v; für Webtests wird zusätzlich requirements-dev.txt benötigt.

• Hardwareverhalten, echte Pi-Kamera, WLAN, SSH-Tunnel und Außeneinsatz nicht aus einem grünen Host-Test ableiten; diese Prüfungen getrennt berichten.

• Tests für neue Sicherheits- oder Zustandsregeln an beobachtbarem Verhalten ausrichten, nicht bloß interne Implementierung spiegeln.

• test_detection.py prüft Linienrichtung, Bestätigung, Flattern, Segmentgrenzen, Gruppenfreigabe, Sperrzeit, Neustart/Änderungen, Fehler-Watchdog, synchrone Frames und Konfigurations-API mit kontrollierter Uhr ohne Modell/Pi.

• Echte NanoDet-Inferenz zusätzlich mit ausdrücklich installiertem Modell prüfen; ein grüner Geometrietest bestätigt keine Erkennungsqualität.

• test_detection_model.py prüft atomare/identische Installation und Ablehnung falscher Downloads ohne Netzwerk. Optional HALLOWEEN_TEST_MODEL auf eine geprüfte ONNX-Datei setzen: Dann wird die echte Inferenz auf leerem Bild geprüft.

• test_pi_update.py prüft echte temporäre Versions-/Datenverzeichnisse mit simuliertem systemd, Python-Paketsetup und HTTP-Ergebnis. Erfolgreichen Wechsel, Start-/HTTP-/Abhängigkeitsfehler, Rückfall samt Daten, alte flache Installation, Erstinstallation und Ablehnung fremder Units/manueller Server prüfen. Kein SSH, kein echter Dienst, kein Netzwerk und keine Hardware in diesen Tests.

• test_motion.py nutzt synthetische JPEGs und optional OpenCV für echten Optical Flow. Vorwärts/gegenläufig/parallel, Pfeilumkehr, gedrehte Geometrie, Bildruhe/Lichtwechsel, Bereichsgrenzen und Bildlücken prüfen. Diensttests prüfen Bestätigung, Sperrzeit, Stopp, Methodenmigration, Persistenz, verworfene alte Inferenzfehler und modellfreie Verarbeitung. Ohne OpenCV werden die Bildtests übersprungen; kein Ersatz für den Nahbereichstest am Pi.

• Nahbereichregression: kleiner 60x60-Bildausschnitt im 640x480-Frame, 2 Pixel Bewegung pro Bild; automatischen Trigger ohne manuelles Bereich-frei und Ablehnung der Gegenrichtung prüfen.

• node tests/test_ui_status.js prüft den echten JS-Statusrenderer isoliert ohne Browser/Netzwerk: automatische Freigabe vs. manuelle Bereich-frei-Flagge, Vorrang von Stopp/Sequenz/Sperrzeit und wirkungslose Betriebsmodi.

• test_event_images.py prüft automatisch zugeordnete JPEGs mit synthetischem Motiv: beschnittener privater Bereich, Dateirechte, Neustart, Migration alter Ereignisse, DB-/Dateifehler, sichere ID-Abrufe, Header für Löschen und Erhalt von Ereignis/Profil. Motion-Test prüft die exakten JPEG-Bytes des Trigger-Frames.

• node tests/test_event_images_ui.js prüft Vorschau/Ansehen und bestätigtes Bildlöschen am echten JS-Renderer mit erfundenen Daten, ohne Browser oder Netz. Abgebrochene Bestätigung löscht nichts; Ereignis bleibt nach Bildlöschung sichtbar.

• Update-Tests verlegen den festen Unitpfad nur in temporären Skriptkopien und simulieren sudo/runuser. Zweiten sudo-Aufruf stets ablehnen, damit Erfolg und Rückfall unabhängig von Passwort-Tickets geprüft werden. Abgelehnte Anmeldung, unprivilegierten Aufruf des internen Rootteils und unveränderte Daten prüfen. Kein echter root-/PAM-/systemd- oder Pi-Nachweis aus diesen Tests.

• UploadConnectionTest simuliert ssh/rsync und prüft genau einen Master, denselben privaten Socket für alle Schritte, BatchMode auf Slaves, TTY für sudo sowie Aufräumen bei Erfolg/Verbindungs-/Transfer-/Aktivierungsfehlern und pure Vorschau. Dies bestätigt keine reale SSH-/Passwortanmeldung am Pi.

• test_follow.py prüft synthetische Farbpunkte (auch Rot um die HSV-Grenze), Mehrdeutigkeit, Bildauswahl, Persistenz ohne Fotos, Pulsgrenzen/Geschwindigkeit, Richtungswechsel, alte Resultate/Sitzungen, Fehler-/Abbruchpfade, API-Interlock und I²C-Protokoll mit künstlichem Bus. Kein echter Pi oder Servo wird angesteuert.

• Follow-Einrichttests prüfen Hold/Release, ablaufende Bewegungslease, verspätete Tastenbefehle, falsche/alte Sitzung, Grenzen jenseits gespeicherter Followwerte, absolute Pulsgrenzen, Richtungsumkehr und persistente Grenze mit Innenabstand.