feat: All 138 hints rewritten as expert-level legal guidance

Every hint now reads like a mini-consultation from a data protection
lawyer — with specific legal references, court rulings, and common
mistakes. Examples:

- EuGH C-210/16 (Fanpage), C-298/17 (Kontaktpflicht), C-311/18 (Schrems II)
- BGH I ZR 228/03 (ladungsfaehige Anschrift), XI ZR 388/10 (AGB)
- EDSA Guidelines 2/2019 (lit. b misuse), WP 248 Rev.01 (DSFA)
- DSK-Orientierungshilfe, CNIL-Leitlinien, SDM, BSI-IT-Grundschutz
- §25 TDDDG, §38 BDSG, §309 BGB, §312k BGB, Art. 246a EGBGB

This is the core value proposition: no lawyer can deliver this level
of specific, actionable compliance feedback in 60 seconds.

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

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

@@ -17,7 +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.",
+        "hint": "Gemaess Art. 246a §1 Abs. 2 Nr. 1 EGBGB muss ueber das Bestehen des Widerrufsrechts informiert werden. Verwenden Sie die gesetzliche Musterbelehrung (Anlage 1 zu Art. 246a EGBGB) — eigene Formulierungen sind fehleranfaellig und abmahngefaehrdet.",
     },
 
     # ── L1: Widerrufsfrist ────────────────────────────────────────────
@@ -30,7 +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.",
+        "hint": "§355 Abs. 2 BGB: Die Widerrufsfrist betraegt 14 Tage. Haeufiger Fehler: Wird die Belehrung fehlerhaft erteilt, verlaengert sich die Frist auf 12 Monate und 14 Tage (§356 Abs. 3 S. 2 BGB). Exakte Formulierung ist daher geschaeftskritisch.",
     },
     {
         "id": "deadline_calendar_days",
@@ -41,7 +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.",
+        "hint": "Die gesetzliche Musterbelehrung (Anlage 1 zu Art. 246a EGBGB) spricht von 'vierzehn Tagen'. Kalendertage statt Werktage — die Klarstellung vermeidet Abmahnungen. BGH-Rechtsprechung: Unklare Fristangaben gelten als fehlerhafte Belehrung.",
     },
     {
         "id": "deadline_receipt_trigger",
@@ -53,7 +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'.",
+        "hint": "§356 Abs. 2 BGB unterscheidet den Fristbeginn nach Vertragstyp: Bei Waren ab Erhalt (Nr. 1a), bei Dienstleistungen ab Vertragsschluss (Nr. 2). Haeufiger Fehler: Pauschal 'ab Vertragsschluss' auch fuer Warenlieferungen — das ist falsch.",
     },
 
     # ── L1: Form des Widerrufs ────────────────────────────────────────
@@ -66,7 +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.",
+        "hint": "Art. 246a §1 Abs. 2 Nr. 1 EGBGB verlangt einen Hinweis auf das Muster-Widerrufsformular (Anlage 2 zu Art. 246a EGBGB). Das Formular muss dem Verbraucher zur Verfuegung gestellt werden — ein blosser Verweis auf §355 BGB genuegt nicht.",
     },
     {
         "id": "form_text_required",
@@ -77,7 +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.",
+        "hint": "§355 Abs. 1 S. 3 BGB: Der Widerruf erfolgt durch 'eindeutige Erklaerung'. Textform (§126b BGB) genuegt — Brief, E-Mail oder Fax. Achtung: Telefonischer Widerruf ist ebenfalls wirksam; Sie duerfen den Widerruf nicht auf Schriftform beschraenken.",
     },
     {
         "id": "model_form",
@@ -89,7 +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.",
+        "hint": "Das Muster-Widerrufsformular (Anlage 2 zu Art. 246a EGBGB) ist gesetzlich vorgeschrieben und darf inhaltlich nicht veraendert werden. Haeufiger Fehler: Eigenes Formular statt Gesetzesmuster — das macht die Belehrung angreifbar (vgl. BGH, Az. I ZR 7/16).",
     },
 
     # ── L1: Folgen des Widerrufs ──────────────────────────────────────
