Haljet nedir?
Toptan tedarik, depo ve teslimat platformu
Haljet, restoran, market ve benzeri alıcıların yaş meyve-sebze ürünlerini sipariş ettiği; depoların bu siparişleri hazırladığı, teslim ettiği ve faturalandırdığı bir ticaret platformudur. Sunucu tarafında geçiş boyunca iki servis birlikte çalışır: haljet-api (v1) ve haljet-api-new (v2).
İki API sürümü
| Sürüm | Kod tabanı | Bugünkü rolü |
|---|---|---|
| v1 | haljet-api | Üretimdeki geniş kapsamlı servis; eski mobil, panel yüzeyleri, cron ve entegrasyonların ana kaynağı |
| v2 | haljet-api-new | Aynı verileri kullanan ikinci servis; taşınan panel uçları, yeni finans/lojistik yüzeyleri ve yeni BUYER uygulaması |
İki servis aynı MySQL, MongoDB ve Redis altyapısını kullanır. Prisma şeması ve migration'ların sahibi geçiş tamamlanana kadar v1'dir. v2'nin yapısı ve geçiş sınırı: v2 nedir?.
Kimler kullanır?
| Kim | Ne yapar |
|---|---|
| Alıcı (Buyer) | Ürün arar, sepete ekler, sipariş verir, ödeme yapar, iade ve sorun bildirir. |
| Satıcı (Seller) | Depoya mal tedarik eder; tedarik talebi açabilir. |
| Yetkili (Officer) | Depoda sipariş hazırlar, teslimat yapar, stok girer, alıcıyla ilgilenir. |
| Yönetici (Admin) | Depo, fiyat, alıcı ilişkisi, içerik ve raporları yönetir. |
| Sistem | Otomatik işler: fatura, arama indeksi, rapor, bildirim, kilit. |
Detay: Roller ve yetkiler.
Platform ne işe yarar?
Kısaca dört işi bir arada tutar:
- Satın alma — katalog, arama, sepet, sipariş ve ödeme.
- Operasyon — depo stoğu, hazırlık, araç ve kurye teslimatı.
- Para ve belge — cari hesap, kapı tahsilatı, e-fatura, HKS bildirimleri.
- İlişki — alıcı CRM, mesajlaşma, bildirim, iç görev tahtası.
Genel resim: Platform genel hatları. Teknik katmanlar: Mimari.
Belgeleri nasıl okumalı?
| Bölüm | Kime hitap eder | Ne anlatır |
|---|---|---|
| Giriş | Herkes | Platformun işi, parçaları ve dış bağlantıları |
| v2 | Ürün ve yazılım | İkinci servisin mimarisi, domain'leri ve kademeli geçişi |
| Yapılar | Operasyon ve yazılım | v1 modüllerinin görevi ve birbirine bağlanması |
| Veri akışları | Operasyon ve yazılım | Aksi belirtilmedikçe v1'de siparişin kayıt, ödeme, teslimat ve faturaya gidişi |
| Veri | Yazılım ve veri | Paylaşılan MySQL/MongoDB verisi ile v1 BigQuery akışı |
Teknik olmayan okuyucu için her sayfa önce “bu ne işe yarar?” ile başlar. Alan adları, durum kodları ve ilişkiler aynı sayfanın devamındadır.
Hızlı yönlendirme
- Siparişin hayatı: Alışveriş → Ödeme → Hazırlık ve teslimat
- Depo ve stok: Lojistik yapıları
- Cari ve fatura: Para ve fatura
- Tablolar: Prisma (MySQL) ve MongoDB