Chat-Bubble Erscheinung

So erscheint James im Shop — Name, Untertitel, Avatar und Farbe.

Deine Regeln für James

Diese Regeln haben höchste Priorität — sie überschreiben alles andere. Schreibe in natürlicher Sprache was James tun soll.

Modulare Prompts — Kaufberater

James nutzt je nach Gesprächsphase einen anderen Prompt. So bleibt jeder Prompt kurz und fokussiert.

System-Prompt — Umfrage

Links

Kaufberater: James öffnen
Umfrage: Survey öffnen

💡 Wer sind deine Kunden?

Top-Kundengruppen (Größe / Gewicht)

Meistgesuchte Produkte & beliebteste Größen

Shopify-Verbindung

Die Verbindung zu deinem Shopify-Shop. Zugangsdaten werden verschlüsselt gespeichert.

Passwort ändern

API-Informationen

⚡ Wie funktioniert der SizeFinder?

Der SizeFinder empfiehlt Kunden die richtige Größe basierend auf Personentypen-Matching. Du definierst im Mischpult für jeden typischen Kunden (z.B. "200cm, 95kg, Normal, Flach") welche Größe er bekommen soll. Wenn ein echter Kunde seine Daten eingibt, findet das System die ähnlichsten Personentypen und leitet daraus die Empfehlung ab.

🔢 Berechnungsgrundlage — Scoring-Engine

Schritt 1: Ähnlichkeit berechnen
Für jeden definierten Personentyp wird berechnet, wie ähnlich der Kunde ist. Die Gewichtung:

Gewicht: 45% (stärkster Faktor, quadratisch — große Abstände werden stark bestraft)
Oberkörper (Schmal/Normal/Athletisch/Breit): 18%
Körpermitte (Flach/Leichter Bauch/Deutlich/Bauch+Hüfte): 18%
Körpergröße: 10% (bei Tall-Größen weniger wichtig)
Fit-Präferenz (Slim/Regular/Oversized/Baggy): 9%
Schritt 2: Stimmen zählen
Jeder ähnliche Personentyp "stimmt" für seine zugeordnete Größe, gewichtet nach Ähnlichkeit.

Schritt 3: Confidence berechnen
Aus dem Verhältnis zwischen Erst- und Zweitplatziertem:
Ratio ≥ 3.0 → 97% (sehr eindeutig)
Ratio ≥ 2.0 → 94%
Ratio ≥ 1.5 → 89%
Ratio ≥ 1.2 → 82% (knapp, Alternative sinnvoll)
Ratio < 1.2 → 72% (sehr knapp)
Schritt 4: Bauch-Korrektur
Bei "Deutlicher Bauch" oder "Bauch + Hüfte" UND knappem Ergebnis → automatisch eine Größe hochstufen.

Schritt 5: Alternative bestimmen
Die nächste Größe in Richtung des Kunden-Gewichts wird als Alternative angeboten. Schwerer → größere Alternative, leichter → kleinere.

👕 Produkt-Verwaltung

Neues Produkt anlegen:
1. "Import aus Bild" — Screenshot der Maßtabelle hochladen (JPG/PNG/PDF). Die KI extrahiert automatisch alle Maße.
2. "Manuell anlegen" — Daten von Hand eintragen.

Auto-Konfiguration:
Klicke "✨ KI-Einschätzung & Auto-Konfiguration" nachdem die Maßtabelle vorhanden ist. Das System:
- Vergleicht die Maße mit bestehenden Produkten
- Übernimmt die Mischpult-Zuordnungen vom ähnlichsten Produkt
- Passt sie an (engere Brust → kleinere Größe etc.)
- Schätzt den Schnitt ein (Slim/Regular/Cropped/Boxy)

Schnitt-Typen:
Slim — Eng anliegend, körperbetont
Regular — Standard-Passform
Relaxed — Etwas lockerer, bequem
Oversized — Deutlich weiter, moderner Look
Baggy — Sehr weit, Streetwear
Boxy — Kastenförmig, breit aber nicht lang
Cropped — Verkürzt, trendy

