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/api/v1/api.py

@@ -3,6 +3,7 @@ from fastapi import APIRouter
 from app.api.v1.endpoints import (
     auth,
     benutzer,
+    dashboard,
     fehlbestaende,
     health,
     kontrollen,
@@ -22,3 +23,4 @@ api_router.include_router(vorlagen.router, tags=["vorlagen"])
 api_router.include_router(objekte.router, tags=["objekte"])
 api_router.include_router(kontrollen.router, tags=["kontrollen"])
 api_router.include_router(fehlbestaende.router, tags=["fehlbestaende"])
+api_router.include_router(dashboard.router, tags=["dashboard"])

backend/app/api/v1/endpoints/benutzer.py

@@ -30,6 +30,7 @@ async def erstelle_benutzer(
     benutzer = Benutzer(
         name=payload.name,
         login=payload.login,
+        email=payload.email,
         passwort_hash=hash_password(payload.passwort),
         aktiv=True,
     )
@@ -55,6 +56,8 @@ async def aendere_benutzer(
 
     if payload.name is not None:
         benutzer.name = payload.name
+    if payload.email is not None:
+        benutzer.email = payload.email
     if payload.aktiv is not None:
         benutzer.aktiv = payload.aktiv
     if payload.rollen is not None:

backend/app/api/v1/endpoints/dashboard.py

@@ -0,0 +1,27 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.deps import require_roles
+from app.db.session import get_db
+from app.models.auth import RolleTyp
+from app.schemas.dashboard import AblaufdatumRead, KennzahlenRead
+from app.services.dashboard import bevorstehende_ablaufdaten, kennzahlen
+
+router = APIRouter()
+
+_verantwortliche = require_roles(
+    RolleTyp.administration, RolleTyp.materialverantwortlicher, RolleTyp.leitungsverantwortlicher
+)
+
+
+@router.get("/dashboard/kennzahlen", response_model=KennzahlenRead)
+async def hole_kennzahlen(db: AsyncSession = Depends(get_db), _=Depends(_verantwortliche)) -> KennzahlenRead:
+    """Prompt 12.1: Zielgruppe Materialverantwortlicher/Leitungsverantwortlicher/
+    Administration. Filterung nach Zuständigkeitsbereich (Karte 04) folgt später,
+    V1 zeigt globale Zahlen für diese Rollen."""
+    return KennzahlenRead(**await kennzahlen(db))
+
+
+@router.get("/dashboard/ablaufdaten", response_model=list[AblaufdatumRead])
+async def hole_ablaufdaten(db: AsyncSession = Depends(get_db), _=Depends(_verantwortliche)) -> list[AblaufdatumRead]:
+    return [AblaufdatumRead(**eintrag) for eintrag in await bevorstehende_ablaufdaten(db)]

backend/app/api/v1/endpoints/fehlbestaende.py

@@ -8,6 +8,7 @@ from app.api.deps import require_roles
 from app.db.session import get_db
 from app.models.auth import KnotenTyp, RolleTyp, Systemknoten
 from app.models.fehlbestand import Fehlbestand
+from app.models.mindermenge import MindermengeStatus, MindermengenGenehmigung
 from app.schemas.fehlbestand import (
     FehlbestandRead,
     NachfuellungCreate,
@@ -41,13 +42,30 @@ async def _hauptserver_id(db: AsyncSession) -> int:
 @router.get("/fehlbestaende", response_model=list[FehlbestandRead])
 async def liste_fehlbestaende(
     status_filter: str | None = None,
+    standort_id: int | None = None,
+    objekt_id: int | None = None,
+    material_id: int | None = None,
+    nur_genehmigte: bool = False,
     db: AsyncSession = Depends(get_db),
     _=Depends(_verantwortliche),
 ) -> list[Fehlbestand]:
-    """Vollständige Filterung nach Zuständigkeit/Standort folgt Sprint 6 (Dashboard)."""
+    """Prompt 12.3 (Minimalversion): Filter Standort/Objekt/Material/Status,
+    Standardsortierung nach Alter absteigend (älteste zuerst, entstanden_am aufsteigend).
+    Vollständige Zuständigkeitsfilterung (Karte 04) ist spätere Ausbaustufe."""
     stmt = select(Fehlbestand)
     if status_filter is not None:
         stmt = stmt.where(Fehlbestand.status == status_filter)
+    if standort_id is not None:
+        stmt = stmt.where(Fehlbestand.standort_id == standort_id)
+    if objekt_id is not None:
+        stmt = stmt.where(Fehlbestand.objekt_id == objekt_id)
+    if material_id is not None:
+        stmt = stmt.where(Fehlbestand.material_id == material_id)
+    if nur_genehmigte:
+        stmt = stmt.join(
+            MindermengenGenehmigung, MindermengenGenehmigung.fehlbestand_id == Fehlbestand.id
+        ).where(MindermengenGenehmigung.status == MindermengeStatus.aktiv)
+    stmt = stmt.order_by(Fehlbestand.entstanden_am.asc())
     result = await db.execute(stmt)
     return list(result.scalars().all())