Projektregeln und Modul-Anleitungen ergänzen

halloween/instructions.md

@@ -0,0 +1,23 @@
+# Modul `halloween/`
+
+Hier liegt die erste Pi-WebUI. `run.py` im Projektstamm startet sie.
+
+- `camera.py` liefert ein gemeinsames MJPEG-Bild für mehrere Betrachter.
+  `--demo` erzeugt ausdrücklich gekennzeichnete Testbilder; echte Kamera
+  läuft nur über Picamera2 auf dem Pi. Kamerafehler sichtbar melden.
+- `controller.py` enthält bislang ausschließlich die simulierte
+  Effekt-Zustandslogik. Stopp bleibt bis zum Rücksetzen bestehen; nach Start
+  oder Rücksetzen muss erst der Bereich frei sein und dann ein neuer Trigger
+  kommen. Beschädigte Einstellungen schalten auf `aus`.
+- `web.py` bietet WebUI und API; `index.html` ist die Oberfläche. `run.py`
+  bindet an `127.0.0.1`, Zugriff vom Laptop erfolgt per SSH-Tunnel.
+- Der Header `X-Halloween-UI` ist nur eine einfache Schranke für
+  Schreibaufrufe, kein echter Zugangsschutz. Vor Betrieb mit anderen
+  Netzfreigaben Authentifizierung entwerfen und prüfen.
+- Laufzeitdaten liegen standardmäßig unter `data/` und werden weder
+  hochgeladen noch in Git aufgenommen.
+- Echte GPIO-/Aktorsteuerung erst nach geklärter Mechanik, Versorgung,
+  sicherem Stopp und den Hardwaretests aus `PLAN.md` ergänzen.
+
+Bei Änderungen an Zustandsübergängen oder Endpunkten die zugehörigen Tests
+unter `tests/` und die Bedienhinweise in `SOFTWARE.md` prüfen.