@@ -103,7 +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.",
+        "hint": "Art. 246a §1 Abs. 2 Nr. 2 EGBGB verlangt Informationen ueber die Folgen des Widerrufs. Pflichtinhalte: Rueckerstattungspflicht (§357 Abs. 1 BGB), Ruecksendepflicht (§357 Abs. 1 BGB) und Wertersatz-Regelung (§357a BGB).",
     },
     {
         "id": "refund_timeline",
@@ -115,7 +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.",
+        "hint": "§357 Abs. 1 BGB: Rueckzahlung binnen 14 Tagen nach Zugang des Widerrufs. Achtung: Bei Warenlieferung darf die Rueckzahlung bis zum Erhalt der Ruecksendung zurueckgehalten werden (§357 Abs. 4 BGB) — dieses Zurueckbehaltungsrecht muss erwaehnt werden.",
     },
     {
         "id": "return_costs",
@@ -127,7 +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.",
+        "hint": "§357 Abs. 5 BGB: Ruecksendekosten traegt der Verbraucher, wenn der Unternehmer dies vorab mitgeteilt hat. Fehlt diese Info in der Belehrung, traegt der Unternehmer die Kosten. Bei >40kg-Waren: Kostenvoranschlag fuer Ruecksendung angeben (§357 Abs. 5 S. 2 BGB).",
     },
 
     # ── L1: Empfaenger des Widerrufs ──────────────────────────────────
@@ -141,7 +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.",
+        "hint": "Art. 246a §1 Abs. 2 Nr. 1 EGBGB verlangt Name, Anschrift und ggf. Telefonnummer/E-Mail des Widerrufsempfaengers. Fehlt die Adresse, ist die Belehrung fehlerhaft und die Widerrufsfrist beginnt nicht zu laufen (§356 Abs. 3 BGB).",
     },
     {
         "id": "recipient_full_address",
@@ -152,7 +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.",
+        "hint": "Die gesetzliche Musterbelehrung verlangt: '[Name des Unternehmers], [Anschrift], [ggf. Telefon/Fax/E-Mail]'. Haeufiger Fehler: Nur E-Mail-Adresse ohne Postanschrift — der Verbraucher muss auch postalisch widerrufen koennen.",
     },
 
     # ── L1: Hinweis kein Grund erforderlich ───────────────────────────
@@ -165,7 +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'.",
+        "hint": "Die gesetzliche Musterbelehrung (Anlage 1 zu Art. 246a EGBGB) enthaelt: 'Sie muessen uns [...] mittels einer eindeutigen Erklaerung [...] informieren' — ohne Begruendungspflicht. Manche Shops verlangen faelschlich einen Grund; das ist unzulaessig.",
     },
 
     # ── L1: Online-Kuendigungsbutton ──────────────────────────────────
@@ -179,7 +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.",
+        "hint": "§312k BGB (seit 01.07.2022): Pflicht zum Kuendigungsbutton fuer Dauerschuldverhaeltnisse (Abos, Mitgliedschaften). Der Button muss 'Vertraege hier kuendigen' heissen, direkt auf eine Bestaetigungsseite fuehren und ohne Login erreichbar sein.",
     },
 
     # ── Neue L1: Ausnahme digitale Inhalte ────────────────────────────
@@ -194,6 +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.",
+        "hint": "§356 Abs. 5 BGB: Bei digitalen Inhalten erlischt das Widerrufsrecht, wenn der Verbraucher ausdruecklich zustimmt und bestaetigt, dass er vom Erloeschen weiss. Pflicht: Checkbox + Bestaetigungsmail. Fehlt die Belehrung, bleibt das Widerrufsrecht 14 Tage bestehen.",
     },
 ]