E2e bataryası

E2e bataryası Cluster ERP'nin tarayıcı test koşusudur. Tek bir Node betiği, web-client/_run_battery.mjs, her _e2e_*.mjs süitini sırayla tek bir test örneğine karşı çalıştırır ve bir günlük yazar. Dört ortak modül süitlere hedef adreslerini, test hesaplarını, fikstürlerini ve temiz bir ana ekran yerleşimini verir. Bu sayfa koşuyu ve yalıtım kurallarını açıklar; süitlerin kendileri e2e süit kataloğu sayfasında listelenir.

Kısaca¶

• Koşucu süitleri birbiri ardına çalıştırır, çünkü tek bir sunucuyu ve tek bir veritabanını paylaşırlar (web-client/_run_battery.mjs:15-16).
• Bir süit yalnız N passed, M failed biçiminde, M sıfır olan bir satır yazdığında geçer; bu satırı yazmadan çıkan süit başarısızlık sayılır (web-client/_run_battery.mjs:18-20, web-client/_run_battery.mjs:110-119).
• Hedef adres ve test veritabanı adı tek bir ortak modülden gelir ve varsayılan hedef geliştirme sunucusu değil, yerel test örneğidir (web-client/_shared_e2e_base.mjs:4-17, web-client/_shared_e2e_base.mjs:40-46).
• Ana ekran yerleşimine dokunan süitler, test hesabının yerleşimini kaydedip geri yükleyen arayüz durumu bekçisini kullanmalıdır (web-client/_ui_state_guard.mjs:1-11, tests/test_e2e_db_isolation.py:177-200).
• CI bataryayı çalıştırmaz; batarya bir etiket kesilmeden önce staging düğümünde çalışır (.github/workflows/ci.yml:21-22).

Nasıl çalışır¶

Koşu¶

Akış şeması bir batarya koşusunu gösterir.

flowchart TD
 start["node _run_battery.mjs"] --> list["_e2e_*.mjs topla, --filter ve --exclude uygula, sırala"]
 list --> h1{"GET /health 200 mü?"}
 h1 -->|hayır| stop["çıkış 2: sunucu yanıt vermiyor"]
 h1 -->|evet| loop["sonraki süiti node ile başlat"]
 loop --> wait{"süre dolmadan sonuç satırı yazıldı mı?"}
 wait -->|evet| add["geçen ve kalan sayıları toplama ekle"]
 wait -->|hayır| broken["1 başarısızlık say, süiti adlandır"]
 add --> more{"başka süit var mı?"}
 broken --> more
 more -->|evet| loop
 more -->|hayır| h2{"GET /health 200 mü?"}
 h2 -->|hayır| inc["çıkış 2: koşu sonuçsuz"]
 h2 -->|evet| done["başarısızlık yoksa çıkış 0, varsa 1"]

Düzyazıyla:

1. Koşucu web-client/ içinde adı _e2e_ ile başlayıp .mjs ile biten dosyaları listeler, --filter ve --exclude uygular ve sıralar (web-client/_run_battery.mjs:42-46). --list ile listeyi yazar ve durur (web-client/_run_battery.mjs:48-52).
2. Hedefin /health rotasını sorar. Yanıt 200 değilse hiçbir şey çalıştırmadan 2 koduyla çıkar (web-client/_run_battery.mjs:54-70).
3. Her süiti ayrı bir Node süreci olarak başlatır ve çıktısını toplar (web-client/_run_battery.mjs:78-99). Süre sınırından uzun çalışan bir süit öldürülür ve süresi dolmuş olarak kaydedilir. Varsayılan süre 900 saniyedir; --timeout bunu değiştirir (web-client/_run_battery.mjs:39-41, web-client/_run_battery.mjs:83-93).
4. Sonuç satırını okur, sayıları ekler ve başarısızlığı olan veya sonuç satırı olmayan her süiti adlandırır (web-client/_run_battery.mjs:110-119).
5. Sonunda /health rotasını yeniden sorar, toplamları ve başarısız süitleri günlüğe yazar; hiçbir şey başarısız olmadıysa 0, bir şey başarısız olduysa 1, sunucu yanıt vermeyi bıraktıysa 2 koduyla çıkar (web-client/_run_battery.mjs:124-137).

Koşucu seçenekleri¶

web-client/ içinden tipik bir tam koşu:

node _run_battery.mjs --log battery

Kaynak: web-client/_run_battery.mjs:8-13.

Ortak temel modül¶

