Sprint 6: Dashboard-Kennzahlen, Ablaufdaten-Warnungen, E-Mail-Benachrichtigung

- benutzer.email ergänzt (additive Migration 0003) - Prompt 20 hatte kein E-Mail-
  Feld vorgesehen, aber Karte 05 braucht es für Benachrichtigungen
- Dashboard-Kennzahlen (Prompt 12.2): offen/in_bearbeitung/nachgefuellt_teilweise
  zählen gemeinsam als "offen", genehmigte Mindermengen separat, kürzlich erledigt
  (7 Tage), problematische Objekte
- Ablaufdaten-Warnungen (Prompt 14): serverseitige Statusberechnung
  gueltig/bald_ablaufend/abgelaufen je Objektposition, Standard-Warnzeitraum 30
  Tage falls am Material nicht gesetzt, sortiert nach verbleibenden Tagen (E1:
  einzige Zeit-/Fälligkeits-Sicht in V1, keine Kontrollintervall-Logik)
- GET /fehlbestaende um Filter (Standort/Objekt/Material/genehmigt) und
  Alter-Sortierung erweitert (Prompt 12.3)
- Asynchrone E-Mail-Benachrichtigung bei neuem Fehlbestand (Karte 05): fire-and-
  forget an aktive Materialverantwortliche/Leitungsverantwortliche mit hinterlegter
  E-Mail; kein SMTP konfiguriert -> wird nur geloggt, kein harter Fehler
- Tests: Aggregationsregel, Ablaufdaten-Filterung/Sortierung, Rollenrechte,
  E-Mail-Versand (SMTP gemockt, kein Docker/Test-Mailserver im Host-Runner
  verfügbar - Aufruf mit korrekten Empfängern/Betreff wird geprüft)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L85hmKbvX7Cqkq47KnQhFt

backend/app/core/app_settings.py

@@ -14,5 +14,15 @@ class Settings(BaseSettings):
     # ID des systemknoten-Datensatzes mit typ='haupt' (Sprintplan E6).
     systemknoten_id: int = 1
 
+    # Karte 05 / Sprint 6: E-Mail-Benachrichtigung bei neuem Fehlbestand.
+    # Leer (Default) = Versand wird übersprungen, nur geloggt (sicherer Default für
+    # Entwicklung/Tests ohne konfigurierten Mailserver).
+    smtp_host: str = ""
+    smtp_port: int = 587
+    smtp_user: str = ""
+    smtp_password: str = ""
+    smtp_from: str = "mabea@example.org"
+    smtp_use_tls: bool = True
+
 
 settings = Settings()

backend/app/core/email.py

@@ -0,0 +1,35 @@
+import logging
+from email.message import EmailMessage
+
+import aiosmtplib
+
+from app.core.app_settings import settings
+
+logger = logging.getLogger(__name__)
+
+
+async def send_email(*, to: list[str], subject: str, body: str) -> None:
+    """Karte 05: Benachrichtigung bei neuem Fehlbestand. Ohne konfigurierten SMTP_HOST
+    (Default auf Entwicklungs-/Testsystemen) wird nur geloggt, nicht gesendet - kein
+    harter Fehler, falls die Mailkonfiguration auf dem Zielsystem noch aussteht."""
+    if not to:
+        logger.info("E-Mail-Versand übersprungen (keine Empfänger): %s", subject)
+        return
+    if not settings.smtp_host:
+        logger.info("SMTP nicht konfiguriert, E-Mail nicht versendet: %s an %s", subject, to)
+        return
+
+    message = EmailMessage()
+    message["From"] = settings.smtp_from
+    message["To"] = ", ".join(to)
+    message["Subject"] = subject
+    message.set_content(body)
+
+    await aiosmtplib.send(
+        message,
+        hostname=settings.smtp_host,
+        port=settings.smtp_port,
+        username=settings.smtp_user or None,
+        password=settings.smtp_password or None,
+        start_tls=settings.smtp_use_tls,
+    )