> For the complete documentation index, see [llms.txt](https://docs.momocode.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.momocode.de/shopware-6/produktvollstaendigkeit/1.-beschreibung.md).

# 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](/files/Mjsokf70sEUFFLLHilLj)

### 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](/files/fBiu0EeKzW6Vg4O8QfKC)

### 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](/files/7Oak5sSTcLeaodT0cBvF)

### 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](/files/K0RfqwUPPyy6vq4HqCVB)

## 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.
