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.

- `test_pages.py` prüft getrennte Seiten/Poller und unabhängige Grab-/Kamera-
  Bedienung. Vorschau darf parallel zur Automatik laufen; echte Bewegung bleibt
  gesperrt. Globale Abschaltung muss weiterhin beide Bereiche stoppen.

- `node tests/test_endpoints_ui.js` prüft gespeicherte Werte vs. Speicherkandidaten,
  Freigabe der richtigen Seite, Richtungsumkehr und Schutz vor ungefragtem
  Speichern beim Start beziehungsweise alten Min-/Max-Formularwerten.

- Endpunkt-UI-Test zusätzlich: eigene numerische Grenzspeicherung, Erhalt der
  Farb-/Richtungsparameter, Ablehnung von Nachführgrenzen außerhalb des Einrichtbereichs und Startblockade
  bei offenem Eingabeentwurf. Erweiterung des Einrichtbereichs explizit speichern.
- Followtest: alte Konfiguration migrieren ohne Erweiterung; Einrichtgrenzen
  dauerhaft speichern, Jog dort begrenzen, Endpunkt mit Innenabstand übernehmen
  und Nachführung auf gespeicherte Endpunkte begrenzen. Keine echte Hardware.

- Reine Dokumentationspflege: lokale Links/Anker, konsistente Revisionsangaben
  und git diff --check prüfen. Frühere Testzahlen als damaligen Prüfstand
  kennzeichnen; daraus keinen neuen Testlauf oder Pi-Test ableiten.

- Startmitten: asymmetrische persistierte Endpunkte, beide Achsen getrennt,
  halbe µs aufgerundet, Richtungsumkehr, Bereiche außerhalb 1500 und gesperrte
  Achse prüfen. Beide Startmodi nutzen dieselbe Berechnung; Dienstkonstruktion
  bewegt nichts. Endpunktspeichern nutzt festen Sitzungsbezug ohne Bewegung,
  erneuter Start berechnet neu. JS prüft dieselbe Speicherfreigabe.

- Mittelstellungsbutton: gezielte Service-/API-/JS-Tests für langsame Bewegung
  beider Achsen zu den zuletzt gespeicherten Endpunkten, Ziel ohne Überschwingen,
  unveränderte Konfiguration, Sitzungs-/Modussperre, Stopp und alte Sequenzen,
  Richtungsübernahme und Watchdog-Abbruch. Echte Servos bleiben ungetestet.

- Nachführtempo: Altdateien mit 80 µs/s ohne Endpunktänderung migrieren;
  80/400/800 bei 15/20 Auswertungen pro Sekunde, begrenztes Nachholen bei
  Bildlücken und FPS-/Laufzeitanzeige mit künstlicher Uhr prüfen. JS prüft
  ungespeichertes Tempo beim Start und Erhalt beim Endpunktspeichern.
- `test_camera.py` prüft gemessene Producer-FPS und veraltete Frames mit
  künstlicher Uhr. Kein Nachweis der Picamera2-Konfiguration oder Pi-Leistung.

- Suchtests: Opt-in/Altdateimigration, kein Suchen vor Erstfund oder in Vorschau,
  Schwenks mit Achsumkehr innerhalb asymmetrischer Follow-Endpunkte, Tempo,
  gesperrte Achse, endlicher Durchlauf und 60-s-Limit. Zwei aufeinanderfolgende
  Funde, Zwischenverlust, erneute Suche, expliziter Stopp sowie alle Watchdogs
  mit künstlicher Uhr/Treiber prüfen. JS: Suchoption speichern/bei Grenzänderung
  erhalten, Start mit ungespeicherter Option ablehnen. Keine echte Suchfahrt.

- Zielverlust-Wartezustand: drei Minuten ohne Punkt bei gesunder Sitzung ohne
  Bewegungsbefehle, Wiederaufnahme nach zwei Funden, nach Suchende kein weiterer
  Durchlauf bis erneutem Fund. Farbe bleibt nach Halt/Dienstneukonstruktion
  erhalten, neue Farbwahl ersetzt sie. Fehlende Bilder/Heartbeat/Auswertung
  beenden weiterhin Sitzung/PWM; reine Abwesenheit des Punkts nicht.