# 1. Description

**Product Completeness & Data Quality** analyses your product catalog and calculates a completeness score from 0 to 100% for every product. At a glance you can see which products have incomplete descriptions, missing images, or insufficient SEO metadata — and where there is room to improve conversions.

## What the plugin does

The plugin adds three areas to the native Shopware Admin:

### Dashboard

The dashboard gives you an immediate overview of your catalog's data quality:

* **Score distribution**: How many products are "Good", "Average", or "Critical"?
* **Average score**: A single number summarising the overall catalog health
* **Missing fields**: The five most common data gaps across your products
* **Validation summary**: How many products pass your mandatory field checks?

![Dashboard with score distribution and missing fields](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-c69344d14b2b3e7294bb32f6e0fd80e7608c97fa%2F1.png?alt=media)

### Dedicated product list

The **Product List** tab provides a dedicated product overview with score and validation status columns, plus filters by score range, missing field, and validation status.

![Dedicated product list with scores and filters](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-a67c32cb49055a421e0a1a7818a9599c757c9824%2F3.png?alt=media)

### Score and validation columns in the product list

Two new columns appear automatically in the native Shopware product list:

* **Completeness**: A color-coded badge (Green / Orange / Red) showing the current score
* **Valid**: A status badge indicating whether the product passes all validation rules

Both columns are filterable and sortable — no configuration required.

![Score and validation columns in the product list](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-fd1c566add9ff0a312fd0592a77b20ae31700fd5%2F6.png?alt=media)

### Score card on the product detail page

On every product detail page, the plugin displays a score card. It shows the current score and lists exactly which fields are still missing or incomplete for that specific product.

![Score card on the product detail page](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-3ef000f5707f5b7e1a5248fa7b5f6cbd86a527c2%2F7.png?alt=media)

## Rule-based evaluation

Scores are not calculated with a fixed formula — they are driven by configurable **rule sets** that you define yourself:

* Which fields matter (name, description, images, categories, custom fields, …)
* How much weight each field carries
* Whether a field should be checked as a binary pass/fail (validation rule)
* Which sales channels and languages a rule set applies to

The plugin automatically detects all compatible fields from Shopware's `ProductDefinition` — text fields, numbers, images, categories, tags, custom fields, and more.

## Asynchronous calculation

Score calculation runs via the **Symfony Messenger** in the background. Product saves in the Admin return immediately — no timeouts, no waiting. Scores are automatically recalculated every time a product is saved.