🏰 BurgCloud – Tester-Handbuch

Version: 1.1
Stand: November 2025
Zielgruppe: QA-Team & interne Tester

⚠️ Bitte nur Testdaten verwenden!

Nach dem Beta-Test wird die Umgebung komplett zurückgesetzt und mit individuellen Rollen neu aufgesetzt.

Hinweis: Während der Testphase rechnen wir mit regelmäßigen Updates, spontanen Downtimes und gelegentlichen Restarts der Umgebung. Bitte meldet Auffälligkeiten trotzdem, damit wir die Stabilität verbessern können.

📚 Inhaltsverzeichnis

  1. Login & Rollen
  2. Dokumenten-Workflow
  3. Temporäre Upload-Links
  4. Admin-Werkzeuge
  5. FAQ & Tipps
  6. Feedback & Kontakt
1. Login & Rollen

Alle Rollen sind bereits konfiguriert und können genutzt werden. Aktuell ist jedoch nur ein gemeinsamer Admin-Account eingerichtet, den alle Tester verwenden dürfen. Eigene Konten folgen erst vor dem Go-Live.

Testzugang
URL: http://49.12.13.17
E-Mail: admin@burgverein.de
Passwort: BurgAdmin2025!
2. Dokumenten-Workflow

Ordner & Navigation

  • Hauptordner sind nach Sektionen gruppiert (Dokumente, Vereinsverwaltung, Finanzen). Unterordner werden in der Navigation eingerückt dargestellt.
  • Container-Ordner (z. B. „Finanzen“) dienen nur als Sammelpunkt: Uploads sind gesperrt, stattdessen erscheint eine Unterordner-Kachelansicht.
  • Foto-Ordner öffnen ein Kontextmenü (Rechtsklick / Langdruck) mit Aktionen wie „Öffnen“, „Download“, „Bearbeiten“, „Versionen“ und „Löschen“.

Upload

  • Drag & Drop oder Button „Dateien auswählen“.
  • Ordnerspezifische Dateitypen werden angezeigt (z. B. RAW-Formate im Ordner „Fotos“). Container-Ordner zeigen keinen Upload-Button.
  • Mehrfach-Uploads laufen parallel über den neuen SFTP-Verbindungspool.

Versionierung

  • Gleicher Dateiname ⇒ automatische neue Version.
  • Ältere Versionen bleiben verfügbar, aber werden als „nicht aktuell“ markiert.
  • Im Bearbeiten-Modal („✏️“) lassen sich Versionen einsehen oder neue hinzufügen.
  • PDF-Dateien blenden bei vorhandenen Schreibrechten einen „Bearbeiten“-Button direkt im Viewer ein.

Löschen & Wiederherstellen

  • „Gefahrenzone" im Bearbeiten-Modal löscht alle Versionen.
  • Der Dokument-Abgleich ermöglicht das Wiederherstellen gelöschter DB-Einträge.
Bitte testen (Desktop & Smartphone)
  • Neue Rollen vergeben und Sicht-/Uploadrechte pro Ordner kontrollieren (Admin-Checkboxen sind jetzt schreibgeschützt).
  • Zusätzliche Benutzer anlegen und wieder entfernen.
  • Ordner (inkl. Unterordner & Container) erstellen, Elternordner zuweisen, Templates wechseln und Auswirkungen prüfen.
  • Kontextmenü & Viewer testen: Fotos via Rechtsklick öffnen, PDF-Bearbeiten-Button ausprobieren.
  • Datei-Uploads in verschiedenen Ordnern (Einzel- & Mehrfach-Upload) und anschließende Downloads.
3. Temporäre Upload-Links

Unter Admin → Token-Verwaltung können Upload-Tokens angelegt werden.

Konfiguration
  • Zielordner (z. B. „Fotos“)
  • Ablaufdatum & Upload-Limit
  • Erlaubte Dateitypen und Maximalgröße
  • Aktive Tokens werden protokolliert (UploadTokenUsage).

Nutzung erfolgt anonym via /PublicUpload/Upload?token=….

Achtung: Die Eingabemaske zum Erstellen neuer Tokens wird aktuell überarbeitet. Falls eine Fehlermeldung erscheint, gerne trotzdem melden – das hilft bei der Fertigstellung.
4. Admin-Werkzeuge

Dokument-Abgleich

  • Erstellt alle 15 Minuten einen Snapshot (Storage Box vs. Datenbank).
  • „Neu scannen“ erzwingt sofort eine Aktualisierung.
  • „Clean Server“ öffnet ein Modal, entfernt verwaiste Dateien (1 TB Storage Box, ~6 MB genutzt).

Ordner & Rollen

  • Ordnerstruktur inklusive Sektionen verwalten und Rollen gezielt Zugriff erteilen.
  • Beim Erstellen/Bearbeiten einer Rolle kannst du direkt festlegen, welche Ordner sichtbar bzw. beschreibbar sind. Administrator-Rechte sind fest vorgegeben und nur lesbar.
  • Container-Ordner („Kann Unterordner enthalten“) erhalten automatisch den Dokumenten-Typ ohne Uploads. Sobald dieses Flag gesetzt ist, verschwindet die Template-Auswahl.
  • Unterordner können nur dann einem Elternordner zugewiesen werden, wenn dieser Container-Funktion erlaubt. Dropdown filtert automatisch nach passender Sektion.
  • Die Ordnerübersicht nutzt feste Hauptkategorien (z. B. „Dokumente“, „Vereinsverwaltung“, „Finanzen“). Sortierung innerhalb einer Sektion erfolgt intern – Eingabefeld „Position“ wurde entfernt.
  • Neu: Jeder Ordner besitzt einen einstellbaren Ordner-Typ (Dokumente, Fotos, Tabellen, Kalender). Der Typ bestimmt die erlaubten Dateiformate und welches Partial angezeigt wird.
Tipp zur Navigation

Falls ein Ordner scheinbar „verschwindet“: Prüfe die passende Sektion. Die Listen sind alphabetisch nach Sektion → Sortierposition → Ordnername aufgebaut.

5. FAQ & Tipps
  • Warum sehe ich keine Änderungen? → Snapshot evtl. älter; „Neu scannen“ klicken.
  • Upload schlägt fehl? → Dateiendung/Größe prüfen (Konsole gibt Hinweise).
  • Wofür ist die lokale 40 GB-Disk? → Temporäre Backups & Restore-Puffer (/home/burgcloud/backups-local).
  • Welche Tests fehlen noch? → Rollen, Benutzer und Ordner bitte aktiv anlegen/ändern – einmal am PC-Browser und zusätzlich über ein Smartphone durchspielen.
6. Feedback & Kontakt

Bitte nutzt bevorzugt den neuen Feedback-Prozess:

🔗 In der Kopfzeile befindet sich der Button „Feedback geben“ → öffnet das Google-Sheet Fehlerberichte BURG_CLOUD.

Falls das Formular nicht erreichbar ist, gerne direkt an Eric melden:

📧 lenk.eric@ikmail.com
💬 WhatsApp-Testgruppe (Link im internen Chat)
🛠️ Logs: docker compose logs