E-ticaret sayfalarındaki ani satın alma dürtüsünü kesmek için CubeZero, deterministik Python çekirdeği (ölçülebilir fiyat, bütçe matematiği, veto) ile olasılıksal LLM katmanını (yapılandırılmış Türkçe gerekçe) ardışık konumlandırır: önce matematik ve veri doğruluğu, sonra dil.

Sistem omurgası: çok stratejili web scraping ile gerçek fiyat → kod içi budget hard block → sabit parametreli opportunity-cost projeksiyonu → Groq LPU üzerinde tek atımlık Llama 3.3 · 70B JSON verdict (AL / BEKLE / ALMA).

Sistemin teknolojik altyapısını ve otonom iş akışını özetleyen, Supabase Auth ile entegre modern arayüz mimarisi.

Kullanıcı e-ticaret URL'sini girdikten sonra multi-strategy scraping katmanının ve deterministik hesaplama motorunun arka planda çalıştığı anlık durum takibi.

Bütçe limitini aşan ürünler için Python çekirdeğinin uyguladığı tavizsiz veto kararı ve sağ panelde Llama 3.3 tarafından üretilen rasyonel/Türkçe finansal gerekçe.

• Groq LPU (Ultra-Low Latency Inference): Düşük gecikmeli çıkarım ile analiz süresini hackathon/demo ve günlük kullanım için saniyeler bandına yaklaştırır; kritik zaman diliminde “şimdi al” dürtüsüne müdahale etmek için hız doğrudan ürün sinyali olur.

• Llama 3.3 · 70B (State-of-the-Art LLM): Deterministik metrikleri üç maddelik, tutarlı JSON rationale ile birleştirerek jüri ve kullanıcıya okunabilir finansal gerekçe üretir; model yalnızca güvenlik sınırları çizilmiş veri üzerinde konuşur.

• 4-Phase Deterministic Agentic Workflow: Fazlar A–C tamamen kodda ölçülür; faz D’ye gelindiğinde “önce kural ve sayı, sonra dil**” ilkesi bozulmaz — dil katmanı bütçe aşımında Hard Block ile ALMA’ya zorunlu eşiklenmiştir.

1. 01 | Algıla (Perceive): Multi-strategy web scraping & fail-closed price extraction (Amazon TR, Trendyol, Hepsiburada) — doğrulanamayan fiyat için sessiz 0 TL yerine hata.

2. 02 | Muhakeme (Reason): Python tabanlı deterministik bütçe optimizasyonu. Limit aşımında tavizsiz Hard Block (Veto): fiyatı bütçe üzerindeyse çıktı politikası ALMA.

3. 03 | Strateji Geliştir (Strategize): Sabit fırsat maliyeti simülasyonu ve finansal kalkan projeksiyonu (referans ~%1.8 aylık — kod sabiti); kullanıcıya harcamanın alternatif zaman çizgisini rakamsal gösterir.

4. 04 | Hüküm Ver (Verdict): Güvenlik sınırları altında response_format: json_object ile yapılandırılmış çıktı ve rasyonel karar (AL / BEKLE / ALMA); LLM çıktısı kural bozarsa Python katmanı düzeltir.

Monorepo kök dizininden; iki ayrı terminal kullanın (backend + frontend).

# Backend bağımlılıkları (Python 3.11+ önerilir)
cd backend
python -m venv .venv
# Windows: .venv\Scripts\activate  |  macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt

# Frontend bağımlılıkları (Node.js 18+)
cd ../frontend
npm install

Çevre değişkenleri: backend/.env ve frontend/.env.local dosyalarını oluşturun.

# backend/.env
GROQ_API_KEY=your_key
GROQ_MODEL=llama-3.3-70b-versatile
SUPABASE_URL=https://xxxxx.supabase.co
SUPABASE_JWT_SECRET=your_jwt_secret
CORS_ORIGINS=http://localhost:3000

# frontend/.env.local
NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
NEXT_PUBLIC_API_URL=http://localhost:8000

# Terminal 1 — API
cd backend
uvicorn main:app --reload --port 8000

# Terminal 2 — UI
cd frontend
npm run dev

Uygulama: http://localhost:3000 · API: http://localhost:8000 · Swagger: /docs.

• POST /analyze — Authorization: Bearer <Supabase JWT>, gövde: url, monthly_limit_try.
• GET /health — auth yok.

• Kart / banka bağlantısı yok.
• DEBUG_BYPASS_AUTH=1 yalnızca yerel geliştirme için; üretimde kapatın.

MIT — ayrıntılar için LICENSE.