# QRMENU Kurulum Rehberi

## 1. Desteklenen Kurulum Tipleri

- localhost veya demo kurulumu
- subdomain kurulumu
- ana domain kurulumu
- Plesk
- cPanel
- klasik PHP hosting
- VPS veya özel sunucu

## 2. Gereksinimler

- PHP 8.x
- MySQL veya MariaDB
- Apache veya Nginx
- `mod_rewrite` veya eşdeğer URL rewrite desteği
- yazılabilir yükleme klasörleri
- HTTPS veya SSL önerilir

## 3. Kurulum Öncesi Hazırlık

Kurulum sırasında şu bilgiler hazır olmalıdır:

- site adresi
- admin kullanıcı adı
- admin şifresi
- veritabanı host
- veritabanı adı
- veritabanı kullanıcı adı
- veritabanı şifresi
- varsayılan dil
- varsayılan para birimi
- demo veri import edilip edilmeyeceği

## 4. Kurulum Akışının Özeti

### Adım 1: Sistem Kontrolü

- PHP sürümü uygun mu
- PDO ve MySQL aktif mi
- yazma izinleri uygun mu
- `uploads` ve benzeri klasörler yazılabilir mi
- base URL doğru algılandı mı

### Adım 2: Veritabanı

- host
- port
- veritabanı adı
- kullanıcı adı
- şifre
- bağlantı testi

### Adım 3: Site ve Marka Ayarları

- işletme adı
- logo
- vergi metni
- fiyat güncelleme metni
- varsayılan dil
- varsayılan para birimi

### Adım 4: Özellik Seçimi

- ürün popup aktif mi
- ürün kartı görseli aktif mi
- online sipariş aktif mi
- fiziksel menü isteği aktif mi
- besin ve içerik alanları aktif mi
- çoklu para birimi aktif mi
- rezervasyon aktif mi
- masa sistemi aktif mi

### Adım 5: Demo İçerik

- demo kategori import et
- her kategoriye örnek ürün oluştur
- örnek ürünleri aktif dillere kopyala
- örnek ürünlere görsel ata
- örnek ürünlerde kalori, içerik ve alerjen alanlarını doldur

### Adım 6: PWA ve Görseller

- logo ve uygulama adı
- PWA ikon paketi
- tema rengi
- arka plan rengi
- offline sayfası

### Adım 7: Admin Hesabı

- admin adı
- admin kullanıcı adı
- admin şifresi

### Adım 8: Kurulumu Bitir

- veritabanı tablolarını oluştur
- temel ayarları kaydet
- manifest ve ikon referanslarını yaz
- istenirse demo veriyi import et
- giriş bağlantılarını göster

## 5. Demo Veri Tavsiyesi

Demo veri import seçeneğinde şu kategoriler kullanılabilir:

- kahvaltılar
- atıştırmalıklar
- ana yemekler
- salatalar
- soğuk içecekler
- tatlılar

Her kategori için en az şu alanlar dolu olmalıdır:

- başlık
- açıklama
- görsel
- fiyat
- kalori bilgisi
- içerik özeti
- alerjen veya besin notu

## 6. Plesk Kurulum

1. Yeni domain veya subdomain oluştur.
2. Dosyaları ilgili klasöre yükle.
3. Yeni veritabanı oluştur.
4. Veritabanı bilgilerini not al.
5. SSL'yi aktif et.
6. PHP sürümünü uygun seç.
7. Gerekirse `Document Root` ayarını kontrol et.
8. Kurulum sihirbazını çalıştır.

## 7. cPanel Kurulum

1. Domain veya subdomain ekle.
2. `File Manager` ile dosyaları yükle.
3. Veritabanı ve kullanıcı oluştur.
4. Kullanıcıyı veritabanına tam yetki ile bağla.
5. SSL'yi aktif et.
6. Kurulum sihirbazını çalıştır.

## 8. Ana Domain ve Subdomain Notu

### Subdomain Örneği

- `menu.siteadi.com`

### Ana Domain Örneği

- `siteadi.com`
- `siteadi.com/menu`

Kurulum sihirbazı mümkünse base URL'yi otomatik algılamalı, ama kullanıcı elle de düzenleyebilmelidir.

## 9. Kurulum Sonrası İlk Kontrol

- admin açılıyor mu
- menü açılıyor mu
- kategori geçişi çalışıyor mu
- ürün detay popup çalışıyor mu
- rezervasyon formu açılıyor mu
- PWA manifest yükleniyor mu
- service worker kayıt oluyor mu

## 10. İlgili Dokümanlar

- `INSTALLER_WIZARD_SPEC.md`
- `PWA_ASSET_GUIDE.md`
- `USAGE_GUIDE.md`
- `AI_AND_API_SETUP.md`