add new configs

src/Agent/AgentRunner.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace App\Agent;
 
 use App\Commerce\ShopSearchService;
+use App\Config\AgentRunnerConfig;
 use App\Context\ContextService;
 use App\Context\UrlAnalyzer;
 use App\Infrastructure\OllamaClient;
@@ -28,6 +29,7 @@ final readonly class AgentRunner
         private CommerceIntentLite $commerceIntentLite,
         private OllamaClient       $ollamaClient,
         private LoggerInterface    $agentLogger,
+        private AgentRunnerConfig  $agentRunnerConfig,
         private bool               $debug,
         private bool               $logPrompt,
         private bool               $logContext,
@@ -84,30 +86,12 @@ final readonly class AgentRunner
 
             if ($commerceIntent === CommerceIntentLite::PRODUCT_SEARCH || $commerceIntent === CommerceIntentLite::ADVISORY_PRODUCT_SEARCH) {
                 //PreOptimize swag search query
-                $promptSwagSearch = '
+                $promptSwagSearch = $this->agentRunnerConfig->getShopPrompt($prompt);
-                Erzeuge aus dem folgenden Nutzereingabetext einen kurzen Suchtext für die Shopware-6-Suche.
-                
-                Regeln:
-                - Gib nur den finalen Suchtext aus.
-                - erstelle immer die singular form von den relevanten Suchbegriffen
-                - Keine Einleitung, keine Erklärung, keine Anführungszeichen.
-                - Verwende nur die shop relevanten Suchbegriffe für eine Shopsuche aus dem Nutzereingabetext.
-                - Maximal 6 Suchbegriffe, besser weniger.
-                - Entferne Füllwörter, Höflichkeitsformen und irrelevante Wörter.
-                - Erhalte Produktnamen, Marken, Modellnummern und zusammengesetzte Begriffe exakt, wenn sie relevant sind.
-                - Zahlen, die zu einem Produktnamen oder Modell gehören (zb Indikator 300 oder Testomat 808), müssen erhalten bleiben.
-                - Trenne die Begriffe nur durch Leerzeichen.
-                
-                Ausgabeformat:
-                Keyword1 Keyword2 Keyword3
-                
-                Nutzereingabetext: ' . $prompt . '
-                ';
 
                 //Reset thinkSuppressor
                 $this->thinkSuppressor->reset();
 
-                yield $this->systemMsg("Ich optimere die Shopanfrage...", "think");
+                yield $this->systemMsg("Ich optimere die Recherche...", "think");
 
                 //Call ai for optimized swag query
                 foreach ($this->ollamaClient->stream($promptSwagSearch) as $swagToken) {
@@ -125,7 +109,7 @@ final readonly class AgentRunner
                     $swagFullOutPut .= $swagCleanToken;
                 }
 
-                yield $this->systemMsg("Ich rufe Shopdaten ab (type: " . $commerceIntent . ")", "think");
+                yield $this->systemMsg("Ich rufe Recherchedaten ab (type: " . $commerceIntent . ")", "think");
 
                 //Search in swag by ai optimized query
                 try {

src/Commerce/CommerceQueryParser.php

@@ -5,27 +5,22 @@ declare(strict_types=1);
 namespace App\Commerce;
 
 use App\Commerce\Dto\CommerceSearchQuery;
+use App\Config\CommerceIntentConfig;
+use App\Config\CommerceQueryParserConfig;
 use App\Knowledge\Retrieval\QueryCleaner;
 use App\Knowledge\Text\TextNormalizer;
 
-final class CommerceQueryParser
+final readonly class CommerceQueryParser
 {
     public function __construct(
-        private readonly TextNormalizer $textNormalizer,
+        private TextNormalizer            $textNormalizer,
-        private readonly QueryCleaner   $queryCleaner,
+        private QueryCleaner              $queryCleaner,
+        private CommerceQueryParserConfig $config,
+        private CommerceIntentConfig      $intentConfig,
     )
     {
-
     }
 
-    /**
-     * @var string[]
-     */
-    private array $knownBrands = [
-        'heyl',
-        'horiba'
-    ];
-
     public function parse(string $originalPrompt, string $intent): CommerceSearchQuery
     {
         $normalized = $this->normalize($originalPrompt);
@@ -103,7 +98,8 @@ final class CommerceQueryParser
     {
         $sizes = [];
 
-        if (preg_match_all('/\b(?:größe|groesse|grösse)\s*([a-z0-9.-]+)\b/u', $prompt, $matches) === false) {
+        $sizePattern = $this->intentConfig->getSizePattern();
+        if (preg_match_all('/\b(?:' . $sizePattern . ')\s*([a-z0-9.-]+)\b/u', $prompt, $matches) === false) {
             return [];
         }
 
@@ -111,7 +107,8 @@ final class CommerceQueryParser
             $sizes[] = trim($size);
         }
 
-        if (preg_match_all('/\b(xs|s|m|l|xl|xxl|xxxl)\b/u', $prompt, $tokenMatches) !== false) {
+        $sizeTokenPattern = $this->intentConfig->getSizeTokenPattern();
+        if (preg_match_all('/\b(' . $sizeTokenPattern . ')\b/u', $prompt, $tokenMatches) !== false) {
             foreach ($tokenMatches[1] as $sizeToken) {
                 $sizes[] = trim($sizeToken);
             }
@@ -122,16 +119,12 @@ final class CommerceQueryParser
 
     private function extractBrand(string $prompt): ?string
     {
-        foreach ($this->knownBrands as $brand) {
+        foreach ($this->config->getKnownBrands() as $brand) {
             if (str_contains($prompt, $brand)) {
                 return $brand;
             }
         }
 
-        if (preg_match('/\bheyl\s+([a-z0-9][a-z0-9\s\-]+)/u', $prompt, $m) === 1) {
-            return trim($m[1]);
-        }
-
         return null;
     }
 
@@ -145,20 +138,7 @@ final class CommerceQueryParser
     {
         $text = ' ' . $prompt . ' ';
 
-        $phrasesToRemove = [
+        $phrasesToRemove = $this->config->getPhrasesToRemove();
-            'ich suche',
-            'suche',
-            'habt ihr',
-            'gibt es',
-            'zeige mir',
-            'welches gerät',
-            'welche gerät',
-            'welches modell',
-            'welches ist besser',
-            'welches ist am besten',
-            'alternative',
-            'alternativen',
-        ];
 
         foreach ($phrasesToRemove as $phrase) {
             $text = str_replace($phrase, ' ', $text);
@@ -173,11 +153,9 @@ final class CommerceQueryParser
         }
 
         if ($priceMin !== null || $priceMax !== null) {
-            if ($priceMin !== null || $priceMax !== null) {
+            $text = preg_replace('/\bzwischen\s+\d+(?:[.,]\d+)?\s+und\s+\d+(?:[.,]\d+)?\s*euro\b/u', ' ', $text) ?? $text;
-                $text = preg_replace('/\bzwischen\s+\d+(?:[.,]\d+)?\s+und\s+\d+(?:[.,]\d+)?\s*euro\b/u', ' ', $text) ?? $text;
+            $text = preg_replace('/\b(?:unter|bis|max(?:imal)?|ab|mindestens|min)\s+\d+(?:[.,]\d+)?\s*euro\b/u', ' ', $text) ?? $text;
-                $text = preg_replace('/\b(?:unter|bis|max(?:imal)?|ab|mindestens|min)\s+\d+(?:[.,]\d+)?\s*euro\b/u', ' ', $text) ?? $text;
+            $text = preg_replace('/\b'.$this->intentConfig->getPricePattern().'\b/u', ' ', $text) ?? $text;
-                $text = preg_replace('/\beuro\b/u', ' ', $text) ?? $text;
-            }
         }
 
         $text = preg_replace('/\s+/u', ' ', $text) ?? $text;

src/Commerce/ShopSearchService.php

@@ -8,7 +8,6 @@ use App\Commerce\Dto\ShopProductResult;
 use App\Shopware\ShopwareCriteriaBuilder;
 use App\Shopware\StoreApiClient;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
-use Symfony\Contracts\HttpClient\Exception\DecodingExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\RedirectionExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\ServerExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
@@ -16,14 +15,13 @@ use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
 final readonly class ShopSearchService
 {
     public function __construct(
-        private CommerceQueryParser     $queryParser,
+        private CommerceQueryParser $queryParser,
         private ShopwareCriteriaBuilder $criteriaBuilder,
-        private StoreApiClient          $storeApiClient,
+        private StoreApiClient $storeApiClient,
-        private bool                    $enabled = true,
+        private bool $enabled = true,
-        private int                     $maxResults = 25,
+        private int $maxResults = 25,
-        private string                  $baseUrl
+        private string $baseUrl
-    )
+    ) {
-    {
     }
 
     /**
@@ -36,18 +34,17 @@ final readonly class ShopSearchService
         }
 
         $response = [];
+
         $query = $this->queryParser->parse($originalPrompt, $commerceIntent);
         $criteria = $this->criteriaBuilder->build($query, $this->maxResults);
 
         try {
             $response = $this->storeApiClient->searchProducts($criteria);
-        } catch (ClientExceptionInterface|DecodingExceptionInterface|RedirectionExceptionInterface|ServerExceptionInterface|TransportExceptionInterface $e) {
+        } catch (ClientExceptionInterface|RedirectionExceptionInterface|ServerExceptionInterface|TransportExceptionInterface $e) {
 
         }
 
-        $result = $this->mapProducts($response);;
+        return $this->mapProducts($response);
-
-        return $result;
     }
 
     /**
@@ -68,42 +65,44 @@ final readonly class ShopSearchService
             }
 
             $results[] = new ShopProductResult(
-                id: (string)($row['id'] ?? ''),
+                id: (string) ($row['id'] ?? ''),
-                name: trim((string)($row['translated']['name'] ?? '')),
+                name: trim((string) ($row['translated']['name'] ?? '')),
-                productNumber: isset($row['productNumber']) ? (string)$row['productNumber'] : null,
+                productNumber: isset($row['productNumber']) ? (string) $row['productNumber'] : null,
+                manufacturer: $this->extractManufacturer($row),
                 price: $this->extractPrice($row),
-                available: isset($row['available']) ? (bool)$row['available'] : null,
+                available: isset($row['available']) ? (bool) $row['available'] : null,
                 url: $this->baseUrl . $this->extractUrl($row),
                 highlights: $this->extractHighlights($row),
                 description: $this->cleanUpDescription($row),
                 productImage: $row['cover']['media']['thumbnails'][0]['url'] ?? 'no-image',
-                customFields: $this->getRelevantCustomFields($row['customFields'])
+                customFields: $this->getRelevantCustomFields($row['customFields'] ?? [])
             );
         }
 
         return array_values(array_filter(
             $results,
-            static fn(ShopProductResult $product): bool => $product->name !== ''
+            static fn (ShopProductResult $product): bool => $product->name !== ''
         ));
     }
 
-    private function getRelevantCustomFields($customField): string
+    private function getRelevantCustomFields(array $customField): string
     {
         $result = ($customField['migration_Backup_product_attr1'] ?? '') . ': ' . ($customField['migration_Backup_product_attr2'] ?? '');
         $result .= ' | Einsatzgebiete: ' . ($customField['migration_Backup_product_attr4'] ?? '');
         $result .= ' | Sprachen: ' . ($customField['migration_Backup_product_attr5'] ?? '');
 
-        return $result;
+        return trim($result);
     }
 
-    private function cleanUpDescription($description): string
+    private function cleanUpDescription(array $description): string
     {
         if (isset($description['translated']['description'])) {
-            $newDesc = strip_tags((string)$description['translated']['description']);
+            $newDesc = strip_tags((string) $description['translated']['description']);
-            $newDesc = preg_replace('/^[ \t]*\R/m', '', $newDesc); // leere Zeilen weg
+            $newDesc = preg_replace('/^[ \t]*\R/m', '', $newDesc);
-            $newDesc = preg_replace('/[ \t]{2,}/', ' ', $newDesc); // mehrere Spaces zu einem
+            $newDesc = preg_replace('/[ \t]{2,}/', ' ', $newDesc);
-            $result = trim($newDesc);
+            $result = trim((string) $newDesc);
-            return substr($result, 0, 500);
+
+            return mb_substr($result, 0, 500);
         }
 
         return '';
@@ -114,7 +113,9 @@ final readonly class ShopSearchService
         $manufacturer = $row['manufacturer'] ?? null;
 
         if (is_array($manufacturer) && isset($manufacturer['name']) && is_string($manufacturer['name'])) {
-            return trim($manufacturer['name']) !== '' ? trim($manufacturer['name']) : null;
+            $name = trim($manufacturer['name']);
+
+            return $name !== '' ? $name : null;
         }
 
         return null;
@@ -128,12 +129,18 @@ final readonly class ShopSearchService
             return null;
         }
 
-        $unitPrice = $calculatedPrice['unitPrice'] ?? $calculatedPrice['totalPrice'] ?? $calculatedPrice['referencePrice'] ?? $calculatedPrice['listPrice'] ?? $calculatedPrice['regulationPrice'] ?? 0;
+        $unitPrice = $calculatedPrice['unitPrice']
+            ?? $calculatedPrice['totalPrice']
+            ?? $calculatedPrice['referencePrice']
+            ?? $calculatedPrice['listPrice']
+            ?? $calculatedPrice['regulationPrice']
+            ?? null;
+
         if (!is_numeric($unitPrice)) {
             return null;
         }
 
-        return number_format((float)$unitPrice, 2, ',', '.') . ' €';
+        return number_format((float) $unitPrice, 2, ',', '.') . ' €';
     }
 
     private function extractUrl(array $row): ?string
@@ -166,7 +173,7 @@ final readonly class ShopSearchService
         $highlights = [];
 
         if (isset($row['available'])) {
-            $highlights[] = ((bool)$row['available']) ? 'Verfügbar' : 'Nicht verfügbar';
+            $highlights[] = (bool) $row['available'] ? 'Verfügbar' : 'Nicht verfügbar';
         }
 
         if (isset($row['productNumber']) && is_string($row['productNumber']) && trim($row['productNumber']) !== '') {

src/Config/AgentRunnerConfig.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Config;
+
+class AgentRunnerConfig
+{
+    public function getShopPrompt($prompt): string
+    {
+        return '
+                Erzeuge aus dem folgenden Nutzereingabetext einen kurzen Suchtext für die Shopware-6-Suche.
+                
+                Regeln:
+                - Gib nur den finalen Suchtext aus.
+                - erstelle immer die singular form von den relevanten Suchbegriffen
+                - Keine Einleitung, keine Erklärung, keine Anführungszeichen.
+                - Verwende nur die shop relevanten Suchbegriffe für eine Shopsuche aus dem Nutzereingabetext.
+                - Maximal 6 Suchbegriffe, besser weniger.
+                - Entferne Füllwörter, Höflichkeitsformen und irrelevante Wörter.
+                - Erhalte Produktnamen, Marken, Modellnummern und zusammengesetzte Begriffe exakt, wenn sie relevant sind.
+                - Zahlen, die zu einem Produktnamen oder Modell gehören (zb Indikator 300 oder Testomat 808), müssen erhalten bleiben.
+                - Trenne die Begriffe nur durch Leerzeichen.
+                
+                Ausgabeformat:
+                Keyword1 Keyword2 Keyword3
+                
+                Nutzereingabetext: ' . $prompt . '
+                ';
+    }
+}

src/Config/CatalogIntentConfig.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Config;
+
+class CatalogIntentConfig
+{
+    // Minimum similarity score. Prevents noise.
+    public const MIN_SCORE = 0.72;
+
+    // Difference between Top 1 and Top 2, so that no uncertain match is accepted.
+    public const AMBIGUITY_DELTA = 0.02;
+}

src/Config/CommerceIntentConfig.php

@@ -0,0 +1,101 @@
+<?php
+
+namespace App\Config;
+
+class CommerceIntentConfig
+{
+    public function getStrongSignalsList(): array
+    {
+        return [
+            'suche',
+            'habt',
+            'gibt',
+            'zeig',
+            'welche',
+            'vergleich',
+            'alternativ',
+            'find',
+            'shop',
+            'store',
+            'sku',
+            'Artikel',
+            'Gerät',
+            'testomat',
+            'indikator',
+            'Titromat',
+            'Seminar',
+            'Schulung',
+            'Sensor',
+            'liste'
+        ];
+    }
+
+    public function getAdvisorySignals(): array
+    {
+        return [
+            'passt',
+            'eignet',
+            'besser',
+            'besten',
+            'geeignet',
+            'empfiehl',
+            'empfehl',
+        ];
+    }
+
+    public function getPricePattern(): string
+    {
+        $pattern = [
+            'euro',
+            '€',
+            'eur',
+            'teuer',
+            'preis',
+            'kosten'
+        ];
+        return implode('|', $pattern);
+    }
+
+    public function getColorPattern(): string
+    {
+        $pattern = [
+            'schwarz',
+            'weiß',
+            'weis',
+            'blau',
+            'grau',
+            'beige',
+            'rosa',
+            'pink',
+            'gruen',
+            'orange',
+            'braun'
+        ];
+        return implode('|', $pattern);
+    }
+
+    public function getSizeTokenPattern(): string
+    {
+        $pattern = [
+            'xs',
+            's',
+            'm',
+            'l',
+            'xl',
+            '',
+            'xxl',
+            'xxxxl',
+        ];
+        return implode('|', $pattern);
+    }
+
+    public function getSizePattern(): string
+    {
+        $pattern = [
+            'größe',
+            'groesse',
+            'grösse'
+        ];
+        return implode('|', $pattern);
+    }
+}

src/Config/CommerceQueryParserConfig.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Config;
+
+class CommerceQueryParserConfig
+{
+    public function getKnownBrands(): array
+    {
+        return [
+            'heyl',
+            'horiba',
+            'neomeris'
+        ];
+    }
+
+    public function getPhrasesToRemove(): array{
+        return [
+            'ich suche',
+            'suche',
+            'habt ihr',
+            'gibt es',
+            'zeige mir',
+            'welches gerät',
+            'welche gerät',
+            'welches modell',
+            'welches ist besser',
+            'welches ist am besten',
+            'alternative',
+            'alternativen',
+        ];
+    }
+}

src/Config/ContextServiceConfig.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Config;
+
+class ContextServiceConfig
+{
+    //Number of lines included in regular context. Intended for normal conversational continuity.
+    public const MAX_VISIBLE_REGULAR_LINES = 25;
+
+    //Number of lines included in full context. Intended for exceptional or diagnostic scenarios.
+    public const MAX_FULL_LINES = 500;
+}

src/Config/IntentLightConfig.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Config;
+
+class IntentLightConfig
+{
+    public const LIST_THRESHOLD = 4;
+
+    public function getQuantityWords(): array
+    {
+        return [
+            'alle',
+            'sämtliche',
+            'saemtliche',
+            'mehrere',
+            'verschiedene',
+            'einige',
+            'viele',
+            'optionen',
+            'möglichkeiten',
+            'moeglichkeiten',
+            'varianten',
+            'arten',
+            'modelle',
+            'funktionen',
+            'punkte',
+            'schritte',
+            'kategorien',
+            'übersicht',
+            'uebersicht',
+        ];
+    }
+
+    public function getStrongPatterns(): array
+    {
+        return [
+            '/\bliste(n)?\b/u',
+            '/\bauflisten\b/u',
+            '/\baufz(a|ä)hl(en)?\b/u',
+            '/\bnenn(e)?\b/u',
+            '/\bzeig(e)?\b/u',
+            '/\bwelche\s+sind\b/u',
+            '/\bwelche\s+gibt\s+es\b/u',
+            '/\bwas\s+sind\b/u',
+            '/\bwie\s+viele\b/u',
+            '/\branking\b/u',
+            '/\btop\s*\d+\b/u',
+        ];
+    }
+}

src/Config/NdjsonHybridRetrieverConfig.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Config;
+
+class NdjsonHybridRetrieverConfig
+{
+    public const VECTOR_SCORE_THRESHOLD = 0.75;
+
+    public const HARD_MAX_CHUNKS = 90;
+    public const HARD_MAX_VECTORK = 250;
+
+    public const LIST_BONUS = 1.25;
+
+    public const MAX_CHUNKS_PER_DOC = 2;
+    public const MIN_CHUNK_DISTANCE = 2.5;
+    public const RRF_K = 60;
+
+    public const THRESHOLD_FLOOR = 0.83;
+    public const THRESHOLD_CEIL = 0.92;
+    public const EMPTY_RRF_FALLBACK_TOPN = 1;
+}

src/Config/SalesIntentConfig.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Config;
+
+class SalesIntentConfig
+{
+
+    // Minimum gap between Top 1 and Top 2 so that an intent is truly dominant.
+    public const DOMINANCE_DELTA = 2;
+
+    // Minimum score required for any non-discovery intent to be accepted.
+    public const MIN_SCORE_THRESHOLD = 3;
+
+
+    public function getSalesSignals(): array
+    {
+        return [
+            'preis', 'preise', 'kosten', 'lizenz', 'lizenzmodell',
+            'tarif', 'tarife', 'gebuehr', 'gebühr',
+            'monatlich', 'jaehrlich', 'jährlich', 'abo', 'subscription'
+        ];
+    }
+
+    public function getComparisonSignals(): array
+    {
+        return [
+            '/\bvergleich(en)?\b/u',
+            '/\bvs\b/u',
+            '/\bgegenueber\b/u',
+            '/\balternative(n)?\b/u',
+            '/\bunterschied(e)?\b/u',
+            '/\bbesser\b/u'
+        ];
+    }
+
+    public function getObjectionSignals(): array
+    {
+        return [
+            'problem', 'risiko', 'nachteil', 'datenschutz',
+            'dsgvo', 'sicherheit', 'compliance',
+            'kritik', 'zweifel', 'unsicher'
+        ];
+    }
+    public function getImplementationSignals(): array
+    {
+        return [
+            'implementierung', 'implementieren',
+            'integration', 'integrieren',
+            'einführung', 'einfuehrung',
+            'aufwand', 'setup', 'rollout',
+            'migration', 'installation',
+            'api', 'schnittstelle'
+        ];
+    }
+    public function getRoiSignals(): array
+    {
+        return [
+            'roi', 'rentabilitaet', 'rentabilität',
+            'business case', 'einsparung',
+            'kosten senken', 'umsatz steigern',
+            'effizienz steigern'
+        ];
+    }
+
+}

src/Context/ContextService.php

@@ -4,6 +4,8 @@ declare(strict_types=1);
 
 namespace App\Context;
 
+use App\Config\ContextServiceConfig;
+
 /**
  * ContextService
  *
@@ -27,22 +29,11 @@ final class ContextService
 {
     private string $historyDir;
 
-    /**
-     * Number of lines included in regular context.
-     * Intended for normal conversational continuity.
-     */
-    private int $maxRegularLines = 20;
-
-    /**
-     * Number of lines included in full context.
-     * Intended for exceptional or diagnostic scenarios.
-     */
-    private int $maxFullLines = 500;
-
     public function __construct(
         string $historyDir,
         string $projectDir,
-    ) {
+    )
+    {
         /**
          * Normalize history directory:
          * - Allow relative paths in env (e.g. "var/agent-history")
@@ -66,7 +57,7 @@ final class ContextService
      * Returns the conversation context for a given user.
      *
      * @param string $userId Stable client identifier
-     * @param bool   $full   Whether to load extended history
+     * @param bool $full Whether to load extended history
      */
     public function buildUserContext(string $userId, bool $full = true): string
     {
@@ -81,7 +72,7 @@ final class ContextService
             return '';
         }
 
-        $maxLines = $full ? $this->maxFullLines : $this->maxRegularLines;
+        $maxLines = $full ? ContextServiceConfig::MAX_FULL_LINES : ContextServiceConfig::MAX_VISIBLE_REGULAR_LINES;
         $selected = array_slice($lines, -$maxLines);
 
         return implode("\n", $selected);

src/Intent/CatalogIntentLite.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Intent;
 
+use App\Config\CatalogIntentConfig;
 use App\Knowledge\Retrieval\QueryCleaner;
 use App\Tag\TagVectorSearchClient;
 use App\Tag\TagTypes;
@@ -24,23 +25,12 @@ use App\Tag\TagTypes;
  * - SalesIntent
  * - Routing
  */
-final class CatalogIntentLite
+final readonly class CatalogIntentLite
 {
-    /**
-     * Minimaler Similarity-Score.
-     * Verhindert Rauschen.
-     */
-    private const MIN_SCORE = 0.72;
-
-    /**
-     * Differenz zwischen Top1 und Top2,
-     * damit kein unsicherer Treffer akzeptiert wird.
-     */
-    private const AMBIGUITY_DELTA = 0.02;
 
     public function __construct(
-        private readonly TagVectorSearchClient $tagVectorClient,
+        private TagVectorSearchClient $tagVectorClient,
-        private readonly QueryCleaner   $queryCleaner,
+        private QueryCleaner          $queryCleaner
     ) {}
 
     /**
@@ -67,7 +57,7 @@ final class CatalogIntentLite
         $bestScore = (float)($best['score'] ?? 0.0);
 
         // 2) Score-Tags
-        if ($bestScore < self::MIN_SCORE) {
+        if ($bestScore < CatalogIntentConfig::MIN_SCORE) {
             return null;
         }
 
@@ -75,7 +65,7 @@ final class CatalogIntentLite
         if (isset($hits[1])) {
             $secondScore = (float)($hits[1]['score'] ?? 0.0);
 
-            if (abs($bestScore - $secondScore) < self::AMBIGUITY_DELTA) {
+            if (abs($bestScore - $secondScore) < CatalogIntentConfig::AMBIGUITY_DELTA) {
                 return null;
             }
         }

src/Intent/CommerceIntentLite.php

@@ -4,12 +4,21 @@ declare(strict_types=1);
 
 namespace App\Intent;
 
+use App\Config\CommerceIntentConfig;
+
 final class CommerceIntentLite
 {
     public const NONE = 'none';
     public const PRODUCT_SEARCH = 'product_search';
     public const ADVISORY_PRODUCT_SEARCH = 'advisory_product_search';
 
+    public function __construct(
+        private readonly CommerceIntentConfig $config
+    )
+    {
+
+    }
+
     /**
      * @return array{intent:string, score:int, signals:string[]}
      */
@@ -28,28 +37,7 @@ final class CommerceIntentLite
         $score = 0;
         $signals = [];
 
-        $strongSignals = [
+        $strongSignals = $this->config->getStrongSignalsList();
-            'suche',
-            'habt',
-            'gibt',
-            'zeig',
-            'welche',
-            'vergleich',
-            'alternativ',
-            'find',
-            'shop',
-            'store',
-            'sku',
-            'Artikel',
-            'Gerät',
-            'testomat',
-            'indikator',
-            'Titromat',
-            'Seminar',
-            'Schulung',
-            'Sensor',
-            'liste'
-        ];
 
         foreach ($strongSignals as $signal) {
             if (str_contains($p, strtolower($signal))) {
@@ -58,40 +46,36 @@ final class CommerceIntentLite
             }
         }
 
-        if(preg_match('#\d{3,10}#', $p)){
+        if (preg_match('#\d{3,10}#', $p)) {
             $score += 2;
             $signals[] = 'sku';
         }
 
-        if (preg_match('/\b\d+(?:[.,]\d+)?\s*(euro|€|eur|teuer|preis|kosten)\b/u', $p) === 1) {
+        $pricePattern = $this->config->getPricePattern();
+        if (preg_match('/\b\d+(?:[.,]\d+)?\s*(' . $pricePattern . ')\b/u', $p) === 1) {
             $score += 2;
             $signals[] = 'price';
         }
 
-        if (preg_match('/\b(größe|groesse|grösse)\s*[a-z0-9.-]+\b/u', $p) === 1) {
+        $sizePattern = $this->config->getSizePattern();
+        if (preg_match('/\b(' . $sizePattern . ')\s*[a-z0-9.-]+\b/u', $p) === 1) {
             $score += 2;
             $signals[] = 'size';
         }
 
-        if (preg_match('/\b(xs|s|m|l|xl|xxl|xxxl)\b/u', $p) === 1) {
+        $sizeTokenPattern = $this->config->getSizeTokenPattern();
+        if (preg_match('/\b(' . $sizeTokenPattern . ')\b/u', $p) === 1) {
             $score += 1;
             $signals[] = 'size_token';
         }
 
-        if (preg_match('/\b(schwarz|weiß|weiss|rot|blau|grün|gruen|gelb|grau|beige|rosa|pink|orange|braun)\b/u', $p) === 1) {
+        $colorPattern = $this->config->getColorPattern();
+        if (preg_match('/\b(' . $colorPattern . ')\b/u', $p) === 1) {
             $score += 1;
             $signals[] = 'color';
         }
 
-        $advisorySignals = [
+        $advisorySignals = $this->config->getAdvisorySignals();
-            'passt',
-            'eignet',
-            'besser',
-            'besten',
-            'geeignet',
-            'empfiehl',
-            'empfehl',
-        ];
 
         foreach ($advisorySignals as $signal) {
             if (str_contains($p, $signal)) {

src/Intent/IntentLite.php

@@ -4,19 +4,27 @@ declare(strict_types=1);
 
 namespace App\Intent;
 
+use App\Config\IntentLightConfig;
+
 /**
  * IntentLite
  *
- * Deterministische, LLM-agnostische Intent-Erkennung.
+ * Deterministic, LLM-agnostic intent detection.
- * Fokus: LIST-Intent für Retrieval-Steuerung.
+ * Focus: LIST intent for retrieval control.
  *
- * WICHTIG:
+ * IMPORTANT:
- * - Immer mit dem ORIGINAL-Prompt aufrufen.
+ * - Always call it with the ORIGINAL prompt.
- * - Nicht mit dem QueryCleaner-Ergebnis.
+ * - Not with the QueryCleaner result.
  */
-final class IntentLite
+final readonly class IntentLite
 {
-    private const LIST_THRESHOLD = 4;
+
+    public function __construct(
+        private IntentLightConfig $config
+    )
+    {
+
+    }
 
     public function detectList(string $originalPrompt): array
     {
@@ -28,19 +36,7 @@ final class IntentLite
         // --------------------------------------------------------
         // 1. Starke explizite Listen-Trigger (hohes Gewicht)
         // --------------------------------------------------------
-        $strongPatterns = [
+        $strongPatterns = $this->config->getStrongPatterns();
-            '/\bliste(n)?\b/u',
-            '/\bauflisten\b/u',
-            '/\baufz(a|ä)hl(en)?\b/u',
-            '/\bnenn(e)?\b/u',
-            '/\bzeig(e)?\b/u',
-            '/\bwelche\s+sind\b/u',
-            '/\bwelche\s+gibt\s+es\b/u',
-            '/\bwas\s+sind\b/u',
-            '/\bwie\s+viele\b/u',
-            '/\branking\b/u',
-            '/\btop\s*\d+\b/u',
-        ];
 
         foreach ($strongPatterns as $pattern) {
             if (preg_match($pattern, $p) === 1) {
@@ -52,27 +48,7 @@ final class IntentLite
         // --------------------------------------------------------
         // 2. Mengen- / Mehrzahl-Indikatoren
         // --------------------------------------------------------
-        $quantityWords = [
+        $quantityWords = $this->config->getQuantityWords();
-            'alle',
-            'sämtliche',
-            'saemtliche',
-            'mehrere',
-            'verschiedene',
-            'einige',
-            'viele',
-            'optionen',
-            'möglichkeiten',
-            'moeglichkeiten',
-            'varianten',
-            'arten',
-            'modelle',
-            'funktionen',
-            'punkte',
-            'schritte',
-            'kategorien',
-            'übersicht',
-            'uebersicht',
-        ];
 
         foreach ($quantityWords as $word) {
             if (preg_match('/\b' . preg_quote($word, '/') . '\b/u', $p) === 1) {
@@ -102,11 +78,11 @@ final class IntentLite
         // --------------------------------------------------------
         // Entscheidung
         // --------------------------------------------------------
-        $isList = $score >= self::LIST_THRESHOLD;
+        $isList = $score >= IntentLightConfig::LIST_THRESHOLD;
 
         return [
             'is_list' => $isList,
-            'score'   => $score,
+            'score' => $score,
             'signals' => $signals,
         ];
     }

src/Intent/SalesIntentLite.php

@@ -4,26 +4,23 @@ declare(strict_types=1);
 
 namespace App\Intent;
 
+use App\Config\SalesIntentConfig;
+
 final class SalesIntentLite
 {
-    public const DISCOVERY      = 'discovery';
+    public const DISCOVERY = 'discovery';
-    public const PRICING        = 'pricing';
+    public const PRICING = 'pricing';
-    public const COMPARISON     = 'comparison';
+    public const COMPARISON = 'comparison';
-    public const OBJECTION      = 'objection';
+    public const OBJECTION = 'objection';
     public const IMPLEMENTATION = 'implementation';
-    public const ROI            = 'roi';
+    public const ROI = 'roi';
 
-    /**
+    public function __construct(
-     * Mindestabstand zwischen Top1 und Top2,
+        private readonly SalesIntentConfig $config
-     * damit ein Intent wirklich dominant ist.
+    )
-     */
+    {
-    private const DOMINANCE_DELTA = 2;
 
-    /**
+    }
-     * Mindestscore, damit überhaupt ein Nicht-Discovery-Intent
-     * akzeptiert wird.
-     */
-    private const MIN_SCORE_THRESHOLD = 3;
 
     public function detect(string $originalPrompt): array
     {
@@ -32,27 +29,23 @@ final class SalesIntentLite
         if ($p === '') {
             return [
                 'intent' => self::DISCOVERY,
-                'score'  => 0,
+                'score' => 0,
             ];
         }
 
         $scores = [
-            self::PRICING        => 0,
+            self::PRICING => 0,
-            self::COMPARISON     => 0,
+            self::COMPARISON => 0,
-            self::OBJECTION      => 0,
+            self::OBJECTION => 0,
             self::IMPLEMENTATION => 0,
-            self::ROI            => 0,
+            self::ROI => 0,
         ];
 
         // ------------------------------------------------------------
         // PRICING
         // ------------------------------------------------------------
-        foreach ([
+        foreach ($this->config->getSalesSignals() as $word) {
-                     'preis','preise','kosten','lizenz','lizenzmodell',
+            if (preg_match('/\b' . preg_quote($word, '/') . '\b/u', $p)) {
-                     'tarif','tarife','gebuehr','gebühr',
-                     'monatlich','jaehrlich','jährlich','abo','subscription'
-                 ] as $word) {
-            if (preg_match('/\b'.preg_quote($word,'/').'\b/u', $p)) {
                 $scores[self::PRICING] += 3;
             }
         }
@@ -60,14 +53,7 @@ final class SalesIntentLite
         // ------------------------------------------------------------
         // COMPARISON
         // ------------------------------------------------------------
-        foreach ([
+        foreach ($this->config->getComparisonSignals() as $pattern) {
-                     '/\bvergleich(en)?\b/u',
-                     '/\bvs\b/u',
-                     '/\bgegenueber\b/u',
-                     '/\balternative(n)?\b/u',
-                     '/\bunterschied(e)?\b/u',
-                     '/\bbesser\b/u'
-                 ] as $pattern) {
             if (preg_match($pattern, $p)) {
                 $scores[self::COMPARISON] += 3;
             }
@@ -76,12 +62,8 @@ final class SalesIntentLite
         // ------------------------------------------------------------
         // OBJECTION
         // ------------------------------------------------------------
-        foreach ([
+        foreach ($this->config->getComparisonSignals() as $word) {
-                     'problem','risiko','nachteil','datenschutz',
+            if (preg_match('/\b' . preg_quote($word, '/') . '\b/u', $p)) {
-                     'dsgvo','sicherheit','compliance',
-                     'kritik','zweifel','unsicher'
-                 ] as $word) {
-            if (preg_match('/\b'.preg_quote($word,'/').'\b/u', $p)) {
                 $scores[self::OBJECTION] += 3;
             }
         }
@@ -89,15 +71,8 @@ final class SalesIntentLite
         // ------------------------------------------------------------
         // IMPLEMENTATION
         // ------------------------------------------------------------
-        foreach ([
+        foreach ($this->config->getImplementationSignals() as $word) {
-                     'implementierung','implementieren',
+            if (preg_match('/\b' . preg_quote($word, '/') . '\b/u', $p)) {
-                     'integration','integrieren',
-                     'einführung','einfuehrung',
-                     'aufwand','setup','rollout',
-                     'migration','installation',
-                     'api','schnittstelle'
-                 ] as $word) {
-            if (preg_match('/\b'.preg_quote($word,'/').'\b/u', $p)) {
                 $scores[self::IMPLEMENTATION] += 3;
             }
         }
@@ -105,13 +80,8 @@ final class SalesIntentLite
         // ------------------------------------------------------------
         // ROI
         // ------------------------------------------------------------
-        foreach ([
+        foreach ($this->config->getRoiSignals() as $word) {
-                     'roi','rentabilitaet','rentabilität',
+            if (preg_match('/\b' . preg_quote($word, '/') . '\b/u', $p)) {
-                     'business case','einsparung',
-                     'kosten senken','umsatz steigern',
-                     'effizienz steigern'
-                 ] as $word) {
-            if (preg_match('/\b'.preg_quote($word,'/').'\b/u', $p)) {
                 $scores[self::ROI] += 3;
             }
         }
@@ -123,31 +93,31 @@ final class SalesIntentLite
         arsort($scores);
 
         $intents = array_keys($scores);
-        $values  = array_values($scores);
+        $values = array_values($scores);
 
         $topIntent = $intents[0] ?? self::DISCOVERY;
-        $topScore  = $values[0] ?? 0;
+        $topScore = $values[0] ?? 0;
         $secondScore = $values[1] ?? 0;
 
         // Kein relevanter Score → Discovery
-        if ($topScore < self::MIN_SCORE_THRESHOLD) {
+        if ($topScore < SalesIntentConfig::MIN_SCORE_THRESHOLD) {
             return [
                 'intent' => self::DISCOVERY,
-                'score'  => 0,
+                'score' => 0,
             ];
         }
 
         // Keine klare Dominanz → Discovery
-        if (($topScore - $secondScore) < self::DOMINANCE_DELTA) {
+        if (($topScore - $secondScore) < SalesIntentConfig::DOMINANCE_DELTA) {
             return [
                 'intent' => self::DISCOVERY,
-                'score'  => $topScore,
+                'score' => $topScore,
             ];
         }
 
         return [
             'intent' => $topIntent,
-            'score'  => $topScore,
+            'score' => $topScore,
         ];
     }
 

src/Knowledge/Retrieval/NdjsonHybridRetriever.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace App\Knowledge\Retrieval;
 
 use App\Catalog\EntityCatalogService;
+use App\Config\NdjsonHybridRetrieverConfig;
 use App\Entity\ModelGenerationConfig;
 use App\Intent\CatalogIntentLite;
 use App\Intent\IntentLite;
@@ -14,35 +15,20 @@ use App\Routing\IntentRouteResolver;
 use App\Tag\TagRoutingService;
 use App\Vector\VectorSearchClient;
 
-final class NdjsonHybridRetriever implements RetrieverInterface
+final readonly class NdjsonHybridRetriever implements RetrieverInterface
 {
-    private const VECTOR_SCORE_THRESHOLD = 0.75;
-
-    private const HARD_MAX_CHUNKS = 90;
-    private const HARD_MAX_VECTORK = 250;
-
-    private const LIST_BONUS = 1.25;
-
-    private const MAX_CHUNKS_PER_DOC = 2;
-    private const MIN_CHUNK_DISTANCE = 2.5;
-    private const RRF_K = 60;
-
-    private const THRESHOLD_FLOOR = 0.83;
-    private const THRESHOLD_CEIL = 0.92;
-    private const EMPTY_RRF_FALLBACK_TOPN = 1;
-
     public function __construct(
-        private readonly NdjsonChunkLookup               $lookup,
+        private NdjsonChunkLookup               $lookup,
-        private readonly VectorSearchClient              $vectorClient,
+        private VectorSearchClient              $vectorClient,
-        private readonly TagRoutingService               $tagRouting,
+        private TagRoutingService               $tagRouting,
-        private readonly ModelGenerationConfigRepository $configRepository,
+        private ModelGenerationConfigRepository $configRepository,
-        private readonly QueryCleaner                    $queryCleaner,
+        private QueryCleaner                    $queryCleaner,
-        private readonly IntentLite                      $intentLite,
+        private IntentLite                      $intentLite,
-        private readonly SalesIntentLite                 $salesIntentLite,
+        private SalesIntentLite                 $salesIntentLite,
-        private readonly CatalogIntentLite               $catalogIntent,
+        private CatalogIntentLite               $catalogIntent,
-        private readonly IntentRouteResolver             $routeResolver,
+        private IntentRouteResolver             $routeResolver,
-        private readonly EntityCatalogService            $entityCatalogService,
+        private EntityCatalogService            $entityCatalogService,
-        private readonly QueryEnricher                   $queryEnricher,
+        private QueryEnricher                   $queryEnricher,
     )
     {
     }
@@ -206,8 +192,8 @@ final class NdjsonHybridRetriever implements RetrieverInterface
     ): array
     {
 
-        $limit = max(1, min($config->getRetrievalMaxChunks(), self::HARD_MAX_CHUNKS));
+        $limit = max(1, min($config->getRetrievalMaxChunks(), NdjsonHybridRetrieverConfig::HARD_MAX_CHUNKS));
-        $vectorTopKBase = max(1, min($config->getRetrievalVectorTopK(), self::HARD_MAX_VECTORK));
+        $vectorTopKBase = max(1, min($config->getRetrievalVectorTopK(), NdjsonHybridRetrieverConfig::HARD_MAX_VECTORK));
 
         $isListQuery = $this->intentLite->isListQuery($prompt);
 
@@ -218,7 +204,7 @@ final class NdjsonHybridRetriever implements RetrieverInterface
             return [
                 'limit' => $limit,
                 'is_list_query' => $isListQuery,
-                'threshold' => self::VECTOR_SCORE_THRESHOLD,
+                'threshold' => NdjsonHybridRetrieverConfig::VECTOR_SCORE_THRESHOLD,
                 'ranked_chunk_ids' => [],
                 'rows' => [],
                 'rrf_scores' => [],
@@ -270,7 +256,7 @@ final class NdjsonHybridRetriever implements RetrieverInterface
         if ($rrfScores === [] && $globalHits !== []) {
             $rrfScores = $this->fallbackRrfFromHits(
                 $globalHits,
-                self::EMPTY_RRF_FALLBACK_TOPN
+                NdjsonHybridRetrieverConfig::EMPTY_RRF_FALLBACK_TOPN
             );
         }
 
@@ -327,7 +313,7 @@ final class NdjsonHybridRetriever implements RetrieverInterface
     ): array
     {
 
-        $threshold = self::VECTOR_SCORE_THRESHOLD;
+        $threshold = NdjsonHybridRetrieverConfig::VECTOR_SCORE_THRESHOLD;
         $topK = $vectorTopKBase;
 
         if (
@@ -338,11 +324,11 @@ final class NdjsonHybridRetriever implements RetrieverInterface
         }
 
         if ($isListQuery) {
-            $topK = (int)round($topK * self::LIST_BONUS);
+            $topK = (int)round($topK * NdjsonHybridRetrieverConfig::LIST_BONUS);
         }
 
-        $topK = max(1, min($topK, self::HARD_MAX_VECTORK));
+        $topK = max(1, min($topK, NdjsonHybridRetrieverConfig::HARD_MAX_VECTORK));
-        $threshold = max(self::THRESHOLD_FLOOR, min(self::THRESHOLD_CEIL, $threshold));
+        $threshold = max(NdjsonHybridRetrieverConfig::THRESHOLD_FLOOR, min(NdjsonHybridRetrieverConfig::THRESHOLD_CEIL, $threshold));
 
         return [$threshold, $topK];
     }
@@ -382,7 +368,7 @@ final class NdjsonHybridRetriever implements RetrieverInterface
                 }
 
                 $rank++;
-                $rrf = 1.0 / (self::RRF_K + $rank);
+                $rrf = 1.0 / (NdjsonHybridRetrieverConfig::RRF_K + $rank);
 
                 if ($boost) {
                     $rrf *= 1.2;
@@ -413,7 +399,7 @@ final class NdjsonHybridRetriever implements RetrieverInterface
             }
 
             $rank++;
-            $rrf[(string)$hit['chunk_id']] = 1.0 / (self::RRF_K + $rank);
+            $rrf[(string)$hit['chunk_id']] = 1.0 / (NdjsonHybridRetrieverConfig::RRF_K + $rank);
 
             if ($rank >= $topN) {
                 break;
@@ -475,13 +461,13 @@ final class NdjsonHybridRetriever implements RetrieverInterface
                 continue;
             }
 
-            if (($docCounter[$docId] ?? 0) >= self::MAX_CHUNKS_PER_DOC) {
+            if (($docCounter[$docId] ?? 0) >= NdjsonHybridRetrieverConfig::MAX_CHUNKS_PER_DOC) {
                 continue;
             }
 
             if (is_int($chunkIndex)) {
                 foreach ($docChunkPositions[$docId] ?? [] as $prevIdx) {
-                    if (abs($prevIdx - $chunkIndex) < self::MIN_CHUNK_DISTANCE) {
+                    if (abs($prevIdx - $chunkIndex) < NdjsonHybridRetrieverConfig::MIN_CHUNK_DISTANCE) {
                         continue 2;
                     }
                 }

src/Shopware/StoreApiClient.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Shopware;
 
+use RuntimeException;
 use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\DecodingExceptionInterface;
 use Symfony\Contracts\HttpClient\Exception\RedirectionExceptionInterface;
@@ -15,18 +16,16 @@ final readonly class StoreApiClient
 {
     public function __construct(
         private HttpClientInterface $httpClient,
-        private string              $baseUrl,
+        private string $baseUrl,
-        private string              $salesChannelAccessKey,
+        private string $salesChannelAccessKey,
-        private int                 $timeoutSeconds = 5,
+        private int $timeoutSeconds = 5,
-    )
+    ) {
-    {
     }
 
     /**
      * @throws TransportExceptionInterface
      * @throws ServerExceptionInterface
      * @throws RedirectionExceptionInterface
-     * @throws DecodingExceptionInterface
      * @throws ClientExceptionInterface
      */
     public function searchProducts(array $criteria): array
@@ -44,10 +43,22 @@ final readonly class StoreApiClient
         ]);
 
         $statusCode = $response->getStatusCode();
+        $content = $response->getContent(false);
+
         if ($statusCode < 200 || $statusCode >= 300) {
-            return [];
+            throw new RuntimeException(sprintf(
+                'Shopware Store API request failed with status %d. Response: %s',
+                $statusCode,
+                mb_substr(trim($content), 0, 1000)
+            ));
         }
 
-        return $response->toArray(false);
+        $data = json_decode($content, true);
+
+        if (!is_array($data)) {
+            throw new RuntimeException('Shopware Store API returned invalid JSON.');
+        }
+
+        return $data;
     }
 }