Add setup and restore flow

docs/docker-release.md

@@ -14,7 +14,6 @@ cp .env.docker-external.example .env.docker-external
 
 ```bash
 DATABASE_URL=postgresql://tickettracker:PASSWORT@10.10.10.23:5432/tickettracker
-ADMIN_PASSWORD=ein-sicheres-passwort
 TICKETTRACKER_IMAGE=git.d-razz.de/michael/tickettracker:latest
 APP_PORT=3910
 ```
@@ -37,7 +36,6 @@ cp .env.docker-postgres.example .env.docker-postgres
 
 ```bash
 POSTGRES_PASSWORD=ein-sicheres-db-passwort
-ADMIN_PASSWORD=ein-sicheres-admin-passwort
 TICKETTRACKER_IMAGE=git.d-razz.de/michael/tickettracker:latest
 APP_PORT=3910
 ```
@@ -50,6 +48,17 @@ docker compose --env-file .env.docker-postgres -f compose.postgres.yml up -d
 
 Die Datenbankdaten liegen im Docker-Volume `tickettracker_postgres_data`.
 
+## Erstes Setup
+
+Admin-Zugangsdaten werden nicht per `.env` gesetzt. Nach dem ersten Start oeffnest du TicketTracker im Browser und landest automatisch auf der Setup-Seite.
+
+Dort gibt es zwei Wege:
+
+- `Admin anlegen`: festen Admin direkt erstellen und anmelden.
+- `Backup einspielen`: ein TicketTracker-SQL-Backup einspielen. Danach meldest du dich mit einem Benutzer aus dem Backup an.
+
+Ein Restore ersetzt den kompletten Systemstand. Vor dem Einspielen werden alle TicketTracker-Tabellen geleert; danach gelten ausschliesslich Benutzer, Passwoerter, Sessions, Settings, Organisationen, fixe Abrechnungen und Abschluesse aus dem Backup.
+
 ## Image bauen und in Gitea pushen
 
 Einmal am Docker/Gitea-Registry anmelden:

docs/user-guide.md

@@ -2,6 +2,17 @@
 
 Diese Anleitung beschreibt die Nutzung von TicketTracker im Arbeitsalltag: Zeiten erfassen, Sessions bewerten, Teamspace-Zeiten eintragen, fixe Abrechnungen verwalten, Statistiken lesen und den Monatsabschluss durchfuehren.
 
+## Erstes Setup
+
+Wenn noch kein Admin existiert, zeigt TicketTracker beim Aufruf automatisch die Setup-Seite.
+
+Dort gibt es zwei Moeglichkeiten:
+
+- `Admin anlegen`: festen Admin mit Benutzername, vollem Namen und Passwort erstellen. Danach ist der Admin direkt angemeldet.
+- `Backup einspielen`: ein TicketTracker-SQL-Backup aus einem frueheren Systemstand einspielen. Danach meldet man sich mit einem Benutzer aus dem Backup an.
+
+Ein Restore ersetzt den kompletten Systemstand. Vor dem Einspielen werden alle TicketTracker-Tabellen geleert. Danach gilt ausschliesslich der Stand des Backups, inklusive aller Benutzer, Passwoerter, Sessions, Einstellungen, Organisationen, fixen Abrechnungen und Abschluesse.
+
 ## Grundprinzip
 
 TicketTracker ersetzt nicht das Ticketsystem und nicht das CRM. Die App ist die Arbeitszeiterfassung und Auswertung daneben.
@@ -26,17 +37,17 @@ An vielen Stellen in der Oberflaeche gibt es ein Fragezeichen-Icon. Ein Klick da
 2. Mit Benutzername und Passwort anmelden.
 3. Nach der Anmeldung ist die Seitenleiste sichtbar.
 
-Normale Benutzer sehen ihre eigenen Zeiten, Auswertungen, fixen Abrechnungen und ihr Profil. Administratoren sehen zusaetzlich den Adminbereich.
+Normale Benutzer sehen ihre eigenen Zeiten, Auswertungen, fixen Abrechnungen und ihr Profil. Der feste Admin sieht nur Administration, Profil und FAQ.
 
 Die Navigation ist in Workflows gegliedert:
 
-- Timer
+- Session starten
 - Auswertung
 - Monatsabschluss
 - Statistiken
 - Fixe Abrechnung
 - Profil
-- Benutzer, nur fuer Admins
+- Administration, nur fuer Admin
 - FAQ
 
 Nach `Auswertung`, nach `Monatsabschluss` und vor `FAQ` trennt eine Linie die Bereiche optisch.
@@ -432,6 +443,8 @@ Der Datenbankexport im Adminbereich erzeugt eine SQL-Datei fuer einen kompletten
 
 Der Export enthaelt alle Tabellen, die fuer den Stand des Systems notwendig sind: Benutzer, Einstellungen, Organisationen, Tickets, Sessions, Teamspace-Werte, fixe Abrechnungen, Ausnahmen und Monatsabschluesse. Er ist kein reiner CSV-Auszug, sondern ein Restore-Backup.
 
+Im laufenden System kann der Admin ein SQL-Backup ebenfalls im Adminbereich wieder einspielen. Vor dem Restore erscheint ein Hinweis, weil alle aktuellen Daten ersetzt werden. Nach dem Restore ist eine neue Anmeldung mit den Zugangsdaten aus dem Backup notwendig.
+
 ## Zammad Sync
 
 Der Zammad-Sync ist nur fuer Administratoren sichtbar.