Architecture: projeye ait kaynak destekli bileşen haritası

Labs → Architecture, erişebildiğiniz projelerin mimari analizini görüntüler. Sayfayı açmak için projects.read, yeni analiz oluşturmak veya mevcut analizi yenilemek için projects.write gerekir. Bu alan Labs menüsündedir; diğer kapalı Labs bağlantıları (Live PoC, Attack Sim, Flow Graph, Intelligence) güncel müşteri akışları değildir.

İlk haritayı oluşturma

1. Önce bir proje ekleyin. Labs → Architecture sayfasında Select a project… listesinden projeyi seçin.
2. Önceden analiz edilmiş ve önbelleğe alınmış bir harita varsa açılır. No Cached Architecture Analysis görünüyorsa yazma yetkili kullanıcı Analyze architecture basmalıdır.
3. İş sıraya alınır; planning, reducing, analysing, verifying, synthesising ve reviewing aşamaları, yüzde ilerleme ve varsa işlenen dosya/kapsam sayıları görünür. Analiz depo büyüklüğü ve model kapasitesine göre birkaç dakika sürebilir.
4. Cancel etkinse süren işi iptal edebilirsiniz. Hata sonrası Retry safely veya Start a fresh analysis gösteriliyorsa ekrandaki nedene göre deneyin. Son başarılı harita hata anında okunabilir kalabilir; onu yeni sonuç gibi yorumlamayın.
5. Kaynak revizyonu analiz sırasında değişirse yeni analiz başlatın. Kaynak checkout, model veya kapasite sorunlarında sayfadaki hata kodunu yöneticiyle paylaşın.

Haritayı inceleme

• Güncel AI graph v2'de L0 overview tüm sistem ilişkisini, L1 scope belirli depo kapsamını gösterir. Architecture scope listesinden kapsam seçin; bileşen düğümüne basıp açıklama, teknoloji, doğrulama durumu, güven düzeyi ve dosya/satır kaynak kanıtını okuyun.
• Search all components… etiket, tür, teknoloji, kapsam ve kanıt yolunda arar. Sonuçtan düğüm seçmek ilgili kapsamı da açar.
• Düğüm ve bağlantı kanıtı ayrı gösterilir. Uncertain findings ve düşük güven değerleri doğrudan kaynak doğrulaması yerine geçmez. Eksik kanıtı mimari olgu olarak kabul etmeden önce dosyayı inceleyin.
• Eski grafik biçiminde All Layers ile Entry Points, Auth & Middleware, Controllers, Services ve Models katmanlarını filtreleyin; Vulnerable Only düğmesi bulguyla işaretli bileşenleri bırakır. Düğüme basarak dosya konumunu görün; View Findings ilgili dosyanın bulgularına gider.
• Grafik yakınlaştırma, uzaklaştırma ve sürükleme denetimleriyle gezilir. Filtre ya da düğüm seçimi kaynağı veya projeyi değiştirmez.

Güncelleme ve geçmiş karşılaştırması

1. Yeni depo durumu için Full re-analysis kullanın. Bu işlem mevcut haritaya ait kaynak doğrulamasını yeniden yapar ve projects.write gerektirir.
2. AI graph v2'de bir L1 kapsamını seçip Refresh scope ile yalnız o kapsamın kanıtını yeniden seçip doğrulayın. Deep pass aynı kapsam için daha büyük açık AI kanıt/çağrı bütçesi kullanır. Seçenekler tarihsel snapshot görüntülenirken kapalıdır.
3. History açıp Architecture snapshot listesinden değişmez önceki analizi seçin. Return to current ile güncele dönün.
4. En az iki snapshot varsa Semantic graph diff içindeki From ve To zamanlarını seçin. Eklenen, kaldırılan ve değişen kapsam/bileşen/ilişkileri; kaynak revizyonunun değişip değişmediğini inceleyin.

Bir bulgu mimari bileşen olarak kendiliğinden oluşturulmaz. Harita yoksa No Architecture Data / No Cached Architecture Analysis mesajı görünür; bir projede bulgu olması tek başına harita üretmez.

Sık karşılaşılan durumlar

Belirti	İşlem
Analyze düğmesi yok	projects.write yetkisi olan kullanıcıdan analiz isteyin.
Eski harita görünüyor	Kaynak revizyonunu ve snapshot zamanını kontrol edip tam analizi yenileyin.
Scope refresh reddedildi	Önce geçerli tam analiz oluşturun; seçili kapsamın halen var olduğundan emin olun.
“Source changed”	Analiz sırasında depo değişmiştir; yeni tam analiz başlatın.
İkinci snapshot karşılaştırılamıyor	Semantik fark için en az iki kayıtlı analiz gerekir.