meldestelle/docs/01_Architecture/Roadmap_Online-Nennung_Mail-Service.md
Stefan Mogeritsch adfa97978e feat(mail-service): initialize Mail-Service and integrate online nomination workflow
- Created `MailServiceApplication` with Spring Boot setup.
- Added `MailPollingService` for IMAP polling, `TurnierNr` extraction, and auto-reply functionality.
- Implemented structured email sending for online nominations via `OnlineNennungFormular`.
- Updated frontend with `Erfolgsscreen` for nomination confirmation and fallback handling.
- Added build configurations for Mail-Service and frontend nomination module.
- Documented phase-based roadmap for Online-Nennung and Mail-Service rollout.
2026-04-14 14:59:15 +02:00

2.5 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 SMTP-Clients (oder API-Call an Backend), um die strukturierte E-Mail zu senden.
  • DSGVO: Checkbox und Hinweistext einbauen.

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

  • 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 an den Absender.
  • Persistence: Speichern der eingegangenen "Nennungs-Mails" in einer temporären Tabelle für den registration-context.

Phase 4: Desktop-Zentrale Integration 🏗️

  • UI-Tab: Neuer Reiter "Nennungs-Eingang" in der Turnierverwaltung.
  • Vorschau: Anzeige der eingegangenen Mails mit Details (Reiter, Pferd, Bewerbe).
  • Übernahme: "Übernehmen"-Button, der die Daten in die Turnieranmeldung vor-ausfüllt.
  • 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.