feat(ai): enhance AI trace warnings with product context

- Added `productName` field to `AdminAiWarning` to include product context in warnings - Updated `collectWarnings` to extract and include `rawName` as `productName` in AI trace warnings - Added `signals` field to `FlyerParseItem` type for detailed product signals - Enhanced Flutter admin panel to display product names in AI trace warnings - Added new `AdminAiTraceResponse` DTO for AI trace data structure
2026-05-24 20:55:14 +02:00
parent 7713eb2fa7
commit ca1eed5061
5 changed files with 117 additions and 93 deletions
@@ -24,22 +24,23 @@ import { buildDisplayNameDetailed } from '../import-common/import-display-name.u
 import { extractImportSignals } from '../import-common/import-signals.util';
 import { ImportedItemSignals } from '../import-common/import-item.types';

-type FlyerParseItem = {
-  rawName: string;
-  normalizedName: string;
-  brand: string | null;
-  category: string | null;
-  price: number | null;
-  priceUnit: string | null;
-  comparisonPrice: number | null;
-  comparisonUnit: string | null;
-  weight: string | null;
-  bundleWeight: string | null;
-  isBundle: boolean;
-  bundleItems: string[];
-  offerText: string | null;
-  confidence: number;
-  reasonCodes: string[];
+type FlyerParseItem = {
+  rawName: string;
+  normalizedName: string;
+  brand: string | null;
+  category: string | null;
+  price: number | null;
+  priceUnit: string | null;
+  comparisonPrice: number | null;
+  comparisonUnit: string | null;
+  weight: string | null;
+  bundleWeight: string | null;
+  isBundle: boolean;
+  bundleItems: string[];
+  offerText: string | null;
+  confidence: number;
+  reasonCodes: string[];
+  signals?: ImportedItemSignals | null;
 };

 type FlyerParseResponse = {
@@ -129,56 +130,59 @@ export class FlyerImportService {
        offerText: item.offerText,
      });

-      const match = this.matchItem(item, signalData.normalizedMatchName, signalData.signals, products, aliasToProduct, productById);
-      const signals = this.extractOfferSignals(item.offerText);
-      const price = item.price ?? signals.price;
-      const priceUnit = this.normalizeUnit(item.priceUnit) ?? signals.priceUnit;
-      const comparisonPrice = item.comparisonPrice ?? signals.comparisonPrice;
-      const comparisonUnit = this.normalizeUnit(item.comparisonUnit) ?? signals.comparisonUnit;
-      const offerLimitText = this.extractOfferLimitText(item.offerText);
-      const displayNameDetailed = buildDisplayNameDetailed({
-        rawName: item.rawName,
-        isBundle: item.isBundle,
-        bundleItems: this.sanitizeBundleItems(item.bundleItems),
-      });
-      const categoryId = this.categoryResolver.resolveForFlyer({
-        categories,
-        signalText: [item.rawName, item.brand ?? '', item.offerText ?? ''].join(' ').trim(),
-        categoryHint: item.category,
-        matchedProductCategoryId: match.product?.categoryId ?? null,
-        matchConfidence: match.confidence,
-      });
-
-      return {
-        flyerItemId: null,
-        rawName: item.rawName,
-        normalizedName: signalData.normalizedMatchName || item.normalizedName,
-        brand: item.brand,
-        category: item.category,
-        categoryId,
-        price,
-        priceUnit,
-        comparisonPrice,
-        comparisonUnit,
-        weight: item.weight,
-        bundleWeight: item.bundleWeight,
-        isBundle: item.isBundle,
-        bundleItems: this.sanitizeBundleItems(item.bundleItems),
-        displayNameDetailed,
-        signals: signalData.signals,
-        offerText: item.offerText,
-        isOffer: this.isOfferItem(item, signals.hasCampaignPattern),
-        offerLimitText,
-        parseConfidence: item.confidence,
-        parseReasons: item.reasonCodes,
-        parseReasonsDetailed: this.describeParseReasons(item.reasonCodes),
-        matchedProductId: match.product?.id ?? null,
-        matchedProductName: match.product?.name ?? null,
-        matchedVia: match.via,
-        matchConfidence: match.confidence,
-        matchReasons: match.reasons,
-        matchReasonsDetailed: this.describeMatchReasons(match.reasons),
-      };
+       const match = this.matchItem(item, signalData.normalizedMatchName, signalData.signals, products, aliasToProduct, productById);
+       const signals = this.extractOfferSignals(item.offerText);
+       const price = item.price ?? signals.price;
+       const priceUnit = this.normalizeUnit(item.priceUnit) ?? signals.priceUnit;
+       const comparisonPrice = item.comparisonPrice ?? signals.comparisonPrice;
+       const comparisonUnit = this.normalizeUnit(item.comparisonUnit) ?? signals.comparisonUnit;
+       const offerLimitText = this.extractOfferLimitText(item.offerText);
+       const displayNameDetailed = buildDisplayNameDetailed({
+         rawName: item.rawName,
+         isBundle: item.isBundle,
+         bundleItems: this.sanitizeBundleItems(item.bundleItems),
+       });
+       const categoryId = this.categoryResolver.resolveForFlyer({
+         categories,
+         signalText: [item.rawName, item.brand ?? '', item.offerText ?? ''].join(' ').trim(),
+         categoryHint: item.category,
+         matchedProductCategoryId: match.product?.categoryId ?? null,
+         matchConfidence: match.confidence,
+       });
+
+       const origin = item.signals?.originCountries?.[0] || null;
+       const brand = item.brand && item.brand.trim() !== origin ? item.brand : null;
+
+       return {
+         flyerItemId: null,
+         rawName: item.rawName,
+         normalizedName: signalData.normalizedMatchName || item.normalizedName,
+         brand,
+         category: item.category,
+         categoryId,
+         price,
+         priceUnit,
+         comparisonPrice,
+         comparisonUnit,
+         weight: item.weight,
+         bundleWeight: item.bundleWeight,
+         isBundle: item.isBundle,
+         bundleItems: this.sanitizeBundleItems(item.bundleItems),
+         displayNameDetailed,
+         signals: signalData.signals,
+         offerText: item.offerText,
+         isOffer: this.isOfferItem(item, signals.hasCampaignPattern),
+         offerLimitText,
+         parseConfidence: item.confidence,
+         parseReasons: item.reasonCodes,
+         parseReasonsDetailed: this.describeParseReasons(item.reasonCodes),
+         matchedProductId: match.product?.id ?? null,
+         matchedProductName: match.product?.name ?? null,
+         matchedVia: match.via,
+         matchConfidence: match.confidence,
+         matchReasons: match.reasons,
+         matchReasonsDetailed: this.describeMatchReasons(match.reasons),
+       };
    });

    this.logImportMetrics(items);
