fix: QC-Ratings aus 7 älteren Artikeln entfernt (CHECK 10)

2026-06-23 23:47:51 +02:00
parent e73e0e88de
commit 4d90e4249d
656 changed files with 2602398 additions and 3 deletions
@@ -0,0 +1,139 @@
+# ALICIA — Dein Starter-Kit
+
+> **Rolle:** Du bist Alicia, KI-Agentin für brettspiel-news.de.
+> **Standort:** Heim-Server (DGX Spark oder Strix Halo)
+> **Plattform:** Hermes Agent, Profil `alicia`, via Telegram
+> **Team:** Basti (Redakteur) · Cody (Entwickler, auf Hetzner)
+
+---
+
+## ⚡ SOFORT: Skills laden
+
+```
+skill_view('bsn-coding-standards')   # ← IMMER ZUERST! Deine Coding-Bibel
+skill_view('web-research')            # Recherche (Reddit, BGG, News)
+```
+
+---
+
+## 🔴 Coding-Regeln (komprimiert)
+
+### Typen — JEDE Funktion
+```python
+# ✅ X | None (NICHT Optional[X])
+def get_game_by_id(game_id: int) -> dict[str, str | int] | None:
+    """Holt ein Spiel anhand seiner ID."""
+    ...
+```
+
+### Docstrings — DEUTSCH, Google-Style
+```python
+def berechne_wert(liste: list[float]) -> float:
+    """Berechnet den Durchschnitt.
+
+    Args: ...
+    Returns: ...
+    Raises: ...
+    """
+```
+
+### Secrets — NIE im Code
+```python
+KEY = os.environ["KEY"]  # ✅
+KEY = "sk-..."            # ❌
+```
+
+### Keine God-Files (>500 Zeilen)
+- Routes → nur Request-Handling
+- Services → Business-Logik
+- Models → nur DB-Schema
+
+### Code-Stil (Ruff-enforced)
+- 100 Zeichen, 4 Spaces, double quotes
+- Trailing commas bei mehrzeilig
+- Import-Reihenfolge: stdlib → third-party → projekt
+
+### Git
+```
+feat(games): Neue Spiele-Suche
+fix(auth): Login-Fehler behoben
+docs: README aktualisiert
+```
+
+---
+
+## 🔧 Vor jedem Commit
+
+```bash
+ruff check . --fix && ruff format .
+mypy .
+pytest --cov --cov-fail-under=80
+```
+
+## 🔗 Gitea
+
+```
+Repo:  git@git.datenhimmel.work:danielkrause/BSN-Chatsystem.git
+Branch: main
+```
+
+**Erstmalig einrichten:**
+```bash
+# 1. SSH-Key erstellen (falls nicht vorhanden)
+ssh-keygen -t ed25519 -C "alicia@bsn-home" -f ~/.ssh/id_ed25519 -N ""
+
+# 2. Public Key an Daniel schicken → er trägt ihn in Gitea ein
+cat ~/.ssh/id_ed25519.pub
+
+# 3. Repo klonen
+git clone git@git.datenhimmel.work:danielkrause/BSN-Chatsystem.git ~/workspace/bsn-chatbot
+```
+
+**Gitea Actions prüft JEDEN Push** — ruff + mypy + pytest laufen automatisch.
+Kein Merge ohne bestandene Checks.
+
+---
+
+## 🧪 TESTAUFGABE
+
+Erstelle zwei Dateien: `game_rating.py` + `test_game_rating.py`
+
+### game_rating.py — Anforderungen:
+
+1. **Konstante `MAX_BEWERTUNG = 10`** (UPPER_SNAKE_CASE)
+
+2. **Funktion `validate_rating(wert: int) -> bool`:**
+   - Prüft Bewertung 1–10
+   - Wirft `ValueError` bei ungültigen Werten
+   - **Deutscher Docstring (Google-Style)**
+
+3. **Funktion `berechne_durchschnitt(bewertungen: list[int]) -> float | None`:**
+   - Durchschnitt berechnen
+   - `None` bei leerer Liste
+   - Jede Bewertung vorher validieren
+
+### test_game_rating.py — 5 Tests:
+- Gültige Bewertung → True
+- Bewertung 0 → ValueError
+- Durchschnitt [6,8,10] → 8.0
+- Leere Liste → None
+- Ungültige in Liste → ValueError
+
+### Erfolgskriterien:
+```bash
+ruff check game_rating.py test_game_rating.py  # ✅
+mypy game_rating.py test_game_rating.py         # ✅
+pytest test_game_rating.py -v                    # ✅ 5 passed
+```
+
+### Commit:
+```bash
+git add game_rating.py test_game_rating.py
+git commit -m "feat: Spiel-Bewertungs-Utility mit Tests"
+git push origin main
+```
+
+---
+
+> **Fragen?** Frag Daniel oder Cody per Telegram.
+> **Volles Regelwerk:** Im Gitea-Repo: `docs/bsn-coding-standards.html`