Sorun Giderme

"Bu işlem için yetkiniz bulunmuyor." (LAN IP ile giriş)

Belirti: http://192.168.x.x:5173/login üzerinden giriş denemesi bu mesajla başarısız oluyor.

Gerçek kök neden: Bir CORS reddi. Backend 403 üretir, arayüz HTTP 403'ü bu mesaja çevirir. Giriş ucu bir auth guard altında değildir.

Çözüm: Geliştirmede özel ağ origin'leri zaten kabul edilir (bkz. Güvenlik / CORS). Üretimde ilgili adresi CORS_ORIGIN listesine ekleyin. origin: '*' yapmayın, IP'yi koda sabit yazmayın.

/health 503 dönüyor

• database: "disconnected" + "Veritabanı bağlantısı yok." → bağlantı hiç kurulmamış.
• "Veritabanına erişilemiyor." → bağlantı kurulmuş ama ping başarısız.

İki farklı mesaj bu iki durumu ayırt etmek için vardır.

Sunucu hiç başlamıyor

MongoDB bağlantısı kurulamazsa HTTP sunucusu hiç başlatılmaz (process.exit(1)). Bu bilinçlidir: yarım ayakta bir servis sağlık kontrolünü yanıltmasın diye port hiç açılmaz.

Sentry'ye olay düşmüyor

1. SENTRY_DSN tanımlı mı? Boşsa Sentry.init hiç çağrılmaz.
2. server.ts içindeki ilk import hâlâ ./instrument mı?
3. instrument.ts içindeki ilk import hâlâ dotenv/config mi?

Docker container "unhealthy"

Backend kontrolü 20 sn start_period sonrası başlar ve 5 ardışık başarısızlık (~75 sn) sonunda unhealthy olur. Önce /health yanıtına, sonra MongoDB erişimine bakın.

Tablo başlıkları kısalıyor / mobil düzen yanlış

Responsive sınıflandırma mantığı ve eşikler için Frontend / Responsive.

CSS kuralı hiç uygulanmıyor

pro-layout'un ürettiği gerçek sınıf adları sürümle değişebilir. Örneğin PageContainer içerik kabı -children-container'dır, -children-content değil. Yanlış sınıf adı kullanan bir kural sessizce etkisiz kalır — !important eklemek bu durumu çözmez.