added point mode

PLAN.md

@@ -1,5 +1,29 @@
 # Halloween – Projektregeln
 
+## Verdrahtungsplan vom 15. Oktober 2026
+
+- Erledigt: dauerhafte Anschlussliste [VERDRAHTUNG.md](VERDRAHTUNG.md) und
+  [Zeichnung](VERDRAHTUNG.svg) für Pi 5, Kamera und zwei Kameraservos angelegt.
+  Kabelkennungen W01–W13; geplante Belegung CH0=PAN, CH1=TILT.
+- Nutzerstand: Schwenkarm gekauft, Kameraadapter wird gedruckt; Nutzer nennt
+  Amazon B07KPS9845 als Servos. Genaue Servodaten nicht unabhängig bestätigt.
+- Dokumentarisch geprüft: Pi-/PCA9685-Verbindung gegen Herstellerreferenzen,
+  getrennte Logik-/Servoversorgung und gemeinsame Masse beschrieben.
+  Keine praktische Verdrahtungs- oder Bewegungsprüfung erfolgt.
+- Per Nutzerfoto bestätigt und lokal abgelegt: PCA9685 mit 16 Kanälen;
+  gelbe Reihe PWM, rote V+, schwarze GND; Plan um das Boardfoto ergänzt.
+- Revision 4: große Pi-Pinübersicht [RASPI_PINS.svg](RASPI_PINS.svg) mit
+  eindeutiger Draufsicht und vergrößerten ersten drei Pinpaaren ergänzt.
+- Revision 3: W01 Grün, W02 Blau, W03 Braun, W04 Grau passend zu den
+  Nutzerkabeln in Anschlussliste und Zeichnung dokumentiert.
+- Offen: Klemmenpolung und Kanalposition am Board, Servotyp/Kabelfarben, geeignetes
+  Servonetzteil und Polung, benutzter Kameraport, I²C-Adresse, Winkelgrenzen
+  und Lasttest. Entwurf noch keine bestätigte Steckanleitung für D1.
+- Offen: echte Kameraservosteuerung und sichere Start-/Fehlerabschaltung;
+  Handservo, Relais/Motor und Beleuchtung später im selben Plan ergänzen.
+- Pflege: nach jeder tatsächlichen Anschlussänderung Liste, Zeichnung und
+  Prüfprotokoll gemeinsam aktualisieren; Kabel an beiden Enden beschriften.
+
 ## Ziel und aktueller Auftrag
 
 Interaktives atmendes Grab für Halloween im Vorgarten der Schwester bauen.
@@ -331,3 +355,44 @@ Bildsequenzen eines Blender-Schnittprojekts bei Weitergabe mitnehmen.
   Aufräumen bei Erfolg/Fehler. Ohne Schlüssel sind SSH und sudo zwei Anmeldungen.
 - Lokal verifiziert: 15 Update-/Transport-Simulationstests bestanden, keine
   Verbindung/Socketerzeugung bei Vorschau. Echte Passwortanzahl am Pi noch offen.
+
+
+## Farbpunktnachführung vom 15. Oktober 2026
+
+- Nutzerauftrag: Kameramodus zum Verfolgen eines Fingers beziehungsweise farbigen
+  Punkts, eventuell mit Beispielfoto. Umgesetzt als Farbpunkt-Test, keine
+  Finger-/Handerkennung und kein trainiertes Modell.
+- Erledigt: Rot/Grün oder Farbwahl im flüchtigen Kamerafoto; eigener synchroner
+  Bildbereich, Vorschau ohne I²C; bewusst gestartete CH0/CH1-Ausgabe mit enger
+  Pulsbegrenzung, Totzone, Richtungsumkehr und begrenzter Geschwindigkeit.
+- Erledigt: kein gleichzeitiger Automatikbetrieb; Controller bleibt gestoppt.
+  Stop/Reset, Heartbeatverlust, Bild-/Auswertungsfehler und Marker-Verlust
+  beenden Hardware-Sitzung; Konfiguration bleibt erhalten, Aktivierung nicht.
+- Nutzer meldet Verdrahtung fertig; derzeit separate Powerbank, die bereits
+  zwei Servos betrieben hat. Modell/Stromreserve und Leitungsstärke offen.
+- Verifiziert lokal: synthetische Bild-/Regelungs-/Fehler-/API-Tests und
+  künstlicher I²C-Bus; Browserdemo prüft Farbwahl, Vorschau, Stopp, Beispielfoto.
+  Vollsuite: 84 Tests, davon 69 bestanden und 15 wegen fehlendem optionalem
+  OpenCV/Modell übersprungen; beide bisherigen JS-UI-Tests und JS-Syntaxprüfung
+  bestanden. Keine echte Bewegung, kein Upload am Pi erfolgt.
+- Offen am Pi: Upload, I²C/Berechtigung/Adresse, entkoppelte 1500-µs-Zentrierung,
+  Drehrichtungen und Grenzen, Stromreserve, Nachführung mit echter NoIR-Kamera.
+- Offen: unabhängige OE-/Hardwareabschaltung. PWM-Aus bei funktionierendem I²C
+  ist keine Stromtrennung und schützt nicht vor hartem Prozess-/Pi-Ausfall.
+
+
+## Manueller Kameraeinrichtmodus vom 15. Oktober 2026
+
+- Nutzerauftrag: Endpunkte ermitteln, insbesondere Neigung manuell stoppen;
+  keine Endschalter vorhanden. Keine automatische Fahrt gegen Anschläge umgesetzt.
+- Erledigt: eigene Einrichtsitzung, große Richtungstasten mit Haltefunktion,
+  sichtbare Sollwerte und gespeicherte Grenzen; Richtungsumkehr konsistent.
+  40 µs/s, Bewegungslease 0,35 s, Sequenzen gegen verspätete Befehle; Loslassen
+  hält Position, Kamerastopp beendet PWM. Grenzspeicherung mit 10 µs Innenabstand.
+- Lokal geprüft: synthetische Hardware-/Lease-/Persistenztests; Browserdemo
+  mit gedrückter Taste, anschließend unveränderter Sollposition und Speicherung.
+  Keine echte Bewegung, kein Upload und keine Bestätigung realer Endpunkte.
+- Offen am Pi: Mittelstellung, Drehrichtungen, sichere mechanische Grenzen und
+  Loslassen/Stopp bei echtem Aufbau prüfen. Beide Achsen vor Anschlag stoppen.
+- Abschlussprüfung lokal: 87 Python-Tests, davon 72 bestanden, 15 optionale
+  OpenCV-/Modelltests übersprungen. Bisherige JS-Tests und JS-Syntaxprüfung bestanden.