# Kalite kapıları

> AI CodeOps bir değişikliğin yayına alınıp alınamayacağına nasıl karar verir: test sonuçları, yapay zekâ bulgu incelemesi, onaylar ve CI'ınızın çağırabildiği yayın kapısı kontrolü.

Kaynak: https://aicodeops.dev/tr/docs/quality-gates

Her yapay zekâ oturumu bir değişiklikle sona erer: projenizin reposuna karşı bir diff. Bu değişiklik pull request'e dönüşmeden önce AI CodeOps onu kontrol eder. Pull request'i konsoldan açsanız da CI'ınızdan sorsanız da kontroller aynıdır.

## Kapı neleri kontrol eder

Bir değişiklik, şunların tümü sağlandığında **release-ready** (yayına hazır) olur:

- **Testler geçiyor.** Değişikliği yazdıktan sonra oturum, projenizin test komutunu sandbox'ında çalıştırır ve sonucu kaydeder. Başarısız testler değişikliği engeller.
- **Bir test sonucu var.** Bir projede kodu değiştiren bir oturumun sayıları içeren bir test sonucuna ihtiyacı vardır. Onun için hiçbir test çalışmadıysa veya test komutu çalışıp test sayısı bildirmediyse değişiklik engellenir: "The test command ran but reported no test counts, so nothing shows a test passed. Check the project's test command". Kanıt yokluğu, geçti anlamına gelmez. Projenin test paketi yoksa ayarlarından **Don't run tests for this project** seçeneğini açın; ayarlar **Plan → Projects** altındadır ([Projeler](https://aicodeops.dev/tr/docs/projects)). Kapı bu durumda o projeden test sonucu istemez. Kod değiştirmeyen bir oturumdan da test sonucu istenmez.
- **Yapay zekâ bulgu incelemesi tamamlandı.** Bir inceleme adımı diff'i okur ve bulguları kaydeder (security, quality, performance, reliability, test coverage ve diğer kategoriler). Bu inceleme tamamlanamadıysa bulgular bilinmez ve değişiklik bekletilir. Oturum sayfası nedenini söyler: inceleyici zamanında yanıt vermedi, yanıtı bulgu olarak okunamadı veya bütçe incelemeden önce tükendi. Oturumu yeniden çalıştırın (son durumda, bütçeyi artırdıktan sonra).
- **Açık engelleyici bulgu yok.** Önem derecesi **high** veya **critical** olan bulgular, triyajdan geçirilene kadar engeller.
- **Testler, çalıştıkları sürüm için sayılır.** Testleri çalıştıktan sonra biri değişikliği düzenlerse eski sonuç onu ne geçirir ne de engeller: kapı bu sürümün test edilmediğini söyler ve onay yeniden açılır; böylece yayına alınmadan önce bir insan karar verir. Yeni sürümü test etmek için oturumu yeniden çalıştırın.

