tickte-system/EMPLOYEE_WORKFLOW_TEST.md

Employee Workflow - End-to-End Test

Diese Anleitung führt dich durch den vollständigen Mitarbeiter-Workflow, vom Anlegen bis zur Ticket-Zuweisung.

Voraussetzungen

1. ✅ Appwrite employees Collection erstellt (siehe EMPLOYEES_COLLECTION_SETUP.md)
2. ✅ Appwrite workorders Collection hat assignedTo Attribut
3. ✅ Collection IDs in .env und src/lib/appwrite.js eingetragen
4. ✅ Du bist als Admin eingeloggt (User Label: admin)

Schritt 1: Appwrite Setup abschließen

1.1 employees Collection ID eintragen

1. Öffne Appwrite: https://appwrite.webklar.com
2. Gehe zu Databases → woms-database → employees
3. Kopiere die Collection ID (z.B. 694bd1fb002b2e583d14)
4. Öffne src/lib/appwrite.js
5. Ersetze 'employees' mit der echten ID:

EMPLOYEES: '694bd1fb002b2e583d14', // <- Deine Collection ID hier

1.2 assignedTo Attribut zu workorders hinzufügen

1. Gehe zu workorders Collection (ID: 6943bf7d001901baa60c)
2. Klicke auf Attributes → Create Attribute
3. Erstelle:
   • Type: String
   • Key: assignedTo
   • Size: 255
   • Required: Nein

Schritt 2: Anwendung starten

cd /Users/kensogrimm/Documents/GitHub/tickte-system
npm run dev

Öffne im Browser: http://localhost:5173

Schritt 3: Mitarbeiter hinzufügen

Option A: Dich selbst als Mitarbeiter hinzufügen

1. Gehe zu Admin Panel (Navigation → Admin)
2. Scrolle zur Sektion Mitarbeiter
3. Klicke auf "Mich selbst hinzufügen"
4. ✅ Du solltest jetzt in der Mitarbeiter-Liste erscheinen

Option B: Manuell Mitarbeiter hinzufügen

1. Gehe zu Appwrite: https://appwrite.webklar.com
2. Öffne Auth → Users
3. Wähle einen Benutzer aus und kopiere die User ID (z.B. 6765fb5b00295d6c0a2c)
4. Gehe zurück zum Admin Panel in deiner App
5. Scrolle zu "Neuen Mitarbeiter hinzufügen"
6. Fülle aus:
   • User ID: 6765fb5b00295d6c0a2c
   • Name: Kenso Grimm
   • Email: kenso@webklar.com
   • Kürzel: KNSO
7. Klicke auf "Mitarbeiter hinzufügen"
8. ✅ Der Mitarbeiter erscheint in der Tabelle

Schritt 4: Weitere Mitarbeiter hinzufügen

Wiederhole Schritt 3 für weitere Mitarbeiter:

Name	Email	Kürzel	User ID (aus Appwrite)
Christian Lehmann	christian.lehmann@example.com	CHLE	[User ID aus Appwrite]
Dietmar Bruckauf	dietmar.bruckauf@example.com	DIBR	[User ID aus Appwrite]
Dominik Armata	dominik.armata@example.com	DOAR	[User ID aus Appwrite]
Gregor Vowinkel	gregor.vowinkel@example.com	GRVO	[User ID aus Appwrite]

Schritt 5: Kürzel zuordnen/bearbeiten

1. In der Mitarbeiter-Tabelle klicke auf Edit (Stift-Icon)
2. Ändere das Kürzel (z.B. von leer zu KNSO)
3. Klicke auf Speichern
4. ✅ Das Kürzel wird in der Tabelle angezeigt

Schritt 6: Ticket erstellen und Mitarbeiter zuweisen

1. Gehe zu Tickets (Navigation → Tickets)
2. Klicke auf "CREATE TICKET"
3. Fülle das Formular aus:
   • Customer ID: Wähle einen Kunden
   • Work Order Type: z.B. Supportrequest
   • Affected System: z.B. Network
   • Priority: z.B. Medium
   • Assigned To: Wähle einen Mitarbeiter (z.B. Kenso Grimm (KNSO))
   • Topic: z.B. WLAN Problem beheben
   • Requested by: z.B. Max Mustermann
