meldestelle/docs/01_Architecture/Roadmap_Online-Nennung_Mail-Service.md

2.6 KiB

Roadmap: Online-Nennung & Mail-Service (Phase 5)

🏗️ [Lead Architect] | 14. April 2026

Dieses Dokument beschreibt die Umsetzung der Online-Nennung für das Turnier in Neumarkt (24. April 2026). Ziel ist ein schlankes Web-Formular, das strukturierte E-Mails an den Mail-Service sendet, welcher diese verarbeitet und in der Desktop-Zentrale zur manuellen Übernahme bereitstellt.


Phase 1: E-Mail-Infrastruktur (Vorbereitung)

  • Definition des Adress-Schemas: meldestelle-[Turnier-Nr]@mo-code.at.
  • Konfiguration der World4You SMTP/IMAP Zugangsdaten.
  • Mailpit Integration für lokale Tests (bereits in dc-ops.yaml).

Phase 2: Das Web-Formular (WasmJS Frontend)

  • Basis-UI: Erstellung des Formulars gemäß Spezifikation (Reiter, Pferd, Lizenz, Bewerbe).
  • Validierung: Implementierung der Pflichtfeld-Prüfung (Buttonsperre bis alles ok).
  • Mail-Versand: Integration des API-Calls an das Backend (mail-service), um die Nennung zu speichern.
  • DSGVO: Checkbox und Hinweistext eingebaut.

Phase 3: Mail-Service (Backend-Verarbeitung) 🏗️

  • Endpoint: POST-Endpunkt für direkte Nennungen aus dem Web-Formular implementiert.
  • Polling: Implementierung des IMAP-Pollers (imap.world4you.com).
  • Parsing: Extraktion der Turnier-Nummer aus dem To-Header und Mapping auf das Datenbank-Schema (Tenant).
  • Auto-Reply: Automatisches Versenden der Eingangsbestätigung (in MailPollingService vorbereitet).
  • Persistence: Speichern der eingegangenen "Nennungs-Mails" in einer temporären Tabelle.

Phase 4: Desktop-Zentrale Integration

  • UI-Tab: Neuer Reiter "Online-Eingang" in der Turnierverwaltung (TurnierDetailScreen).
  • Vorschau: Anzeige der eingegangenen Nennungen mit Details (OnlineNennungEingangTabContent).
  • Übernahme: "Übernehmen"-Button, der Reiter/Pferd in die Nennung vorausfüllt (NennungViewModel).
  • Abschluss: Manueller "Bestätigen"-Button zum Versenden der finalen Bestätigungsmail.

Phase 5: End-to-End Test & Deployment 🚀 (Deadline: 21.04.2026)

  • Test-Nennung über Web-Formular (Mailpit).
  • Verifikation der Schema-Zuordnung im Backend.
  • Live-Test mit online-nennen@mo-code.at.
  • Go-Live für Neumarkt.

Meilensteine

  1. 16.04.: Web-Formular ist funktionsfähig (Senden möglich).
  2. 18.04.: Mail-Service verarbeitet Mails und sendet Auto-Antworten.
  3. 20.04.: Desktop-UI zur Übernahme ist fertig.
  4. 24.04.: Erstes Turnier (Neumarkt) startet mit Online-Nenn-System.