50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
# 🌐 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
|
||
```bash
|
||
./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:
|
||
```bash
|
||
.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)
|