Stok Sayımı ve Envanter Doğrulama: Sistemsel Yaklaşım

CREATE TABLE urunler (
    urun_id SERIAL PRIMARY KEY,
    urun_kodu VARCHAR(50) UNIQUE NOT NULL,
    urun_adi VARCHAR(255) NOT NULL,
    barkod VARCHAR(13) UNIQUE,
    kategori_id INT REFERENCES kategoriler(kategori_id),
    birim VARCHAR(20) DEFAULT 'adet',
    minimum_stok INT DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE stok_hareketleri (
    hareket_id SERIAL PRIMARY KEY,
    urun_id INT REFERENCES urunler(urun_id),
    depo_id INT REFERENCES depolar(depo_id),
    hareket_tipi VARCHAR(20) CHECK (hareket_tipi IN ('giris', 'cikis', 'sayim', 'transfer')),
    miktar DECIMAL(10,2) NOT NULL,
    referans_no VARCHAR(100),
    kullanici_id INT REFERENCES kullanicilar(kullanici_id),
    tarih TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE sayim_kayitlari (
    sayim_id SERIAL PRIMARY KEY,
    sayim_tarihi DATE NOT NULL,
    depo_id INT REFERENCES depolar(depo_id),
    durum VARCHAR(20) DEFAULT 'devam_ediyor',
    onaylayan_id INT REFERENCES kullanicilar(kullanici_id),
    tamamlanma_tarihi TIMESTAMP
);

CREATE TABLE sayim_detay (
    detay_id SERIAL PRIMARY KEY,
    sayim_id INT REFERENCES sayim_kayitlari(sayim_id),
    urun_id INT REFERENCES urunler(urun_id),
    sistem_miktari DECIMAL(10,2) NOT NULL,
    sayilan_miktar DECIMAL(10,2),
    fark DECIMAL(10,2) GENERATED ALWAYS AS (sayilan_miktar - sistem_miktari) STORED,
    aciklama TEXT
);

from dataclasses import dataclass
from decimal import Decimal
from enum import Enum

class SapmaDerecesi(Enum):
    KABUL = "kabul_edilebilir"
    UYARI = "uyari"
    KRITIK = "kritik"

@dataclass
class SayimSonucu:
    urun_kodu: str
    sistem_miktari: Decimal
    sayilan_miktar: Decimal

    @property
    def fark(self) -> Decimal:
        return self.sayilan_miktar - self.sistem_miktari

    @property
    def sapma_orani(self) -> Decimal:
        if self.sistem_miktari == 0:
            return Decimal("100") if self.sayilan_miktar != 0 else Decimal("0")
        return abs(self.fark / self.sistem_miktari) * 100

    @property
    def derece(self) -> SapmaDerecesi:
        oran = self.sapma_orani
        if oran <= 2:
            return SapmaDerecesi.KABUL
        elif oran <= 5:
            return SapmaDerecesi.UYARI
        return SapmaDerecesi.KRITIK


def envanter_dogrulama(sonuclar: list[SayimSonucu]) -> dict:
    rapor = {"kabul": [], "uyari": [], "kritik": []}
    toplam_fark_maliyeti = Decimal("0")

    for sonuc in sonuclar:
        derece = sonuc.derece
        rapor[derece.value.split("_")[0] if "_" not in derece.value else derece.value].append({
            "urun": sonuc.urun_kodu,
            "sistem": sonuc.sistem_miktari,
            "sayim": sonuc.sayilan_miktar,
            "fark": sonuc.fark,
            "sapma": f"%{sonuc.sapma_orani:.1f}"
        })

    rapor["ozet"] = {
        "toplam_urun": len(sonuclar),
        "sapmali_urun": len(rapor["uyari"]) + len(rapor["kritik"]),
        "dogruluk_orani": f"%{((len(rapor.get('kabul', [])) / len(sonuclar)) * 100):.1f}" if sonuclar else "%0"
    }
    return rapor

SELECT
    u.urun_kodu,
    u.urun_adi,
    SUM(sh.miktar * u.birim_fiyat) AS toplam_deger,
    SUM(SUM(sh.miktar * u.birim_fiyat)) OVER (ORDER BY SUM(sh.miktar * u.birim_fiyat) DESC)
        / SUM(SUM(sh.miktar * u.birim_fiyat)) OVER () * 100 AS kumulatif_yuzde,
    CASE
        WHEN SUM(SUM(sh.miktar * u.birim_fiyat)) OVER (ORDER BY SUM(sh.miktar * u.birim_fiyat) DESC)
             / SUM(SUM(sh.miktar * u.birim_fiyat)) OVER () * 100 <= 80 THEN 'A'
        WHEN SUM(SUM(sh.miktar * u.birim_fiyat)) OVER (ORDER BY SUM(sh.miktar * u.birim_fiyat) DESC)
             / SUM(SUM(sh.miktar * u.birim_fiyat)) OVER () * 100 <= 95 THEN 'B'
        ELSE 'C'
    END AS abc_sinifi
FROM urunler u
JOIN stok_hareketleri sh ON u.urun_id = sh.urun_id
WHERE sh.hareket_tipi = 'cikis'
  AND sh.tarih >= CURRENT_DATE - INTERVAL '12 months'
GROUP BY u.urun_kodu, u.urun_adi
ORDER BY toplam_deger DESC;

def sapma_alarmi_kontrol(sayim_sonuclari, bildirim_servisi):
    kritik_esik = Decimal("5")   # %5 üzeri kritik
    uyari_esik = Decimal("2")    # %2 üzeri uyarı

    for sonuc in sayim_sonuclari:
        if sonuc.sapma_orani > kritik_esik:
            bildirim_servisi.gonder(
                kanal="envanter-kritik",
                mesaj=f"KRITIK SAPMA: {sonuc.urun_kodu} - "
                      f"Sistem: {sonuc.sistem_miktari}, "
                      f"Sayim: {sonuc.sayilan_miktar}, "
                      f"Sapma: %{sonuc.sapma_orani:.1f}",
                oncelik="yuksek"
            )
        elif sonuc.sapma_orani > uyari_esik:
            bildirim_servisi.gonder(
                kanal="envanter-uyari",
                mesaj=f"UYARI: {sonuc.urun_kodu} - Sapma: %{sonuc.sapma_orani:.1f}",
                oncelik="normal"
            )