4. Klicke auf "CREATE NOW"

✅ Erwartetes Ergebnis:

• Das Ticket wird erstellt
• Status ist automatisch "Assigned" (nicht "Open"!)
• In der Ticket-Liste siehst du das neue Ticket mit Status "Assigned"

Schritt 7: Status-Automatik testen

Test 1: Ticket ohne Zuweisung

1. Erstelle ein neues Ticket
2. Lasse Assigned To auf "Unassigned"
3. Erstelle das Ticket

✅ Erwartetes Ergebnis:

• Status ist "Open"

Test 2: Zuweisung nachträglich hinzufügen

1. Öffne ein Ticket mit Status "Open"
2. Weise einen Mitarbeiter zu (Edit-Funktion)
3. Speichere

✅ Erwartetes Ergebnis:

• Status wechselt automatisch zu "Assigned"

Test 3: Zuweisung entfernen

1. Öffne ein Ticket mit Status "Assigned"
2. Entferne die Mitarbeiter-Zuweisung (setze auf "Unassigned")
3. Speichere

✅ Erwartetes Ergebnis:

• Status wechselt automatisch zurück zu "Open"

Schritt 8: Mitarbeiter-Dropdown überprüfen

1. Öffne das "CREATE TICKET" Modal
2. Scrolle zum "Assigned To" Dropdown
3. Klicke darauf

✅ Erwartetes Ergebnis:

• Du siehst alle Mitarbeiter
• Format: Name (Kürzel) oder nur Name wenn kein Kürzel
• Beispiel: Kenso Grimm (KNSO)
• Erste Option ist Unassigned

Schritt 9: Admin Panel überprüfen

1. Gehe zu Admin Panel
2. Scrolle zur Mitarbeiter-Sektion

✅ Erwartetes Ergebnis:

• Tabelle zeigt alle Mitarbeiter
• Spalten: Name, Email, Kürzel, User ID, Aktionen
• Kürzel ist farbig hervorgehoben (blau wenn gesetzt, grau wenn leer)
• Edit und Delete Buttons funktionieren

Fehlerbehebung

Fehler: "Collection not found"

Lösung:

• Überprüfe, ob die Collection ID in src/lib/appwrite.js korrekt ist
• Stelle sicher, dass die Collection in Appwrite existiert

Fehler: "Unauthorized" beim Laden der Mitarbeiter

Lösung:

• Überprüfe die Permissions der employees Collection
• Read sollte mindestens "Users" sein

Fehler: "User ID not found"

Lösung:

• Die User ID muss von einem existierenden Appwrite Auth User sein
• Überprüfe in Appwrite unter Auth → Users

Fehler: "Duplicate userId"

Lösung:

• Ein Mitarbeiter mit dieser User ID existiert bereits
• Prüfe die Mitarbeiter-Liste im Admin Panel

Mitarbeiter erscheinen nicht im Dropdown

Lösung:

1. Überprüfe, ob Mitarbeiter im Admin Panel angezeigt werden
2. Prüfe Browser Console auf Fehler
3. Stelle sicher, dass employees Collection die richtigen Permissions hat

Erfolg! 🎉

Wenn alle Tests erfolgreich waren:

• ✅ Mitarbeiter können im Admin Panel verwaltet werden
• ✅ Kürzel können zugeordnet werden
• ✅ Tickets können Mitarbeitern zugewiesen werden
• ✅ Status wechselt automatisch zwischen "Open" und "Assigned"
• ✅ Mitarbeiter werden im Dropdown mit Kürzel angezeigt

Nächste Schritte

1. Weitere Mitarbeiter hinzufügen: Füge alle Team-Mitglieder hinzu
2. Kürzel-Konvention: Lege ein einheitliches Format fest (z.B. erste 2 Buchstaben Vorname + 2 Buchstaben Nachname)
3. Tickets zuweisen: Weise bestehende Tickets Mitarbeitern zu
4. Workflow testen: Erstelle Test-Tickets und teste den vollständigen Workflow

Support

Bei Problemen:

1. Überprüfe die Appwrite Console auf Fehler
2. Prüfe die Browser DevTools Console
3. Lies EMPLOYEES_COLLECTION_SETUP.md für Setup-Details
4. Überprüfe die Permissions in Appwrite