← Tüm projeler
01/ 05Stok & ön muhasebe

Stok Kontrol

Eczane, market, dükkân ve depolar için çok şirketli stok, satış ve ön muhasebe uygulaması. Docker ile Oracle Cloud'da, Cloudflare arkasında yayında.

Stok Kontrol, işletmelerin ürün, stok, satış ve gelir-gider takibini tek yerden yaptığı bir web uygulaması. Uygulamayı baştan sona tek başıma geliştirdim, Docker konteynerlerine taşıyıp kendi sunucumda yayına aldım. Şu an stok.ariftekbas.com adresinde çalışıyor.

Neler yapıyor

  • Ürün yönetimi: birim, alış/satış fiyatı, KDV, asgari ve hedef stok, kategori, tedarikçi ve barkod. Tek tek, toplu tablodan ya da Excel/CSV’den eklenebiliyor
  • Stok hareketleri: alış, satış, iade, fire, sayım farkı ve depolar arası transfer. Her hareket o anki fiyat ve KDV ile saklanıyor, silinmiyor, iptal ediliyor
  • Barkod okutarak kasa gibi çalışan hızlı satış ekranı
  • Barkodla stok sayımı; farklar otomatik düzeltme hareketine dönüşüyor
  • Son kullanma tarihi ve parti takibi; satış en yakın SKT’li partiden düşüyor
  • Çoklu depo, sipariş önerisi ve tedarikçiye göre eksik listesi
  • Gelir/gider takibi, vade ve ödeme durumu; Excel ve PDF raporlar
  • Çok şirketli yapı: her şirketin verisi ayrı, kayıt şirketin davet koduyla
  • Beş farklı rol ile yetki yönetimi ve değişiklik geçmişi (kim, neyi, ne zaman değiştirdi)

Altyapı ve yayın

  • Uygulama dört Docker konteynerinde çalışıyor: PHP 8.2-FPM, Nginx, MySQL 8 ve Redis
  • Konteynerler Oracle Cloud’daki sunucuda Docker Compose ile ayağa kalkıyor; sunucu yeniden başlarsa kendiliğinden açılıyor
  • Trafik Cloudflare üzerinden geliyor: alan adı, HTTPS ve vekil sunucu ayarları Cloudflare arkasında çalışacak şekilde yapıldı
  • Uygulama portu ve veritabanı sadece sunucunun içinden erişilebilir; internete doğrudan açık değil
  • Her konteynerin CPU ve bellek sınırı sunucunun kapasitesine göre ayarlandı

Kod kalitesi

  • 248 otomatik test: şirket izolasyonu, yetkiler, stok tutarlılığı, KDV ve muhasebe kuralları gibi kritik akışları kapsıyor
  • GitHub Actions her push’ta testleri MySQL 8 üzerinde çalıştırıyor
  • Stoğu değiştiren tüm işlemler tek bir servis sınıfından geçiyor; ürün ve depo stoğu her zaman parti katmanlarının toplamına eşit