bd55a69b8b
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>
44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
# 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.
|