Onaylar, aynı yol üzerindeki ayrı bir kontroldür. Bkz. [Onaylar ve politikalar](https://aicodeops.dev/tr/docs/approvals-and-policies).

## Nerede görürsünüz

Bir oturumun çalıştırma sayfasını açın. **Quality gates** paneli **Release-ready** veya **Not release-ready** ifadesini, test toplamlarını, her test sonucunu ve değişikliğin henüz hazır olmamasının nedenlerini gösterir. **Findings** paneli her bulguyu önem derecesi, dosyası ve satırıyla listeler.

Çalışma alanı genelindeki test sonuçları ve açık bulgular **Build & Test → Quality** altındadır.

## Bulguları triyajdan geçirin

Her bulgunun bir durumu vardır. Durumu, çalıştırmanın Findings listesindeki açılır menüden değiştirin:

| Durum                                       | Değişikliği engeller mi?     |
| ------------------------------------------- | ---------------------------- |
| open, acknowledged, in progress             | Evet, high veya critical ise |
| fixed, won't fix, false positive, duplicate | Hayır                        |

Bir bulguda **Fix** düğmesini seçerek onu düzelten bir yapay zekâ çalıştırması da başlatabilirsiniz. Bir bulgunun durumunu değiştirmek için triyaj izni olan bir rol gerekir. Owner, Admin, Developer, Member ve Security Admin rollerinde bu izin vardır; Viewer rolünde yoktur.

## Kapı neleri engeller

Bir pull request açmayı seçtiğinizde AI CodeOps şu sırayla kontrol eder:

1. Çalışma alanı politikası. Bir deny kuralı pull request'i durdurur; bir ask kuralı onaylanmış bir inceleme gerektirir.
2. Onay. Reddedilmiş veya bekleyen bir onay onu durdurur.
3. Kalite kapısı. Yayına hazır olmayan bir değişiklik ilk gerekçeleri alır; örneğin "This change isn't release-ready: HIGH security: …".

Aynı kalite kapısı, konsol kendi açtığı bir pull request'i merge etmeden önce yeniden çalışır. Pull request, `codeops/run-<id>` adlı bir branch üzerinde açılır.

## CI için yayın kapısı

**Review & Gate → Release gate** sayfası, bir pull request URL'sini veya commit SHA'sını ona dokunan tüm oturumlar genelinde değerlendirir ve gerekçeleriyle birlikte **Allowed** veya **Denied** sonucunu gösterir. CI'ınız aynı soruyu bir çalışma alanı API anahtarıyla `POST /api/release/check` üzerinden sorabilir. CI kontrolü, çalıştırma başına kapının kullanmadığı seçenekler ekler: zorunlu iş akışları, asgari bir kapsam yüzdesi, izin verilmeyen lisanslar (projenin SBOM'una göre kontrol edilir) ve staging gibi zorunlu bir önceki dağıtım. Bir kapsam alt sınırı bir kapsam sayısı gerektirir: bir alt sınır belirlerseniz ve değişiklik üzerindeki hiçbir test çalıştırması kapsam bildirmediyse kontrol reddeder.

CI kontrolü yukarıdaki test sonucu kuralını da uygular ve test sonucu olmayan oturumları `testEvidenceMissing` alanında listeler. `"blockOnTestFailure": false` göndermek bunu o çağrı için kapatır.

Alanlar ve yanıt [API sayfasındadır](https://aicodeops.dev/tr/docs/api). [CI'da yayın kapısı](https://aicodeops.dev/tr/docs/release-gate-ci) sayfasında GitHub Actions, GitLab CI ve Bitbucket Pipelines için kopyalanacak işler bulunur ve işin nasıl zorunlu bir kontrol yapılacağı gösterilir.

Kapı kontrolünün kendisi çalışamıyorsa, örneğin kısa bir kesinti sırasında, pull request açılmaz: "The release check couldn't run just now." Biraz sonra yeniden deneyin.

## Sonraki adımlar

- [CI'da yayın kapısı](https://aicodeops.dev/tr/docs/release-gate-ci)
- [Onaylar ve politikalar](https://aicodeops.dev/tr/docs/approvals-and-policies)
- [Güvenlik ve SBOM](https://aicodeops.dev/tr/docs/security-and-sbom)
- [Kanıt paketleri](https://aicodeops.dev/tr/docs/evidence-packs)

## Sık sorulan sorular

### Bulgular hâlâ açıkken pull request açabilir miyim?

Yüksek (high) veya kritik (critical) bir bulgu açıkken, testler başarısızken veya yapay zekâ incelemesi tamamlanmamışken hayır. Bulguyu triyajdan geçirin veya oturumu yeniden çalıştırın, ardından pull request'i açın.

### Projemde hiç test yoksa ne olur?

Projenin ayarlarından "Don't run tests for this project" seçeneğini açın. Bu yapılmazsa, kodu değiştiren bir oturumun sayıları içeren bir test sonucuna ihtiyacı vardır. Hiçbir test çalışmadıysa veya test komutu sayı bildirmediyse değişiklik engellenir; çünkü kanıt yokluğu, geçti anlamına gelmez.
