Zum Inhalt springen

Integrationen

Archiv im eigenen Speicher

Ein Betrieb kann seine Daten als Archiv in einen Speicher schreiben lassen, der ihm selbst gehört. Das Archiv ist eine ZIP-Datei mit allem, was der Betrieb auf Ski4me hat, in Formen, die sich ohne Ski4me lesen lassen.

Eingerichtet wird es im Portal unter Archiv, Karte Eigener Speicher. Das darf nur ein Admin.

Unterstützt wird Speicher mit S3-Schnittstelle. Das sind die großen Anbieter ebenso wie ein selbst betriebener, etwa mit MinIO.

Angabe Bedeutung
Name zum Wiedererkennen im Portal
Endpunkt Adresse des Speichers, mit https://
Bucket wohin geschrieben wird
Präfix Ordner im Bucket, freiwillig
Region wo der Anbieter sie verlangt
Zugangsschlüssel und Geheimnis mit Schreibrecht auf den Bucket

Die Zugangsdaten liegen verschlüsselt und werden nie wieder angezeigt. Der Endpunkt muss von außen erreichbar sein; Adressen in privaten Netzen werden abgelehnt.

Testen schreibt eine kleine Datei, liest sie zurück und löscht sie wieder. So zeigt sich vor dem ersten Lauf, ob Adresse und Rechte stimmen.

Angabe Wahl
Rhythmus täglich, wöchentlich, monatlich oder einmal nach Saisonende
Uhrzeit volle Stunde in der Zeit des Betriebs, Vorgabe 2 Uhr
Wochentag bei wöchentlich
Tag im Monat bei monatlich, 1 bis 28
Aufbewahren wie viele Archive im Speicher bleiben, Vorgabe 12

Nach jedem Lauf entfernt Ski4me ältere Archive, die über die Zahl hinausgehen. Der Lauf nach Saisonende startet am Tag nach dem Ende der Saison aus den Einstellungen.

Die Dateien heißen <betrieb>-archiv-<JJJJ-MM-TT>-<lauf>.zip.

Pfad Inhalt
README.txt was das Archiv ist und wie man es liest
manifest.json Inhaltsverzeichnis mit Prüfsummen
pruefen.mjs ein Skript, das die Prüfsummen nachrechnet
datenbank/db.sqlite, datenbank/schema.sql die Datenbank des Betriebs und ihr Aufbau
tabellen/*.csv Buchungen, Personen, Positionen, Aufträge, Zahlungen, Rückzahlungen, Kurse, Belege, Unterkünfte, Preislisten und weitere
tabellen/journal.jsonl das Journal
dokumente/ Rechnungen, Gutschriften und weitere Dokumente
bilder/ die Originale der hochgeladenen Bilder
website/ Inhalte der Website des Betriebs

Ein Admin kann jederzeit ein Archiv anstoßen und es im Portal herunterladen, höchstens dreimal am Tag. Die Datei liegt sieben Tage bereit. Der Link zum Herunterladen gilt einmal und nur für eine angemeldete Person.

Eine Schnittstelle nach außen hat das Archiv nicht: es gibt keinen Schlüssel, mit dem ein fremdes Programm einen Lauf anstößt oder ein Archiv abholt. Wer Daten laufend braucht, nimmt die offene Schnittstelle; wer einen vollständigen Stand braucht, liest das Archiv aus dem eigenen Speicher.