# 2. Installationsanleitung

## Installation

Installieren Sie das Plugin über den Shopware Store oder laden Sie die ZIP-Datei manuell hoch:

1. Navigieren Sie zu **Einstellungen → System → Plugins → Plugin hochladen**
2. Wählen Sie die heruntergeladene ZIP-Datei aus
3. Klicken Sie auf **Plugin aktivieren**
4. Leeren Sie den Cache unter **Einstellungen → System → Caches & Indizes → Cache leeren**

## Erste Schritte

Nach der Aktivierung finden Sie das Plugin unter **Kataloge → Produktvollständigkeit**.

Das Dashboard zeigt zunächst keine Scores — diese müssen zuerst berechnet werden. Gehen Sie dazu wie folgt vor:

1. Navigieren Sie zu **Kataloge → Produktvollständigkeit → Regelsets**
2. Erstellen Sie Ihr erstes Regelset und fügen Sie Bedingungen hinzu (z. B. Name: required, Beschreibung: required, Bilder: count\_min 1)
3. Speichern Sie das Regelset
4. Wechseln Sie zum **Dashboard** und klicken Sie auf **Scores neu berechnen**
5. Die Berechnung läuft asynchron im Hintergrund — nach kurzer Zeit erscheinen die Scores im Dashboard

## Score-Schwellenwerte konfigurieren

Die Farbbereiche für „Gut" und „Kritisch" sind unter **Einstellungen → System → Konfiguration → Momo Product Completeness** einstellbar. Standardwerte:

* **Gut**: Score ≥ 70 %
* **Kritisch**: Score ≤ 39 %

## ACL-Rechte

Das Plugin bringt eigene ACL-Berechtigungen mit. Weisen Sie diese Rollen unter **Einstellungen → System → Benutzer & Berechtigungen** zu:

| Berechtigung                | Aktionen                                 |
| --------------------------- | ---------------------------------------- |
| `momo_completeness_rule`    | Lesen, Erstellen, Aktualisieren, Löschen |
| `momo_product_completeness` | Scores neu berechnen                     |

## Hinweise

* Die Score-Berechnung läuft asynchron über den Symfony Messenger. Stellen Sie sicher, dass Worker aktiv sind (`messenger:consume async`).
* Scores werden automatisch bei jedem Produkt-Speichervorgang neu berechnet. Eine manuelle Neuberechnung ist nur nach größeren Regelset-Änderungen notwendig.
* Das Plugin ist kompatibel mit Shopware \~6.6.0.