Lojistik

Depo, stok ve teslimat

Alıcı siparişi bir depoya düşer. Yetkililer hazırlar, stoğu düşer, kurye veya müşteri teslimi ile kapatır. Bu sayfa o operasyonun yapılarını anlatır.

`warehouse`

Görevi: Depo tanımı ve depo içi operasyon.

Yol	İş
`warehouse/admin`	Depo, hizmet alanı, poligon bölge, araç, ayar, yetkili atama
`warehouse/officer`	Yetkili depo görünümü
`warehouse/stock`	Stok giriş/çıkış (eski koleksiyonlar dahil)
`warehouse/:id/statistics`	Toplu istatistik
`warehouse/heatmap`	Coğrafi yoğunluk

Prisma tarafında depo, dikdörtgen hizmet alanı, poligon koordinat bölgesi, gün bazlı asgari sepet, araç ve anahtar-değer ayar tutulur. Stok miktarı WarehouseProduct.stock alanındadır; hareketin ayrıntısı Mongo’dadır.

İki stok dünyası vardır:

Sistem	Koleksiyon	Ne zaman
Eski	`warehouseProductStockIn` / `warehouseProductStockOut`	Manuel giriş, HKS ham veri, yönetici/yetkili stok ekranı
Yeni FIFO	`stockEntries` / `stockExits`	Sipariş sevkında `StockService`

Şema: Depo ve teslimat alanı, Stok ve transfer.

`stock`

Görevi: FIFO lot. Giriş lotu (StockEntry) kalan miktar taşır; çıkış (StockExit) lotlara referans verir.

Yol: stock — yönetici ve yetkili. Sipariş sevkı bu modülü çağırır: önce uygun lotlar seçilir, sonra satış çıkışı yazılır, sipariş kalemine referans işlenir.

Giriş durumları: PRE_DECLARED, DECLARED, CONFIRMED, CANCELLED. Çıkış tipi: SALE, FIRE, ADJUSTMENT.

`order`

Görevi: Alıcı siparişinin tek belgesi ve durum makinesi.

Sipariş Mongo buyerOrders koleksiyonundadır; MySQL’de sipariş tablosu yoktur. Belge alıcı kopyası, kalemler, ödeme bloğu, teslimat, depo, geçmiş, fatura özeti ve transfer referanslarını bir arada tutar.

Yol	Kimin için
`order/buyer`	Alıcı (iki ödeme test ucu açık)
`order/buyer/return`	Alıcı iade talebi
`order/officer`, `order/officer/return`	Yetkili
`order/admin`, `order/admin/return`	Yönetici
`order/heatmap`	Yönetici ve yetkili

Sipariş düzeyindeki durumlar ve kalem düzeyindeki iade alt durumları durum değerleri sayfasındadır. Akış: Alışveriş, Hazırlık ve teslimat.

İlgili belgeler: iade (buyerOrderReturns), sorun (buyerOrderIssues), anket (orderSurveyResponses), heatmap (orderHeatmaps).

`transfer`

Görevi: Siparişi kapıya götürmek.

Kurye teslimatlı siparişlerde BuyerOrderTransfer açılır. Birden fazla transfer bir araç seferine (WarehouseVehicleTransfer) bağlanabilir; GPS noktaları ve kapıda tahsilat bu seferde tutulur.

Yol	Kimin için
`transfer/buyer`	Alıcı
`transfer/officer`	Yetkili (`officer:buyer-order-transfer:full`)
`transfer/admin`	Yönetici

Durumlar: PENDING, SHIPPING, DELIVERED, CANCELLED, RETURNED. Teslim, siparişi DELIVERED yapar.

Kuyruk transfer-operations: sevk ve araç faturası üretimi.

Teslimat türü

Sipariş teslimatı iki tiptir (DeliveryType):

Değer	Anlamı
`COURIER`	Platform kuryesi. Transfer kaydı bu tipte açılır.
`CUSTOMER`	Alıcı kendi alır / kendi organize eder.

Sağlayıcı enum’u şu an yalnız PLATFORM değerini taşır.