Die Terminverwaltung im Vereinsbetrieb betreiben
Du sorgst für einen erreichbaren Dienst, geschützte Daten und wiederherstellbare Sicherungen. Die vollständigen Konfigurations- und Wiederherstellungsbefehle stehen in Betrieb.
Alle Anleitungen · Hilfe bei Problemen
Lokal starten und an die Administration übergeben
Für einen Build aus dem Quellcode brauchst du die Go-Version aus go.mod. Mit einem passenden Releaseprogramm ist Go für den Start nicht nötig.
- Baue im Projektverzeichnis bei Bedarf das Programm mit
make build. - Starte
./Start.sh; auf dem Mac kann auchStart.commandverwendet werden. - Öffne die konfigurierte Browseradresse. Ohne Änderung ist das
http://127.0.0.1:8080. - Gib das beim ersten Start ausgegebene Einrichtungstoken vertraulich an die zuständige Administration weiter oder führe die Einrichtung selbst aus.
- Verwende für Gruppen, Kalender und Mitglieder die Administrationsanleitung.
Ein vorhandenes bin/terminverwaltung hat beim Startskript Vorrang vor einem plattformspezifischen Releaseprogramm. Beachte das beim Wechsel der Programmversion. Die lokale Adresse ist an dieses Gerät gebunden; für gemeinsame Nutzung wird ein erreichbarer Server benötigt.
Den gemeinsamen Zugang einrichten
Die öffentliche Vereinsadresse wird über APP_PUBLIC_URL konfiguriert und muss exakt der Browseradresse entsprechen. APP_ADDR bestimmt, wo der Server lauscht; APP_DATA nennt den privaten Datenordner. .env.example ist die Vorlage. Bereits gesetzte Umgebungsvariablen haben Vorrang vor .env.
Für den gemeinsamen Betrieb verwende eine HTTPS-Adresse und einen vertrauenswürdigen Reverse-Proxy. Das Backend bleibt lokal oder in einem privaten Netz erreichbar. Die Betriebsanleitung beschreibt das Linux-Binary hinter Apache sowie die Einrichtung mit Caddy und Compose.
Prüfe vor der Übergabe, ob die vereinbarte Adresse von einem vorgesehenen Mitgliedsgerät erreichbar ist. Stelle der Administration Vereinsadresse, Datenpfad, Verfahren zum Neustart und eine zuständige Kontaktperson bereit. Der private Datenordner darf nicht als Webseite ausgeliefert werden. Pro Datenordner darf nur eine Instanz laufen.
Den täglichen Betrieb kontrollieren
- Prüfe die Erreichbarkeit der Vereinsseite und auffällige Anwendungsfehler.
- Lass die Administration Fehler beim Feedabgleich prüfen. Die Anwendung behält bei fehlgeschlagenem Abruf den bisherigen Terminbestand.
- Prüfe, ob aktuelle Sicherungen vorhanden sind und externe Kopien erstellt werden.
- Halte fest, welche Programmversion und welche Konfiguration verwendet werden.
Der Server ruft nur öffentlich erreichbare unterstützte HTTPS-Feeds ab. Lokale Netzwerkziele und reine CalDAV-Zugänge mit Anmeldung sind keine unterstützten Quellen. Importprobleme und die genaue Abrufkonfiguration beschreibt Terminfeeds und Aktualisierung.
Sicherungen aufbewahren
Standardmäßig liegen die Daten unter data-lite und automatische Sicherungen in dessen Unterordner backups. Beim Start und stündlich wird der aktuelle UTC-Tagesstand gesichert; höchstens 14 Tagesarchive bleiben erhalten. Kopiere Sicherungen regelmäßig auf einen weiteren geschützten Datenträger, damit ein Defekt des Servers nicht auch alle Kopien betrifft.
Sicherungen sind unverschlüsselte JSON-Dateien und enthalten unter anderem vertrauliche Quelladressen, Mitgliederdaten, Antworten und Passwort-Hashes. Die automatisch erzeugten Dateirechte ersetzen keine geschützte Aufbewahrung externer Kopien. .env und die verwendete Startkonfiguration werden separat gesichert; über Umgebungsvariablen gesetzte Pfadschutzdaten sind nicht Teil der Anwendungssicherung.
Für eine zusätzliche Offline-Sicherung stoppe zuerst den laufenden Dienst. Ein Beispiel aus der Betriebsanleitung:
./Start.sh -backup /sicherer/pfad/termine.json
Der Zielpfad ist ein Platzhalter für deinen vorbereiteten geschützten Sicherungsort. Eine unter Verwaltung → Einstellungen heruntergeladene Sicherung enthält ebenfalls vertrauliche Daten. Exporte von Kalenderterminen oder Rückmeldungen ersetzen keine vollständige Sicherung.
Wiederherstellung planen
- Stoppe den Dienst und bewahre den bisherigen Datenordner auf.
- Stelle die Sicherung in einen leeren Zieldatensatz wieder her und prüfe ihn.
- Stelle die Startkonfiguration auf den geprüften Datenordner und die richtige Vereinsadresse ein.
- Starte den Dienst und prüfe mit der Administration öffentliche Inhalte, Gruppen und Termine.
- Lass neue Mitgliederzugänge, persönliche Abos und Gastlinks ausstellen. Informiere die betroffenen Personen über die nötige erneute Einrichtung.
Beispiel für einen leeren Zielordner:
./Start.sh -data ./wiederhergestellt -restore /sicherer/pfad/termine.json
./Start.sh -data ./wiederhergestellt -check
Restore entwertet Sitzungen, offene Freischaltlinks, persönliche Abotokens und Gastlinks. Bestehende Daten und Gaststimmen bleiben erhalten. Ein Domainwechsel erfordert außerdem neue öffentliche Abos. Prüfe die Wiederherstellung zunächst mit einem getrennten Datenordner; Details stehen unter Sicherung und Wiederherstellung.
Aktualisierungen und Zugangsprobleme bearbeiten
Stoppe vor einer Aktualisierung den Dienst, erstelle eine vollständige Sicherung und beachte die Hinweise zur Datenübernahme. Ersetze die Programmdateien und starte mit demselben vorgesehenen Datenordner. Alte und neue Version dürfen einen übernommenen Bestand nicht parallel fortschreiben. Der Abschnitt zu Aktualisierungen erklärt die vorhandenen Altformate und Grenzen.
Bei vergessenem Administrationspasswort verwende nach Stoppen des Dienstes den dokumentierten Passwortreset. Für einen verloren gegangenen, in der Anwendung gespeicherten Pfadschutz gibt es -reset-path-auth. Ein durch Umgebungsvariablen gesetzter Schutz wird dadurch nicht entfernt. Diese Eingriffe gehören in eine private Betriebssitzung.
Mitglieder benötigen bei normalen Gerätewechseln keinen Eingriff am Server: Die Administration stellt neue Freischaltlinks aus. Bei Rückmeldefragen ist die zuständige Leitung die erste Ansprechperson.