# 1. Beschreibung

Das Plugin **Produktvollständigkeit & Datenqualität** analysiert Ihre Produktdaten und berechnet für jedes Produkt einen Vollständigkeits-Score von 0 bis 100 %. So erkennen Sie auf einen Blick, welche Produkte unvollständige Beschreibungen, fehlende Bilder oder unzureichende SEO-Metadaten haben — und wo Optimierungspotenzial für bessere Conversions besteht.

## Was das Plugin leistet

Das Plugin ergänzt den nativen Shopware-Admin um drei Bereiche:

### Dashboard

Das Dashboard gibt Ihnen einen sofortigen Überblick über den Zustand Ihres Produktkatalogs:

* **Score-Verteilung**: Wie viele Produkte sind „Gut", „Mittel" oder „Kritisch"?
* **Durchschnittlicher Score**: Ein einziger Wert für den Gesamtzustand des Katalogs
* **Fehlende Felder**: Die fünf häufigsten Datenlücken in Ihrem Sortiment
* **Validierungszusammenfassung**: Wie viele Produkte bestehen Ihre Pflichtfeld-Prüfungen?

![Dashboard mit Score-Verteilung und fehlenden Feldern](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-c69344d14b2b3e7294bb32f6e0fd80e7608c97fa%2F1.png?alt=media)

### Dedizierte Produktliste

Unter dem Tab **Produktliste** finden Sie eine eigene Produktübersicht mit Score- und Validierungsstatus-Spalten sowie Filtern nach Score-Bereich, fehlendem Feld und Validierungsstatus.

![Dedizierte Produktliste mit Scores und Filtern](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-a67c32cb49055a421e0a1a7818a9599c757c9824%2F3.png?alt=media)

### Score- und Validierungsspalten in der Produktliste

In der nativen Shopware-Produktliste erscheinen automatisch zwei neue Spalten:

* **Completeness**: Farbcodierter Badge (Grün / Orange / Rot) mit dem aktuellen Score
* **Valid**: Status-Badge, ob das Produkt alle Validierungsregeln erfüllt

Beide Spalten sind filterbar und sortierbar — ohne Konfiguration.

![Score- und Validierungsspalten in der Produktliste](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-fd1c566add9ff0a312fd0592a77b20ae31700fd5%2F6.png?alt=media)

### Score-Karte auf der Produkt-Detailseite

Auf jeder Produkt-Detailseite blendet das Plugin eine Score-Karte ein. Sie zeigt den aktuellen Score und listet konkret auf, welche Felder für dieses Produkt noch fehlen oder unvollständig sind.

![Score-Karte auf der Produkt-Detailseite](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-3ef000f5707f5b7e1a5248fa7b5f6cbd86a527c2%2F7.png?alt=media)

## Regelbasierte Auswertung

Der Score wird nicht pauschal berechnet, sondern nach konfigurierbaren **Regelsets**. Sie definieren selbst:

* Welche Felder relevant sind (Name, Beschreibung, Bilder, Kategorien, Custom Fields, …)
* Wie stark jedes Feld gewichtet wird
* Ob ein Feld binär geprüft werden soll (Validierungsregel: vorhanden oder nicht)
* Für welche Verkaufskanäle und Sprachen ein Regelset gelten soll

Das Plugin erkennt automatisch alle kompatiblen Felder aus der Shopware `ProductDefinition` — Textfelder, Zahlen, Bilder, Kategorien, Tags, Custom Fields und mehr.

## Asynchrone Berechnung

Die Score-Berechnung läuft über den **Symfony Messenger** im Hintergrund. Produkt-Saves im Admin kehren sofort zurück — kein Timeout, kein Warten. Scores werden automatisch bei jedem Produkt-Speichervorgang neu berechnet.