Platform genel hatları
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 yarar | API’deki karşılığı |
|---|---|---|
| Hesap ve giriş | Telefon, e-posta veya Google ile kimlik | Kimlik ve erişim |
| Katalog | Ürün, kategori, KDV, birim, arama | Ticaret |
| Sepet ve sipariş | Alışveriş, teslimat seçimi, sipariş belgesi | Alışveriş akışı |
| Depo | Stok, fiyat kademesi, hizmet alanı, araç | Lojistik |
| Teslimat | Kurye / müşteri teslim, araç rotası | Hazırlık ve teslimat |
| Ödeme | Kart, havale, cari, kapıda tahsilat | Ödeme akışı |
| Cari | Bakiye, borç, kasa/palet sayımı | Para ve fatura |
| Fatura | E-fatura / e-arşiv, HKS künye | Fatura ve HKS |
| CRM | Alıcı durumu, arama, not, grup | Kişiler ve CRM |
| İletişim | Push, SMS, e-posta, sohbet | İletişim |
Günlük döngü
- Alıcı uygulamadan ürün arar. Arama, MeiliSearch indeksinden gelir; fiyat ve stok ilgili depodan okunur.
- Sepet MySQL’de tutulur. Sipariş oluşturulunca MongoDB’de tam bir sipariş belgesi yazılır; sepet temizlenir.
- Ödeme kart ise önce ödeme bekler; havale ise onay bekler; cari veya kapıda ödeme ise sipariş doğrudan işleme alınabilir.
- Depo yetkilisi siparişi onaylar, hazırlar, sevk eder. Stok çıkışı bu aşamada işlenir.
- Teslimat kurye ise bir transfer kaydı açılır; araç rotasına bağlanabilir.
- Teslimden sonra fatura ve HKS bildirimleri otomatik veya operasyonla üretilir.
- 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.