feat(mimari): ANLAMA LLM'DE, HESAP KODDA — yapilandirilmis stok sorgusu

Kullanicinin tezi dogrulandi: her Turkce cekim icin kural yazmak surdurulemez.
Stopword listesi 100 kelimeyi asti; 'elektrikli' kurali varken 'Elektrik
Bisiklet' bir harf farkiyla deldi, bot Verve 3'u yine elektrikli diye satti.

YENI AKIS:
musteri mesaji -> intent analyzer (gpt-4o-mini, ZATEN her mesajda calisiyor)
-> yapilandirilmis sorgu {urun, kategori, beden, renk, magaza, fiyat_max,
siralama, adet_sorusu, malzeme, onceki_urun}
-> lookup_stock_structured(): KOD deterministik calistirir (filtre/sayma/
siralama — olcum: sayma sorusunda Luna=19, Terra=19, kod=25 DOGRU)
-> ayni hukum/seal formatiyla doner.

- 'sarjli/akulu/pilli/elektrik' icin kural GEREKMEZ — model normalize eder.
- 'urun' alani SADECE mevcut mesajtan (onceki sohbetten Madone tasima
zehirlenmesi bitti); takip sorusu 'onceki_urun: true' ile ayri.
- Eski metin ayristirici FALLBACK olarak durur -> regresyon 65/65 yesil.
- Ek maliyet ~SIFIR: analyzer zaten calisiyordu, sema genisledi.
- /debug-intent endpoint'i: soru -> LLM anlama -> kod hesap zinciri testi.

Ilk denemede yakalanan bug da duzeltildi: siralama stok kontrolunden ONCE
ilk 5'i kesiyordu, en ucuz katalog kayitlari stoksuz cikinca bos donuyordu.

app.py

@@ -1523,7 +1523,30 @@ def process_whatsapp_message_with_memory(user_message, phone_number):
 
         # Stok bilgisi ekle - detected_product kullan
         # ONCELIK: XML sonucu (smart_warehouse_with_price.py) daha guvenilir
-        warehouse_info = get_warehouse_stock(stock_query_product)
+        # YAPILANDIRILMIS SORGU — ANLAMA LLM'DE, HESAP KODDA (11 Agu gece).
+        # Intent analyzer serbest Turkce'yi yapiya cevirir ({kategori:
+        # elektrikli, siralama: ucuz...}), kod deterministik calistirir.
+        # 'Elektrik/sarjli/akulu' icin kural GEREKMEZ — model Turkce'yi bilir.
+        # Eski metin ayristirici FALLBACK olarak durur.
+        warehouse_info = None
+        _struct = intent_analysis.get("stok_sorgusu") if isinstance(intent_analysis, dict) else None
+        if isinstance(_struct, dict) and any(v for v in _struct.values()):
+            if _struct.get("onceki_urun") and not _struct.get("urun"):
+                _prev_p = get_conversation_context(phone_number).get("current_product")
+                if _prev_p:
+                    _struct["urun"] = _prev_p
+            try:
+                from warehouse_lookup import lookup_stock_structured
+                warehouse_info = lookup_stock_structured(_struct)
+                if warehouse_info:
+                    logger.info(f"🎯 [wh_struct] HIT: {_struct}")
+                else:
+                    logger.info(f"[wh_struct] None, metin yoluna dusuluyor: {_struct}")
+            except Exception as e:
+                logger.warning(f"[wh_struct] hata, metin yolu devrede: {e}")
+
+        if not warehouse_info:
+            warehouse_info = get_warehouse_stock(stock_query_product)
         # TAKIP SORUSU DESTEGI (11 Agu): "medium ne var" gibi urunsuz sorgular
         # tek basina eslesmez; sohbet baglamindaki son urunle birlestirip dene.
         # ("small elektrikli bisiklet" -> "medium ne var" => "medium elektrikli bisiklet")
@@ -1621,12 +1644,13 @@ def process_whatsapp_message_with_memory(user_message, phone_number):
         # arama adinda 'karbon' gecen AKSESUARLARI buluyor ve kompakt stok
         # listesi hic gonderilmiyordu -> bot 'stokta karbon bisiklet yok'
         # dedi (11 Agu). Malzeme sorusunda o yolu ATLA, dogrudan listeye git.
