← hutauf.org

Datenkonto selbst betreiben

Das Datenkonto ist das Backend hinter dem Userscript taxsummary und dem Vine Produkt Manager: Es speichert deine Produktdaten und gleicht sie zwischen deinen Geräten ab. Wer seine Daten nicht dem gehosteten Datenkonto anvertrauen möchte, betreibt dasselbe Backend auf einem eigenen Server. Eine einzige Python-Datei genügt.

self_hosted_backend.py herunterladen 2641 Zeilen, 100 KB · SHA-256 d0ed27be05cc6ae7d64bb8de59ee2ac414ee3212aeb449becd8c14c7bcb76674

Ohne eigenen Server brauchst du nichts davon: Ohne Token bleiben alle Daten ausschließlich lokal in deinem Browser. Diese Seite beschreibt den Weg über einen kostenlosen Account bei PythonAnywhere; jeder andere Server mit Python und Flask geht genauso.

Teil 1: Das Backend einrichten

  1. Account anlegenLege bei PythonAnywhere (pythonanywhere.com) einen kostenlosen „Beginner“-Account an.
  2. Flask-CORS installierenÖffne im Dashboard den Tab Consoles, starte eine Bash-Konsole und führe aus:
    pip install --user flask-cors
    Die Meldung Requirement already satisfied bedeutet, dass das Paket schon da ist. Weitere Pakete braucht das Backend nicht.
  3. Web-App anlegen und Code einsetzenErstelle im Tab Web eine neue Flask-Web-App. Öffne im Tab Files die angelegte flask_app.py, lösche ihren Inhalt und ersetze ihn durch den Inhalt von self_hosted_backend.py (oben herunterladen).
  4. Eigene Tokens festlegenSuche im Code den Block VALID_TOKENS = { … } und ersetze die Platzhalter durch eigene, lange, zufällige Zeichenketten. Sie sind die Passwörter deiner API: Wer einen Token kennt, kann die Daten dazu lesen und ändern. Für jede Person einen eigenen Token; jeder Token bekommt seine eigene Datenbank.
  5. Speichern und neu ladenSpeichere die Datei und klicke im Tab Web auf den grünen Button Reload.
  6. Am Leben haltenIm kostenlosen Tarif deaktiviert PythonAnywhere eine Web-App nach drei Monaten. Melde dich alle zwei bis drei Monate an und klicke im Tab Web auf Run until 3 months from today.

Teil 2: Die Werkzeuge verbinden

  1. Vine Produkt ManagerÖffne die Einstellungen, trage unter Backend API URL deine Adresse ein und darunter deinen Token, dann Speichern:
    https://DEIN_BENUTZERNAME.pythonanywhere.com/data_operations
  2. taxsummary im Vine-PortalÖffne im Amazon-Vine-Portal die Seite Konto, in der VineTaxTools-Box den Dialog Synchronisation, trage deinen PythonAnywhere-Benutzernamen und denselben Token ein und klicke auf Konfiguration speichern.

Aktualisieren

Für ein Update ersetzt du den Inhalt deiner flask_app.py wieder vollständig durch die aktuelle Datei von dieser Seite und trägst deine Tokens erneut ein.

Vorher sichern. Lade vor jedem Update den Ordner user_databases herunter. Beim ersten Start einer neuen Version werden bestehende Datenbanken automatisch auf das aktuelle Format gebracht; dabei entstehen einmalig Sicherungen mit der Endung .pre-sync-v2.bak. Laufen alte und neue Version gleichzeitig, kann das Daten durcheinanderbringen: alte Version erst ganz beenden, dann die neue starten.

Die Datenbanken liegen im Ordner user_databases relativ zum Arbeitsverzeichnis der App. Wer einen festen Ort will, setzt vor dem Start die Umgebungsvariable VINE_SYNC_DB_DIR auf einen absoluten Pfad und prüft danach, dass die bestehenden Daten dort auch gefunden werden.

Quellcode

Die Datei ist der gepflegte Stand des Backends. Das frühere Repository hutauf/data_operations_backend ist veraltet und verweist hierher.