================================================================================
BEDESTEN KİTAP ~ KAFE | TAM PROJE YEDEĞİ VE ÇALIŞTIRMA KILAVUZU
================================================================================
Tarih       : 31 Ekim 2026
Alan Adları : bedestenkitapkafe.com / bedestenkitapkafe.com.tr
Sunucu      : Veridyen Python Hosting (metis.veridyen.com - 185.149.101.6)
E-Posta     : erginyurekyunus@gmail.com
================================================================================

1. NEYİ NASIL YAPTIK?
--------------------------------------------------------------------------------
- TASARIM MİMARİSİ: Boston Drink & Dessert (bostondd.com) tarzı yüksek enerjili,
  koyu kontrastlı vitrin tasarımı, Bedesten Kitap ~ Kafe logonuzun orijinal PDF
  vektör renkleriyle (#9A1B12 Bordo, #46120B Koyu Kahve, #BA8558 Karamel,
  #D8BFAA Krem) harmanlanarak sıfırdan kodlandı.
- VEKTÖR LOGO ÇIKARIMI: bedesten_logosu.pdf içindeki vektör çizimler kayıpsız
  olarak static/img/logo.svg, logo-dark.svg ve logo-icon.svg dosyalarına
  dönüştürüldü.
- ONSO CLOUD ENTEGRASYONU: Onso Cloud hesabınızdaki (api.onsocloud.com) 1.214
  stok kalemi taranarak aktif 12 kafe kategorisi, 191 kafe ürünü (gerçek ürün
  fotoğrafları ve güncel fiyatları ile) ve 8 seçkin kitap data/menu.json
  veritabanına aktarıldı.
- HİBRİT POS & VİTRİN SUNUCU YAPISI: Veridyen Python sunucunuzdaki mevcut
  Bedesten POS / AdisyonPro (FastAPI + SQLite bedesten.db) sisteminiz hiç
  bozulmadan korundu. Ana sayfada (/) yeni vitrin ve dijital QR menü açılırken,
  /pos adresinde mevcut POS sisteminiz çalışmaya devam etmektedir.
- GÜNLÜK E-POSTA YEDEKLEME: backup_mailer.py betiği ile tüm proje kodları,
  menu.json ve POS veritabanı her gün otomatik olarak ZIP formatında
  erginyurekyunus@gmail.com adresine gönderilecek şekilde yapılandırıldı.

2. HANGİ PLATFORMLARDA ÇALIŞABİLİR?
--------------------------------------------------------------------------------
Bu paket 4 farklı ortamda doğrudan çalışacak şekilde hazırlanmıştır:

A) cPanel / CloudLinux Python Hosting (Veridyen vb. - Şu An Aktif):
   - Python 3.9 - 3.12 Passenger WSGI destekli tüm hostinglerde çalışır.
   - Ana dizindeki passenger_wsgi.py veya veridyen_server_entegrasyon/ içindeki
     server_main.py ile doğrudan yayınlanır.

B) Linux VPS / Bulut Sunucu (Ubuntu, Debian, AWS, DigitalOcean, Hetzner):
   - "pip install -r requirements.txt" ve "gunicorn app:app" veya
     "uvicorn app.main:app" komutuyla tüm Linux sunucularda çalışır.

C) Windows Masaüstü / Windows Server:
   - Python kuruluysa "python app.py" komutuyla http://localhost:5000 üzerinden,
   - Python kurulu değilse doğrudan "index.html" dosyasına çift tıklayarak
     (offline/yerel modda) tüm tarayıcılarda çalışır.

D) Standart PHP / Statik HTML Hosting & CDN (Netlify, Vercel, Cloudflare Pages):
   - "index.html" ve "static/" klasörü önceden derlenmiş (pre-rendered) olduğu
     için Python desteği olmayan herhangi bir standart hostingde de %100
     sorunsuz çalışır.

Detaylı teknik rehber için "KURULUM_VE_MIMARI_REHBERI.md" dosyasını inceleyiniz.
================================================================================
