Amaç

Bu sayfa, Rentiva'nın test ekosistemini (PHPUnit konfigürasyonu, CI matrisi, Docker wrapper'ları ve özel Listener yapısı) geliştirenlere açıklar.

Test Suite Mimarisi

Rentiva, WordPress için özelleştirilmiş bir PHPUnit 9.6 altyapısı kullanır. Bu altyapı, testlerin hem hızını hem de veritabanı temizlik kalitesini garanti eden özel araçlarla güçlendirilmiştir.

---

Mevcut Test Baseline

Sürüm	Test	Assertion	Atlanmış	Tarih
v4.23.0 (guncel)	567	2036	4	26.03.2026
v4.22.2	562	2024	4	25.03.2026
v4.22.0 (T8+T9 milestone)	563	2022	—	24.03.2026
v4.21.27+T8	517	1963	—	24.03.2026
v4.21.27	463	1901	—	—
v4.20.0 (ilk kilitli temel)	268	1379	—	—

---

Test Kategorileri

Shortcode Render Testleri

13 adet shortcode render test dosyası ile tum shortcode'larin çıktısi dogrulanir. Bu testler CAM pipeline'i uctan uca kapsar: AllowlistRegistry -> CanonicalAttributeMapper -> shortcode render().

SettingsSanitizer Testleri

4 adet SettingsSanitizer test dosyası ile ayar değerlerinin sanitizasyonu ve validasyonu test edilir.

AllowlistRegistry Testleri

199 benzersiz attribute key, 19 TAG_MAPPING girişi ve enum değerlerinin tutarliligi dogrulanir.

KeyNormalizer Testleri

27 test, 32 assertion — camelCase/snake_case dönüşumu, alias çözümlemesi ve edge case'ler.

---

CI Matrisi

CI pipeline'i asagidaki matris uzerinde çalışır:

	PHP 8.1	PHP 8.2	PHP 8.3
WP 6.7	PHPUnit	PHPUnit	PHPUnit
WP latest	PHPUnit	PHPUnit + PHPCS	PHPUnit

• Toplam: 6 paralel job (PHP 8.1/8.2/8.3 x WP 6.7/latest)
• PHPCS gate: PHP 8.2 uzerinde composer phpcs komutuyla çalışır ve zorunlu gecit noktasidir
• Tum job'lar başarılı olmadan merge yapilamaz

---

Core Bileşenler

1. PHPUnit Konfigurasyonu (phpunit.xml)

Test süreci tests/bootstrap.php üzerinden WordPress test ortamini ayaga kaldirir.

• Coverage: ./src/ dizinini %100 kapsama hedefiyle izler.
• Multisite: Standart olarak 0 (false) ayarlidir.

2. MHM Test Listener (MHM_Test_Listener)

"Hybrid Reset" stratejisini uygulayan ozel bir dinleyicidir.

• Gorev: Izole edilmis test kosturmalarinda (MHM_TEST_IS_ISOLATED) oluşturulan gecici tabloları (wptests_ prefix) otomatik olarak temizler.
• Güvenlik: Sadece kontrollu pattern'e sahip tabloları siler (DROP TABLE IF EXISTS).

---

Docker ve CLI Kullanimi

Testler, Windows/MacOS/Linux fark etmeksizin izole bir Docker konteyneri içinde çalıştırilir.

# Tum testleri kostur
npm run test

# Sadece belirli bir grubu kostur
docker exec -it mhm-container vendor/bin/phpunit --group financial

# PHPCS kontrolu (CI gate)
composer phpcs

---

Kapsama Raporu (Code Coverage)

Sistem, kritik finansal ve cekirdek (Core) moduller için kati kapsama kuralları uygular.

• HTML Report: build/coverage dizininde üretilir.
• Kritik Moduller: src/Core/Financial ve src/Core/Security modulleri her zaman denetlenir.

---

Test Fixtures (Veri Hazirlama)

Test verileri tests/fixtures dizininde tutulur.

• Idempotency: Her test suit öncesi veritabanı temizlendigi için testler birbirine bagimli değildir.
• Isolation: MHM_Test_Listener sayesinde paralel test kosturmalarinda veriler cakismaz.

Bölüm Sonu Özeti

• Test altyapısı PHPUnit 9.6 üzerine kuruludur.
• 567 test, 2036 assertion (v4.23.0 baseline).
• CI matrisi 6 job (PHP 8.1/8.2/8.3 x WP 6.7/latest) + PHPCS gate.
• Hybrid Reset stratejisi ile veritabanı kirliligi onlenir.
• Gelistirme sürecinde npm run test komutu ana doğrulama noktasidir.

Değişiklik Günlüğü

Tarih	Sürüm	Not
27.03.2026	4.23.0	Test baseline v4.23.0 (567/2036/4), CI matrisi (6 job + PHPCS), test kategorileri (shortcode render, sanitizer, allowlist, key normalizer) eklendi.
19.03.2026	4.21.2	PHPUnit 9.6 ve MHM_Test_Listener dokumantasyonu eklendi.