Files
tickettracker/docs/confluence/06-profil-admin-und-betrieb.md
2026-10-13 10:43:53 +02:00

3.9 KiB

Profil, Adminbereich und Betrieb

Diese Seite beschreibt persönliche Einstellungen, Adminfunktionen und betriebliche Hinweise.

Profil

Jeder Benutzer pflegt im Profil seine persönlichen Einstellungen:

  • Benutzername und Anzeigename
  • Passwort
  • persönlicher Zammad API-Token
  • Teamspace-Geraete-ID und Geraetepasswort
  • angezeigte Zammad User-ID
  • angezeigte Teamspace User-ID
  • Bewertungsabfrage beim Timerabschluss
  • Teamspace-Zeiten in TT erfassen
  • interne Zammad-Notiz beim Timerabschluss
  • Standard-Typ für interne Zammad-Notizen
  • optionale Zammad-Zeitaufrundung für time_unit
  • ATOSS/eMail-Sync-Optionen, sofern aktiviert
  • Projekt-Wiedervorlagen

Passwortänderungen erfordern das aktuelle Passwort. Bleiben die Passwortfelder leer, werden nur die übrigen Profildaten gespeichert.

Zammad-Zugang im Profil

Normale Benutzer können im Profil einen persönlichen Zammad API-Token hinterlegen. Beim Speichern eines neuen Tokens ruft TicketTracker Zammad ab und speichert die User-ID, die Zammad für diesen Token zurückliefert.

Der Token wird verschlüsselt gespeichert. Die User-ID wird danach read-only im Profil angezeigt.

Teamspace-Zugang im Profil

Jeder Benutzer kann seine Teamspace-Geraete-ID und sein Geraetepasswort speichern.

Beim Speichern werden die Zugangsdaten gegen Teamspace geprüft. Wenn die Prüfung erfolgreich ist, speichert TicketTracker die Teamspace User-ID und zeigt sie im Profil an.

Geraete-ID und Passwort werden verschlüsselt in der Datenbank gespeichert.

Teamspace-Zeiten in TT erfassen

Der Schalter Teamspace-Zeiten in TT erfassen ist userbezogen und steuert, ob ein Benutzer Teamspace-Tageswerte in TicketTracker pflegt.

An:

  • Teamspace-Tageswerte können in TicketTracker erfasst werden.
  • Manuelle Projektstunden sind editierbar.
  • Projekt-Ist kommt aus TT-Teamspace-Tageswerten plus manuellen Projektstunden.
  • Statistiken und Monatsprüfung vergleichen TT gegen Teamspace-Werte.

Aus:

  • Teamspace-Tageswerte können nicht erfasst werden.
  • Manuelle Projektstunden sind ausgeblendet und serverseitig gesperrt.
  • Projekt-Ist kommt aus Teamspace.
  • Monatsprüfung und Widgets prüfen nur Session-Status.
  • Teamspace-Differenzen werden ausgeblendet.

Der Schalter ist bewusst userbezogen. Zwei Benutzer können am gleichen Projekt arbeiten und trotzdem unterschiedliche Erfassungs- und Prüflogiken nutzen.

Adminbereich

Der feste Admin ist für Systemverwaltung vorgesehen. Er kann:

  • Benutzer anlegen und bearbeiten
  • Passwörter für Benutzer setzen
  • Zammad-Adminzugang für Organisationssync pflegen
  • Teamspace-Base-URL speichern
  • Organisationen aus Zammad synchronisieren
  • SQL-Backups herunterladen
  • Restore-fähige SQL-Backups wieder einspielen

Der Admin sieht keine Timer, keine persönlichen Auswertungen, keine Statistiken, keine fixen Abrechnungen und keinen Monatsabschluss. Diese Bereiche sind für normale Benutzer vorgesehen.

Teamspace-Base-URL

Die Teamspace-Base-URL wird im Adminbereich gespeichert. Ohne diese URL können Benutzer ihre Teamspace-Zugangsdaten nicht sinnvoll für API-Syncs nutzen.

Die persönlichen Teamspace-Zugangsdaten liegen dagegen im Benutzerprofil.

Backup und Restore

Der Adminbereich kann SQL-Backups erzeugen und wieder einspielen.

Der Export enthält alle Tabellen, die für den Systemstand notwendig sind, unter anderem:

  • Benutzer
  • Einstellungen
  • Organisationen
  • Tickets
  • Sessions
  • Teamspace-Werte
  • Projektinformationen
  • Unterpositionen
  • fixe Abrechnungen
  • Ausnahmen
  • Monatsabschlüsse

Ein Restore ersetzt den aktuellen Datenbestand durch den Stand des Backups. Vor dem Restore wird die Struktur geprüft. Nach dem Restore ist eine neue Anmeldung mit den Zugangsdaten aus dem Backup notwendig.

Technischer Stack

  • Frontend: Next.js, React, shadcn/ui, Tailwind CSS
  • Backend: Node.js, Express, TypeScript
  • Datenbank: PostgreSQL
  • Deployment: Docker-fähig

Secrets wie Zammad-Token und Teamspace-Zugangsdaten werden verschlüsselt gespeichert.