108 lines
3.9 KiB
Markdown
108 lines
3.9 KiB
Markdown
# 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.
|