pdf_to_ics/WEB_README.md

🌐 Web-Version (MVP)

Diese Variante stellt den PDF-zu-ICS-Konverter im Browser bereit, damit die Nutzung auch auf mobilen Geräten möglich ist.

Starten

Linux/macOS

./start_web.sh

Windows

Doppelklick auf start_web.cmd

Danach im Browser öffnen:

• Lokal: http://localhost:8000
• Im Netzwerk (z. B. Smartphone): http://<IP-des-Rechners>:8000

Funktionen

• PDF-Datei hochladen
• Optional Ruhetage ausschließen
• Optional Urlaub ausschließen
• ICS-Datei direkt herunterladen

Hinweise für mobile Nutzung

• Smartphone und Server müssen im gleichen Netzwerk sein (lokaler Betrieb)
• Bei Internet-Betrieb sollte HTTPS und ein Reverse Proxy (z. B. Nginx) genutzt werden
• Hochgeladene Dateien werden nur temporär verarbeitet

Technischer Aufbau

• web/app.py – FastAPI-Backend + Upload/Download-Endpunkte
• web/templates/index.html – mobile Web-Oberfläche
• web/requirements-web.txt – Web-spezifische Abhängigkeiten

Produktion (Kurz)

Beispiel mit Uvicorn direkt:

.venv/bin/python -m uvicorn web.app:app --host 0.0.0.0 --port 8000

Empfohlen für Internet-Betrieb:

• Uvicorn hinter Nginx
• HTTPS aktivieren
• Upload-Größenlimit setzen
• Zugriff absichern (z. B. Basic Auth oder Login)