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

@@ -16,6 +16,7 @@ COOKIE_CHECKLIST = [
             r"cookie.*(?:art|typ|kategori)",
         ],
         "severity": "HIGH",
+        "hint": "Ihre Cookie-Richtlinie muss die verschiedenen Arten von Cookies auflisten (z.B. notwendige, funktionale, Statistik-, Marketing-Cookies). Ergaenzen Sie eine Kategorisierung aller eingesetzten Cookie-Typen.",
     },
     {
         "id": "cookie_names_listed",
@@ -27,6 +28,7 @@ COOKIE_CHECKLIST = [
             r"name\s+des\s+cookie",
         ],
         "severity": "MEDIUM",
+        "hint": "Neben den Kategorien sollten auch die konkreten Cookie-Namen aufgefuehrt werden (z.B. _ga, _gid, PHPSESSID). Listen Sie jeden einzelnen Cookie mit seinem technischen Namen auf.",
     },
     {
         "id": "cookie_essential_justified",
@@ -37,6 +39,7 @@ COOKIE_CHECKLIST = [
             r"(?:unbedingt|zwingend)\s+erforderlich",
         ],
         "severity": "LOW",
+        "hint": "Fuer essenzielle/notwendige Cookies muss begruendet werden, warum sie technisch erforderlich sind (z.B. Warenkorb, Session, Sicherheit). Ergaenzen Sie eine kurze Begruendung je Cookie.",
     },
 
     # ── L1: Zwecke der Cookies ────────────────────────────────────────
@@ -53,6 +56,7 @@ COOKIE_CHECKLIST = [
             r"cookies?\s+(?:dienen|helfen|erm(?:oe|ö)glichen)",
         ],
         "severity": "HIGH",
+        "hint": "Die Cookie-Richtlinie muss erklaeren, zu welchem Zweck Cookies eingesetzt werden (z.B. Analyse, Marketing, Funktionalitaet). Beschreiben Sie den Zweck fuer jede Cookie-Kategorie.",
     },
     {
         "id": "cookie_providers_named",
@@ -63,6 +67,7 @@ COOKIE_CHECKLIST = [
             r"(?:anbieter|provider|dienst)\s*[:\|]\s*[A-Z]",
         ],
         "severity": "MEDIUM",
+        "hint": "Die konkreten Anbieter und Dienste, die Cookies setzen, muessen namentlich genannt werden (z.B. Google Analytics, Meta Pixel, Hotjar). Ergaenzen Sie alle Drittanbieter-Dienste mit Namen.",
     },
     {
         "id": "cookie_analytics_named",
@@ -72,6 +77,7 @@ COOKIE_CHECKLIST = [
             r"google\s+analytics|matomo|piwik|plausible|fathom|adobe\s+analytics|microsoft\s+clarity|hotjar|etracker",
         ],
         "severity": "LOW",
+        "hint": "Falls Sie Analyse-/Statistik-Tools einsetzen, muessen diese konkret benannt werden (z.B. Google Analytics, Matomo, Hotjar). Fuehren Sie jedes eingesetzte Analysetool namentlich auf.",
     },
     {
         "id": "cookie_marketing_named",
@@ -81,6 +87,7 @@ COOKIE_CHECKLIST = [
             r"(?:facebook|meta)\s+pixel|google\s+ads|linkedin\s+insight|tiktok\s+pixel|pinterest\s+tag|criteo|adroll|taboola",
         ],
         "severity": "LOW",
+        "hint": "Falls Sie Marketing- oder Tracking-Tools einsetzen, muessen diese konkret benannt werden (z.B. Meta Pixel, Google Ads, LinkedIn Insight Tag). Listen Sie alle Marketing-Dienste namentlich auf.",
     },
 
     # ── L1: Speicherdauer ─────────────────────────────────────────────
@@ -93,6 +100,7 @@ COOKIE_CHECKLIST = [
             r"cookie.*(?:\d+\s+(?:tag|monat|jahr)|session)",
         ],
         "severity": "MEDIUM",
