From d79f039b8b9e16f5f269033b188a75acacb55ea6 Mon Sep 17 00:00:00 2001
From: Gulum <gulum@rismer.de>
Date: Sat, 6 Jun 2026 09:58:04 +0200
Subject: [PATCH] FEAT-13-Followup: /hilfe sections for Abgabevertrag wizard +
 Zuchtprofil (du-Form, de.ts-referenced labels) + finish-step in Abgabe
 section

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 gerbil-manager-web/src/pages/HilfePage.tsx | 38 ++++++++++++++++++++++
 gerbil-manager-web/src/strings/de.ts       |  3 ++
 2 files changed, 41 insertions(+)

diff --git a/gerbil-manager-web/src/pages/HilfePage.tsx b/gerbil-manager-web/src/pages/HilfePage.tsx
index bfcd958..4d1d3ef 100644
--- a/gerbil-manager-web/src/pages/HilfePage.tsx
+++ b/gerbil-manager-web/src/pages/HilfePage.tsx
@@ -15,6 +15,10 @@ const st = de.pages.stammbaum
 const ge = de.pages.genetik
 const ab = de.pages.abgabe
 const stat = de.pages.statistik
+// FEAT-13-Followup: Vertrag + Zuchtprofil
+const v = de.pages.vertraege
+const vw = de.pages.vertraege.wizard
+const ez = de.pages.einstellungen.zuchtprofil
 const scheckeWarning = de.genetics.warnings.SCHECKE_LETHAL
 const rexWarning = de.genetics.warnings.REX_SEMI_LETHAL
 
@@ -139,11 +143,45 @@ const sections: Section[] = [
           <li>
             <strong>KI-Unterstützung (optional):</strong> Mit <strong>„{ab.ai.improve}"</strong> kann der Text automatisch verbessert werden — dazu ist ein API-Schlüssel nötig.
           </li>
+          <li>
+            <strong>Abschließen:</strong> Sind die Tiere vergeben, klicke in der Gruppe auf <strong>„{ab.export.finish}"</strong> — das öffnet den Vertrags-Assistenten mit den Tieren der Gruppe (siehe Abschnitt <em>„{t.sections.vertraege}"</em>).
+          </li>
         </ol>
         <p className="hilfe-hint">Tipp: Bearbeite jede Gruppe einzeln — Text und Fotos für eine Gruppe gleichzeitig zusammenstellen, dann weiter zur nächsten.</p>
       </>
     ),
   },
+  {
+    id: 'vertraege',
+    title: t.sections.vertraege,
+    content: (
+      <>
+        <p>Den Vertrags-Assistenten <strong>„{vw.title}"</strong> erreichst du auf drei Wegen: über <strong>„{ab.export.finish}"</strong> in einer Abgabe-Gruppe, über den gleichnamigen Knopf auf der Tierakte oder unter <strong>„{nav.contracts}"</strong> → <strong>„{v.newButton}"</strong>.</p>
+        <p>Der Assistent führt dich in vier Schritten durch die Abgabe:</p>
+        <ol>
+          <li><strong>„{vw.steps[0]}"</strong> — wähle den Käufer aus deinen Kontakten oder lege ihn direkt an (Name, Adresse, Telefon, E-Mail — so erscheinen sie im Vertrag).</li>
+          <li><strong>„{vw.steps[1]}"</strong> — bestätige die Tiere; kommst du aus einer Abgabe-Gruppe oder Tierakte, sind sie schon angehakt.</li>
+          <li><strong>„{vw.steps[2]}"</strong> — Kaufpreis (z.&nbsp;B. <code>72,00</code>) und Übergabedatum eintragen.</li>
+          <li><strong>„{vw.steps[3]}"</strong> — Zusammenfassung prüfen und <strong>„{vw.generate}"</strong> klicken.</li>
+        </ol>
+        <p>Danach kannst du den fertigen Vertrag als <strong>Word-Datei (.docx)</strong> herunterladen — er sieht aus wie deine bisherigen Verträge, mit deinen Zuchtdaten, dem Käufer und einer Tabelle pro Tier. Gleichzeitig werden die Tiere automatisch als <em>„{de.pages.gerbils.statusLabels.GivenAway}"</em> markiert (Abnehmer und Abgabedatum sind dann in der Tierakte eingetragen).</p>
+        <p>Alle erstellten Verträge findest du unter <strong>„{nav.contracts}"</strong> — dort kannst du sie jederzeit erneut <strong>„{v.download}"</strong> oder löschen.</p>
+        <p className="hilfe-hint">Tipp: Fülle zuerst dein Zuchtprofil aus (siehe Abschnitt „{t.sections.einstellungen}") — diese Angaben erscheinen als Verkäufer-Block in jedem Vertrag.</p>
+      </>
+    ),
+  },
+  {
+    id: 'einstellungen',
+    title: t.sections.einstellungen,
+    content: (
+      <>
+        <p>Unter <strong>„{nav.settings}"</strong> pflegst du dein <strong>„{ez.title}"</strong>: {ez.intro}</p>
+        <p>Wichtig für den Vertrag sind <strong>„{ez.fields.name}"</strong>, <strong>„{ez.fields.address}"</strong> und <strong>„{ez.fields.city}"</strong> (der Ort erscheint in der Unterschriftszeile). Zuchtname, Telefon, E-Mail und Homepage vervollständigen den Briefkopf.</p>
+        <p>Solange etwas fehlt, zeigen die Einstellungen und der Vertrags-Assistent einen Hinweis — du musst die Angaben nur einmal eintragen.</p>
+        <p>Außerdem findest du hier den <strong>„{de.pages.datenexport.title}"</strong>, mit dem du alle Daten als Zip herunterladen kannst.</p>
+      </>
+    ),
+  },
   {
     id: 'statistik',
     title: t.sections.statistik,
diff --git a/gerbil-manager-web/src/strings/de.ts b/gerbil-manager-web/src/strings/de.ts
index 394fe84..50bbe10 100644
--- a/gerbil-manager-web/src/strings/de.ts
+++ b/gerbil-manager-web/src/strings/de.ts
@@ -589,6 +589,9 @@ export const de = {
       genetik: 'Probeverpaarung & Genetik',
       stammbaum: 'Stammbaum',
       abgabe: 'Abgabe-Ablauf',
+      // FEAT-13-Followup (Kelly): Vertrag + Zuchtprofil
+      vertraege: 'Abgabevertrag erstellen',
+      einstellungen: 'Zuchtprofil (Einstellungen)',
       statistik: 'Statistik',
       datensicherung: 'Datensicherung',
     },