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