Geliştirici ve mobil uygulama altyapısı

Paket mimarisi

Kural: hiçbir ekran yerel depoya doğrudan erişmez; her okuma/yazma api.* üzerinden gider. Demo MockAdapter işlemleri olay olarak sekmeler arasında yayar — paneldeki makas değişikliği ya da satış duraklatma müşteri ekranına anında düşer.

Tek fiyat motoru: bu yüzük gerçekten hesaplandı

import { piyasaAn, urunFiyat } from '@sirmava/core'

const piyasa = piyasaAn(Date.now(), fiyatAyar)  // has altın ₺/g
const d = urunFiyat(urun, { ayar: '14', renk: 'sari', olcu: 14 },
  { piyasa, fiyat: fiyatAyar, kampanyalar })
// d.maden = gram × milyem × has satış (+ makas)
// d.iscilik = gram başı | % | sabit (kural ezebilir)
// d.kdv = (işçilik + taş) × oran   — altın, mevzuata göre
// web, mobil, panel ve sunucu: aynı sonuç

Mobil uygulama ekran haritası

React Native iskeleti bu depodaki apps/mobile klasöründedir ve tip denetiminden geçer. Her ekranın kullandığı çekirdek fonksiyon aşağıda; bu fonksiyonlar web'de de aynıdır.

1. 01KeşfetKategori, koleksiyon, canlı "başlayan" fiyatkartFiyat · fiyatGirdi
2. 02ÜrünAyar · renk · ölçü, şeffaf fiyat dökümüurunFiyat · varyantGram
3. 03SepetFiyat kilidi sayacı, güncel fiyatla yenilesepetHesapla · kilitYenile
4. 04ÖdemeSağlayıcının güvenli sayfası WebView içinde/v1/odeme/baslat · 3D Secure
5. 05SiparişlerimAtölye → kalite → sigortalı kargoadimlar · DURUM_AD
6. 06FiyatlarCanlı alış/satış, çeyrek, gram altınkalemFiyatlari · piyasaAn
7. 07Fiyat alarmıHedef fiyata inince push bildirimFiyatAlarmi · /v1/ben/alarmlar
8. 08Sanal denemeKamera ile küpe/kolye/yüzük (cihazda)ArTur · dekupe görsel

Yerel yetenekler kurulumda eklenir: push bildirim (fiyat alarmı, sipariş ve atölye durumu), kamera ile sanal deneme, ödeme WebView'i. Ayrıntı: Mobil uygulama.

Ödeme sağlayıcı adaptörleri

Üç adaptör aynı OdemeSaglayici arayüzünü uygular: odemeBaslat, ucDSecureTamamla, iade, iptal, taksitSorgula, callbackDogrula. İmza üreten çağrılar yalnız sunucuda çalışır; kriptografi dışarıdan enjekte edilir, böylece aynı kod React Native'de de derlenir. Kuyumcuda ön provizyon kullanılmaz: fiyat kilitli olduğu için kesin tutar ödeme anında bellidir, iadeler kısmi ya da tam iadeyle yapılır.

Yüksek tutarlı siparişte ek doğrulama adımı istenir; test kipindeki ödeme sipariş ve tahsilat yazmaz. Ödeme altyapısı ayrıntıları · Demo — gerçek ödeme alınmaz. Sağlayıcı arayüzleri ve logoları kullanılmaz.

Fiyat, ERP ve e-Fatura entegrasyon noktaları

interface FiyatSaglayici {     // lisanslı canlı fiyat
  an(): Promise<PiyasaAn>           // has/gümüş alış-satış
  akis(f: (p: PiyasaAn) => void): () => void
}
interface GramStokKaynagi {     // ERP / kasa
  hasStok(magaza: string): Promise<{ altin: Gram; gumus: Gram }>
  parcalar(degisenSonra: Iso): Promise<TekilParca[]>
}
interface KargoSaglayici {      // değer beyanlı sigortalı kargo
  etiket(s: Siparis, deger: Kurus): Promise<{ takip: string; pdf: string }>
}
interface EBelgeSaglayici {     // e-Arşiv / e-Fatura entegratörü
  faturaKes(s: Siparis): Promise<{ ettn: string; pdf: string }>
}

Demo — gerçek bağlantı yok; kurulumda kurumun yetkisi ve sağlayıcının arayüzü üzerinden bağlanır.

API sözleşmesi (OpenAPI 3.1)

Fiyat, katalog, sepet ve fiyat kilidi, siparişler, müşteri, ödeme ve panel uçları; bütün tutarlar kuruş. Uçlara tıklayıp şema, örnek istek ve curl komutunu görebilirsiniz. openapi.yaml

Sık sorulanlar

Bütün yazılım özellikleri