Add browser-based web MVP with mobile upload flow
This commit is contained in:
49
WEB_README.md
Normal file
49
WEB_README.md
Normal file
@@ -0,0 +1,49 @@
|
||||
# 🌐 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)
|
||||
Reference in New Issue
Block a user