From 57ffd1dda620272aa657a05e30b0531c20657d56 Mon Sep 17 00:00:00 2001
From: Pino <pino@it-s-center.de>
Date: Thu, 11 Jun 2026 00:12:12 +0200
Subject: [PATCH] DOC-QUALITY-001: Quickstart, ENV-Doku und Tests beschreiben

---
 .env.example |  2 ++
 README.md    | 38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..f6be041
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,2 @@
+SILLYHOME_HA_URL=http://homeassistant.local:8123
+SILLYHOME_HA_TOKEN=REPLACE_ME_WITH_LONG_LIVED_TOKEN
diff --git a/README.md b/README.md
index e983512..7165428 100644
--- a/README.md
+++ b/README.md
@@ -12,3 +12,41 @@ TheSillyHome zeigte die Idee: statt statischer Regeln das Zuhause aus Verhaltens
 - Automationen vorschlagen und direkt generieren
 - Lokal-first ohne Cloudpflicht
 - Erweiterbar, testbar, dokumentiert
+
+## APPENDIX
+
+### Quickstart
+1. Python-Venv anlegen und Abhängigkeiten installieren:
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+2. Konfiguration aus `.env.example` übernehmen und anpassen:
+```bash
+cp .env.example .env
+```
+
+3. API starten:
+```bash
+uvicorn app.main:app --reload
+```
+
+4. Erreichbar unter:
+- `http://127.0.0.1:8000/health` - Health-Check
+- `http://127.0.0.1:8000/docs/` - OpenAPI-Dokumentation
+- `http://127.0.0.1:8000/v1/entities` - Home-Assistant-Entities
+
+### ENV-Konfiguration (`.env.example`)
+- `SILLYHOME_HA_URL` – Basis-URL deiner Home-Assistant-Instanz (z. B. `http://homeassistant.local:8123`)
+- `SILLYHOME_HA_TOKEN` – Long-Lived Access Token aus Home Assistant (nur lesen)
+
+Hinweis: Nutze ausschließlich Long-Lived Access Tokens mit Leserechten. Niemals Administrator-Tokens oder Passwörter eintragen. `.env` gehört nicht in Versionskontrollsysteme.
+
+### Tests
+```bash
+pytest -q
+ruff check .
+mypy app tests
+```
\ No newline at end of file