@@ -716,24 +720,25 @@ export class FlyerImportService {
      // 3. Normalisera resultatet
      const normalizedItems = this.normalizer.normalize(aiParseResult.items);

-      // 4. Konvertera till intern FlyerParseItem-format
-      const items: FlyerParseItem[] = normalizedItems.map((item) => ({
-        rawName: item.rawName,
-        normalizedName: item.normalizedName,
-        brand: item.brand,
-        category: item.categoryHint,
-        price: item.price,
-        priceUnit: item.priceUnit,
-        comparisonPrice: item.comparisonPrice,
-        comparisonUnit: item.comparisonUnit,
-        weight: item.weight,
-        bundleWeight: item.bundleWeight,
-        isBundle: item.isBundle,
-        bundleItems: item.bundleItems,
-        offerText: item.offerText,
-        confidence: item.parseConfidence,
-        reasonCodes: item.parseReasons,
-      }));
+       // 4. Konvertera till intern FlyerParseItem-format
+       const items: FlyerParseItem[] = normalizedItems.map((item) => ({
+         rawName: item.rawName,
+         normalizedName: item.normalizedName,
+         brand: item.brand,
+         category: item.categoryHint,
+         price: item.price,
+         priceUnit: item.priceUnit,
+         comparisonPrice: item.comparisonPrice,
+         comparisonUnit: item.comparisonUnit,
+         weight: item.weight,
+         bundleWeight: item.bundleWeight,
+         isBundle: item.isBundle,
+         bundleItems: item.bundleItems,
+         offerText: item.offerText,
+         confidence: item.parseConfidence,
+         reasonCodes: item.parseReasons,
+         signals: null,
+       }));

      const warnings: string[] = [];
      if (items.length === 0) {