Sorun Giderme

"results.json bulunamadı"

generate-ci-report.mjs, run-ci.mjs çıktısına ihtiyaç duyar:

node ci/scripts/run-ci.mjs
node ci/scripts/generate-ci-report.mjs

Bir faz BLOCKED görünüyor

Çalışma dizini bulunamamıştır (backend / dashboard). IQV_PROJECT_ROOT değişkenini repo köküne ayarlayın.

MongoDB / MinIO testleri skipped

Test guard'ları TEST_MONGODB_HOST / TEST_MINIO_ENDPOINT yoksa gerçek servise bağlanmaz ve testi atlar. CI compose veya Actions servisleri çalışıyorsa bu değişkenler ayarlıdır. Yerelde Docker'sız çalıştırıyorsanız atlama beklenen davranıştır ve rapora Normal İyileştirme olarak düşer.

Frontend testleri zaman aşımına uğruyor

Component testleri antd render + userEvent nedeniyle ağırdır. Az çekirdekli makinelerde --maxWorkers=2 bile yetmeyebilir:

IQV_CI_PHASE_TIMEOUT_MS=3600000 node ci/scripts/run-ci.mjs --only=frontend-tests

Zaman aşımı exit code 124 ile kaydedilir; raporda gerçek hatadan ayırt edilebilmesi için timedOut: true alanı tutulur.

ESLint kırmızı ama CI yeşil

Beklenen davranıştır: ESLint uyarı seviyesindedir ve sürümü durdurmaz (bkz. quality-policy.md). Düzeltmek için:

cd "dashboard" && npm run lint:fix

Güvenlik taraması yanlış pozitif verdi

Test dosyaları bilerek sahte sır kullanır. Tarayıcı şu işaretleyicileri içeren satırları yok sayar: test-only, <REDACTED>, process.env, @host (sahte konak), .invalid (RFC 2606) ve example.com/org/net.

Muafiyet dosya bazında değil satır bazındadır — bir test dosyası tümüyle taramanın dışında bırakılmaz. Yeni bir sahte değer ekliyorsanız yukarıdaki işaretleyicilerden birini kullanın; örneğin smtp.example.com veya kullanici@iqv.invalid.

Docker Desktop kapalı

docker compose komutları çalışmaz. Docker'sız yol için local-run.md bölümüne bakın; Docker yokluğu kod hatası değildir.

Rapor "0 puan" gösteriyor

Bir kategoride çalışmış hiçbir faz yoksa puan 0'dır — bu bilinçli bir tasarımdır. Kanıt üretilmeden puan verilmez. results.json içindeki ilgili fazın status alanını kontrol edin.