eship/setup/PRODUCTS_SCAN_TROUBLESHOOTING.md

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:

   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