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

@@ -16,6 +16,7 @@ AGB_CHECKLIST = [
             r"diese\s+(?:agb|bedingungen)\s+gelten",
         ],
         "severity": "HIGH",
+        "hint": "Ihre AGB enthalten keinen Geltungsbereich. Ergaenzen Sie einen Abschnitt, der festlegt, fuer welche Vertraege und Parteien die AGB gelten.",
     },
     {
         "id": "incorporation_clause",
@@ -27,6 +28,7 @@ AGB_CHECKLIST = [
             r"§\s*305",
         ],
         "severity": "MEDIUM",
+        "hint": "Es fehlt eine Einbeziehungsklausel gemaess §305 BGB. Stellen Sie klar, dass der Kunde vor Vertragsschluss auf die AGB hingewiesen wird und ihnen zustimmt.",
     },
 
     # ── L1: Vertragsschluss ───────────────────────────────────────────
@@ -39,6 +41,7 @@ AGB_CHECKLIST = [
             r"contract\s+formation", r"angebot\s+und\s+annahme",
         ],
         "severity": "HIGH",
+        "hint": "Die AGB beschreiben nicht, wie ein Vertrag zustande kommt. Ergaenzen Sie eine Regelung zu Angebot und Annahme (z.B. Bestellung als Angebot, Bestaetigung als Annahme).",
     },
 
     # ── L1: Haftung ───────────────────────────────────────────────────
@@ -51,6 +54,7 @@ AGB_CHECKLIST = [
             r"schadensersatz", r"haftungsbeschr(?:ae|ä)nkung",
         ],
         "severity": "HIGH",
+        "hint": "Es fehlt eine Haftungsregelung. Nehmen Sie einen Abschnitt auf, der die Haftung regelt und dabei die gesetzlichen Mindestrechte (Vorsatz, grobe Fahrlaessigkeit, Personenschaeden) unberuehrt laesst.",
     },
 
     # ── L1: Gerichtsstand / Anwendbares Recht ─────────────────────────
@@ -63,6 +67,7 @@ AGB_CHECKLIST = [
             r"jurisdiction", r"governing\s+law",
         ],
         "severity": "MEDIUM",
+        "hint": "Die AGB enthalten keine Angabe zum anwendbaren Recht oder Gerichtsstand. Benennen Sie das geltende Recht (z.B. deutsches Recht) und ggf. den Gerichtsstand.",
     },
     {
         "id": "dispute_odr_link",
@@ -74,6 +79,7 @@ AGB_CHECKLIST = [
             r"(?:online[\-\s]?streitbeilegung|online\s+dispute\s+resolution)",
         ],
         "severity": "MEDIUM",
+        "hint": "Der Link zur EU-Online-Streitbeilegungsplattform (https://ec.europa.eu/consumers/odr) fehlt. Dieser ist fuer Online-Haendler nach EU-Verordnung 524/2013 Pflicht.",
     },
     {
         "id": "choice_of_law_specific",
@@ -86,6 +92,7 @@ AGB_CHECKLIST = [
             r"un[\-\s]kaufrecht.*(?:ausgeschlossen|findet\s+keine\s+anwendung)",
         ],
         "severity": "LOW",
+        "hint": "Es wird kein konkretes anwendbares Recht benannt. Geben Sie explizit an, welches Recht gilt (z.B. 'Es gilt das Recht der Bundesrepublik Deutschland') und ob das UN-Kaufrecht ausgeschlossen ist.",
     },
 
     # ── L1: Zahlungsbedingungen ───────────────────────────────────────
@@ -99,6 +106,7 @@ AGB_CHECKLIST = [
             r"zahlungsweise", r"rechnungsstellung",
         ],
         "severity": "MEDIUM",
+        "hint": "Die AGB enthalten keine Zahlungsbedingungen. Ergaenzen Sie Angaben zu Preisen, Zahlungsarten und Faelligkeit.",
     },
     {
         "id": "payment_methods",
@@ -108,6 +116,7 @@ AGB_CHECKLIST = [
             r"(?:vorkasse|nachnahme|lastschrift|sepa|(?:ue|ü)berweisung|kreditkarte|paypal|sofort(?:ue|ü)berweisung|klarna|rechnung|giropay|apple\s*pay|google\s*pay)",
         ],
         "severity": "LOW",
+        "hint": "Es werden keine konkreten Zahlungsarten aufgefuehrt. Listen Sie die akzeptierten Zahlungsmethoden auf (z.B. Kreditkarte, PayPal, SEPA-Lastschrift, Ueberweisung).",
     },
     {
         "id": "payment_due_date",
@@ -119,6 +128,7 @@ AGB_CHECKLIST = [
             r"zahlungsfrist",
         ],
         "severity": "LOW",
+        "hint": "Es fehlt eine Angabe zur Faelligkeit der Zahlung. Geben Sie an, wann die Zahlung faellig ist (z.B. 'sofort nach Rechnungsstellung' oder 'innerhalb von 14 Tagen').",
     },
 
     # ── L1: Lieferung ─────────────────────────────────────────────────
@@ -132,6 +142,7 @@ AGB_CHECKLIST = [
             r"(?:zugang|zugriff).*(?:dienst|leistung)",
         ],
         "severity": "MEDIUM",
