From 9c325dbff3a1a2fe6d274711205be78c9e9a2f7d Mon Sep 17 00:00:00 2001
From: Joachim Hummel <jh@unixweb.de>
Date: Mon, 1 Jun 2026 14:51:36 +0200
Subject: [PATCH] .env.example mit dokumentierten Platzhaltern hinzugefuegt

Vorlage fuer die lokale .env (alle 16 Env-Variablen erklaert, nur
generische Platzhalter/Defaults). 'cp .env.example .env' zum Start.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .env.example | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..6f46bd6
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,46 @@
+# ===========================================================================
+# Beispiel-Konfiguration fuer den Vehicle-Counter
+# ---------------------------------------------------------------------------
+# 1. Diese Datei nach ".env" kopieren:   cp .env.example .env
+# 2. Werte an die eigene Umgebung anpassen.
+# Die .env wird beim Start automatisch geladen (python-dotenv) und ist per
+# .gitignore vom Repository ausgeschlossen.
+# ===========================================================================
+
+# --- Kamera / Livestream ---------------------------------------------------
+# MJPEG-Stream der ESP32-CAM (oder einer anderen HTTP-Stream-Quelle).
+export CAMERA_URL="http://CAMERA-IP:81/stream"
+# Frei waehlbare Kennung der Kamera (taucht in den MQTT-Events auf).
+export CAMERA_ID="meine-kamera"
+
+# --- Inferenz-Tuning -------------------------------------------------------
+# Modell fuer den Webcam-/Livestream-Pfad (Nano = schnell).
+export WEBCAM_MODEL="yolo11n.pt"
+# Eingabegroesse fuer YOLO. Kleiner = schneller, groesser = genauer.
+export YOLO_IMGSZ=480
+# Motion-Gate: ab so vielen veraenderten Pixeln laeuft YOLO ueberhaupt.
+export MOTION_PIXELS=500
+# 24/7-Zaehlung auch ohne Zuschauer: 1 = an, 0 = nur bei aktivem Viewer.
+export GRABBER_ALWAYS_ON=0
+# FP16-Inferenz. Leer lassen = automatisch (an bei CUDA-GPU, sonst aus).
+#export YOLO_HALF=1
+
+# --- MQTT (optional) -------------------------------------------------------
+# Komplett abschaltbar: "false" -> App laeuft ohne Broker, sendet keine Events.
+export MQTT_ENABLED="true"
+# Adresse + Port des MQTT-Brokers (z. B. Mosquitto).
+export MQTT_HOST="127.0.0.1"
+export MQTT_PORT=1883
+# Zugangsdaten nur setzen, wenn der Broker Authentifizierung verlangt.
+#export MQTT_USER="user"
+#export MQTT_PASS="passwort"
+# Basis-Topic. Events laufen auf <TOPIC>/crossing, Status auf <TOPIC>/status.
+export MQTT_TOPIC="vehiclecounter/meine-kamera"
+
+# --- Sonstiges -------------------------------------------------------------
+# Zeitzone fuer die Zeitstempel der Events.
+export TZ_NAME="Europe/Berlin"
+# Flask-Secret. Fuer den Produktivbetrieb unbedingt aendern!
+export SECRET_KEY="bitte-aendern"
+# Speicherort der persistierten Zaehllinie.
+export LINE_FILE="counting_line.json"