From 5537f491034efcce79418c37915c2c898251748e Mon Sep 17 00:00:00 2001
From: Hermes Agent <hermes@v2202605360184461552.supersrv.de>
Date: Mon, 22 Jun 2026 10:51:21 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20Alicia=20lokale=20Test-Umgebung=20?=
 =?UTF-8?q?=E2=80=94=20venv,=20pip,=20ruff,=20mypy,=20pytest?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/alicia-setup.md | 56 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 docs/alicia-setup.md

diff --git a/docs/alicia-setup.md b/docs/alicia-setup.md
new file mode 100644
index 0000000..5b405a7
--- /dev/null
+++ b/docs/alicia-setup.md
@@ -0,0 +1,56 @@
+# Alicia — Lokale Test-Umgebung einrichten
+
+> **Einmalig ausführen.** Danach nur noch `pytest -v` vor jedem Commit.
+
+## Installation
+
+```bash
+cd /tmp/BSN-Livesystem
+
+# 1. Virtuelle Umgebung anlegen
+python3 -m venv .venv
+source .venv/bin/activate
+
+# 2. Projekt + Dev-Dependencies installieren
+pip install flask pydantic redis structlog pytest pytest-cov mypy fakeredis
+
+# 3. Ruff installieren (via pip)
+pip install ruff
+
+# 4. Testen ob alles geht
+ruff check .
+ruff format --check .
+mypy --config-file pyproject.toml .
+pytest -v
+```
+
+## Täglicher Workflow
+
+```bash
+cd /tmp/BSN-Livesystem
+source .venv/bin/activate    # venv aktivieren (einmal pro Session)
+
+git pull origin main         # aktuellen Stand holen
+
+# ... Dateien erstellen/bearbeiten ...
+
+# VOR jedem Commit:
+ruff check .
+ruff format .
+mypy --config-file pyproject.toml .
+pytest -v
+
+# Wenn ALLE 4 Checks grün:
+git add -A
+git commit -m "feat: ..."
+git push origin main
+```
+
+## Was ist was
+
+| Befehl | Prüft |
+|---|---|
+| `ruff check .` | Code-Stil, Sicherheit, Magic-Values |
+| `ruff format .` | Formatierung (macht auto-fix) |
+| `mypy --config-file pyproject.toml .` | Statische Typ-Prüfung |
+| `pytest -v` | Alle Tests ausführen |