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/impressum_checks.py

@@ -16,6 +16,7 @@ IMPRESSUM_CHECKLIST = [
             r"firma", r"unternehmen",
         ],
         "severity": "HIGH",
+        "hint": "Der vollstaendige Name des Unternehmens oder der Person muss im Impressum stehen (z.B. 'Musterfirma GmbH'). Bei Einzelunternehmen genuegt der vollstaendige Vor- und Nachname.",
     },
 
     # ── L1: Anschrift ─────────────────────────────────────────────────
@@ -28,6 +29,7 @@ IMPRESSUM_CHECKLIST = [
             r"d-\d{5}", r"\d{5}\s+\w+",
         ],
         "severity": "HIGH",
+        "hint": "Eine vollstaendige ladungsfaehige Anschrift (Strasse, Hausnummer, PLZ, Ort) muss im Impressum angegeben werden. Ein Postfach genuegt nicht.",
     },
     {
         "id": "address_zip_city",
@@ -37,6 +39,7 @@ IMPRESSUM_CHECKLIST = [
             r"(?:d[\-\s]?)?\d{5}\s+[a-z\u00c0-\u017e]\w{2,}",
         ],
         "severity": "MEDIUM",
+        "hint": "Die Anschrift muss eine fuenfstellige Postleitzahl und den Ortsnamen enthalten (z.B. '10115 Berlin').",
     },
     {
         "id": "address_street_number",
@@ -47,6 +50,7 @@ IMPRESSUM_CHECKLIST = [
             r"\w+\s+(?:str|stra(?:ss|ß)e|weg|platz|allee)\s*\.?\s*\d+",
         ],
         "severity": "MEDIUM",
+        "hint": "Bitte den Strassennamen und die Hausnummer angeben (z.B. 'Musterstrasse 12'). Ohne Hausnummer ist die Anschrift nicht ladungsfaehig.",
     },
 
     # ── L1: Kontaktdaten ──────────────────────────────────────────────
@@ -59,6 +63,7 @@ IMPRESSUM_CHECKLIST = [
             r"\+?\d[\d\s/\-]{8,}",
         ],
         "severity": "HIGH",
+        "hint": "Das Impressum muss mindestens eine E-Mail-Adresse und eine Telefonnummer enthalten, damit Nutzer schnell Kontakt aufnehmen koennen.",
     },
     {
         "id": "contact_email_format",
@@ -68,6 +73,7 @@ IMPRESSUM_CHECKLIST = [
             r"[a-z0-9._%+\-]+@[a-z0-9.\-]+\.[a-z]{2,}",
         ],
         "severity": "MEDIUM",
+        "hint": "Die E-Mail-Adresse muss in einem gueltigen Format vorliegen (z.B. 'info@beispiel.de'). Bitte pruefen Sie, ob ein '@'-Zeichen und eine Domain vorhanden sind.",
     },
     {
         "id": "contact_phone_format",
@@ -79,6 +85,7 @@ IMPRESSUM_CHECKLIST = [
             r"0\d{2,4}\s*[/\-\s]\s*\d{4,}",
         ],
         "severity": "MEDIUM",
+        "hint": "Bitte eine Telefonnummer mit Vorwahl angeben (z.B. '+49 30 12345678' oder '030 / 12345678'). Ein reines Kontaktformular reicht nicht aus.",
     },
 
     # ── L1: Handelsregister ───────────────────────────────────────────
@@ -91,6 +98,7 @@ IMPRESSUM_CHECKLIST = [
             r"register.*(?:nr|nummer)",
         ],
         "severity": "MEDIUM",
+        "hint": "Falls das Unternehmen im Handelsregister eingetragen ist, muessen Registergericht und Registernummer angegeben werden (z.B. 'Amtsgericht Muenchen, HRB 12345').",
     },
     {
         "id": "register_court",
@@ -101,6 +109,7 @@ IMPRESSUM_CHECKLIST = [
             r"ag\s+[A-Z\u00c0-\u017e]\w+",
         ],
         "severity": "LOW",
+        "hint": "Bitte das zustaendige Registergericht benennen (z.B. 'Amtsgericht Muenchen'). Die alleinige Angabe der Registernummer ohne Gericht ist unvollstaendig.",
     },
     {
         "id": "register_number",
@@ -110,6 +119,7 @@ IMPRESSUM_CHECKLIST = [
             r"(?:hrb|hra)\s*\d+",
         ],
         "severity": "LOW",
+        "hint": "Die Registernummer muss mit dem Praefix HRB oder HRA und der zugehoerigen Nummer angegeben werden (z.B. 'HRB 12345').",
     },
 
     # ── L1: USt-IdNr ──────────────────────────────────────────────────
@@ -122,6 +132,7 @@ IMPRESSUM_CHECKLIST = [
             r"vat.*id", r"de\s*\d{9}",
         ],
         "severity": "MEDIUM",
+        "hint": "Falls eine Umsatzsteuer-Identifikationsnummer vorhanden ist, muss diese im Impressum angegeben werden. Die Steuernummer allein genuegt nicht als Ersatz.",
     },
     {
         "id": "vat_de_format",
@@ -131,6 +142,7 @@ IMPRESSUM_CHECKLIST = [
             r"de\s*\d{9}",
         ],
         "severity": "LOW",
+        "hint": "Die USt-IdNr. muss im Format 'DE' gefolgt von 9 Ziffern angegeben werden (z.B. 'DE123456789'). Bitte pruefen Sie, ob die Nummer vollstaendig ist.",
     },
 
     # ── L1: Vertretungsberechtigte ────────────────────────────────────
@@ -143,6 +155,7 @@ IMPRESSUM_CHECKLIST = [
             r"vorstand", r"inhaber",
         ],
         "severity": "MEDIUM",
+        "hint": "Bei juristischen Personen (GmbH, AG etc.) muss die vertretungsberechtigte Person namentlich genannt werden (z.B. 'Geschaeftsfuehrer: Max Mustermann').",
     },
     {
         "id": "representative_person",
@@ -153,6 +166,7 @@ IMPRESSUM_CHECKLIST = [
             r"(?:vertreten\s+durch|repr(?:ae|ä)sentiert)\s*:?\s*[A-Z\u00c0-\u017e]",
         ],
         "severity": "LOW",
+        "hint": "Bitte den vollstaendigen Vor- und Nachnamen der vertretungsberechtigten Person angeben (z.B. 'Geschaeftsfuehrer: Max Mustermann'). Eine reine Funktionsbezeichnung reicht nicht.",
     },
 
     # ── Neue L1: Redaktionell Verantwortlicher ────────────────────────
@@ -166,6 +180,7 @@ IMPRESSUM_CHECKLIST = [
             r"§\s*18\s+m(?:edien)?st(?:aat)?v",
         ],
         "severity": "LOW",
+        "hint": "Wenn die Website journalistisch-redaktionelle Inhalte enthaelt, muss ein inhaltlich Verantwortlicher mit Name und Anschrift benannt werden (§18 MStV, 'V.i.S.d.P.').",
     },
 
     # ── Neue L1: Streitbeilegung ──────────────────────────────────────
@@ -181,5 +196,6 @@ IMPRESSUM_CHECKLIST = [
             r"alternative\s+streitbeilegung",
         ],
         "severity": "LOW",
+        "hint": "Online-Haendler muessen einen Link zur EU-Streitbeilegungsplattform (https://ec.europa.eu/consumers/odr) angeben und erklaeren, ob sie zur Teilnahme an Streitbeilegungsverfahren bereit oder verpflichtet sind.",
     },
 ]