Her süit web-client/_shared_e2e_base.mjs modülünü import eder (197 süitin 197'si, grep -L ile sayıldı). Sağladıkları:

Doğrudan veritabanı yardımcılarının kullandığı parolalar ortam değişkenlerinden gelir; değerleri güvenlik ifşa politikası gereği verilmez.

Arayüz durumu bekçisi¶

Ana ekran yerleşimi sunucudaki kullanıcı hesabına aittir (bkz. sunucu tarafı arayüz durumu). guardUiState ayrılmış test hesabıyla oturum açar, yönetici hesabıyla devam etmeyi reddeder, hesabın saklanan yerleşim anahtarlarını kaydeder, bilinen bir test tahtası yazar ve süreç bittiğinde, çökme veya kesinti olsa bile, özgün değerleri geri yükler (web-client/_ui_state_guard.mjs:34-49, web-client/_ui_state_guard.mjs:114-195). Koruduğu anahtarlar DEFAULT_KEYS içinde listelenir (web-client/_ui_state_guard.mjs:106-113). guardUiStateWithApps test tahtasına uygulama kutucukları ekler (web-client/_ui_state_guard.mjs:91-97). 118 süit guardUiState çağırır (grep -l ile sayıldı).

Fikstürler¶

web-client/_shared_fixtures.mjs ön koşulları bir kullanıcının yapacağı gibi açık API üzerinden oluşturur ve veri zaten varsa hiçbir şey yapmaz (web-client/_shared_fixtures.mjs:1-4). Örnekler ensureGroupWorkweek, ensureRfqWithVendor ve ensureRichBom'dur (web-client/_shared_fixtures.mjs:42, web-client/_shared_fixtures.mjs:61, web-client/_shared_fixtures.mjs:266). 18 süit bunu import eder. web-client/_shared_history.mjs analitik süitleri için bugüne göre göreli bir pencerede satış siparişi ve üretim geçmişi kurar (web-client/_shared_history.mjs:1-13, web-client/_shared_history.mjs:22-29). 7 süit bunu import eder.

Neden böyle kurulmuştur¶

Gerekçeler kodda belirtilir. Varsayılan hedef test örneğidir; böylece dikkatsiz bir koşu kullanıcının verisine ulaşamaz (web-client/_shared_e2e_base.mjs:4-13). Veritabanı adı temel adresle birlikte taşınır, çünkü bir süit bir zamanlar test edilenden farklı bir veritabanına yazmıştı (tests/test_e2e_db_isolation.py:3-18). Koşucu takılan bir süiti öldürür; böylece takılan tek bir tarayıcı bir gece koşusunu durdurmaz (web-client/_run_battery.mjs:75-77). report yazmayı bekler, çünkü process.exit() yük altında bir boruda sonuç satırlarını kaybetmişti (web-client/_shared_e2e_base.mjs:263-276).

Kurallar ve sınırlar¶

tests/test_e2e_db_isolation.py her süiti metin olarak okur ve şu kuralları uygular:

Yedi süit kendi sunucusunu başlatır ve kendi sunuculudur (grep -l CLUSTER_ERP_SERVER_PORT ile sayıldı): _e2e_operator_console.mjs, _e2e_residency.mjs, _e2e_sep_companies.mjs, _e2e_sep_roles.mjs, _e2e_tenant_isolation.mjs, _e2e_tenant_regions.mjs ve _e2e_tenant_signup.mjs. Koşucu yorumu, batarya uzak bir düğüme karşı çalıştığında bunların ve bölge süitinin dışarıda bırakıldığını söyler (web-client/_run_battery.mjs:35-37).

Diğer parçalarla etkileşim¶

Batarya çalışan bir test örneği ister; sunucunun nasıl başlatılacağı yerel geliştirme kurulumu sayfasındadır. Staging'den üretime terfi batarya sonucunu kullanır; bkz. ortamlar ve terfi. pytest yalıtım bekçisi, batarya çalışmasa da CI'da çalışır (.github/workflows/ci.yml:124).

Sınırlar ve açık noktalar¶

• web-client/ klasöründe her tarihsel koşu için bir tane olmak üzere eski numaralı PowerShell koşu betikleri ve geçmiş koşuların birçok günlük dosyası da vardır. Koşucu başlığı, bu koşu başına betiklerin yerini aldığını söyler (web-client/_run_battery.mjs:5-6). Güncel yöntemin parçası değildirler ve tek tek anlatılmazlar.
• Koddan belirlenemedi: bataryanın bir zamanlaması. .github/workflows/ veya deploy/ içinde _run_battery.mjs için bir zamanlayıcı girdisi yoktur.

Tanıtılan terimler¶

İlgili sayfalar¶

• Katkı
• E2e süit kataloğu
• Python testleri
• Geliştirici araçları ve betikleri
• Kullanıcı arayüz durumu

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.