# EPOS Pro - Kurulum Rehberi

## ⭐ ÖNERİLEN: Masaüstü uygulaması (.exe)

XAMPP, MySQL, Apache hiçbir şey kurmana gerek yok. Tek dosya, çift tıkla aç.

### Adım 1: Node.js kur (bir kerelik, ~3 dk)
1. https://nodejs.org/ → yeşil "LTS" butonuna bas → indir
2. İndirilen `.msi` dosyasını çift tıkla, "Next, Next" ile kur
3. Bittiğinde **bilgisayarı yeniden başlat** (PATH güncellensin)

### Adım 2: Build et (bir kerelik, ~10 dk)
1. Bu zip'i istediğin yere çıkar (mesela `Desktop\epos-php\`)
2. **`desktop-app`** klasörüne gir
3. Klasörün içindeki **`BUILD-PORTABLE.bat`**'a ÇİFT TIKLA
4. Pencere açılacak, "Pause" diyecek → bir tuşa bas, devam etsin
5. Sırasıyla şunları yapacak:
   - PHP indir (~30 MB)
   - MariaDB indir (~80 MB)
   - Electron + bağımlılıklar (~250 MB)
   - Tek bir `.exe` derler
6. **5–15 dakika bekle** (internet hızına göre)
7. Bittiğinde `dist\` klasörü açılacak

### Adım 3: Yükle
- `dist\` klasöründe **`EPOS-Pro-Setup.exe`** olacak
- Çift tıkla → kurulum sihirbazı çalışır → "Next, Next, Install"
- Masaüstüne **EPOS Pro** kısayolu eklenir
- Kısayoldan çift tıkla → uygulama açılır

PHP ve MariaDB uygulamanın içine gömülü. Hiçbir kurulum gerektirmez.

---

## Alternatif: XAMPP üzerinden (eski yöntem)

İllaki klasik web sürümü istiyorsan:

### 1. XAMPP indir, kur
- https://www.apachefriends.org/
- XAMPP Control Panel → Apache + MySQL "Start"

### 2. Dosyaları kopyala
- Bu zip'in içindeki **`epos-php`** klasörünü `C:\xampp\htdocs\` altına kopyala
- Klasör adı önemli değil, ama önerimiz `C:\xampp\htdocs\epos\`

### 3. Veritabanı oluştur
- http://localhost/phpmyadmin
- Sol üst "New" → veritabanı adı: **`epos_pro`** → "Create"
- Sol menüden `epos_pro` seç → "Import"
- **Yeni kurulum:** `database/schema.sql` yükle → "Go"
- **Eskiyi günceliyorsan:** `database/migrate.sql` yükle → "Go"

### 4. Aç
- POS: http://localhost/epos
- Admin: http://localhost/epos/admin
- KDS: http://localhost/epos/kitchen.php

---

## İlk ayarlar (her iki yolda da)

1. **Admin → Printer & Fees** sekmesine git
2. **Connection**: Termal printer IP gir, "Test connection" tıkla
3. **Print behaviour**:
   - ☑ **Auto-print receipt after payment** → Her ödemede otomatik yazdırır
   - ☐ Boş bırak → Yazdırmaz (Print butonuyla manuel yapılır)
4. **Receipt header**: Restoran adı, adres, telefon
5. **Logo**: PNG/JPG yükle (max 2MB)
6. **Default delivery fee**: £2.50 önerilir
7. **Service fee** (isteğe bağlı): Yüzde gir, hangi sipariş türlerine uygulanacağını seç
8. **Save all settings**

## Özellikler

- ✓ Masa siparişi (sepet otomatik kaydedilir, geri butonu ile gitsen bile durur)
- ✓ Takeaway ve Delivery (UK postcode arama)
- ✓ Termal yazıcı (ESC/POS, logo destekli)
- ✓ Cash drawer açma
- ✓ £5/£10/£20/£50 hızlı butonlar + para üstü hesap
- ✓ Discount (% veya £)
- ✓ Service fee + Delivery fee
- ✓ Sepetteki ürüne tıkla → opsiyonları düzenle
- ✓ Print butonu (ödeme almadan fiş yazdır)
- ✓ KDS (Kitchen Display)
- ✓ Müşteri hafızası (telefondan otomatik bul)
- ✓ Loyalty: Bronze/Silver/Gold tier'lar
- ✓ Detaylı raporlar: saatlik dağılım, peak hour, en çok satılanlar, dönem karşılaştırma

## Şifre

- Varsayılan: `admin` / `admin123`
- Mutlaka değiştir!

## Sorun giderme

### CSS yüklenmiyor / sayfa düzensiz
- **En sık sorun**: Apache çalışmıyor. XAMPP Control'de "Start" tıklanmış mı?
- URL doğru mu? `http://localhost/epos/` (sondaki / önemli)
- Klasör adı farklıysa URL onunla eşleşmeli (`htdocs/cafem` → `localhost/cafem`)

### "404 Not Found"
- `htdocs` altında doğru klasör adı var mı kontrol et
- URL'deki klasör adı ile fiziki klasör adı aynı olmalı

### MySQL bağlantı hatası
- XAMPP Control'de MySQL "Start" durumda olmalı
- Veritabanı `epos_pro` adıyla oluşturuldu mu?

### Termal printer yazdırmıyor
- Yazıcı IP'sini "Test connection" ile dene
- Yazıcı ve PC aynı ağda mı?
- Port genelde 9100

### "BUILD-PORTABLE.bat" hata veriyor
- "Node not found": Node.js kurulu değil veya bilgisayar yeniden başlatılmamış
- "PHP indirilemedi": İnternet veya antivirüs sorunu
- "npm install failed": İnternet yavaş, biraz bekle ve tekrar dene

### Electron build sonucu
- `desktop-app\dist\EPOS-Pro-Setup.exe` çıkmalı
- Eğer yoksa pencerede yazan hata mesajına bak veya `desktop-app\` klasöründeki dosyaları sil ve tekrar BUILD-PORTABLE.bat çalıştır

### Uygulama açılırken "MariaDB başlatılamadı"
- Senin makinende `%APPDATA%\EPOS Pro\epos.log` dosyasına bak (detaylı hata var)
- Antivirüs MariaDB'yi engelliyorsa istisna ekle