docs: HUMANQUESTION.md — fully German + 'nicht selbst bearbeiten, an Michael antworten' banner at top (wife reads this)

HUMANQUESTION.md

@@ -1,87 +1,93 @@
-# HUMANQUESTION.md — offene Fragen & Daten für Julian und seine Frau
+# HUMANQUESTION.md — offene Fragen & benötigte Daten
 
-> Diese Datei sammelt **alles, was das Team von euch braucht**, um weiterzubauen.
-> Antworte direkt hier (Stichworte reichen) oder sag es Michael (god) im Chat.
-> Stand: 2026-06-06. Jede offene Frage zeigt, **was dadurch blockiert ist**.
+> ## ⛔ BITTE DIESE DATEI NICHT SELBST BEARBEITEN
+> **Antwortet einfach Michael (dem Assistenten) im Chat** — Stichworte genügen
+> („C1: ja", „A1: hier der Schlüssel …", „Ella: der erste Genotyp stimmt").
+> **Michael pflegt diese Datei** und streicht jede Frage, sobald sie beantwortet
+> ist. So steht hier immer nur das, was **noch offen** ist. Nichts geht verloren —
+> alles wartet geduldig, bis ihr antwortet.
 
-Der Manager ist funktional fertig und läuft. Der Import ist erledigt
-(**723 Würfe + 247 Tiere + 99 Fotos** sind drin). Viele KI-Funktionen sind
-**fertig gebaut, aber schlafen**, bis ein Gemini-Key da ist.
+_Stand: 2026-06-06._
+
+Der Manager ist fertig und läuft. Die alten Daten sind importiert
+(**723 Würfe + 247 Tiere + 99 Fotos** sind drin). Mehrere KI-Funktionen sind
+**fertig gebaut, schlafen aber**, bis ein Gemini-Schlüssel hinterlegt ist.
+Jede offene Frage unten zeigt, **was dadurch blockiert ist**.
 
 ---
 
-## A. Für Julian — Konten, Schlüssel, Infrastruktur
+## A. Für Julian — Konten, Schlüssel, Technik
 
-| # | Was wir brauchen | Wozu / was es freischaltet | Blockiert gerade |
+| # | Was gebraucht wird | Wofür / was es freischaltet | Blockiert gerade |
 |---|---|---|---|
-| A1 | **Gemini API-Key** (aistudio.google.com → „Get API key"). Plus Entscheidung zur **Abrechnung** (siehe A2). Dann als `AI__BaseUrl` / `AI__ApiKey` / `AI__Model` setzen. | Schaltet **auf einen Schlag 4 Funktionen** live | KI-Verkaufstexte (FEAT-12), Charakterbogen-KI (fertig, schläft), Webseiten-Chat-Editor (WEB-4/5), KI-Antwortentwürfe im Posteingang (INBOX-2) |
-| A2 | **Billing-Entscheidung (EEA/Deutschland).** Gemini-AGB verlangen für EU-Nutzer die **bezahlte Stufe** — die ist bei eurem Volumen **praktisch 0 €**, schützt aber eure Daten (kein Training). Empfehlung: **Billing aktivieren** (bleibt fast gratis). Alternative für volle Privatsphäre: lokales Modell (Ollama). | Datenschutz für E-Mail-Inhalte + AGB-konform | dieselben KI-Funktionen wie A1 (v. a. der E-Mail-Posteingang mit echten Personendaten) |
-| A3 | **Gmail App-Passwort.** Einmalig: Google-Konto → 2-Faktor aktivieren → „App-Passwörter" → eins für „GerbilManager" erstellen → 16-stelligen Code an Michael / in die Einstellungen. (Wir nutzen App-Passwort statt OAuth — robuster, einmalig.) | Posteingang live verbinden (Anfragen abrufen + Antworten senden) | INBOX live (Import & Versand) |
-| A4 | **Domain-Name** (ist registriert ✔) + **Cloudflare-Konto & API-Token** (Berechtigung: „Cloudflare Pages → Edit"). | Öffentliche Webseite auf Cloudflare Pages veröffentlichen | WEB-2 (Deploy der neuen Webseite, Ersatz für Jimdo) |
-| A5 | **TrueNAS / Gitea Antworten (4):** (a) TrueNAS SCALE-Version? (Electric Eel 24.10+?) (b) Gitea Actions aktiviert/aktivierbar? (c) Eigener Postgres-Container (empfohlen) oder bestehender NAS-Postgres? (d) Welcher Dataset-Pfad für Daten/Backups, und ist Port 80 frei? | Manager auf den NAS deployen (Produktivbetrieb + Backups + CI) | OPS-2 (TrueNAS-Deployment; compose + CI sind fertig geschrieben und warten) |
+| A1 | **Gemini API-Schlüssel** (aistudio.google.com → „API-Schlüssel erstellen"). | Schaltet **vier Funktionen auf einmal** frei | KI-Verkaufstexte, Charakterbogen-KI (fertig, schläft), Webseiten-Chat-Editor, KI-Antwortentwürfe im Posteingang |
+| A2 | **Abrechnung aktivieren? (EU/Deutschland)** Die Gemini-AGB verlangen für EU-Nutzer die **bezahlte Stufe** — bei eurem Volumen **praktisch 0 €**, aber eure Daten werden dann **nicht** zum Training genutzt. Empfehlung: **Abrechnung einschalten** (bleibt fast gratis). Alternative für volle Privatsphäre: lokales Modell (Ollama). | Datenschutz (v. a. E-Mail-Inhalte) + AGB-konform | dieselben KI-Funktionen wie A1 |
+| A3 | **Gmail App-Passwort.** Einmalig: Google-Konto → 2-Faktor-Bestätigung aktivieren → „App-Passwörter" → eines für „GerbilManager" erstellen → 16-stelligen Code an Michael. | Posteingang verbinden (Anfragen abrufen + Antworten senden) | E-Mail-Posteingang (live) |
+| A4 | **Domain-Name** (ist registriert ✔) + **Cloudflare-Konto & API-Token** (Berechtigung „Cloudflare Pages → Edit"). | Öffentliche Webseite auf Cloudflare veröffentlichen | Veröffentlichung der neuen Webseite (Ersatz für Jimdo) |
+| A5 | **TrueNAS / Gitea — 4 Antworten:** (a) TrueNAS SCALE-Version? (Electric Eel 24.10+?) (b) Gitea Actions aktiviert/aktivierbar? (c) Eigener Postgres-Container (empfohlen) oder bestehender NAS-Postgres? (d) Welcher Dataset-Pfad für Daten/Backups, und ist Port 80 frei? | Manager auf dem NAS betreiben (Produktiv + Backups + CI) | NAS-Deployment (compose + CI sind fertig vorbereitet) |
 
 ## B. Für Julian — kleine Aktionen (jederzeit)
 
 | # | Aktion | Warum |
 |---|---|---|
-| B1 | **`git pull` + neu starten** (F5/AppHost) auf der laufenden Instanz | Holt den **Such-Bugfix** + neue Felder (Herkunft-Filter, nameSearch, Charakterbogen). Die laufende Instanz ist sonst auf altem Stand. |
-| B2 | **Firewall-Regel** (PowerShell **als Admin**): `New-NetFirewallRule -DisplayName "GerbilManager dev" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 5173,5179 -Profile Any` | Damit das Handy deiner Frau im WLAN auf die App kommt (wir konnten die Regel nicht ohne Admin setzen). |
-| B3 | **2 Test-Datensätze löschen:** „Testmaus E2E…" und „Wurf E2E…" | Übrig gebliebene Test-Einträge aus der Qualitätssicherung. |
+| B1 | **`git pull` + App neu starten** auf der laufenden Instanz | Holt den **Such-Fix** + neue Felder (Herkunft-Filter, unscharfe Suche, Charakterbogen). Die laufende Instanz ist sonst auf altem Stand. |
+| B2 | **Firewall-Regel** (PowerShell **als Administrator**): `New-NetFirewallRule -DisplayName "GerbilManager dev" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 5173,5179 -Profile Any` | Damit das Handy deiner Frau im WLAN auf die App kommt. |
+| B3 | **2 Test-Einträge löschen:** „Testmaus E2E…" und „Wurf E2E…" | Übrig gebliebene Test-Einträge aus der Qualitätssicherung. |
 
 ---
 
-## C. Für deine Frau — Genetik-Schreibweise & Import-Prüfung
+## C. Für die Züchterin — Genetik-Schreibweise & Import-Prüfung
 
-Diese Antworten schalten den **Rest der importierten Daten** frei (die unten
-gelisteten Konflikte + Tiere mit Sonder-Tokens warten in Quarantäne, **nicht**
-verloren — sobald geklärt, lädt ein erneuter Import sie automatisch nach).
+Diese Antworten laden die **restlichen importierten Daten** nach (die unten
+gelisteten Konflikt-Tiere + Tiere mit Sonder-Kürzeln warten in Quarantäne —
+**nichts ist verloren**; sobald geklärt, werden sie automatisch nachgeladen).
 
 | # | Frage | Blockiert |
 |---|---|---|
-| C1 | **Was bedeuten** die Gen-Tokens **`Uw`, `Sls`, `Dea`**? Und die Marker **`WFNZ`, `WP`, `DP`, `RV`, `GV`, `(taub)`**? | Tiere mit diesen Tokens (Quarantäne) + sauberes Genetik-Modell |
-| C2 | Stimmt: **`-` = „Allel unbekannt"**? (z. B. `D-` = ein D-Allel unbekannt) | korrekte Genotyp-Interpretation beim Nachimport |
+| C1 | **Was bedeuten** die Gen-Kürzel **`Uw`, `Sls`, `Dea`**? Und die Marker **`WFNZ`, `WP`, `DP`, `RV`, `GV`, `(taub)`**? | Tiere mit diesen Kürzeln (Quarantäne) |
+| C2 | Stimmt: **`-` = „Allel unbekannt"**? (z. B. `D-` = ein D-Allel unbekannt) | korrekte Genotyp-Übernahme |
 | C3 | Dürfen Tiere mit **gleichem Namen + Geburtsdatum automatisch zusammengeführt** werden (du bekommst die Konfliktliste zur Prüfung)? | Nachimport-Strategie |
-| C4 | Gibt es eine **Wurfchronik „Teil 2"** (oder mehr)? | weitere Würfe importieren |
-| C5 | Ist **„Schwarzschimmel" dasselbe wie „Orangeschimmel"** (nur anderer Name)? | Farbschlag-Katalog (Alias zusammenführen) |
-| C6 | **Die 32 Konflikt-Tiere prüfen** → siehe Abschnitt **D** unten. | diese 32 Tiere werden erst nach deiner Klärung geladen |
-| C7 | *(optional)* Was hat dir bei **Renner Pro** gefehlt? Lieblings-Statistiken/Berichte? | mögliche neue Features |
+| C4 | Gibt es eine **Wurfchronik „Teil 2"** (oder weitere Teile)? | weitere Würfe importieren |
+| C5 | Ist **„Schwarzschimmel" dasselbe wie „Orangeschimmel"** (nur anderer Name)? | Farbschlag-Katalog (Namen zusammenführen) |
+| C6 | **Die 32 Konflikt-Tiere prüfen** → siehe Abschnitt **D**. | diese 32 Tiere werden erst danach geladen |
+| C7 | *(optional)* Was hat dir bei **Renner Pro** gefehlt? Lieblings-Auswertungen? | mögliche neue Funktionen |
 
 ---
 
-## D. Die 32 Konflikt-Tiere (gleicher Name+Datum, widersprüchliche Angaben in mehreren Dateien)
+## D. Die 32 Konflikt-Tiere (gleicher Name + Datum, aber widersprüchliche Angaben in mehreren Dateien)
 
-Bitte je Tier sagen, **welche Angabe stimmt**. Gruppiert nach Konflikt-Art.
-Volle Details (alle Genotyp-Varianten + Quelldateien): `tools/import/output/review-report.md`.
+Bitte je Tier kurz sagen, **welche Angabe stimmt**. Gruppiert nach Konflikt-Art.
+Alle Details (sämtliche Genotyp-Varianten + Quelldateien): `tools/import/output/review-report.md`.
 
-### D1 · Farbschlag-Feld enthält versehentlich einen **Tiernamen** (Tippfehler) — welcher Farbschlag stimmt?
+### D1 · Im Farbschlag-Feld steht versehentlich ein **Tiername** (Tippfehler) — welcher Farbschlag stimmt wirklich?
 | Tier | im Farbschlag steht fälschlich |
 |---|---|
 | ZoneFire (*07.12.2020) | „Kalea von den Kleinen Chaoten" |
 | Louis v.d. Kleinen Chaoten (*15.07.2017) | „Roswitha…" (+ Genotyp G/Uw, siehe D2) |
-| Bruno of Black Forest (*01.06.2022) | „Mystique of Black Forest" (echt evtl. Blau) |
+| Bruno of Black Forest (*01.06.2022) | „Mystique of Black Forest" (evtl. Blau) |
 | Little Runner's Big Ben (*03.02.2020) | „Daja of Little Rose" |
-| Vance Jr. v.d. Kleinen Chaoten (*10.04.2022) | „Velvet…" (echt evtl. Kohlfuchs, hell) |
-| Trogir v.d. Kleinen Chaoten (*21.03.2022) | „Mahima…" (echt evtl. Gold Ansatzschecke) |
-| Chayton v.d. Kleinen Chaoten (*04.02.2022) | „Victoria Welby…" (echt evtl. Orangeschimmel, hell) |
+| Vance Jr. v.d. Kleinen Chaoten (*10.04.2022) | „Velvet…" (evtl. Kohlfuchs, hell) |
+| Trogir v.d. Kleinen Chaoten (*21.03.2022) | „Mahima…" (evtl. Gold Ansatzschecke) |
+| Chayton v.d. Kleinen Chaoten (*04.02.2022) | „Victoria Welby…" (evtl. Orangeschimmel, hell) |
 | Zac gen. Action v.d. Kleinen Chaoten (*25.12.2020) | „Belica gen. Emi…" |
-| Chesnut (*13.11.2019) | „Tennessee…" (echt evtl. Kohlfuchsschimmel) |
-| Ethan v.d. Kleinen Chaoten (*09.07.2020) | „Ichika…" (echt evtl. Orangeschimmel hell Kragenschecke) |
+| Chesnut (*13.11.2019) | „Tennessee…" (evtl. Kohlfuchsschimmel) |
+| Ethan v.d. Kleinen Chaoten (*09.07.2020) | „Ichika…" (evtl. Orangeschimmel hell Kragenschecke) |
 | Quied Soldier of Black Forest (*07.06.2018) | „Hoshi…" |
 
-### D2 · Genotyp: nur **G- vs Uw-Schreibweise** (vermutlich dasselbe Gen — Antwort auf C1/„Uw" klärt alle auf einmal)
+### D2 · Genotyp: nur **G- gegen Uw-Schreibweise** (vermutlich dasselbe Gen — die Antwort auf C1 zu „Uw" klärt alle auf einmal)
 Ella (*10.06.2019) · Roswitha v.d. K.C. (*10.09.2018) · Silenos gen. Adonis (*11.10.2015) · Brandon Stark v.d. K.C. (*13.12.2017) · Enya v.d. K.C. (*01.11.2017)
 
 ### D3 · Genotyp: **kleine Abweichung** (eine Quelle genauer als die andere — `DD`↔`D-`, `PP`↔`P-`, `Ee`↔`E`, mit/ohne `spsp`) — welche stimmt?
 Firefly v.d. K.C. (*18.12.2019, DD↔D-) · Zuleika v.d. K.C. (*24.10.2015) · WildFire v.d. K.C. (*05.10.2017, PP↔P-) · Milka of LennyLengo (*09.12.2018) · Silvain v.d. K.C. (*27.03.2022) · Daja of Little Rose (*16.05.2021, spsp) · Ichika v.d. K.C. (*19.04.2020) · Chelsea v.d. K.C. (*02.04.2021)
 
-### D4 · **Marker** unterschiedlich (`WP` / `DP` / `WFNZ` / „hörend" mal da, mal nicht) — welcher gilt?
-Vestra von den Schlossmäusen (*08.02.2019, WP) · Hedwig of BGB (*30.10.2019, DP+hörend) · Pitari gen. Piti v.d. K.C. (*16.05.2021, DP) · Little Hero of Black Forest (*22.02.2018, WFNZ ± spsp) · Victoria Welby gen. Welby v.d. K.C. (*16.01.2023, DP + Genotyp Ee[f]↔ee[f])
+### D4 · **Marker** unterschiedlich (`WP` / `DP` / `WFNZ` / „hörend" mal vorhanden, mal nicht) — welcher gilt?
+Vestra von den Schlossmäusen (*08.02.2019, WP) · Hedwig of BGB (*30.10.2019, DP + hörend) · Pitari gen. Piti v.d. K.C. (*16.05.2021, DP) · Little Hero of Black Forest (*22.02.2018, WFNZ ± spsp) · Victoria Welby gen. Welby v.d. K.C. (*16.01.2023, DP + Genotyp Ee[f]↔ee[f])
 
 ### D5 · **Sterbedatum** widersprüchlich
 | Tier | Problem |
 |---|---|
-| Flint v.d. Kleinen Chaoten (*23.12.2017) | Tod 10.05.**2021** vs 10.05.**2022** (Jahr-Tippfehler?) |
-| Hanami v.d. Kleinen Chaoten (*10.09.2015) | Tod 12.12.2019 vs 14.01.2020 |
+| Flint v.d. Kleinen Chaoten (*23.12.2017) | Tod 10.05.**2021** vs. 10.05.**2022** (Jahr-Tippfehler?) |
+| Hanami v.d. Kleinen Chaoten (*10.09.2015) | Tod 12.12.2019 vs. 14.01.2020 |
 | Molly of Black Forest (*13.09.2021) | Tod **03.05.2021 — VOR der Geburt** → klarer Datenfehler, bitte korrigieren |
 
 *(Das sind 32 Tiere: 11 + 5 + 8 + 5 + 3.)*
@@ -90,14 +96,13 @@ Vestra von den Schlossmäusen (*08.02.2019, WP) · Hedwig of BGB (*30.10.2019, D
 
 ## E. Charakterbogen — Eigenschaften-Liste (für die KI-Verkaufstexte)
 
-Aktuell eingebaute Häkchen-Eigenschaften (je 1 Zeile leicht änderbar). **Bitte
-ergänzen/streichen:**
+Aktuell eingebaute Häkchen-Eigenschaften (jede ist leicht änderbar). **Bitte
+sagen, was ergänzt oder gestrichen werden soll:**
 
 > zutraulich · handzahm · neugierig · aufgeschlossen · ruhig/ausgeglichen ·
 > lebhaft/aktiv · verschmust · eigenständig · anfängergeeignet · futterfreudig ·
 > buddelt gern · klettert gern · läuft gern im Laufrad · gut verträglich · schreckhaft
 
-Fragen:
 - **E1** — Eigenschaften hinzufügen/entfernen? (z. B. *dominant, rangniedrig, für erfahrene Halter, einzelgängerisch* …?)
 - **E2** — Auch **ehrliche „negative" Eigenschaften** aufnehmen (z. B. *schreckhaft, beißt manchmal*) für ehrliche Inserate, oder nur Positives?
 
@@ -109,14 +114,14 @@ Fragen:
 |---|---|---|
 | KI-Verkaufstexte (Abgeben) | gebaut, schläft | **A1** (+A2) |
 | Charakterbogen → KI-Text | gebaut, schläft | **A1** |
-| Webseiten-Chat-Editor (Gemini) | geplant (WEB-4/5) | **A1** + WEB-Phasen |
-| Öffentliche Webseite live | in Bau (WEB-0…) | **A4** (Domain+Cloudflare) für Deploy |
-| E-Mail-Posteingang (Anfragen) | in Bau (INBOX-0…) | **A3** (App-Passwort) + **A1/A2** für Entwürfe |
+| Webseiten-Chat-Editor (Gemini) | in Arbeit | **A1** + Webseiten-Phasen |
+| Öffentliche Webseite live | in Arbeit | **A4** (Domain + Cloudflare) |
+| E-Mail-Posteingang (Anfragen) | in Arbeit | **A3** (App-Passwort) + **A1/A2** für Entwürfe |
 | NAS-Deployment / Produktiv | fertig vorbereitet | **A5** |
-| Restliche importierte Tiere (Konflikte/Sonder-Tokens) | in Quarantäne | **C1–C6** |
+| Restliche importierte Tiere (Konflikte/Sonder-Kürzel) | in Quarantäne | **C1–C6** |
 | Handy-Zugriff im WLAN | App läuft | **B2** (Firewall) |
 
 ---
 
-*Antworte einfach abschnittsweise — ich (Michael) arbeite die Antworten ein und
-melde, was dadurch live geht. Nichts ist verloren; alles wartet geduldig.*
+*Einfach abschnittsweise antworten — Michael arbeitet die Antworten ein, streicht
+sie hier und meldet, was dadurch live geht.*