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.
Speicher
Abschnitt betitelt „Speicher“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.
Zeitplan
Abschnitt betitelt „Zeitplan“| 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.
Inhalt des Archivs
Abschnitt betitelt „Inhalt des Archivs“| 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 |
Manuelles Archiv
Abschnitt betitelt „Manuelles Archiv“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.
Schnittstelle
Abschnitt betitelt „Schnittstelle“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.