+        "hint": "Die Cookie-Richtlinie muss Angaben zur Speicherdauer der Cookies enthalten. Ergaenzen Sie fuer jede Cookie-Kategorie oder jeden Cookie, wie lange er gespeichert wird (z.B. Session, 30 Tage, 1 Jahr).",
     },
     {
         "id": "cookie_duration_values",
@@ -104,6 +112,7 @@ COOKIE_CHECKLIST = [
             r"(?:ablauf|expiry|laufzeit)\s*[:\|]\s*\d+",
         ],
         "severity": "LOW",
+        "hint": "Neben einer allgemeinen Angabe sollten konkrete Speicherdauern pro Cookie angegeben werden (z.B. _ga: 2 Jahre, Session-Cookie: bis Browser geschlossen). Ergaenzen Sie die exakte Laufzeit fuer jeden Cookie.",
     },
 
     # ── L1: Drittanbieter ─────────────────────────────────────────────
@@ -116,6 +125,7 @@ COOKIE_CHECKLIST = [
             r"(?:google|facebook|meta|microsoft).*cookie",
         ],
         "severity": "MEDIUM",
+        "hint": "Falls Drittanbieter-Cookies eingesetzt werden, muss dies in der Cookie-Richtlinie erwaehnt werden. Geben Sie an, welche Drittanbieter Cookies auf Ihrer Website setzen.",
     },
     {
         "id": "cookie_legal_basis",
@@ -128,6 +138,7 @@ COOKIE_CHECKLIST = [
             r"ttdsg|tdddg|§\s*25",
         ],
         "severity": "MEDIUM",
+        "hint": "Fuer nicht-essentielle Cookies muss die Rechtsgrundlage genannt werden (§25 TDDDG bzw. Art. 6 Abs. 1 lit. a DSGVO — Einwilligung). Ergaenzen Sie die Rechtsgrundlage, insbesondere den Verweis auf die Einwilligung.",
     },
 
     # ── L1: Widerspruch ───────────────────────────────────────────────
@@ -140,6 +151,7 @@ COOKIE_CHECKLIST = [
             r"cookie.*(?:ablehnen|deaktivieren|l(?:oe|ö)schen)",
         ],
         "severity": "MEDIUM",
+        "hint": "Die Cookie-Richtlinie muss eine Widerspruchsmoeglichkeit beschreiben — also wie Nutzer Cookies ablehnen, deaktivieren oder loeschen koennen. Ergaenzen Sie einen Abschnitt zum Opt-out.",
     },
     {
         "id": "cookie_consent_mechanism",
@@ -151,6 +163,7 @@ COOKIE_CHECKLIST = [
             r"einwilligung\s+(?:jederzeit|widerrufen|zurueckziehen|zur(?:ue|ü)ckziehen)",
         ],
         "severity": "LOW",
+        "hint": "Beschreiben Sie das eingesetzte Consent-Tool oder Cookie-Banner und erklaeren Sie, wie Nutzer ihre Einwilligung jederzeit widerrufen koennen (z.B. ueber das Cookie-Banner oder eine Einstellungsseite).",
     },
     {
         "id": "cookie_browser_settings",
@@ -162,6 +175,7 @@ COOKIE_CHECKLIST = [
             r"(?:chrome|firefox|safari|edge).*(?:cookie|einstellung)",
         ],
         "severity": "LOW",
+        "hint": "Weisen Sie Nutzer darauf hin, dass sie Cookies auch ueber die Browser-Einstellungen verwalten, blockieren oder loeschen koennen. Nennen Sie idealerweise die gaengigen Browser (Chrome, Firefox, Safari, Edge).",
     },
 
     # ── Neue L1: Cookie-Tabelle ───────────────────────────────────────
@@ -175,5 +189,6 @@ COOKIE_CHECKLIST = [
             r"(?:first[\-\s]?party|third[\-\s]?party)\s*[\|\t]",
         ],
         "severity": "LOW",
+        "hint": "Eine strukturierte Cookie-Tabelle oder -Liste mit Spalten wie Name, Anbieter, Zweck und Speicherdauer erleichtert die Uebersichtlichkeit und wird von Aufsichtsbehoerden empfohlen. Ergaenzen Sie eine tabellarische Uebersicht aller Cookies.",
     },
 ]