V

VIXPOS

Yönetici & Kurulum Rehberi v2.2

Nasıl Çalışır?

Bu sistem, "Database-less" (Veritabanısız) mimari üzerine kuruludur. Geleneksel sistemlerin aksine MySQL, MariaDB veya PostgreSQL kurulumu gerektirmez. Tüm veriler (siparişler, kullanıcılar, ürünler) database.json isimli tek bir dosyada güvenle saklanır.

Yönetim Paneli Kolaylığı

Artık kodlarla uğraşmanıza gerek yok! Gelişmiş Yönetim Paneli sayesinde ürünleri, fiyatları, personelleri ve restoran ayarlarını kolayca yönetebilirsiniz. Sistem Restoran veya Market modunda çalışabilir.

✨ Otomatik Kurulum Sihirbazı

Dosyaları yükledikten sonra hiçbir teknik ayar yapmadan sistemi kurabilirsiniz.

  1. 1 Tarayıcınızda siteadresi.com/setup.php adresine gidin.
  2. 2 İşletme Türü seçin (Restoran veya Market). Bu seçim, masa düzeninden raporlara kadar tüm arayüzü işletmenize göre otomatik olarak yapılandırır.
  3. 3 Yönetici hesap bilgilerini belirleyin ve Kurulumu Tamamla diyerek bitirin.

Sistem Gereksinimleri

  • ✓
    PHP 7.4 veya üzeri Çoğu sunucuda standarttır.
  • ✓
    Apache / Nginx / IIS Herhangi bir web sunucusu.

1. Dosya Yükleme

Sitemi kurmak için size verilen ZIP dosyasını klasöre çıkartın.

cPanel / Plesk File Manager Kullanarak (Önerilen)
  1. Hosting panelinize giriş yapın ve Dosya Yöneticisi'ne gidin.
  2. public_html klasörünü açın. (Eğer site ana dizinde çalışacaksa).
  3. Yükle (Upload) butonuna basıp ZIP dosyasını seçin.
  4. Yükleme bitince ZIP dosyasına sağ tıklayıp Extract (Çıkart) deyin.

2. İzin Ayarları (Kritik Adım)

Sistemin en önemli adımı burasıdır. Eğer bu adımı atlarsanız, siparişler kaydedilmez ve sistem hata verir. Sistemin, database.json dosyasına veri yazabilmesi için "yazma iznine" (Write Permission) ihtiyacı vardır.

Nasıl Yapılır?

  1. Dosya Yöneticisinde database.json dosyasını bulun.
  2. Dosyaya sağ tıklayın ve Permissions (İzinler) veya Chmod seçeneğine tıklayın.
  3. Sayısal Değer kutusuna 777 yazın (Veya Yönetici, Grup ve Dünya için "Yazma - Write" kutucuklarını işaretleyin).
  4. Kaydedin.

3. Varsayılan Şifreler ve İlk Giriş

Kurulum tamamlandı! Tarayıcınızda siteadresi.com/login.php adresine gidin. Aşağıdaki bilgilerle giriş yapın:

Rol Kullanıcı Adı Şifre
Yönetici admin password
Kasiyer kasa1 password
Garson garson1 password
⚠️ Önemli: Giriş yaptıktan sonra şifrelerinizi Yönetim Panelinden değiştirmeyi unutmayın!

Yönetim Paneli: Ürünler

Yönetim > Ürünler sekmesinden menünüzü kolayca oluşturabilirsiniz.

  • Kategori Ekleme: Ürünlerinizi gruplamak için önce Kategoriler oluşturun (Örn: Çorbalar, Kebaplar, İçecekler).
  • Ürün Ekleme: Ürün adı, açıklama, fiyat ve resim bilgilerini girerek ürün ekleyin.
  • Düzenleme/Silme: Fiyat değişiklikleri veya menüden kaldırma işlemlerini tek tıkla yapın.

Yönetim Paneli: Kullanıcılar

Personelinizi sisteme kaydedin ve yetkilerini belirleyin.

Admin (Yönetici)

Tüm sisteme erişebilir. Ayarları değiştirebilir, raporları görebilir.

Waiter (Garson)

Sadece sipariş alabilir ve masaları yönetebilir. Ayarlara giremez.

Cashier (Kasa)

Ödeme alabilir ve kasa raporlarını görebilir.

Kitchen (Mutfak)

Sadece mutfak ekranını görür. Gelen siparişleri hazırlar.

Yönetim Paneli: Masalar

