Gitea-Veröffentlichung und Projektübersicht vorbereiten

README.md

@@ -0,0 +1,36 @@
+# Halloween: interaktives atmendes Grab
+
+Raspberry-Pi-Projekt für eine Halloween-Grabattrappe mit Kamera,
+Weboberfläche und geplantem Effektablauf.
+
+Die erste Softwareversion bietet ein Picamera2-Livebild, einen Demo-Feed,
+gespeicherte Moduswahl, einen simulierten Effektablauf sowie eine lokale
+SQLite-Datenbank für Testereignisse und manuell zugeordnete Profile.
+GPIO-Steuerung, automatische Personenerkennung und Aufnahme von Clips
+sind noch nicht umgesetzt. Die echte Kamera und die Aktoren sind noch
+nicht praktisch geprüft.
+
+## Lokal ohne Hardware starten
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install -r requirements.txt
+.venv/bin/python run.py --demo
+```
+
+Danach `http://127.0.0.1:8000` öffnen. Das Bild ist synthetisch und als
+Demo gekennzeichnet. Die WebUI bindet ausschließlich an `127.0.0.1`.
+Für den Zugriff auf einen Pi ist ein SSH-Tunnel vorgesehen.
+
+## Dokumentation
+
+- [Software, Pi-Einrichtung und lokale Prüfungen](SOFTWARE.md)
+- [Projektdateien auf den Pi übertragen](UPLOAD.md)
+- [Arbeitsplan, Hardwarestand und offene Entscheidungen](PLAN.md)
+- [Blender-Konzeptvorschau](preview/README.md)
+- [Projektregeln](AGENTS.md)
+
+Code, Planung und bearbeitbare Blender-Szenen werden versioniert.
+Laufzeitdaten unter `data/`, `.venv`, Referenzclips und gerenderte
+Bilder/Videos bleiben lokal. Die Blender-Vorschau ist eine Simulation;
+einige Schnittprojekte benötigen zusätzlich die lokal erzeugten Bildsequenzen.