> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.md).

# Befehle

Der Konsolenbefehl des Plugins mit allen Optionen und die Shopware-Befehle, die bei Installation, Betrieb und Fehlersuche helfen.

Diese Seite richtet sich an Administratoren und Agenturen. Sie beschreibt den Konsolenbefehl des Plugins und die Shopware-Befehle, die Sie im Zusammenhang mit der Suche brauchen. Alle Befehle führen Sie im Hauptordner Ihres Shops aus.

Die Shopware-Befehle sind Standard von Shopware, ihre Optionen sind nicht Teil des Plugins. Im Zweifel zeigt `bin/console <befehl> --help` die Optionen Ihrer Shopware-Version.

## Der Befehl des Plugins: Umsatz nachtragen

Das Plugin bringt genau einen eigenen Befehl mit:

```bash
bin/console cogi-insightsearch:suite-backfill
```

### Wofür er gedacht ist

Der Befehl trägt Bestellungen und den Umsatz über die Suche **einmalig als Tagessummen** für den cogi Commander nach. Das ist sinnvoll für Bestellungen aus der Zeit, bevor der Commander installiert wurde. Mehr zum Commander lesen Sie unter [Feedback, Support und Commander](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feedback-und-commander.md).

### Voraussetzung

Der cogi Commander muss installiert und aktiv sein. Sonst bricht der Befehl ab und meldet, dass der Commander nicht aktiv ist. Die richtige Reihenfolge ist:

1. Commander installieren und aktivieren.
2. Den Nachtrag starten.
3. Danach übernimmt der Commander die weiteren Daten selbst.

### Optionen

| Option              | Wirkung                                                        | Standard          |
| ------------------- | -------------------------------------------------------------- | ----------------- |
| `--from=JJJJ-MM-TT` | Erster Tag, ab dem Bestellungen nachgetragen werden            | alle Bestellungen |
| `--force`           | Lässt den Nachtrag erneut laufen, obwohl er schon gelaufen ist | aus               |

Beispiele:

```bash
# alle Bestellungen nachtragen
bin/console cogi-insightsearch:suite-backfill

# nur Bestellungen ab dem 1. Januar 2026
bin/console cogi-insightsearch:suite-backfill --from=2026-01-01

# erneut ausführen
bin/console cogi-insightsearch:suite-backfill --force
```

### Gut zu wissen

* Läuft der Nachtrag ein zweites Mal ohne `--force`, meldet der Befehl, an welchem Datum er schon lief, und tut nichts.
* Verwenden Sie `--force` nur, solange der Commander noch nichts übernommen hat. Sonst werden Werte doppelt gezählt.
* Das Datum bei `--from` muss im Format `JJJJ-MM-TT` stehen, zum Beispiel `2026-01-01`. Sonst bricht der Befehl mit einer Fehlermeldung ab.
* Der Zeitraum endet an dem Tag, an dem der laufende Weg über Ereignisse begann. So wird nichts doppelt gezählt.
* Am Ende meldet der Befehl, wie viele Bestellungen er gelesen hat, wie viele Zeilen er geschrieben hat und welchen Zeitraum er abdeckt.

## Shopware-Befehle im Zusammenhang

### Installation und Update

| Befehl                                                    | Wirkung                                                                |
| --------------------------------------------------------- | ---------------------------------------------------------------------- |
| `bin/console plugin:refresh`                              | Das Plugin nach dem Ablegen der Dateien erkennen lassen                |
| `bin/console plugin:install --activate CogiInsightSearch` | Installiert und aktiviert das Plugin                                   |
| `bin/console plugin:update CogiInsightSearch`             | Aktualisiert das Plugin und führt Datenbank-Anpassungen aus            |
| `bin/console cache:clear`                                 | Leert den Zwischenspeicher von Shopware                                |
| `bin/console theme:compile`                               | Baut das Theme neu, damit Änderungen in der Storefront sichtbar werden |

Wenn Sie das Plugin über die Erweiterungsverwaltung im Admin installieren, entfallen die ersten drei Befehle.

Die Befehle für Installation und Update in der Reihenfolge:

```bash
bin/console plugin:refresh
bin/console plugin:install --activate CogiInsightSearch
bin/console cache:clear
```

```bash
bin/console plugin:update CogiInsightSearch
bin/console cache:clear
```

### Hintergrundverarbeitung (Worker)

| Befehl                                             | Wirkung                                                                                                                                  |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `bin/console messenger:consume async low_priority` | Startet einen Worker. Er arbeitet die Aufträge der Warteschlange ab, zum Beispiel Push-Pakete und Meldungen zu Warenkorb und Bestellung. |
| `bin/console messenger:stop-workers`               | Sagt laufenden Workern, dass sie sich beenden sollen. Ein Dienst wie Supervisor oder systemd startet sie neu.                            |

Für den Dauerbetrieb starten Sie den Worker als Dienst und geben ihm Grenzen mit:

```bash
bin/console messenger:consume async low_priority --time-limit=3600 --memory-limit=512M
```

Wann sich welcher Befehl lohnt:

