docs: HUMANQUESTION.md — open questions/data requests for Julian + wife (incl. 32 conflict animals, blockers per item)

HUMANQUESTION.md

@@ -0,0 +1,122 @@
+# HUMANQUESTION.md — offene Fragen & Daten für Julian und seine Frau
+
+> 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**.
+
+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.
+
+---
+
+## A. Für Julian — Konten, Schlüssel, Infrastruktur
+
+| # | Was wir brauchen | Wozu / 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) |
+
+## 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. |
+
+---
+
+## C. Für deine Frau — 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).
+
+| # | 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 |
+| 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 |
+
+---
+
+## D. Die 32 Konflikt-Tiere (gleicher Name+Datum, 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`.
+
+### D1 · Farbschlag-Feld enthält versehentlich einen **Tiernamen** (Tippfehler) — welcher Farbschlag stimmt?
+| 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) |
+| 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) |
+| 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) |
+| 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)
+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])
+
+### 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 |
+| 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.)*
+
+---
+
+## E. Charakterbogen — Eigenschaften-Liste (für die KI-Verkaufstexte)
+
+Aktuell eingebaute Häkchen-Eigenschaften (je 1 Zeile leicht änderbar). **Bitte
+ergänzen/streichen:**
+
+> 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?
+
+---
+
+## F. Was hängt woran (Kurzübersicht)
+
+| Funktion | Status | Wartet auf |
+|---|---|---|
+| 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 |
+| NAS-Deployment / Produktiv | fertig vorbereitet | **A5** |
+| Restliche importierte Tiere (Konflikte/Sonder-Tokens) | 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.*