Merge remote changes and update project files

setup/PRODUCTS_SCAN_TROUBLESHOOTING.md

@@ -0,0 +1,78 @@
+# Products Scan Fehlerbehebung
+
+## Fehler: "Parsing failed (unknown)"
+
+Dieser Fehler kann zwei Ursachen haben:
+
+### 1. Extension-Fehler (Parsing failed)
+
+**Symptome:**
+- Fehlermeldung: `Extension-Fehler: Parsing failed (unknown)`
+- Die Extension kann keine Produkte auf der eBay-Seite finden
+
+**Mögliche Ursachen:**
+- Die Account-URL zeigt nicht auf eine Seite mit Produkt-Listings
+- Die eBay-Seite hat sich geändert und die Extension-Selektoren funktionieren nicht mehr
+- Die Seite ist noch nicht vollständig geladen
+
+**Lösung:**
+- Stelle sicher, dass die Account-URL auf eine Seite mit Produkt-Listings zeigt (z.B. `/str/` Storefront oder `/usr/` Seller Profile mit Items)
+- Versuche die Extension neu zu laden
+- Prüfe die Browser-Konsole für weitere Details
+
+### 2. Datenbank-Fehler (Collection/Attribute fehlt)
+
+**Symptome:**
+- Fehlermeldung: `Datenbank-Fehler: Products-Collection existiert nicht` oder
+- Fehlermeldung: `Datenbank-Fehler: Ein Attribut fehlt oder ist ungültig`
+
+**Mögliche Ursachen:**
+- Die `products` Collection wurde noch nicht erstellt
+- Die Collection existiert, aber es fehlen erforderliche Attribute
+- Die Berechtigungen für die Collection sind nicht korrekt konfiguriert
+
+**Lösung:**
+
+1. **Prüfe ob die Collection existiert:**
+   ```bash
+   appwrite databases listCollections --database-id eship-db
+   ```
+
+2. **Erstelle die Collection falls sie fehlt:**
+   - Öffne die Appwrite-Konsole
+   - Navigiere zu Databases → eship-db → Collections
+   - Erstelle eine neue Collection mit ID: `products`
+
+3. **Erstelle die erforderlichen Attribute:**
+   Die Collection benötigt folgende Attribute:
+   - `product_account_id` (string, required)
+   - `product_platform` (enum: ["amazon", "ebay"], required)
+   - `product_platform_market` (string, required)
+   - `product_platform_product_id` (string, required, unique)
+   - `product_title` (string)
+   - `product_price` (float)
+   - `product_currency` (string)
+   - `product_url` (string)
+   - `product_status` (enum: ["active", "ended", "unknown"])
+   - `product_category` (string)
+   - `product_condition` (string)
+
+4. **Prüfe die Berechtigungen:**
+   - Die Collection muss Lese- und Schreibrechte für authentifizierte Benutzer haben
+
+## Fehler: "ERR_CONNECTION_REFUSED" auf Port 7242
+
+Dieser Fehler ist **nicht kritisch** und kann ignoriert werden. Es handelt sich um einen Debug-Logging-Versuch, der fehlschlägt, weil kein Server auf Port 7242 läuft. Dies hat keinen Einfluss auf die Funktionalität.
+
+## Diagnose-Schritte
+
+1. **Prüfe die Browser-Konsole** für detaillierte Fehlermeldungen
+2. **Prüfe ob die Extension geladen ist:**
+   - Öffne `chrome://extensions/`
+   - Stelle sicher, dass die Extension aktiviert ist
+3. **Prüfe die Datenbank-Struktur:**
+   - Verwende die Appwrite-Konsole oder CLI
+   - Stelle sicher, dass die `products` Collection existiert
+4. **Teste die Account-URL:**
+   - Öffne die Account-URL manuell im Browser
+   - Stelle sicher, dass Produkt-Listings sichtbar sind