🧠 Training — KI durch Korrekturen trainieren

Mischpult (Hauptmethode):
53 vordefinierte Personentypen (185cm–210cm, 65kg–130kg, alle Körperformen). Du schiebst pro Person nur einen Regler auf die richtige Größe. Das System interpoliert für alle Werte dazwischen.

Admin-Korrektur im Widget:
1. Öffne das Widget im Admin-Modus: ?admin=DEIN_API_KEY
2. Gib Testdaten ein wie ein Kunde
3. Wenn das Ergebnis falsch ist → "Korrigieren" klicken
4. Richtige Größe wählen → wird als Few-Shot-Beispiel für die KI gespeichert

Training-Korrekturen:
Werden bei KI-gestützten Empfehlungen als "Bisherige Korrekturen" im Prompt mitgegeben. Die KI lernt daraus.

💬 James — Der Chatbot

Was macht James?
James führt ein natürliches Gespräch mit dem Kunden und ermittelt:
- Vorname (für persönliche Ansprache)
- Welches Produkt gesucht wird
- Körpergröße + Gewicht (in einer Frage)
- Oberkörper-Typ (Schultern)
- Körpermitte (mit Silhouetten-Bildern)
- Fit-Präferenz

Empfehlung:
James rät NICHT selbst — er sammelt die Infos und ruft die gleiche Mischpult-Engine auf wie der Wizard. Konsistente Ergebnisse garantiert.

Bilder:
Kunden können ein Foto von sich schicken. James nutzt GPT-4o Vision um den Körpertyp einzuschätzen.

Sicherheit:
- James antwortet NUR auf Kleidungs-/Größenfragen
- Keine medizinischen, politischen, kontroversen Themen
- Keine wertenden Kommentare über Gewicht/Körper
- Prompt-Injection wird ignoriert
- Nachrichten max. 1000 Zeichen, Chat max. 30 Nachrichten
- Off-Topic → freundliche Umleitung zum Thema

Link: James öffnen

🌐 Widget einbinden (Externe Shops)

CSS + JS einbinden:
<link rel="stylesheet" href="https://sizefinder.maxento.de/assets/css/sizefinder.css">
<script src="https://sizefinder.maxento.de/assets/js/sizefinder.js"></script>
Trigger-Button platzieren:
<button class="sizefinder-trigger" data-product-type="half-zipper-basic">Größe finden</button>
Modal-HTML:
Das komplette Modal-HTML muss in die Seite eingebettet werden (aus index.html kopieren).

Event abfangen:
document.addEventListener('sizefinder:selected', function(e) {
  console.log('Gewählt:', e.detail.size); // z.B. "XL-T"
});

💻 API-Endpunkte

Admin-Endpunkte erfordern X-Api-Key Header. Öffentliche Endpunkte sind CORS-geschützt.

🔒 Sicherheit

CORS: Nur erlaubte Domains (oneninetyfive.shop + eigene Domain)
Rate Limiting: 30 Requests/Minute auf öffentlichen Endpunkten
Admin-Auth: API-Key (SHA-256 gehasht in DB)
Kundendaten: Token-basiert (SHA-256), DSGVO-Löschung über DELETE-Endpoint
James Chatbot: System-Prompt mit Sicherheitsregeln, Input-Längenbegrenzung, Chat-Verlauf-Limit
Bild-Upload: Max. 10MB, nur Bilder/PDF akzeptiert

🛠 Technische Details

Backend: PHP 8.3, Slim 4, MySQL 8, PDO
Frontend: Vanilla JS, CSS (kein Framework)
KI: OpenAI GPT-4o-mini (Empfehlungen, Chat), GPT-4o (Bilderkennung)
Server: sizefinder.maxento.de
DB: usrdb_maxendba_sizefinder
Tabellen: tenants, product_profiles, size_charts, size_chart_entries, customers, customer_recommendations, size_finder_logs, training_corrections, translations
Namespace: SizeFinder\