Ö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
- Bir mesleğin patronu kaydı İşletme sekmesinden gönderir.
Config.Registration.RequireApproval = trueolduğunda bir yönetici bunu Yönetim sekmesinden onaylar. Yönetici bir meslek için doğrudan işletme de açabilir. - 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.
- İşletme stoğu tezgâh noktasında açılır. Satılacak ürünleri oraya koy.
- Menü. ox_inventory item'larından ürün ekle, onlara fiyat ve kategori ver ve menüler (combo) oluştur.
- 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.OfferSecondsiç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.PayWindowiç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')