1.1.0-rc1

docs/confluence/00-tickettracker-hauptseite.md

@@ -0,0 +1,89 @@
+# TicketTracker
+
+Stand: Oktober 2026
+
+TicketTracker ist ein Arbeits-, Projekt- und Abrechnungscockpit für ticketbasierte Arbeit. Das System ergänzt Zammad und Teamspace: Zammad bleibt das Ticketsystem, Teamspace bleibt die Quelle für Projektbudgets und gebuchte Projektwerte, TicketTracker führt Erfassung, Bewertung, ToDos, Projektüberwachung und Monatsabschluss zusammen.
+
+Der Kernnutzen: Jeder Benutzer sieht, was er gearbeitet hat, was noch bewertet werden muss, welche Projektbudgets kritisch sind, welche Teamspace-Daten fehlen oder abweichen und wann ein Monat sauber abgeschlossen werden kann.
+
+## Zielgruppe und Einsatz
+
+TicketTracker ist für Teams oder Einzelpersonen gedacht, die viel mit Tickets arbeiten und ihre Zeiten zuverlässig nachvollziehen müssen.
+
+Typische Einsatzfälle:
+
+- Support- und Consulting-Zeiten per Timer erfassen
+- Sessions nachträglich ergänzen
+- Arbeit am Ticket dokumentieren
+- Sessions als offen, abrechenbar, abgerechnet oder nicht abrechenbar bewerten
+- Teamspace-Tageswerte für abrechnungsrelevante Projektzeiten pflegen oder Teamspace als Ist-Quelle nutzen
+- Monatsabschlüsse kontrolliert vorbereiten
+- Consulting-Projekte mit Teamspace-Budgets, Reststunden und Unterpositionen überwachen
+- ToDos und Wiedervorlagen direkt am Ticket oder Projekt organisieren
+- wiederkehrende Leistungen automatisch erzeugen lassen
+- interne Zammad-Notizen aus TicketTracker heraus erzeugen
+
+## Grundprinzip
+
+TicketTracker arbeitet auf drei Ebenen:
+
+1. **Session-Zeit**  
+   Die tatsächlich gemessene oder manuell erfasste Arbeitszeit.
+2. **Teamspace-/Projekt-Ist**  
+   Je nach Profilmodus entweder in TicketTracker gepflegte Teamspace-Tageswerte oder direkt aus Teamspace synchronisierte Ist-Werte.
+3. **Monatsabschluss**  
+   Der kontrollierte Abschluss eines Monats, sobald alle Sessions final bewertet und die benötigten Prüfpunkte erledigt sind.
+
+Wichtig: Tickets werden nicht abgeschlossen. Tickets dienen als Arbeits- und Auswertungsrahmen. Abgeschlossen wird der Monat.
+
+## Die wichtigsten Bereiche
+
+- **Timer und Sessions:** Zeiten erfassen, nachtragen, bewerten und dokumentieren.
+- **Tickets:** Sessions pro Ticket, Tag und Monat prüfen.
+- **Projekte:** Consulting-Projekte, Teamspace-Projekte, Budgets, Reststunden und Unterpositionen überwachen.
+- **Teamspace:** Projekt-IDs, Budgets, Unterpositionen, Monatszeiten und Istwerte synchronisieren.
+- **Zammad:** Organisationen, Ticketstammdaten, Status, Priorität und interne Notizen anbinden.
+- **ToDos:** Aufgaben, Termine, Wiedervorlagen und Projektfollow-ups verwalten.
+- **Dashboard:** Tagessteuerung für offene Bewertungen, ToDos, Teamspace-Nacharbeit und Projektwarnungen.
+- **Statistiken:** Monatswerte, Organisationen, Tickets, Projektbudgets und Teamspace-Abgleich auswerten.
+- **Monatsabschluss:** Einen Monat kontrolliert schließen oder wieder öffnen.
+
+## Unterseiten für Confluence
+
+Diese Dokumentation ist für den Import als Confluence-Seitenbaum vorbereitet:
+
+1. `01-zeiterfassung-sessions-monatsabschluss.md`
+2. `02-projekte-budgets-teamspace.md`
+3. `03-zammad-sync-und-integration.md`
+4. `04-dashboard-statistiken-und-widgets.md`
+5. `05-todos-wiedervorlagen-fixe-abrechnungen.md`
+6. `06-profil-admin-und-betrieb.md`
+
+## Typischer Tagesablauf
+
+1. Ticketnummer eingeben und Timer starten.
+2. Tätigkeit dokumentieren.
+3. Timer beenden und Session speichern.
+4. Bei Bedarf Session nachtragen.
+5. Sessions im Ticket bewerten.
+6. Wenn Teamspace-Erfassung in TT aktiv ist: Teamspace-Tageswerte pro Projekt/Tag pflegen.
+7. ToDos und Wiedervorlagen bearbeiten.
+8. Dashboard prüfen, ob offene Bewertungen oder Teamspace-Nacharbeiten vorhanden sind.
+
+## Typischer Monatsablauf
+
+1. Monat in Tickets, Statistiken oder Monatsabschluss auswählen.
+2. Offene Sessions prüfen.
+3. Sessions final als **Abgerechnet** oder **Nicht abrechenbar** bewerten.
+4. **Abrechenbar**-Zwischenstände klären, weil sie den Abschluss blockieren.
+5. Bei aktivierter Teamspace-Erfassung: Teamspace-Tageswerte und Differenzen prüfen.
+6. Im Zammad-Sync bei Bedarf den Teamspace-Monatsabgleich ausführen, um echte TS-Monatszeiten pro Projekt gegen TT zu prüfen.
+7. Bei deaktivierter Teamspace-Erfassung: Teamspace-Differenzen entfallen; nur Session-Status ist relevant.
+8. ToDos, Wiedervorlagen und Projektwarnungen prüfen.
+9. Monat abschließen.
+
+TicketTracker ist damit das Kontrollzentrum zwischen täglicher Ticketarbeit, Zammad-Dokumentation, Teamspace-Projekten und sauberer Abrechnung.
+
+Die zentrale Frage bleibt:
+
+**Ist alles vollständig, bewertet, dokumentiert und abrechnungsbereit?**