feat: Add actionable hints to all 138 compliance checks

Each check now has a "hint" field explaining what is missing and
what the customer should do to fix it. Hints are shown in the
frontend below failed checks in red text.

Examples:
- "Bei Verarbeitung auf Basis von Art. 6(1)(f) muss dokumentiert
  werden, warum Ihr berechtigtes Interesse die Rechte der
  Betroffenen ueberwiegt."
- "Die ladungsfaehige Anschrift fehlt. Erforderlich: Strasse,
  Hausnummer, PLZ und Ort."

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

backend-compliance/compliance/services/doc_checks/widerruf_checks.py

@@ -17,6 +17,7 @@ WIDERRUF_CHECKLIST = [
             r"recht\s+(?:zum|auf)\s+widerruf",
         ],
         "severity": "HIGH",
+        "hint": "Die Widerrufsbelehrung muss ausdruecklich ueber das Bestehen eines Widerrufsrechts informieren. Ergaenzen Sie einen Abschnitt, der den Verbraucher klar auf sein Widerrufsrecht hinweist.",
     },
 
     # ── L1: Widerrufsfrist ────────────────────────────────────────────
@@ -29,6 +30,7 @@ WIDERRUF_CHECKLIST = [
             r"14\s+days", r"fourteen\s+days",
         ],
         "severity": "HIGH",
+        "hint": "Die gesetzliche Widerrufsfrist von 14 Tagen muss explizit genannt werden. Fuegen Sie die Angabe '14 Tage' oder 'vierzehn Tage' in Ihre Widerrufsbelehrung ein.",
     },
     {
         "id": "deadline_calendar_days",
@@ -39,6 +41,7 @@ WIDERRUF_CHECKLIST = [
             r"14\s+calendar\s+days",
         ],
         "severity": "LOW",
+        "hint": "Zur Klarstellung sollte 'Kalendertage' statt nur 'Tage' angegeben werden. Aendern Sie die Formulierung zu '14 Kalendertage', um Missverstaendnisse auszuschliessen.",
     },
     {
         "id": "deadline_receipt_trigger",
@@ -50,6 +53,7 @@ WIDERRUF_CHECKLIST = [
             r"beginnt\s+(?:mit|ab)\s+(?:dem\s+)?(?:zugang|erhalt)",
         ],
         "severity": "MEDIUM",
+        "hint": "Der Fristbeginn muss klar definiert sein (z.B. ab Erhalt der Ware oder ab Vertragsschluss). Ergaenzen Sie eine Angabe wie 'Die Frist beginnt ab dem Tag des Erhalts der Ware'.",
     },
 
     # ── L1: Form des Widerrufs ────────────────────────────────────────
@@ -62,6 +66,7 @@ WIDERRUF_CHECKLIST = [
             r"withdrawal\s+form", r"formular",
         ],
         "severity": "MEDIUM",
+        "hint": "Die Widerrufsbelehrung muss ueber die Form des Widerrufs informieren und auf das Muster-Widerrufsformular hinweisen. Fuegen Sie einen entsprechenden Abschnitt mit Verweis auf das Formular hinzu.",
     },
     {
         "id": "form_text_required",
@@ -72,6 +77,7 @@ WIDERRUF_CHECKLIST = [
             r"(?:mittels|durch)\s+(?:einer?\s+)?(?:eindeutige|klare)\w*\s+erkl(?:ae|ä)rung",
         ],
         "severity": "LOW",
+        "hint": "Es sollte klargestellt werden, dass der Widerruf in Textform (z.B. per Brief, E-Mail oder Fax) erfolgen kann. Nennen Sie die zulaessigen Kommunikationswege ausdruecklich.",
     },
     {
         "id": "model_form",
@@ -83,6 +89,7 @@ WIDERRUF_CHECKLIST = [
             r"widerruf.*(?:beigef(?:ue|ü)gt|anlage|anhang|formular)",
         ],
         "severity": "LOW",
+        "hint": "Das gesetzliche Muster-Widerrufsformular muss beigefuegt oder verlinkt sein. Fuegen Sie das Formular als Anlage bei oder verlinken Sie es direkt in der Belehrung.",
     },
 
     # ── L1: Folgen des Widerrufs ──────────────────────────────────────