+        "hint": "Die AGB regeln nicht die Lieferung oder Leistungserbringung. Ergaenzen Sie Angaben zu Liefergebiet, Versandart und Lieferfristen.",
     },
     {
         "id": "delivery_timeframe",
@@ -143,6 +154,7 @@ AGB_CHECKLIST = [
             r"(?:liefer|versand).*\d+[\-\s]+(?:\d+\s+)?(?:werk)?tage",
         ],
         "severity": "LOW",
+        "hint": "Es wird keine konkrete Lieferzeit angegeben. Nennen Sie die voraussichtliche Lieferfrist (z.B. '3-5 Werktage nach Zahlungseingang').",
     },
 
     # ── L1: Gewaehrleistung ───────────────────────────────────────────
@@ -156,6 +168,7 @@ AGB_CHECKLIST = [
             r"gew(?:ae|ä)hrleistungsfrist",
         ],
         "severity": "MEDIUM",
+        "hint": "Die AGB enthalten keine Gewaehrleistungsregelung. Nehmen Sie einen Abschnitt zu Maengelrechten auf, der die gesetzlichen Gewaehrleistungsansprueche beschreibt.",
     },
     {
         "id": "warranty_period",
@@ -167,6 +180,7 @@ AGB_CHECKLIST = [
             r"(?:gew(?:ae|ä)hrleistung|m(?:ae|ä)ngel|verj(?:ae|ä)hrung).*(?:2|zwei)\s+jahre",
         ],
         "severity": "LOW",
+        "hint": "Die Gewaehrleistungsfrist wird nicht genannt. Geben Sie die Frist an (gesetzlich: 2 Jahre bei Neuware, 1 Jahr bei Gebrauchtwaren gegenueber Verbrauchern moeglich).",
     },
 
     # ── L1: Kuendigung ────────────────────────────────────────────────
@@ -180,6 +194,7 @@ AGB_CHECKLIST = [
             r"k(?:ue|ü)ndigungsfrist",
         ],
         "severity": "MEDIUM",
+        "hint": "Es fehlt eine Kuendigungsregelung. Beschreiben Sie, wie und unter welchen Bedingungen der Vertrag gekuendigt werden kann.",
     },
     {
         "id": "termination_period",
@@ -191,6 +206,7 @@ AGB_CHECKLIST = [
             r"(?:k(?:ue|ü)ndig|frist).*\d+\s+(?:tage?|wochen?|monate?)",
         ],
         "severity": "LOW",
+        "hint": "Es wird keine konkrete Kuendigungsfrist angegeben. Nennen Sie die Frist (z.B. '4 Wochen zum Monatsende') und den Zeitpunkt, ab dem sie gilt.",
     },
     {
         "id": "termination_form",
@@ -201,6 +217,7 @@ AGB_CHECKLIST = [
             r"(?:schriftlich|textform).*k(?:ue|ü)ndigung",
         ],
         "severity": "LOW",
+        "hint": "Die Formvorschrift fuer Kuendigungen fehlt. Geben Sie an, in welcher Form eine Kuendigung erfolgen muss (z.B. Textform per E-Mail oder schriftlich per Post).",
     },
 
     # ── L1: Datenschutzhinweis in AGB ─────────────────────────────────
@@ -215,6 +232,7 @@ AGB_CHECKLIST = [
             r"dsgvo.*(?:agb|vertrag)",
         ],
         "severity": "LOW",
+        "hint": "Die AGB enthalten keinen Verweis auf den Datenschutz. Ergaenzen Sie einen Hinweis, dass personenbezogene Daten gemaess Ihrer Datenschutzerklaerung verarbeitet werden, und verlinken Sie diese.",
     },
 
     # ── Neue L1: Salvatorische Klausel ────────────────────────────────
@@ -229,6 +247,7 @@ AGB_CHECKLIST = [
             r"(?:uebrigen|übrigen)\s+bestimmungen.*(?:unberuehrt|unberührt|wirksam|bestehen)",
         ],
         "severity": "LOW",
+        "hint": "Es fehlt eine salvatorische Klausel. Ergaenzen Sie eine Regelung, dass die uebrigen Bestimmungen wirksam bleiben, falls einzelne Klauseln unwirksam sein sollten.",
     },
 
     # ── Neue L1: Aenderungsklausel ────────────────────────────────────
@@ -243,6 +262,7 @@ AGB_CHECKLIST = [
             r"(?:neue\s+fassung|neufassung).*(?:agb|bedingung)",
         ],
         "severity": "LOW",
+        "hint": "Die AGB enthalten keine Aenderungsklausel. Beschreiben Sie, wie und wann die AGB geaendert werden koennen und wie Kunden ueber Aenderungen informiert werden.",
     },
 
     # ── Neue L1: Verbraucherrechte §309 ───────────────────────────────
@@ -257,5 +277,6 @@ AGB_CHECKLIST = [
             r"(?:verbrauch|konsument).*(?:recht|anspruch|schutz)",
         ],
         "severity": "LOW",
+        "hint": "Es fehlt ein Hinweis, dass zwingende Verbraucherrechte (§309 BGB) unberuehrt bleiben. Stellen Sie klar, dass gesetzliche Verbraucherrechte durch die AGB nicht eingeschraenkt werden.",
     },
 ]