Modül haritası
v1 API, src/modules altında domain modülleri ve src kökünde altyapı modülleri olarak ayrılır. Aşağıdaki görevler haljet-api içindeki ilgili *Module, denetleyici ve servis dosyalarından çıkarılmıştır.
Nasıl okunur?
Her satır “bu ekip / bu ekran ne işe yarar?” sorusuna iş dilinde cevap verir. Teknik bağlantılar Bağımlılıklar sayfasındadır.
Kimlik, kişi ve yer
| Modül | Görevi |
|---|---|
auth | Kayıt, giriş, çıkış, telefon ve e-posta doğrulama, jeton üretimi. |
user | Profil, parola, avatar, cihaz (FCM), istemci logları. |
area | Ülke, il, ilçe, mahalle. Açık uç. |
buyer | Alıcı profili, adres, depo eşlemesi, ekstre, Firestore senkronu. |
seller | Satıcı profili, vergi bilgisi, İzibiz bağlantısı. |
officer | Yetkili profili, konum, alıcı adına işlem, mesaj. |
admin | Yönetici paneli: alıcı CRM, yetkili atama, ana sayfa. |
buyer-group | Alıcı segmenti (ciro, sipariş adedi, sepet ortalaması, sepet indirimi). |
Detay: Kimlik ve erişim, Kişiler ve CRM.
Ticaret
| Modül | Görevi |
|---|---|
catalog | Ürün, kategori, arama, ürün seçenekleri, ürün talebi, HKS ürün kodu, şirket tipine göre görünürlük. |
basket | Alıcı sepeti (MySQL satırları, isteğe bağlı seçenek). |
purchase | Sipariş önizleme ve oluşturma: teslimat, ödeme kırılımı, grup indirimi, asgari sepet. |
post | Slider, banner, hikâye, akademi; isteğe bağlı haftalık aktif pencere. |
procurement | Satıcının tedarik talebi (Mongo belge). |
static | Politika sayfaları ve alıcıya özel statik içerik. |
Detay: Ticaret.
Sipariş, depo, para
| Modül | Görevi |
|---|---|
order | Alıcı siparişi yaşam döngüsü, iade (cari iadesi), sorun, anket, heatmap, fatura tetikleme. |
warehouse | Depo tanımı, stok, istatistik, heatmap, kapsama alanı, fiyat geçmişi, seçenek fiyatı. |
stock | FIFO stok girişi / çıkışı (yeni stok modülü). |
transfer | Sipariş teslimatı ve araç seferi; boş sefer iptali. |
payment | PayTR, Paywall, MagicPay ve manuel tahsilat. |
financial | Cari bakiye, hareket defteri, kampanya ödülü tanımları. |
invoice | Giden ve gelen e-fatura kayıtları. |
Detay: Lojistik, Para ve fatura.
İletişim, operasyon, zeka
| Modül | Görevi |
|---|---|
message | Sohbet, tepki, okundu, yetkili hatırlatması, bağlama göre konuşma (sipariş, iade, ürün…). |
notification | Yönetici yayını, segment, kutu kaydı. |
workflow | Depo bazlı kanban: departman, kart, görev, not. |
report | Satış, alım, alıcı yaşam döngüsü, cari, pazarlama, BigQuery aktarım. |
ai | Açık uç: doğal dil sorgu ve şema bağlamı. |
price-analytics | Fiyat mumu, İBB Hal verisi, ürün eşlemesi, ticker. |
Detay: İletişim, Operasyon, Zeka ve analitik.
Altyapı klasörleri (modül değil ama yapı)
Bunlar app.module içinde bağlanır; iş kuralı taşımaz, servis sağlar.
| Klasör | Görevi |
|---|---|
prisma | MySQL istemcisi |
common | Sayfalama, depolama, telefon, tarih, Telegram uyarı, Google Maps |
firebase | Push, Firestore, Storage |
mail / sms | E-posta / SMS |
meilisearch | Arama istemcisi |
izibiz / hks | Fatura ve hal bildirimi |
gemini | Metin üretimi |
bigquery | Analitik yazımı |
HTTP yüzeyi
v1 yolları api önekinin altındadır. Örnek: alıcı sepeti api/basket/buyer. v2 de aynı genel öneki kullanır; yeni mobil sepeti api/orders/buyer/basket, yeni finans yüzeyi api/finance/* altındadır. Rol dağılımı Roller ve yetkiler sayfasındadır.