Bekannte Einschränkungen v1.0

Bewusst akzeptierte Limitationen, die zukünftige Versionen adressieren — siehe Roadmap.

Compact-Mode auf engen Surfaces

Search-Suggest-Dropdown und Cart-Line-Item-Thumbnails sind zu klein (44–56 px) für das volltextige Badge der Produktdetailseite. Stattdessen erscheint ein kreisrundes „AI"-Chip (Default 22 px Durchmesser, konfigurierbar). Der Volltext erscheint auf Hover oder Fokus als Tooltip.

Mobile + Touch

Mobile-Touch-Geräte zeigen den Tooltip nicht (kein Hover-Event). Das aria-label-Attribut ist aber für Screenreader voll lesbar — die Accessibility-Pflicht aus dem European Accessibility Act bleibt erfüllt.

Eine optionale Tap-to-show-Tooltip-Logik per JS ist v1.2-Roadmap (geringe Priorität).

Lightbox-Badge per JS-Inject

Shopware verwendet für PDP-Zoom-Modals Bootstrap-Modal mit JS-Plugin. Das Modal kopiert das <img>-Element in den Modal-Container, nicht den umgebenden Badge-Wrapper. Daher injiziert ein Plugin-eigenes Storefront-JS das Badge in die kopierte Modal-Instanz.

Konsequenz: Bei deaktiviertem JavaScript zeigt das Modal das Bild ohne Badge. Akzeptiert für v1.0 — Screenreader nutzen das Alt-Suffix („… (mit KI bearbeitet)"); die Kennzeichnung ist dort weiterhin sichtbar.

Eine reine Server-Side-Lösung würde einen Decorator des Bootstrap-Modal-Renderers erfordern und ist v1.2-Kandidat.

Theme-Drift bei sw_extends-Bypass

Bestimmte Theme-Override-Patterns brechen die Plugin-Override-Kette — drei Pattern dokumentiert in Theme-Integration. v1.0-Workaround: Theme-Autor bindet das Badge-Partial defensiv ein. Strukturelle Lösung: Phase 2.D (JS-Fallback) macht den Drift theme-agnostisch.

Indigo7BoutiqueTheme PDP-Galerie

Indigo7BoutiqueTheme ersetzt die Shopware-Standard-PDP-Image-Gallery durch ein eigenes Stacked-Slot-Component. Die Plugin-Theme-Integration für diese Galerie ist im Theme selbst ab v1.9.0 implementiert; ältere Versionen brauchen das Drop-in-Snippet aus Theme-Integration.

Performance auf großen Katalogen

Auf Shopware-Installationen mit > 50 000 Media-Einträgen kann der Bulk-Editor-Listing-Load 1–3 Sekunden brauchen (DAL-Search über media + JOIN auf i7_ai_label_media + Optional-Counts).

Empfehlungen

• Page-Size auf 25 statt 50 reduzieren (Plugin-Einstellungen → Karte 2).
• Auf sehr großen Stores nach Plugin-Install (oder größeren Klassifikations-Wellen) einmal:

  OPTIMIZE TABLE media;
  OPTIMIZE TABLE i7_ai_label_media;

  Defragmentiert Indizes — typisch 20–40 % schnellere Listings.

Plugin-Update auf größere Versionen

Direkt-Updates (z. B. v1.0 → v1.1) werden technisch unterstützt — die Migrationen sind idempotent. Bei größeren Versionswechseln (z. B. zukünftiges v1.0 → v2.0) empfehlen wir den expliziten zweistufigen Pfad:

bin/console plugin:uninstall --keep-user-data Indigo7AiLabel
bin/console plugin:install --activate Indigo7AiLabel

--keep-user-data erhält die Klassifikations-Datenbank, entfernt aber alle Plugin-systemkonfigurationen. Der anschließende Re-Install fügt sie mit den aktuellen Defaults wieder hinzu. Dieser Workflow ist robust gegen historisch entfernte Config-Keys (Plugin v1.0 räumt mit einem defensiven Wildcard-DELETE auf Indigo7AiLabel.config.% auf — ein typisches Problem bei Plugins, die in einer alten Version Config-Keys hatten, die in einer neueren Version nicht mehr existieren).