README.md aktualisiert

README.md

@@ -29,6 +29,65 @@ Erst bei Bestehen des Checks wird die Anmeldung an Listmonk weitergegeben, wo an
 Alle relevanten Einstellungen und Variablen können direkt im Code angepasst werden.
 Es sind keine externen Dienste oder APIs erforderlich.
 
+## Benutzung
+
+Im Ordner **`n8n-workflow`** befindet sich der Newsletter-Antispam-Workflow als JSON-Datei zum direkten Import in **n8n**.  
+Vor oder nach dem Import müssen die **Domain- und URL-Variablen** an die eigene Umgebung angepasst werden.
+
+Im **Code Node** des Workflows erfolgt ein lokaler Antispam-Check, der jede Anmeldung vor der Weiterleitung an Listmonk prüft.
+
+### Durchgeführte Prüfungen
+
+- Herkunft des Requests (Origin / Referer)
+- Optionales Shared Secret
+- Honeypot-Felder
+- Zeit- und Bot-Speed-Check
+- User-Agent-Plausibilität
+- E-Mail Pflichtfeld & Formatprüfung
+- Domain-Blacklist
+- Consent- / Checkbox-Pflicht
+- Prüfung auf gefüllte Kommentar- / Textfelder
+- Name-Spam-Erkennung
+- Bad-Word-Blacklist
+- Wortlängen- und Zeichen-Plausibilität
+
+Alle Prüfungen können je nach Bedarf angepasst oder erweitert werden.
+
+## Formulare & Frontend
+
+Im Ordner **`codes`** befinden sich:
+
+- Das Newsletter-Anmeldeformular  
+  (inkl. **Listmonk-Listen-UUID**)
+- Die notwendigen **Domain-Variablen** für den n8n-Webhook
+- Passendes **JavaScript** und **CSS-Styling**, wie es produktiv auf Donau2Space.de eingesetzt wird
+
+## Statusseiten (WordPress)
+
+Für die Rückmeldungen werden in WordPress zwei Seiten angelegt, z. B.:
+
+- **Newsletter Danke**
+- **Newsletter Fehler**
+
+Diese werden mit folgenden Shortcodes ausgestattet:
+
+- `[d2s_newsletter_danke]`
+- `[d2s_newsletter_error]`
+
+Weitere Konfiguration ist nicht erforderlich.
+
+## Ablauf
+
+1. Nutzer füllt das Newsletter-Anmeldeformular aus
+2. Die Checkbox (Datenschutz / Newsletter abonnieren) muss aktiv sein
+3. Die Anmeldung wird an den **n8n-Workflow** gesendet
+4. Der lokale Antispam-Check prüft die Daten
+5. Bei Erfolg:
+   - Weiterleitung auf die **Newsletter-Danke-Seite**
+   - Übergabe der Anmeldung an **Listmonk**
+   - Versand der **Double-Opt-In-E-Mail**
+6. Nach Bestätigung ist der Nutzer regulär im Listmonk-Newsletter angemeldet
+
 ## Demo
 
 Produktiv im Einsatz auf: