E-Ticaret İçin AI Agent — 6 kritik iş, uçtan uca

Sen bir e-ticaret işletmesi için 'AI ürün içerik fabrikası' kuran bir geliştiricisin.

Hedef: /src/ecommerce/productContent/ klasörü.

Bileşenler:
1. /src/ecommerce/productContent/types.ts — Zod şemaları:
   - ProductAttributes (name, brand, category, attributes Record, price, currency)
   - GeneratedContent (title, metaDescription, shortDesc, longDesc, bullets[],
     crossSellCopy, altText, social: { instagram, tiktok }, translations: Record<lang, ...>)

2. /src/ecommerce/productContent/generator.ts — generateContent(attrs, languages)
   - Anthropic Claude Sonnet çağrısı, system prompt'ta marka sesi (brandVoice.md'den).
   - Structured output: yukarıdaki GeneratedContent şeması.
   - Languages parametre olarak: ['tr', 'en', 'de'] gibi.

3. /src/ecommerce/productContent/shopify.ts
   - listenWebhook(): Shopify 'products/create' ve 'products/update' webhook'larını yakalar
   - fetchProductAttrs(productId)
   - updateProductContent(productId, content) — Storefront API'ye yazar
   - HMAC signature doğrulaması (Shopify-Hmac-Sha256 header)

4. /src/ecommerce/productContent/reviewQueue.ts
   - Postgres 'content_review_queue' tablosu: id, product_id, generated_content,
     status ('pending'|'approved'|'rejected'), created_at, reviewer
   - Web UI (/admin/content-review): pending listesi + yan yana karşılaştırma
     (mevcut vs üretilen) + Approve/Edit/Reject butonları
   - Approve → Shopify API'ye PATCH

Kategori bazlı şablonlar: /src/ecommerce/productContent/templates/
  - cosmetics.md, electronics.md, textile.md
  - Her birinde o kategorinin tonal kuralları, kullanılması gereken keywordler

5. Maliyet kontrolü:
   - Her ürün için max bir kez üret (idempotency: product_id + content_hash)
   - Günlük budget cap (env var). Aşılınca review queue'ya 'budget_exceeded' işaretle.

Önce planı göster.

Sen bir e-ticaret işletmesi için multi-channel destek bot kuran bir geliştiricisin.

Hedef: /src/ecommerce/support/ klasörü.

Bileşenler:
1. /src/ecommerce/support/agent.ts
   - customerSupportAgent({ message, channel, userId, attachments })
   - System prompt brandVoice.md + supportRules.md birleşimi
   - Memory: Postgres session_id = channel:external_id (örn. 'whatsapp:905XX')
   - Vector retrieve: top_k=5 from product_kb (ürün spec) + policy_kb (iade kuralları)

2. /src/ecommerce/support/tools/
   - getOrderStatus.ts — Shopify GraphQL ile sipariş durumu + kargo no
   - startReturn.ts — Shopify Returns API ile iade başlat (politikaya göre)
   - searchKnowledge.ts — pgvector hybrid search
   - escalateToHuman.ts — Slack 'support-escalations' kanalına post

3. /src/ecommerce/support/channels/
   - whatsapp.ts — Meta Cloud API, 24-saat penceresi, template message support
   - instagram.ts — Meta Graph API IG Messenger
   - webWidget.ts — Express endpoint + JS widget script
   - hepsi: HMAC verify + rate limit (IP + session bazlı)

4. /src/ecommerce/support/ingestion.ts
   - Shopify product feed'i nightly cron ile pgvector'a indeksle
   - /policy klasöründeki iade/kargo dökümanları markdown'dan chunk + embed

5. /src/ecommerce/support/monitoring.ts
   - Her etkileşim: { session_id, channel, intent, tool_called, resolved, escalated, latency_ms, tokens }
   - Postgres 'support_events' tablosuna yaz
   - Haftalık Slack raporu: çözüm oranı, ortalama gecikme, top intent, eskalasyon nedenleri

Önce plan.

Sen bir e-ticaret marka için 'görsel üretim agent'i kuran bir geliştiricisin.

Hedef: /src/ecommerce/visuals/ klasörü.

Bileşenler:
1. /src/ecommerce/visuals/promptBuilder.ts
   - Input: { productAttrs, sceneType, format, brandStyle }
   - Şablonlar/sahne tipleri: 'studio', 'lifestyle-home', 'outdoor', 'flat-lay'
   - Format presets: instagram-square, instagram-portrait, story-vertical, banner-horizontal
   - Output: provider-spesifik prompt (Midjourney prompt args + Flux negative prompts)

2. /src/ecommerce/visuals/providers/
   - midjourney.ts — Discord botu üzerinden generation
   - flux.ts — Replicate veya Together AI API
   - dalle.ts — OpenAI Images API
   - runway.ts — video varyantları için
   - Her birinin generate(prompt, n_variants) interface'i

3. /src/ecommerce/visuals/pipeline.ts
   - generateBatch(product, sceneTypes[], formats[]) — paralel olarak tüm kombinasyonları üret
   - Maliyet kontrol: günlük budget cap (env var)
   - Output: Google Drive 'visuals/<sku>/<date>/' klasörüne kaydet
   - Her görsel için metadata: prompt, model, seed (varsa), generated_at

4. /src/ecommerce/visuals/approval.ts
   - Slack'e Block Kit ile yan yana 4 görsel + 'Approve/Reject/Regenerate' butonları
   - Approve → 'approved/' subfolder + Shopify'a auto-attach OR Meta Ads Library'e yükle
   - Regenerate → yeni seed ile tekrar üret

5. /src/ecommerce/visuals/abTest.ts
   - Bir kampanya için 5 varyant üret, Meta Ads API ile 5'ini de ad set olarak yükle
   - 48 saat sonra CTR/CPM/CPA topla, en iyi performansı işaretle

Önce plan.

Sen bir e-ticaret markası için 'sepet kurtarma agent sistemi' kuran bir geliştiricisin.

Hedef: /src/ecommerce/recovery/ klasörü.

Bileşenler:
1. /src/ecommerce/recovery/sessionTracker.ts
   - Shopify 'checkouts/create' ve 'checkouts/update' webhook'ları yakala
   - 'checkout_completed' webhook'unu yakaladığında session'ı 'recovered' işaretle
   - Eğer 1 saat içinde completed olmazsa 'abandoned' işaretle, recovery pipeline'ı tetikle

2. /src/ecommerce/recovery/customerEnrichment.ts
   - Müşteri profili çek (Shopify customer + previous_orders + tier)
   - Sepetteki ürünlerin özelliklerini çek
   - Bağlam objesi oluştur: { customer, cart, brand_voice, kupon_yetki }

3. /src/ecommerce/recovery/copywriter.ts
   - Claude Sonnet ile structured output: 3 e-posta + 1 WhatsApp + 1 IG DM
   - Her biri için: subject, preview_text, html, plain_text, suggested_send_time
   - Marka sesi (brandVoice.md) + müşteri tier (sadık vs yeni) + sepet tutarı (kupon eşiği)

4. /src/ecommerce/recovery/scheduler.ts
   - 1 saat: e-posta 1 + IG DM (if user follows brand)
   - 24 saat: e-posta 2 + WhatsApp template message
   - 72 saat: e-posta 3 + %10 kupon (if customer tier allows)
   - Her aşamada: 'recovered?' kontrol — recovered ise serinin geri kalanını iptal

5. /src/ecommerce/recovery/retargeting.ts
   - 4 saat sonra customer audience'ı Meta Ads Custom Audience'a push et
   - Sepetteki ürünün görselleriyle (Görsel Üretimi modülü) dynamic ad oluştur
   - 7 gün sonra audience'tan çıkar (gizlilik)

6. /src/ecommerce/recovery/analytics.ts
   - Her recovery için: opens, clicks, recovered (true/false), revenue
   - Haftalık rapor: kampanya başına ROI, en iyi şablon, en iyi gönderim saati

Önce plan.

Sen bir e-ticaret markası için 'rakip fiyat izleme + dinamik fiyat öneri sistemi' kuran bir geliştiricisin.

Hedef: /src/ecommerce/pricing/ klasörü.

Bileşenler:
1. /src/ecommerce/pricing/competitors.config.ts
   - Liste: { name, domain, sitemap_url, scraping_strategy: 'shopify-json'|'html'|'apify-actor' }
   - 50 rakibin meta bilgisi

2. /src/ecommerce/pricing/scraper.ts
   - Schedule 4x/gün: her rakibin sitemap'ından product URL'lerini çek
   - Strategy'e göre: Shopify json endpoint, HTML parsing veya Apify actor
   - Output: { competitor, sku_seen, url, title, price, currency, in_stock, scraped_at }

3. /src/ecommerce/pricing/skuMatcher.ts
   - Bizim SKU + rakip SKU eşleştirme
   - Strategy 1: Barcode/MPN (varsa exact match)
   - Strategy 2: Title embedding + price band + brand match
   - Confidence skoru (0-1); < 0.7 ise manuel review queue

4. /src/ecommerce/pricing/storage.ts
   - Postgres + TimescaleDB hypertable 'price_history':
     time, our_sku, competitor, competitor_sku, price, currency, in_stock
   - Aggregation queries: avg/min/max per day/week, % change

5. /src/ecommerce/pricing/alerts.ts
   - Kural: bizim fiyatımız max rakip fiyatından %15+ yüksek → kritik alert
   - Kural: rakip 24 saat içinde %20+ düşürdü → bilgi alert
   - Kural: stok-out detected on bizim ürün + rakipte var → fırsat alert
   - Slack #pricing kanalına Block Kit ile mesaj

6. /src/ecommerce/pricing/analyst.ts
   - Haftalık Schedule: son 7 gün data'yı Claude Sonnet'e ver
   - Structured output: top 10 SKU için durum + aksiyon önerisi + risk
   - PDF rapor: pdfkit, Drive'a yükle, Slack'e link

ÖNEMLİ: Otomatik fiyat değişikliği YAPMA. Sadece öneri üret, insan onayı sonrası Shopify API ile uygula.

Önce plan.

Sen bir e-ticaret markası için 'talep tahmin + stok planlama' motoru kuran bir geliştiricisin.

Hedef: /src/ecommerce/inventory/ klasörü.

Bileşenler:
1. /scripts/forecast.py (Python)
   - Shopify orders tablosundan son 24 ay (sku, day, qty)
   - Her aktif SKU için Facebook Prophet model
   - Mevsimsellik bileşenleri: weekly, yearly, holidays (TR holidays + e-com özel: black-friday, mother's-day, sevgililer)
   - Output: /tmp/forecast.json: { sku, monthly: [{ month, yhat, yhat_lower, yhat_upper }] }

2. /src/ecommerce/inventory/forecast.ts (TypeScript)
   - Python script'i child_process ile çalıştır
   - forecast.json'u Claude Sonnet'e ek context'le ver: { campaigns_next_12mo,
     supplier_lead_times, new_b2b_pipeline, holiday_calendar }
   - Structured output:
     {
       sku_recommendations: [{
         sku, monthly_forecast, order_calendar: [{ month, order_qty, place_order_by, reasoning }],
         supplier_alerts: string[], risks: string[]
       }],
       executive_summary, top_actions: string[5]
     }

3. /src/ecommerce/inventory/storage.ts
   - Postgres 'forecasts' tablosu: snapshot her hafta — geçmişle karşılaştırma için
   - 'reorder_calendar' tablosu: planlanan siparişler

4. /src/ecommerce/inventory/reordering.ts
   - Bir reorder time geldiğinde Slack #procurement'a uyarı + Notion'da sipariş kartı
   - Tedarikçi kapasite uyarı taslağı (önceki Satın Alma sayfasındaki şablonu kullan)
   - Onay sonrası Procurement modülüne (Satın Alma için AI sayfasında anlatılan) bağla

5. /src/ecommerce/inventory/cold-start.ts
   - Yeni eklenen SKU'lar için geçmiş veri yok
   - Strategy: en benzer 5 SKU'yu (embedding + kategori) bul, onların ilk 90 gün satışını ortalama → yeni SKU'nun başlangıç tahmini

6. /src/ecommerce/inventory/dashboard.tsx (Next.js)
   - Her SKU için: mevcut stok, son 30 gün satış, 30 gün tahmin, reorder point, gün sayısı
   - Renk kodu: yeşil ≥ 60 gün, sarı 30-60, kırmızı < 30 (= acil)

Önce plan.