woms 3.0

WSID_ATTRIBUTE_SETUP.md

@@ -0,0 +1,119 @@
+# WSID Attribut Hinzufügen
+
+Diese Anleitung zeigt dir, wie du das **WSID (Work Sheet ID)** Attribut zur `workorders` Collection hinzufügst.
+
+## Was ist WSID?
+
+- **WSID** = Work Sheet ID
+- **Format**: 6-stellige Nummer (100000-999999)
+- **Funktion**: Sequentielle ID ähnlich wie WOID, aber mit 6 Stellen
+- **Beispiele**: 100000, 100001, 100002, etc.
+
+## Schritt-für-Schritt Anleitung
+
+### 1. Appwrite Dashboard öffnen
+
+1. Gehe zu https://appwrite.webklar.com (oder deine Appwrite-Instanz)
+2. Logge dich ein
+3. Öffne dein Projekt **woms**
+
+### 2. Zur workorders Collection navigieren
+
+1. Klicke auf **Databases** im linken Menü
+2. Wähle die Datenbank **woms-database** (ID: `6943bf0e0003291f8c35`)
+3. Klicke auf die Collection **workorders** (ID: `6943bf7d001901baa60c`)
+
+### 3. WSID Attribut erstellen
+
+1. Klicke auf den Tab **Attributes**
+2. Klicke auf **Create Attribute**
+3. Wähle **String** als Typ
+4. Fülle die Felder wie folgt aus:
+
+**Attribut-Konfiguration:**
+- **Attribute ID**: `wsid`
+- **Attribute Name**: `wsid`
+- **Size**: `10` (für 6-stellige Zahlen + Reserve)
+- **Required**: ❌ Nein (nicht required, damit alte Tickets ohne WSID weiter funktionieren)
+- **Array**: ❌ Nein
+- **Default Value**: Leer lassen
+
+5. Klicke auf **Create**
+
+### 4. Index für WSID erstellen (Optional, aber empfohlen)
+
+Ein Index verbessert die Performance beim Suchen und Filtern:
+
+1. Klicke auf den Tab **Indexes**
+2. Klicke auf **Create Index**
+3. Fülle die Felder wie folgt aus:
+
+**Index-Konfiguration:**
+- **Key**: `wsid`
+- **Type**: `key`
+- **Attributes**: Wähle `wsid`
+- **Order**: `ASC` (aufsteigend)
+
+4. Klicke auf **Create**
+
+### 5. Fertig! ✅
+
+Das WSID-Attribut ist jetzt in deiner Collection verfügbar. Die Anwendung wird automatisch:
+
+- Für neue Tickets eine sequentielle WSID generieren (startend bei 100000)
+- Die WSID in der Ticket-Liste anzeigen
+- Die WSID im Detail-View anzeigen
+
+## Hinweise
+
+### Sequentielle Generierung
+
+Die WSID wird ähnlich wie WOID automatisch generiert:
+
+```javascript
+// Beispiel:
+Erstes Ticket:  WSID = 100000
+Zweites Ticket: WSID = 100001
+Drittes Ticket: WSID = 100002
+// etc.
+```
+
+### Unterschied WOID vs WSID
+
+| Feld | Stellen | Start | Format | Beispiel |
+|------|---------|-------|--------|----------|
+| WOID | 5 | 10000 | String | "10000" |
+| WSID | 6 | 100000 | String | "100000" |
+
+### Alte Tickets
+
+Tickets, die vor dem Hinzufügen des WSID-Attributs erstellt wurden, haben keine WSID. In der UI wird dann "-" angezeigt.
+
+## Troubleshooting
+
+### Problem: Attribut kann nicht erstellt werden
+
+**Lösung**: 
+- Überprüfe, ob das Attribut `wsid` nicht bereits existiert
+- Stelle sicher, dass du die richtigen Berechtigungen hast (Admin)
+
+### Problem: WSID wird nicht angezeigt
+
+**Lösung**:
+1. Überprüfe, ob das Attribut erfolgreich erstellt wurde
+2. Lade die Seite neu (Strg+F5 / Cmd+Shift+R)
+3. Erstelle ein neues Ticket zum Testen
+
+### Problem: WSID startet nicht bei 100000
+
+**Lösung**:
+- Das ist normal, wenn bereits Tickets mit WSID existieren
+- Die WSID wird immer sequentiell von der höchsten bestehenden WSID weitergezählt
+
+## Support
+
+Bei Fragen oder Problemen:
+1. Überprüfe die Appwrite Logs
+2. Schaue in die Browser Console (F12)
+3. Überprüfe, ob alle Berechtigungen korrekt gesetzt sind
+