openclaw - 💡(How to fix) Fix MVP-Arbeitspakete: Contao Mail-Automation (Drip) [1 participants]

Kontext

Folge-Ticket zu #61749. Ziel: MVP in umsetzbare technische Arbeitspakete zerlegen.

Ziel des MVP

Ein lauffähiger End-to-End-Flow in Contao: Trigger → Enrollment → zeitversetzte Steps → E-Mail-Versand → Logging/Fehlerbehandlung.

Arbeitspakete

1) Projektgerüst & Architektur-Skeleton

• Bundle-Struktur für Contao/Symfony aufsetzen
• Namespaces, Service-Container, Config-Basics
• Grundlegende Modulstruktur (Domain, Application, Infrastructure)

Akzeptanzkriterien

• Bundle lässt sich in Zielumgebung installieren/booten
• Basis-Services sind registriert
• Smoke-Test läuft ohne Fehler

---

2) Datenmodell & Persistenz

• Entities/Tabellen definieren:
  • Sequence
  • SequenceStep
  • Enrollment
  • ExecutionLog
• Statusmodelle und Indizes festlegen
• Migrationen erstellen

Akzeptanzkriterien

• Migrationen laufen sauber vor/zurück
• Kernobjekte sind CRUD-fähig
• Basis-Indizes für fällige Steps/Lookup vorhanden

---

3) Backend-Management (DCA/UI)

• DCA/Backend-Ansichten für Sequence + Steps
• Aktivieren/Deaktivieren von Sequences
• Validierungen (z. B. Reihenfolge, Delay >= 0)

Akzeptanzkriterien

• Sequence inkl. Steps kann vollständig im Backend gepflegt werden
• Ungültige Konfiguration wird verständlich abgefangen

---

4) Trigger-Adapter (MVP)

• Trigger 1: manuelle Einschreibung im Backend
• Trigger 2: Formular-Event (Contao Hook/Event)
• Optionale Erweiterbarkeit für API/Tag-Events vorbereiten

Akzeptanzkriterien

• Kontakt kann über beide Trigger eingeschrieben werden
• Enrollment ist idempotent (keine Duplikate für gleichen Scope)

---

5) Orchestrierung/Runner

• Fällige Steps ermitteln (Scheduler/cron/queue)
• Schrittweise Ausführung mit Sperr-/Idempotenzlogik
• Zustandsübergänge (pending → processing → done/failed/skipped)

Akzeptanzkriterien

• Fällige Schritte werden zuverlässig abgearbeitet
• Kein Doppelversand bei Parallelität/Retry
• Zustände sind nachvollziehbar konsistent

---

6) E-Mail-Versandadapter

• Versand über bestehende Mail-Infrastruktur integrieren
• Tokenauflösung/Personalisierung für Mailinhalte
• Abbruch, wenn Consent/Unsubscribe verletzt ist

Akzeptanzkriterien

• Testversand + produktiver Versand funktionieren
• Tokens werden korrekt ersetzt
• Consent-Regeln werden strikt erzwungen

---

7) Logging, Monitoring, Fehlerbehandlung

• ExecutionLog pro Schritt/Kontakt
• Fehlerklassifikation (temporär/permanent)
• Retry-Policy mit Backoff

Akzeptanzkriterien

• Fehler sind inkl. Kontext einsehbar
• Temporäre Fehler werden begrenzt erneut versucht
• Permanente Fehler werden sauber final markiert

---

8) Datenschutz/Compliance-Basics

• Consent-Checks zentralisieren
• Unsubscribe-Verarbeitung pro Sequence respektieren
• Aufbewahrungslogik für Logs vorsehen (konfigurierbar)

Akzeptanzkriterien

• Versand ohne gültigen Consent wird verhindert
• Abmeldungen stoppen weitere Schritte

---

9) Tests & Qualitätssicherung

• Unit-Tests für Kernlogik (Runner, State-Machine, Idempotenz)
• Integrations-Test für End-to-End-MVP-Flow
• Testdaten/Fixtures für reproduzierbare Abläufe

Akzeptanzkriterien

• Kritische Kernpfade sind automatisiert abgesichert
• Mindestens ein vollständiger E2E-MVP-Flow grün

---

10) Dokumentation & Betrieb

• README/Installationsschritte
• Betriebsdoku (Cron/Scheduler, Troubleshooting)
• Kurze Admin-Doku für Sequence-Erstellung

Akzeptanzkriterien

• Setup und Betrieb sind ohne implizites Wissen möglich
• Support kann Logs/Fehler mit Doku nachvollziehen

Vorschlag Reihenfolge

1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9 → 10

Definition of Done (gesamt)

• End-to-End-MVP läuft stabil in Zielumgebung
• Keine Doppelversendungen in Parallel-/Retry-Szenarien
• Consent/Unsubscribe werden zuverlässig eingehalten
• Doku + Tests auf MVP-Niveau vorhanden

Nächste Schritte

• Ziel-Contao-Version final festlegen
• Trigger-MVP final bestätigen (manuell + Formular)
• Arbeitspakete in einzelne Umsetzungs-Issues schneiden