İşletme düzeninize göre sınırsız masa oluşturabilirsiniz.

  • QR Kod Oluşturma: Her masa için otomatik QR kod oluşturulur. Bunu yazdırıp masalara yapıştırabilirsiniz.
  • Müşteriler QR kodu okuttuğunda doğrudan o masanın menüsüne gider.
  • Masa Taşıma: Bir masadaki siparişleri başka bir masaya taşımak için masanın üzerine tıklayın ve "Masayı Taşı" seçeneğini kullanın. Hedef masayı seçtiğinizde tüm siparişler oraya aktarılır.

Genel Ayarlar & Garson Çağırma

İşletmenizin kimliğini ve sistem fonksiyonlarını buradan yönetin.

  • Firma Bilgileri: Restoran adı, logosu, adresi.
  • Para Birimi & Vergi: Kullandığınız para birimi (₺, $, €) ve KDV oranını ayarlayın.
  • Garson Çağırma Sistemi: Müşterilerin menüden "Garson Çağır" butonunu kullanıp kullanamayacağını buradan açıp kapatabilirsiniz.
  • Wi-Fi Bilgileri: Müşterilerinizle paylaşmak istediğiniz Wi-Fi adını ve şifresini buraya girin. Menüde otomatik görünür.
  • Vergi (KDV) Ayarları: Satışlarınıza uygulanacak KDV oranını (%) belirleyin. Bu oran Gün Sonu (Z-Raporu) raporlarına yansır.

Yeni Özellikler Kullanım Kılavuzu

Müşteri Sadakat Programı

Müşterilerinizi telefon numaraları ile kaydedin ve her siparişte %10 puan kazandırın.

  • Ödeme ekranında müşteri telefon numarasını girin.
  • Müşteri kayıtlı değilse otomatik oluşturulur.
  • Biriken puanlar bir sonraki siparişte indirim olarak kullanılabilir.

Market Modu & Barkod

Hızlı satış noktaları için özel arayüz.

  • Ürünlerinize barkod numaralarını tanımlayın.
  • Satış ekranında barkod okuyucunuzu kullanarak ürünleri sepete ışık hızında atın.
  • "Hızlı Ödeme" tuşu ile saniyeler içinde fiş kesin.

Termal Yazıcı Ayarları

Kusursuz fiş çıktısı için tarayıcınızda ve Windows'ta yapmanız gereken ayarlar şunlardır:

1. Yazıcı Tercihleri (Windows)

  • Denetim Masası > Aygıtlar ve Yazıcılar.
  • Termal yazıcınıza sağ tıklayın -> Yazdırma Tercihleri.
  • Kağıt Boyutu: 80mm x Receipt.
  • Kesim: "Document End" -> "Cut".

2. Tarayıcı Ayarları (Chrome)

  • Hedef: Termal Yazıcınızı seçin.
  • Kenar Boşlukları (Margins): "Yok" (None).
  • Üstbilgi/Altbilgi: Tiki kaldırın.

Sıkça Sorulan Sorular

Soru: Girdiğim veriler kaybolur mu?

Hayır. Tüm veriler database.json dosyasında saklanır. Bu dosyanın yedeğini alarak verilerinizi güvene alabilirsiniz. Bilgisayarınıza indirmeniz yeterlidir.

Soru: Sipariş veriyorum ama sayfayı yenileyince siliniyor.

Çözüm: Yazma izni sorunu. "2. İzin Ayarları" başlığına dönün ve database.json dosyasının izninin 777 olduğundan emin olun.

Soru: KDV raporlara nasıl yansıyor?

Yapılan her satışın içinde, Ayarlar'da belirlediğiniz KDV oranı kadar vergi hesaplanır ve Z-Raporunda "Toplanan KDV" olarak ayrı bir satırda gösterilir.

Soru: Sadakat puanları nasıl hesaplanıyor?

Standart olarak sipariş tutarının %10'u müşteriye puan olarak yüklenir. 1 Puan = 1 Para Birimi değerindedir.

API Referansı

Dış sistemlerle entegrasyon için aşağıdaki uç noktaları kullanabilirsiniz. Tüm istekler GET veya POST methodu ile yapılır.

GET /api.php?get_products=1 Ürün Listesi

Tüm kategorileri ve ürünleri JSON formatında döndürür.

POST /api.php Sipariş Gönder

Yeni sipariş oluşturur. Payload:

{
  "action": "add_order",
  "tableId": "masa-1",
  "items": [...]
}
POST /api/send_status.php Durum Bildirimi

Sipariş durumu değişikliklerini (Hazır, Teslim Edildi vb.) sisteme bildirir.