From bd55a69b8bde8124bcbcdb2633e18993dae2dd1b Mon Sep 17 00:00:00 2001
From: Andreas Knorr <anknorr@gmail.com>
Date: Mon, 22 Jun 2026 07:11:45 +0000
Subject: [PATCH] =?UTF-8?q?Mermaid-Beispiel:=20Brevo=E2=86=92Communi-Pipel?=
 =?UTF-8?q?ine?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Demonstriert Mermaid-Rendering in der Gitea-Web-Ansicht
(flowchart TD + LR, Tabelle). Ergänzt monitoring-datenfluss.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 brevo-communi-pipeline.md | 43 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 brevo-communi-pipeline.md

diff --git a/brevo-communi-pipeline.md b/brevo-communi-pipeline.md
new file mode 100644
index 0000000..1bcae48
--- /dev/null
+++ b/brevo-communi-pipeline.md
@@ -0,0 +1,43 @@
+# Brevo Newsletter → Communi App
+
+Automatische Übernahme der CK-Newsletter aus Brevo in den Communi-News-Feed.
+
+## Ablauf (Webhook-Pipeline)
+
+```mermaid
+flowchart TD
+    Brevo[Brevo Newsletter-Versand]
+    WH["brevo-webhook · VPS<br/>(Container, Port 8055)"]
+    Seen{"camp_id schon<br/>in seen_campaigns.json?"}
+    Fetch["Kampagne via<br/>/emailCampaigns/{camp_id} holen"]
+    Conv["HTML → Markdown<br/>Format: 📰 {Typ} · {Betreff}"]
+    Communi["Communi API · /recommendation<br/>Gruppe 88531 · isOfficial"]
+
+    Brevo -->|"Webhook: Event 'Zugestellt'<br/>(liefert camp_id)"| WH
+    WH --> Seen
+    Seen -->|ja| Skip["200 skipped<br/>kein API-Call"]
+    Seen -->|nein| Fetch
+    Fetch --> Conv
+    Conv --> Communi
+    WH -.antwortet IMMER 200.-> Brevo
+```
+
+## Verteiler (Brevo-Listen-IDs)
+
+| Newsletter | Brevo-Liste | Communi-Gruppe |
+|---|---|---|
+| GemeindeNewsletter | 198 (Gemeinderundmail) | 88531 |
+| Regionalnewsletter | 89 (Regional-NL SCK) | 88531 |
+
+## Schutzmechanik
+
+```mermaid
+flowchart LR
+    A["'Zugestellt' feuert<br/>pro Empfänger (~150x)"] --> B{Idempotenz<br/>pro camp_id}
+    B -->|1. Mal| C[verarbeiten + posten]
+    B -->|"2..n"| D[verwerfen]
+    C --> E["Fehler? → ntfy-Alert<br/>(nie HTTP 500)"]
+```
+
+> Hinweis: Idempotenz keyt auf `camp_id` (nicht Event-`id`) — sonst 1 Post pro Empfänger.
+> Webhook antwortet immer 200, damit Brevo keinen Retry-Sturm auslöst.