demo showcase README.md

README.md

@@ -53,6 +53,31 @@ Läuft als Docker Container, pollt periodisch einen privaten Google Calendar ICS
    docker compose up -d
    ```
 
+## Demo / Lokaler Test (ohne Docker)
+
+Schneller Weg um Web-UI und API lokal zu testen, ohne MariaDB oder Docker:
+
+```bash
+./demo.sh
+```
+
+Das Script erstellt eine virtuelle Python-Umgebung, installiert Dependencies, legt eine SQLite Demo-Datenbank mit 4 Beispiel-Terminen an und startet die API auf Port 8000.
+
+**Endpoints:**
+- Web-UI: http://localhost:8000/
+- API JSON: http://localhost:8000/api/events
+- Health: http://localhost:8000/api/health
+
+**Demo-Events (4 Stück):**
+| Termin | Zeit | Status |
+|--------|------|--------|
+| Team Daily | heute 14:00–15:00 | CONFIRMED |
+| Yoga Kurs | heute 18:30–20:00 | CONFIRMED |
+| Projekt-Deadline | morgen Ganztag | TENTATIVE |
+| Arzttermin | übermorgen 10:00–11:30 | CONFIRMED |
+
+Die Demo verwendet SQLite (`DB_BACKEND=sqlite`) statt MariaDB. Die Events werden relativ zum heutigen Datum erstellt.
+
 ## Konfiguration
 
 | Variable | Default | Beschreibung |