Özellikler

Order (fx-orderapp)

Şehrin işletmeleri için paketle gelen sipariş ve kurye uygulaması; telefona nasıl kurulduğu, ana ayarları ve export'ları.

#Nedir

fx-orderapp, şehrin işletmeleri için bir sipariş ve kurye uygulamasıdır. Patron işletmeyi uygulamadan kaydeder ve menüsünü stoğundaki item'lardan oluşturur. Müşteri kuryeyle teslimat ya da gelip alma için sipariş verir ve teslimatta nakit, banka ya da faturayla öder.

Uygulama telefon olmadan da, bir komutla açılan tablet olarak çalışır.

FX Phone, uygulamanın başlamasına yalnızca Config.BundledApps (configs/config_apps.lua) içinde ['fx-orderapp'] true olduğunda izin verir. Uygulama başlamıyorsa bu kaydı kontrol et. Bkz. Uygulamalar.

#Gereksinimler

Resource Zorunlu
ox_lib Evet
oxmysql Evet
ox_inventory Evet (stok, ürünler, item teslimi)
Bir framework qb-core, qbx_core, ESX ya da bridge/server.lua üzerinden standalone
fx-phone Hayır. Telefon yoksa uygulama tablet olarak açılır
fx-billingapp Yalnızca faturayla ödeme yöntemi için

#Kurulum

Uygulamayı ox_lib, oxmysql, ox_inventory, framework ve telefondan sonra başlat:

cfgensure fx-phone
ensure fx-orderapp
  • Tablolar ilk başlatmada oluşturulur (fxo_businesses, fxo_orders, fxo_ledger, fxo_reviews, fxo_favorites, fxo_wallets, fxo_pending).
  • Yönetici yetkisi:
cfgadd_ace group.admin fxorder.admin allow

Config.Admin.Groups içindeki qb-core yetki grupları da yönetici sayılır.

#Telefona nasıl kaydolur

Config.Phone.Resource = 'auto' olduğunda ilk başlatılan telefon kullanılır: önce fx-phone, sonra lb-phone, sonra cylex_phone. FX Phone adaptörü (client/phone/fxphone.lua), uygulamayı Config.Phone.AppIdentifier (varsayılan fx_order), AppName, Description, Developer, Icon, DefaultApp ve Size kullanarak exports['fx-phone']:AddCustomApp ile kaydeder.

#İşletme kurma

  1. Bir mesleğin patronu kaydı İşletme sekmesinden gönderir. Config.Registration.RequireApproval = true olduğunda bir yönetici bunu Yönetim sekmesinden onaylar. Yönetici bir meslek için doğrudan işletme de açabilir.
  2. Noktalar. Patron ya da bir yönetici tezgâhta durur ve noktayı ayarlar. Kurye motoru noktası isteğe bağlıdır; motorun bakmasını istediğin yöne dönük dur.
  3. İşletme stoğu tezgâh noktasında açılır. Satılacak ürünleri oraya koy.
  4. Menü. ox_inventory item'larından ürün ekle, onlara fiyat ve kategori ver ve menüler (combo) oluştur.
  5. Profil (kapak, logo, açıklama, tür, öne çıkan ürünler) ve Ayarlar (yayında, sipariş alıyor, kurye ve gelip alma, ödeme yöntemleri, kurye payı, çalışan komisyonu).

İşletme onaylandığında, yayımlandığında ve bir tezgâh noktası olduğunda listelenir.

#Sipariş akışı

  • Müşteri siparişi verir. Personel de bir müşteriye id ile teklif gönderebilir; müşteri bunu Config.Orders.OfferSeconds içinde kabul eder.
  • Tezgâhın yakınında mesaideki bir çalışan siparişi paketler. Ürünler stoktan siparişe geçer.
  • Bir kurye siparişi tezgâhtan alır; motor depozito karşılığında çıkar. Kurye müşterinin yanında siparişi teslim edildi olarak işaretler, müşteri Config.Orders.PayWindow içinde öder. Ödemeyle ürünler müşterinin envanterine geçer.
  • Toplamdan vergi (Config.Payout.Tax), kurye payı ve çalışan komisyonu düşülür; kalanı işletme hesabına gider. Her hareket işletmenin kasa defterinde yer alır ve her siparişin kayıtlarda bir zaman çizelgesi vardır.
  • Paketlemeden önce iptal ücretsizdir. Paketlemeden sonra müşteri yüzde Config.Orders.CancelFee öder ve ürünler stoğa döner.

#Öne çıkan config ayarları

Ayar Anlamı
Config.Locale tr veya en
Config.Phone Telefon seçimi, AppIdentifier, AppName, Title, Icon, DefaultApp, Theme, Notify
Config.Standalone Tablet modu: Enabled, Command (varsayılan siparis), Key, AllowWithPhone
Config.Admin Yönetici sayılan ACE adı ve framework grupları
Config.Registration Enabled, RequireApproval, Fee, BlockedJobs, AllowedJobs
Config.Points Noktaları kimin ayarlayabileceği; stok, paketleme ve teslim alma mesafeleri; stok boyutu
Config.Menu Ürün ve menü sınırları, fiyat aralığı, engellenen item'lar ve kalıplar
Config.Orders Bekleme süresi, açık sipariş sınırları, hazırlama ve teslim zaman aşımları, iptal ücreti, teslim mesafesi, ödeme süresi, kurye sınırları, geçmiş uzunluğu
Config.Payments Hangi ödeme yöntemlerinin açık olduğu: Cash, Bank, Invoice
Config.Payout Tax, CourierCut, Commission aralıkları ve komisyonun nereye ödendiği
Config.Bike Kurye motoru ve depozitosu
Config.Society, Config.Billing, Config.Keys Hangi şirket hesabı, fatura ve anahtar resource'larının kullanılacağı; auto bunları algılar
Config.Reviews, Config.Chat, Config.Map Değerlendirmeler, sipariş sohbeti ve harita işaretleri
Config.ImageHosts İşletme görsellerinin gelebileceği host'lar
Config.Ledger, Config.Log Kasa defteri sayfa boyutu ve saklama süresi, işlem logu

Şifreli olmayan bridge dosyaları:

Dosya Ne için
bridge/server.lua Framework: qb-core, qbx_core, ESX, standalone
bridge/society.lua İşletme hesabı: tgiann-bank, Renewed-Banking, qb-management, esx_society. Hiçbiri bulunamazsa para uygulamanın kendi kasasında tutulur ve patron bunu Ayarlar'dan çeker
bridge/inventory.lua ox_inventory
bridge/billing.lua fx-billingapp: fatura işletmenin adına kesilir
bridge/keys.lua Motor anahtarları
client/phone/*.lua Telefon adaptörleri

#Loglar

Her adım data/log.json dosyasına yazılır (Config.Log). Server konsol komutu fxolog, bu dosyada sipariş id'si, işletme, citizen id, oyuncu id'si ya da event'e göre arama yapar.

#Export'lar

Export Taraf Amaç
GetBusiness(job) Server Mesleğin işletmesi için { key, label, status, listed } ya da nil döndürür
OpenApp() Client Uygulamayı tablet olarak açar
CloseApp() Client Tableti kapatır
lualocal business = exports['fx-orderapp']:GetBusiness('burgershot')