-        _is_material_q = False
-        try:
-            from warehouse_lookup import _detect_material
-            _is_material_q = _detect_material(user_message) is not None
-        except Exception:
-            pass
+        _is_material_q = bool(isinstance(_struct, dict) and _struct.get("malzeme"))
+        if not _is_material_q:
+            try:
+                from warehouse_lookup import _detect_material
+                _is_material_q = _detect_material(user_message) is not None
+            except Exception:
+                pass
 
         if should_query_stock and stock_query_product and not xml_has_valid_stock:
             realtime_stock = None if _is_material_q else get_realtime_stock_parallel(stock_query_product)
@@ -2085,6 +2109,29 @@ async def debug_flow(q: str):
     })
 
 
+@app.get("/debug-intent")
+async def debug_intent(q: str):
+    """UCTAN UCA yapilandirilmis sorgu testi:
+    soru -> intent analyzer (LLM anlama) -> lookup_stock_structured (kod hesap).
+    'Elektrik Bisiklet' gibi kural-disi ifadelerin cozuldugunu dogrulamak icin."""
+    import asyncio as _a
+    from intent_analyzer import analyze_customer_intent
+    from warehouse_lookup import lookup_stock_structured
+
+    analysis = await _a.to_thread(analyze_customer_intent, q, None)
+    struct = analysis.get("stok_sorgusu") if isinstance(analysis, dict) else None
+    result = None
+    if isinstance(struct, dict) and any(v for v in struct.values()):
+        result = await _a.to_thread(lookup_stock_structured, struct)
+    return JSONResponse({
+        "soru": q,
+        "1_llm_anlama": struct,
+        "2_kod_hesap": {"hit": result is not None,
+                        "hukum": (result[0][:160] if result else None),
+                        "satirlar": (result[1:12] if result else None)},
+    })
+
+
 @app.get("/model-compare")
 async def model_compare(q: str, models: str = "gpt-5.6-luna,gpt-5.6-terra"):
     """LUNA vs TERRA — ayni soru, ayni baglam, farkli model.

intent_analyzer.py

@@ -88,8 +88,46 @@ JSON FORMATI:
     "customer_mood": "positive",
     "suggested_action": "notify_store",  // notify_store, answer_directly, both, none
     "notification_required": true,
-    "notification_reason": "Müşteri FX 2'yi ayırtmak istiyor"
-}"""
+    "notification_reason": "Müşteri FX 2'yi ayırtmak istiyor",
+    "stok_sorgusu": { ... }  // Aşağıya bak — stok/fiyat sorusuysa DOLDUR, değilse null
+}
+
+STOK_SORGUSU (EN ÖNEMLİ ALAN — stok/fiyat/model sorularında doldur):
+Müşterinin serbest cümlesini şu YAPIYA çevir. Sistem bu yapıyı deterministik
+çalıştırır; senin görevin Türkçe'yi ANLAYIP normalize etmek:
+{
+    "urun": "marlin 4",      // SADECE BU MESAJTA geçen model adı. Önceki
+                             // konuşmadaki ürünü BURAYA YAZMA! Kategori
+                             // sorusunda ("elektrikli bisikletler") null bırak.
+    "onceki_urun": false,    // "bunun başka rengi", "medium'u var mı" gibi
+                             // önceki ürüne atıf varsa true
+    "kategori": null,        // elektrikli|sehir|dag|yol|gravel|cocuk|giyim|kask|lastik|pompa
+                             // NORMALIZE ET: "elektrik/şarjlı/akülü/pilli/e-bike" → elektrikli
+                             // "MTB/dağ/arazi" → dag, "hibrit/city" → sehir
+    "beden": null,           // XXS|XS|S|M|ML|L|XL|XXL veya 47-62 kadro ölçüsü
+                             // "small→S, medium→M, large→L, küçük→S, orta→M"
+    "renk": null,            // "su yeşili", "mat siyah", "kırmızı"...
+    "magaza": null,          // caddebostan|alsancak|bahcekoy
+                             // "Kadıköy→caddebostan, İzmir→alsancak, Sarıyer→bahcekoy"
+    "fiyat_max": null,       // "100 bin altında/bütçem 150 bin" → 100000/150000
+    "fiyat_min": null,       // "300 bin üstü" → 300000
+    "siralama": null,        // "en ucuz/uygun/ekonomik" → ucuz, "en pahalı/iyi" → pahali
+    "adet_sorusu": false,    // "kaç tane/kaç adet var" → true
+    "malzeme": null          // "karbon" | "aluminyum" (kadro malzemesi sorusuysa)
+}
+
+STOK_SORGUSU ÖRNEKLERİ:
+- "Elektrik Bisiklet modellerini soruyorum" → {"kategori": "elektrikli"}
+- "şarjlı bisiklet var mı" → {"kategori": "elektrikli"}
+- "En ucuz elektrikli bisiklet modeli hangisi" → {"kategori": "elektrikli", "siralama": "ucuz"}
+- "su yeşili xs marlin hangi mağazada" → {"urun": "marlin", "beden": "XS", "renk": "su yeşili"}
+- "caddebostanda kaç tane marlin var" → {"urun": "marlin", "magaza": "caddebostan", "adet_sorusu": true}
+- "100 bin altında dağ bisikleti" → {"kategori": "dag", "fiyat_max": 100000}
+- "oğlum için 80 bin bütçeyle mtb arıyoruz" → {"kategori": "dag", "fiyat_max": 80000}
+- "madone kaç para" → {"urun": "madone"}
+- "bunun mavisi var mı" → {"onceki_urun": true, "renk": "mavi"}
+- "karbonda hangi modeller var" → {"malzeme": "karbon"}
+- "merhaba nasılsınız" → stok_sorgusu: null"""
 
     # Bağlam varsa ekle
     context_info = ""

warehouse_lookup.py

@@ -578,6 +578,232 @@ def _detect_material(query: str) -> str | None:
     return None
 
 
+# ---------- YAPILANDIRILMIS SORGU (11 Agu gece mimari degisikligi) ----------
+# ANLAMA LLM'DE, HESAP KODDA. Eski yol: kod, Turkce'yi stopword/regex'le
+# ayristirmaya calisiyordu — her cekim icin kural gerekiyordu ('elektrikli'
+# kurali vardi, 'Elektrik Bisiklet' bir harf farkiyla deldi; kullanici hakli:
+# binlerce kural yazilamaz). Yeni yol: intent analyzer (LLM, zaten her
+# mesajda calisiyor) serbest metni SU YAPIYA cevirir, kod calistirir:
+#   {urun, kategori, beden, renk, magaza, fiyat_max, fiyat_min,
+#    siralama, adet_sorusu, malzeme, onceki_urun}
+# Boylece 'sarjli bisiklet', 'akulu', 'pilli' icin kural GEREKMEZ — model
+# Turkce'yi zaten biliyor. Sayma/filtreleme/siralama kodda kalir (olcum:
+# Luna ve Terra 19 dedi, kod 25 — dogru).
+
+_STRUCT_CATEGORY_MAP = {
+    "elektrikli": "ELEKTRİKLİ", "sehir": "ŞEHİR/HİBRİT", "hibrit": "ŞEHİR/HİBRİT",
+    "dag": "DAĞ", "yol": "YOL", "gravel": "GRAVEL", "cocuk": "ÇOCUK",
+    "giyim": "GİYİM", "lastik": "LASTİK", "kask": "KASK", "pompa": "POMPA",
+}
+
+
+def _rule_for_label(label: str):
+    for lb, _qw, cat_pat, name_pat in _CATEGORY_RULES:
+        if lb == label:
+            return cat_pat, name_pat
+    return None, None
+
+
+def lookup_stock_structured(p: dict) -> list[str] | None:
+    """Intent analyzer'in cikardigi yapilandirilmis sorguyu calistirir.
+    Donus: lookup_stock_for_query ile ayni format (hukumlu satir listesi).
+    None = bu sorgu stokla cozulemez -> cagiran taraf eski yola/listeye duser."""
+    if not isinstance(p, dict):
+        return None
+
+    urun = (p.get("urun") or "").strip()
+    kategori_raw = normalize((p.get("kategori") or "").strip())
+    beden = (p.get("beden") or "").strip().upper() or None
+    renk = normalize((p.get("renk") or "").strip()) or None
+    magaza = (p.get("magaza") or "").strip().upper() or None
+    if magaza:
+        magaza = normalize(magaza).upper().replace("İ", "I")
+        magaza = {"CADDEBOSTAN": "CADDEBOSTAN", "ALSANCAK": "ALSANCAK",
+                  "BAHCEKOY": "BAHCEKOY"}.get(magaza, None)
+    try:
+        fiyat_max = float(p["fiyat_max"]) if p.get("fiyat_max") else None
+        fiyat_min = float(p["fiyat_min"]) if p.get("fiyat_min") else None
+    except (TypeError, ValueError):
+        fiyat_max = fiyat_min = None
+    siralama = (p.get("siralama") or "").strip().lower() or None
+    adet_sorusu = bool(p.get("adet_sorusu"))
+    malzeme = (p.get("malzeme") or "").strip().lower() or None
+
+    # Hicbir kriter yoksa yapacak is yok
+    if not any([urun, kategori_raw, beden, renk, fiyat_max, fiyat_min,
+                siralama, adet_sorusu]):
+        return None
+
+    # Malzeme sorusu -> None: app.py kompakt liste + malzeme talimati gonderir
+    # (A/B olcumu: siniflandirmayi LLM listeden koddan IYI yapiyor)
+    if malzeme and not any([beden, renk, fiyat_max, adet_sorusu]):
+        logger.info("[wh_struct] malzeme sorusu -> kompakt listeye birakildi")
+        return None
+
+    # Rakip marka koruma
+    if urun and set(re.findall(r"[a-z0-9]+", normalize(urun))) & _COMPETITOR_TOKENS:
+        logger.info(f"[wh_struct] rakip marka: {urun!r}")
+        return None
+
+    idx = get_index()
+    sku_map = _get_sku_map()
+    if not sku_map or not idx.ensure():
+        return None
+
+    # --- AILE SECIMI ---
+    label = _STRUCT_CATEGORY_MAP.get(kategori_raw) if kategori_raw else None
+    cat_pat, name_pat = _rule_for_label(label) if label else (None, None)
+    urun_tokens = [t for t in re.findall(r"[a-z0-9]+", normalize(urun))
+                   if t not in ("bisiklet", "bisikleti", "bike", "model", "modeli")] if urun else []
+    bike_search = bool(label and label not in ("GİYİM", "LASTİK", "KASK", "POMPA")) or \
+        any(t in _BIKE_FAMILY_TOKENS for t in urun_tokens)
+
+    family: list[dict] = []
+    for prod in idx.snapshot():
+        if prod["is_variant"]:
+            continue
+        nn = prod.get("_label_norm", "")
+        if not nn:
+            continue
+        if urun_tokens:
+            words = set(re.findall(r"[a-z0-9]+", nn))
+            if not all(t in words for t in urun_tokens):
+                continue
+        if label:
+            cn = prod.get("_category_norm", "")
+            if cn:
+                if cat_pat and not cat_pat.search(cn):
+                    continue
+            elif name_pat and not name_pat.search(nn):
+                continue
+        if bike_search and any(t in nn for t in _ACCESSORY_TOKENS):
+            continue
+        family.append(prod)
+
+    # Kriter var ama urun/kategori yok (sadece renk/beden/fiyat/siralama):
+    # tum bisiklet havuzunda ara
+    if not family and not urun_tokens and not label:
+        family = _all_bikes()
+
+    if not family:
+        if label or urun_tokens:
+            hedef = urun or (label or "")
+            return _seal([f"[STOK HÜKMÜ — KESİN VERİ] '{hedef}' için stokta ürün YOK ❌. "
+                          f"Model/fiyat UYDURMA, müşteriyi mağazaya yönlendir."])
+        return None
+
+    cat_suffix = f" ({label})" if label else ""
+
+    # --- ADET SAYMA ---
+    if adet_sorusu:
+        toplam = 0
+        dagilim: dict[str, int] = {}
+        satirlar: list[str] = []
+        for m in family:
+            link = m.get("link") or ""
+            for v in (idx.variants_of(link) if link else [m]):
+                sku = (v.get("sku") or "").strip()
+                if not sku:
+                    continue
+                for wh, qty in sku_map.get(sku, []):
+                    if magaza and wh.upper() != magaza:
+                        continue
+                    if beden and not _variant_matches_size(v, beden):
+                        continue
+                    if renk and renk not in normalize(_format_variant_label(v)):
+                        continue
+                    toplam += qty
+                    dagilim[wh] = dagilim.get(wh, 0) + qty
+                    satirlar.append(f"• {m['name']} {_format_variant_label(v)} — {wh}: {qty} adet")
+        if toplam:
+            nerede = f"{magaza} mağazasında" if magaza else "tüm mağazalarda"
+            dag = ", ".join(f"{k}: {v}" for k, v in sorted(dagilim.items(), key=lambda x: -x[1]))
+            out = [f"[ADET HÜKMÜ — KESİN VERİ] {nerede} TOPLAM {toplam} ADET var. "
+                   f"Dağılım: {dag}. Bu sayı sistem hesabı — KENDİN SAYMA:"]
+            out.extend(satirlar[:30])
+            return _seal(out)
+        return _seal([f"[ADET HÜKMÜ — KESİN VERİ] {'bu kriterlerle' if not magaza else magaza + ' mağazasında'} "
+                      f"stok YOK (0 adet). Sayı UYDURMA."])
+
+    # --- FIYAT FILTRESI ---
+    if fiyat_min is not None or fiyat_max is not None:
+        family = [m for m in family if m.get("_category_norm") or not label]
+        family = [m for m in family if _price_in_range(m.get("price"), fiyat_min, fiyat_max)]
+        family.sort(key=lambda m: m.get("price") or 0)
+
+    # --- SIRALAMA (en ucuz / en pahali) ---
+    # STOKLU olanlar arasindan sec: fiyat sirali katalog listesinin basi
+    # stoksuz eski modellerle dolu olabiliyor (ilk denemede 'en ucuz
+    # elektrikli' bos donmustu — en ucuz 5 kayit depoda yoktu).
+    if siralama in ("ucuz", "pahali", "cheap", "expensive"):
+        pool = [m for m in family if m.get("price")]
+        if label:
+            cat_ok = [m for m in pool if m.get("_category_norm")]
+            if cat_ok:
+                pool = cat_ok  # kategori dogrulanmis olanlar (aksesuar sizmasin)
+        ucuz = siralama in ("ucuz", "cheap")
+        pool.sort(key=lambda m: m["price"], reverse=not ucuz)
+        picked: list[list[str]] = []
+        for m in pool:
+            lines, found, _ = _stock_lines_for_main(
+                m, sku_map, idx, size=beden, name_suffix=cat_suffix, color=renk)
+            if found:
+                picked.append(lines)
+            if len(picked) >= 3:
+                break
+        if picked:
+            out = [f"[STOK HÜKMÜ — KESİN VERİ] Stoktaki EN "
+                   f"{'UYGUN FİYATLI' if ucuz else 'ÜST SEGMENT'} {kind if (kind := (label + ' ') if label else '') else ''}"
+                   f"modeller ({'ucuzdan' if ucuz else 'pahalıdan'} sıralı). "
+                   f"Fiyat hesabı YAPMA, sırayı DEĞİŞTİRME:"]
+            for s in picked:
+                out.extend(s)
+            return _seal(out)
+        return _seal([f"[STOK HÜKMÜ — KESİN VERİ] Bu kriterlerle stokta fiyatlı ürün "
+                      f"bulunamadı ❌. Fiyat/model UYDURMA, mağazaya yönlendir."])
+
+    # --- SONUC LISTESI ---
+    sections: list[list[str]] = []
+    all_sizes: set[str] = set()
+    for m in family:
+        lines, found, sizes = _stock_lines_for_main(
+            m, sku_map, idx, size=beden, name_suffix=cat_suffix, color=renk)
+        all_sizes |= sizes
+        if found:
+            sections.append(lines)
+        if len(sections) >= 8:
+            break
+
+    kind = f"{label} " if label else ""
+    if sections:
+        parts = []
+        if beden:
+            parts.append(f"{beden} beden")
+        if renk:
+            parts.append(f"'{renk.upper()}' renk")
+        if fiyat_max:
+            parts.append(f"{int(fiyat_max):,} TL altı".replace(",", "."))
+        kriter = " + ".join(parts) if parts else "aranan kriterlerde"
+        out = [f"[STOK HÜKMÜ — KESİN VERİ] {kriter} {kind}ürün STOKTA VAR ✅. "
+               f"Aşağıdakileri eksiksiz aktar, 'stok yok' YAZMA:"]
+        for s in sections:
+            out.extend(s)
+        return _seal(out)
+
+    # Aile var ama filtre bos birakti -> kesin YOK + alternatifler
+    if beden or renk or fiyat_max:
+        sizes_str = ", ".join(sorted(all_sizes)) if all_sizes else "-"
+        out = [f"[STOK HÜKMÜ — KESİN VERİ] Bu kriterlerle STOKTA YOK ❌. "
+               f"Stokta olan bedenler: {sizes_str}. Alternatif sun, UYDURMA:"]
+        for m in family[:5]:
+            lines, found, _ = _stock_lines_for_main(m, sku_map, idx, name_suffix=cat_suffix)
+            if found:
+                out.extend(lines)
+        return _seal(out)
+
+    return None
+
+
 def _seal(lines: list[str]) -> list[str]:
     """Hukum listesini KAPAT: modele 'listede olmayani ekleme' de.