Community · Hilfe

Sheetward Benutzerhandbuch

Verwandeln Sie eine Excel- oder OpenDocument-Arbeitsmappe (oder ein Google Sheet) in eine mehrbenutzerfähige Web-App — Formulare, Validierung, Nachschlagelisten, Import/Export und mehr.

Eine veröffentlichte eigenständige App ausführen

Eine eigenständige App ist eine eigenständige ZIP-Datei, die Sie auf einem Laptop, einem Büro-PC oder Ihrem eigenen Server ausführen können. Es kommt startbereit an: eine kompilierte Web-Oberfläche, ein kleines Programm zum Starten und die Daten der App in einer lokalen SQLite-Datei. Wer es betreibt (der eigenständige App-Operator), muss nichts kompilieren — kein git, kein npm. Die README.md im Ordner erklärt jede Einstellung, und manifest.json hält fest, wann die enthaltene Web-Oberfläche gebaut wurde — die laufende App meldet denselben Stempel unter /api/health, praktisch, wenn Sie erneut in denselben Ordner exportieren.

Schnellstart — entpacken Sie die Datei, dann in diesem Ordner:

  • python -m pip install -r requirements.txt
  • python run.py — öffnen Sie dann http://127.0.0.1:8000 in Ihrem Browser.
  • Sie brauchen eine andere Adresse oder einen anderen Port? PORT=9000 HOST=0.0.0.0 python run.py.

Wer sich anmelden kann. Eine eigenständige App registriert nie neue Konten und bleibt damit genauso privat wie am Tag der Veröffentlichung. Alle, die beim Veröffentlichen Zugriff hatten, sind bereits angelegt und melden sich mit derselben E-Mail-Adresse und demselben Passwort an. Das Zurücksetzen des Passworts gibt es in einem eigenständige App nicht — verwenden Sie nach der Anmeldung Passwort ändern.

Sensible Felder. Enthält die App verschlüsselte Felder, lassen sich deren Werte nur mit dem Schlüssel der App öffnen. Nach dem Export zeigt Sheetward den Schlüssel einmal an — tragen Sie ihn vor dem Start als SHEETAPP_APP_FIELD_KEY in die .env im Ordner ein. Oder Sie setzen beim Export das Häkchen, damit er direkt in die .env geschrieben wird: bequem, aber dann kann jeder mit der ZIP-Datei diese Felder lesen. Ohne Schlüssel läuft die App, diese Felder bleiben jedoch unlesbar.
Daten & Backups. Alles liegt neben run.py: Datensätze in einer lokalen app.db-Datei, Anhänge im Ordner data/. Kopieren Sie diese beiden regelmäßig an einen sicheren Ort, und Sie können Ihre Datensätze jederzeit wiederherstellen.