woms 3.0
This commit is contained in:
Basilosaurusrex
215
EMPLOYEE_WORKFLOW_TEST.md
Normal file
215
EMPLOYEE_WORKFLOW_TEST.md
Normal file
@@ -0,0 +1,215 @@
|
||||
# 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:
|
||||
|
||||
```javascript
|
||||
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
|
||||
|
||||
```bash
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user