Add native Dateiverteilung API

README.md

@@ -39,6 +39,8 @@ The portal modules are referred to as applets because SPH is built on top of Moo
 - `stundenplan` — timetable data
 - `lerngruppen` — study groups
 - `oberstufenwahl` — student-facing elections and course choices
+- `dateispeicher` — school file storage and downloads
+- `dateiverteilung` — targeted notices, personal files, and authenticated downloads
 - `school_list` — school names and IDs for login and school selection
 
 

api/api.py

@@ -340,6 +340,7 @@ def validate_module_preferences(cls, value):
     "dashboard",
     "messages",
     "dateispeicher",
+    "dateiverteilung",
     "vertretungsplan",
     "dsb",
     "courses",
@@ -1995,6 +1996,55 @@ async def download_dateispeicher_file(
     )
 
 
+# --- Dateiverteilung ---
+
+
+@app.get("/dateiverteilung")
+async def get_dateiverteilung(
+    refresh: bool = False,
+    auth: AuthSession = Depends(client_dependency),
+) -> Dict[str, object]:
+    if not refresh:
+        cached = await sessions.get_cached(auth.user_id, "/dateiverteilung")
+        if cached is not None:
+            return cached
+
+    result = await run_in_threadpool(auth.client.dateiverteilung_get_overview)
+    if result.get("success"):
+        await sessions.set_cache(auth.user_id, "/dateiverteilung", result)
+    elif result.get("error_kind") == "authentication":
+        await sessions.invalidate_schulportal_client(auth.user_id, auth.client)
+    return result
+
+
+@app.get("/dateiverteilung/file")
+async def download_dateiverteilung_file(
+    url: str = Query(..., min_length=1, max_length=2048),
+    auth: AuthSession = Depends(client_dependency),
+):
+    result = await run_in_threadpool(auth.client.dateiverteilung_download_file, url)
+    stream = result.get("stream")
+    if not result.get("success") or stream is None:
+        error_kind = result.get("error_kind")
+        if error_kind == "validation":
+            error_status = status.HTTP_400_BAD_REQUEST
+        elif error_kind == "authentication":
+            await sessions.invalidate_schulportal_client(auth.user_id, auth.client)
+            error_status = status.HTTP_401_UNAUTHORIZED
+        elif result.get("upstream_status") == status.HTTP_404_NOT_FOUND:
+            error_status = status.HTTP_404_NOT_FOUND
+        else:
+            error_status = status.HTTP_502_BAD_GATEWAY
+        raise HTTPException(status_code=error_status, detail=result.get("error", "File not found"))
+
+    filename = re.sub(r'[\r\n"]', "_", str(result.get("filename") or "dateiverteilung-datei"))
+    return StreamingResponse(
+        content=stream,
+        media_type=result.get("content_type") or "application/octet-stream",
+        headers={"Content-Disposition": f"attachment; filename*=UTF-8''{quote(filename, safe='')}"},
+    )
+
+
 # --- Lerngruppen ---
 
 

api/auth_db.py

@@ -96,6 +96,7 @@ def _pairing_code_hash(code: str) -> str:
     "dashboard",
     "messages",
     "dateispeicher",
+    "dateiverteilung",
     "vertretungsplan",
     "dsb",
     "courses",

api/documentation.py

@@ -33,6 +33,7 @@
     ("/vertretungsplan", "Plans"),
     ("/stundenplan", "Plans"),
     ("/dateispeicher", "File Storage"),
+    ("/dateiverteilung", "File Distribution"),
     ("/lerngruppen", "Study Groups"),
     ("/school-list", "School List"),
     ("/benutzer", "User Info"),

docs/API.md

@@ -327,6 +327,17 @@ Fetch files and folders for a specific dateispeicher node.
 
 Search files in the dateispeicher by name.
 
+#### dateiverteilung_get_overview
+
+Fetch targeted file distributions for the authenticated user. Returns each
+distribution's title, provenance, date, unread state, files, and related links.
+
+#### dateiverteilung_download_file
+
+Stream a file from `dateiverteilung.php` through the authenticated portal
+session. Download URLs are restricted to the configured Schulportal origin,
+the Dateiverteilung endpoint, and known download actions.
+
 #### lerngruppen_get_overview
 
 Fetch study groups and exam data (lerngruppen.php).

schulportal_hessen/applets/dateiverteilung/__init__.py

@@ -0,0 +1 @@
+"""Dateiverteilung (targeted file distribution) applet."""