Sorun Giderme¶
Servis healthy olmuyor¶
docker compose ps
docker compose logs --tail=80 backend
/health 200 dönüyor ama veri gelmiyor¶
Backend, MongoDB'ye ulaşamasa da ayağa kalkar (tasarım gereği) ve ilk
sorguda yeniden dener. MONGODB_URI değerini ve MongoDB erişimini kontrol
edin. Veri uçlarında getaddrinfo ENOTFOUND görüyorsanız adres yanlıştır.
Port kullanımda¶
.env içinde FRONTEND_PORT değerini değiştirip ./update.sh --no-pull
çalıştırın.
Update "kaydedilmemiş değişiklikler var" diyor¶
Bu bir korumadır — değişiklikleriniz ezilmesin diye durur. git stash,
git commit yapın ya da ./update.sh --no-pull ile yalnızca yeniden kurun.
Windows'ta betik çalışmıyor¶
powershell -ExecutionPolicy Bypass -File .\install.ps1
Native kip ve kaldırma işlemleri yönetici yetkisi ister.
Docker Desktop hazır değil¶
Betik açılmasını bekler. Uzun sürerse Docker Desktop'ı başlatıp tekrar deneyin.
CI'da npm test takılıyor / zaman aşımına uğruyor¶
Backend testleri MongoDB'ye gerçek bağlantı açmaz — test/env.setup.mjs
zorunlu ortam değişkenlerine (MONGODB_URI, ERP_AUTH_SECRET,
GO_API_BASE_URL) yalnızca readRequired doğrulamasını geçecek zararsız
varsayılanlar atar. Testler yerelde takılıyorsa önce backend/.env
dosyasının test çalıştırmasını etkilemediğinden emin olun.
k6 smoke testi üretime karşı çalıştırılamıyor¶
Bu bilinçli bir güvenlik kapısıdır (assertNonProductionTarget). k6
testleri yalnızca localhost / *.test / *.local / *staging* /
*.internal adreslerini hedefleyebilir.