@@ -96,6 +103,7 @@ WIDERRUF_CHECKLIST = [
             r"r(?:ue|ü)ckerstattung",
         ],
         "severity": "MEDIUM",
+        "hint": "Die Folgen des Widerrufs (insbesondere die Rueckerstattungspflicht) muessen erlaeutert werden. Ergaenzen Sie einen Abschnitt 'Folgen des Widerrufs' mit Angaben zur Rueckabwicklung.",
     },
     {
         "id": "refund_timeline",
@@ -107,6 +115,7 @@ WIDERRUF_CHECKLIST = [
             r"(?:unverz(?:ue|ü)glich|sp(?:ae|ä)testens).*(?:r(?:ue|ü)ck|erstatt)",
         ],
         "severity": "MEDIUM",
+        "hint": "Die Rueckerstattung muss innerhalb von 14 Tagen nach Eingang des Widerrufs erfolgen. Geben Sie an, dass die Rueckzahlung spaetestens 14 Tage nach Zugang des Widerrufs erfolgt.",
     },
     {
         "id": "return_costs",
@@ -118,6 +127,7 @@ WIDERRUF_CHECKLIST = [
             r"(?:tragen|uebernehmen|übernehmen)\s+(?:die\s+)?(?:kosten|r(?:ue|ü)cksende)",
         ],
         "severity": "LOW",
+        "hint": "Es muss angegeben werden, wer die Kosten der Ruecksendung traegt. Stellen Sie klar, ob der Verbraucher oder der Unternehmer die Ruecksendekosten uebernimmt.",
     },
 
     # ── L1: Empfaenger des Widerrufs ──────────────────────────────────
@@ -131,6 +141,7 @@ WIDERRUF_CHECKLIST = [
             r"widerruf.*(?:per|via|an)",
         ],
         "severity": "MEDIUM",
+        "hint": "Name und Anschrift des Widerrufsempfaengers muessen angegeben werden. Fuegen Sie den vollstaendigen Firmennamen und die Postanschrift hinzu, an die der Widerruf zu richten ist.",
     },
     {
         "id": "recipient_full_address",
@@ -141,6 +152,7 @@ WIDERRUF_CHECKLIST = [
             r"(?:d[\-\s]?)?\d{5}\s+[a-z\u00c0-\u017e]\w+.*widerruf",
         ],
         "severity": "LOW",
+        "hint": "Die vollstaendige Postanschrift mit Postleitzahl und Ort fehlt beim Widerrufsempfaenger. Ergaenzen Sie Strasse, PLZ und Ort des Unternehmens in der Widerrufsbelehrung.",
     },
 
     # ── L1: Hinweis kein Grund erforderlich ───────────────────────────
@@ -153,6 +165,7 @@ WIDERRUF_CHECKLIST = [
             r"(?:kein|keine).*(?:begr(?:ue|ü)ndung|grund).*(?:erforderlich|n(?:oe|ö)tig)",
         ],
         "severity": "LOW",
+        "hint": "Der Verbraucher muss darauf hingewiesen werden, dass er keinen Grund fuer den Widerruf angeben muss. Ergaenzen Sie den Satz 'Der Widerruf muss nicht begruendet werden'.",
     },
 
     # ── L1: Online-Kuendigungsbutton ──────────────────────────────────
@@ -166,6 +179,7 @@ WIDERRUF_CHECKLIST = [
             r"k(?:ue|ü)ndigung.*(?:button|link|formular|online)",
         ],
         "severity": "MEDIUM",
+        "hint": "Seit Juli 2022 ist ein Online-Kuendigungsbutton fuer Dauerschuldverhaeltnisse Pflicht (§312k BGB). Stellen Sie auf Ihrer Website einen gut sichtbaren Kuendigungsbutton bereit.",
     },
 
     # ── Neue L1: Ausnahme digitale Inhalte ────────────────────────────
@@ -180,5 +194,6 @@ WIDERRUF_CHECKLIST = [
             r"(?:ausnahme|ausschluss).*widerruf.*digital",
         ],
         "severity": "LOW",
+        "hint": "Falls Sie digitale Inhalte verkaufen, muss auf den moeglichen Verlust des Widerrufsrechts nach §356 BGB hingewiesen werden. Ergaenzen Sie eine Belehrung ueber die Ausnahme fuer digitale Inhalte.",
     },
 ]