* **Nach einem Plugin-Update:** `messenger:stop-workers`, damit die Worker den neuen Code laden.
* **Push hängt oder Statistik bleibt leer:** Prüfen Sie, ob ein Worker läuft. Mehr dazu unter [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).

### Geplante Aufgaben

| Befehl                                            | Wirkung                                                                 |
| ------------------------------------------------- | ----------------------------------------------------------------------- |
| `bin/console scheduled-task:register`             | Registriert die geplanten Aufgaben, auch die des Plugins                |
| `bin/console scheduled-task:run`                  | Arbeitet die geplanten Aufgaben dauerhaft ab (als Dienst oder per Cron) |
| `bin/console scheduled-task:run-single <Aufgabe>` | Startet eine einzelne Aufgabe sofort                                    |

Die Aufgaben des Plugins heißen:

| Technischer Name                    | Wirkung                                       |
| ----------------------------------- | --------------------------------------------- |
| `cogi_insightsearch.push_indexing`  | Täglicher Push aller Push-Indizes             |
| `cogi_insightsearch.push_finalize`  | Überwachung hängender Läufe                   |
| `cogi_insightsearch.keepalive`      | Verbindungsprüfung                            |
| `cogi_insightsearch.delta_push`     | Live-Abgleich                                 |
| `cogi_insightsearch.order_backfill` | Nachholen von Bestellungen der letzten 7 Tage |

Beispiel: Einen hängenden Push-Lauf lassen Sie von der Überwachung sofort prüfen, ohne 10 Minuten zu warten:

```bash
bin/console scheduled-task:run-single cogi_insightsearch.push_finalize
```

Eine Übersicht der Aufgaben mit Takt finden Sie unter [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).

### Konfiguration lesen und setzen

| Befehl                                                                      | Wirkung                                                              |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| `bin/console system:config:get CogiInsightSearch.config.enableSearch`       | Liest einen Konfigurationswert, hier den Schalter „Suche aktivieren“ |
| `bin/console system:config:set CogiInsightSearch.config.<Schlüssel> <Wert>` | Setzt einen Konfigurationswert                                       |

Ein wichtiger Fall ist die **Kopie eines Shops auf Stage**. Wurde ein bereits verbundener Shop 1:1 kopiert, trägt die Kopie dieselbe Verbindung wie das Original und würde in dessen Suchindex und Statistik schreiben. Dann leeren Sie in der Kopie beide Schlüssel:

```bash
bin/console system:config:set CogiInsightSearch.config.installationSecret ""
bin/console system:config:set CogiInsightSearch.config.accountSecret ""
```

Durchlaufen Sie danach die Einrichtung im Plugin neu und legen Sie einen eigenen Index an. Deaktivieren oder deinstallieren Sie das Plugin in der Kopie vorher nicht, sonst wird das Original abgemeldet. Mehr dazu unter [Stage und Live](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md).

### Indizes und Produktexport

| Befehl                                | Wirkung                                                                         |
| ------------------------------------- | ------------------------------------------------------------------------------- |
| `bin/console dal:refresh:index`       | Baut die Indizes von Shopware neu auf, etwa nach großen Importen                |
| `bin/console product-export:generate` | Erzeugt die Produktexport-Datei (den Feed) sofort. Die Optionen zeigt `--help`. |

Zwei Hinweise dazu:

* **Pull-Feed:** Mit der Einstellung „Im Hintergrund generieren“ erscheinen Änderungen erst, wenn Shopware den Export neu erzeugt. Den Export können Sie mit `product-export:generate` anstoßen. Lesen Sie danach die Produktdaten im Bereich „Quellen“ neu ein.
* **Live-Abgleich:** Das Plugin merkt sich Änderungen, die Shopware beim Neuaufbau der Indizes meldet. Ein sehr großer Neuaufbau kann viele Einträge vormerken. Übersteigen sie 20.000, wird die Vormerkung verworfen und der nächste vollständige Push übernimmt alles.

## Welcher Befehl hilft wann?

| Situation                                    | Befehl                                                                      |
| -------------------------------------------- | --------------------------------------------------------------------------- |
| Plugin neu installiert oder aktualisiert     | `plugin:install --activate` oder `plugin:update`, danach `cache:clear`      |
| Worker mit altem Code                        | `messenger:stop-workers`                                                    |
| Einstellungen in der Storefront wirken nicht | `cache:clear`, bei Theme-Änderungen `theme:compile`                         |
| Push bleibt stehen                           | Worker prüfen, `scheduled-task:run-single cogi_insightsearch.push_finalize` |
| Feed zeigt alte Daten                        | `product-export:generate`, danach „Produktdaten neu einlesen“               |
| Stage-Kopie schreibt ins Original            | beide Schlüssel mit `system:config:set` leeren                              |
| Alte Bestellungen im Commander fehlen        | `cogi-insightsearch:suite-backfill`                                         |

## Weiterlesen

{% content-ref url="/pages/TB60BMQ05uLv6epja2ky" %}
[Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md)
{% endcontent-ref %}

{% content-ref url="/pages/IRaJNiR83at8tpKODJsz" %}
[Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md)
{% endcontent-ref %}

{% content-ref url="/pages/SjGrQJy19tWx34BxWnlQ" %}
[Stage und Live](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
