Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Platform genel hatları

İşin büyük resmi

Haljet bir pazaryeri vitrini değil, depo merkezli toptan tedarik sistemidir. Alıcı bir ürün listesinden sipariş verir; sipariş bir depoya düşer; yetkililer hazırlar ve teslim eder; para ve fatura bu sürecin peşinden gelir.

İşin özü

Alıcıların çoğu işletmedir (restoran, market, otel). Her alıcının teslimat adresi, fatura bilgisi ve çoğu zaman bir cari hesabı vardır. Ürün fiyatı ülke genelinde tek değil; depoya göre stok ve fiyat vardır. Alıcının hangi depodan alışveriş yapacağı, adresinin düştüğü hizmet alanına göre belirlenir.

Ana parçalar

Bu parçalar yapılar bölümünde ayrı ayrı anlatılır. Buradaki liste, iş dilindeki karşılıklarıdır.

İş parçasıNe işe yararAPI’deki karşılığı
Hesap ve girişTelefon, e-posta veya Google ile kimlikKimlik ve erişim
KatalogÜrün, kategori, KDV, birim, aramaTicaret
Sepet ve siparişAlışveriş, teslimat seçimi, sipariş belgesiAlışveriş akışı
DepoStok, fiyat kademesi, hizmet alanı, araçLojistik
TeslimatKurye / müşteri teslim, araç rotasıHazırlık ve teslimat
ÖdemeKart, havale, cari, kapıda tahsilatÖdeme akışı
CariBakiye, borç, kasa/palet sayımıPara ve fatura
FaturaE-fatura / e-arşiv, HKS künyeFatura ve HKS
CRMAlıcı durumu, arama, not, grupKişiler ve CRM
İletişimPush, SMS, e-posta, sohbetİletişim

Günlük döngü

  1. Alıcı uygulamadan ürün arar. Arama, MeiliSearch indeksinden gelir; fiyat ve stok ilgili depodan okunur.
  2. Sepet MySQL’de tutulur. Sipariş oluşturulunca MongoDB’de tam bir sipariş belgesi yazılır; sepet temizlenir.
  3. Ödeme kart ise önce ödeme bekler; havale ise onay bekler; cari veya kapıda ödeme ise sipariş doğrudan işleme alınabilir.
  4. Depo yetkilisi siparişi onaylar, hazırlar, sevk eder. Stok çıkışı bu aşamada işlenir.
  5. Teslimat kurye ise bir transfer kaydı açılır; araç rotasına bağlanabilir.
  6. Teslimden sonra fatura ve HKS bildirimleri otomatik veya operasyonla üretilir.
  7. Raporlar gece MongoDB’de toplanır; bazı olaylar BigQuery’ye de yazılır.

Detaylı sıra: Veri akışları.

İki veri dünyası

Platform kasıtlı olarak iki veritabanı kullanır:

  • MySQL (Prisma) — kullanıcı, ürün, depo tanımı, sepet, cari bakiye. Bunlar görece sabit, ilişkili kayıtlardır.
  • MongoDB — sipariş, ödeme, stok hareketi, transfer, fatura, rapor. Bunlar belge niteliğinde, iç içe ve yüksek hacimli kayıtlardır.

Neden böyle ayrıldığı: Nerede ne tutulur.

Bu belgede olmayanlar

Kodda olmayan mobil uygulama ekranları, ayrı bir frontend reposu veya pazarlama vaatleri burada anlatılmaz. Dış servislerin (PayTR, İzibiz, HKS) kendi panelleri de bu sitenin konusu değildir; Haljet’in onlarla nasıl konuştuğu anlatılır.