Hər pull request-də təcrübəli bir memar.

ArchPilot hər pull/merge request açılan anda işə düşür, dəyişən kodu memarlıq qaydalarınıza görə oxuyur və düzəlişi birbaşa sətir içi rəy şərhi kimi qoyur.

Bizimlə əlaqə Demo planlaşdır

İşləyən bir quraşdırmadan ekranlar

Bir merge request-in yolu

CI-niz ilə AppArch paneli arasında altı addım; hər ikisi sizin şəbəkənizdədir. Depo heç vaxt yüklənmir, yalnız tapıntılar ötürülür.

CI və Git
Merge request açılır

Yeni MR və ya ona yeni push pipeline-ınızı başladır.
CI və Git
Analizator job-u başlayır

Qayda dəstini paneldən, layihə və iş sahəsi ayarları tətbiq olunmuş halda çəkir.
CI və Git
Yalnız dəyişən fayllar oxunur

Baxış rejimində analizator əvvəlcə dəyişən faylları müəyyən edir və yalnız onları oxuyur.
AppArch paneli
Tapıntılar panelə gedir

Qayda, fayl, sətir və mesaj panelə gedir; deponun özü heç vaxt yüklənmir.
AppArch paneli
Yeni, təkrar və ya düzəldilib

Panel əvvəlki işləmə ilə müqayisə edir: yeni tapıntıya şərh yazılır, təkrarlanana yenidən yazılmır, düzələn həll olunur.
CI və Git
Şərhlər və xülasə MR-a düşür

Dəqiq sətirlərdə sətiriçi şərhlər və MR təsvirində cəmləri göstərən AppArch bölməsi.

İstəyə bağlı qapı: paneldə fail-on ciddilik dərəcəsi seçin; tapıntı ona çatanda job nəticələr göndərildikdən sonra 4 kodu ilə çıxır və pipeline qırmızı olur.

Bir şərhin anatomiyası

Hər şərh eyni beş suala cavab verir və dörd Git provayderində eyni görünür.

AP ArchPilot src/Orders/OrderService.cs

41public Order Get(Guid id)

42using var conn = new SqlConnection(_cs);2

1XətaDomain qatı infrastrukturdan asılı olmamalıdır

3OrderService birbaşa SqlConnection ilə danışır; domain artıq verilənlər bazası sürücüsündən asılıdır. Biznes qaydaları çətin test olunur və bir saxlama yerinə bağlanır.

4Təklif: Məlumat girişini repository interfeysinin arxasına keçirin və servisə inject edin.

5Qayda təfərrüatları

Qayda və ciddilik

Hansı qayda və nə qədər ciddi. Ciddilik balı və istəyə bağlı qapını müəyyən edir.
Dəqiq sətir

Şərh qaydanı pozan sətirdə durur, heç vaxt onun üstündəki annotasiyada.
Niyə vacibdir

Əsaslandırma; beləliklə düzəliş təxmin deyil, qərar olur.
Təklif

Nəyin dəyişməli olduğu, analizatorun təklif etdiyi kimi.
Qayda təfərrüatları

Qaydanın öz sənəd səhifəsinə keçid.

Yalnız dəyişdirdiyiniz sətirlər

Eyni fayldakı köhnə borcu ArchScan yenə ölçür, amma merge request-inizdə baxış səs-küyünə çevrilmir.

Yeni pozuntu: şərh yazıldı
Mövcud borc: şərh yoxdur

Bir tapıntının merge request üzərindəki həyatı

Hər tapıntıya bir şərh, ilk push-dan sonuncuya qədər. Tapıntı bir-bir bağlanır: düzəldilərək və ya bir şəxs tərəfindən.

TapıldıOnu gətirən push: bir sətiriçi şərh.
Hələ də varSonrakı push-lar: şərh qalır, təkrarı yazılmır.
DüzəldildiSətir artıq qaydanı pozmur: şərh həll olunur.

Əl ilə bağlandıBir şəxs bağlayır: düzəldilmiş deyil, rədd edilmiş sayılır.

Dörd Git provayderi, tək davranış

Şərhlər standart inteqrasiya istifadəçisindən və ya workspace-ə xüsusi təyin edilmiş botdan göndərilir.

GitHub GitLab Bitbucket Azure DevOps

Qapağın altında nələr var?

ArchPilot linter deyil; komandanızın axınına uyğunlaşan, səs-küy yaratmayan bir memar kimi davranır.

Sətiriçi inceleme şərhləri

Tapıntı tam aidiyyəti olan sətrə düşür - nəyin niyə səhv olduğunu və təklif edilən düzəlişi, eynilə insan reviewer kimi izah edir. Müzakirə üçün thread-ə cavab yaza bilərsiniz.

Diff-yönümlü analiz

Yalnız həmin PR/MR-də dəyişən kod yoxlanılır. Köhnə texniki borc səs-küyə çevrilmir; komanda yalnız hazırda gətirdiyi riskə fokuslanır.

Təkrarsız & avtomatik həll

Şərhlər bir marker ilə açarlanır: eyni tapıntı hər push'da yenidən yazılmır, düzəldilən pozuntular avtomatik bağlanır. PR təmiz və oxunaqlı qalır.

Təyin edilmiş bot hesabı + şərh dili

Şərhlər standart inteqrasiya istifadəçisindən və ya workspace'ə xüsusi təyin edilmiş bot hesabından göndərilir. Şərh dilini workspace səviyyəsində seçirsiniz (TR/EN).

İstəyə bağlı manual baxış

Müəyyən bir MR-ı paneldən əl ilə işə salın. ArchPilot əvvəlcə girişi yoxlayır ("oxuya bilirəmmi?"), sonra yoxlamanı sizin CI xəttinizdə icra edir.

Tərtibatçı sinxronizasiyası & xal

Git üzvləri və MR müəllifləri avtomatik sinxronlaşdırılır; servis/bot hesabları avtomatik işarələnir (əl ilə də redaktə edilir). Hər developer üçün ArchPilot əsaslı bir bal formalaşır.

Layihə/workspace qayda override-ı

Qaydaları layihə və ya workspace səviyyəsində aktivləşdirin, söndürün və ya tənzimləyin. Paneldən söndürdüyünüz qaydalar bota heç çatmır - yanlış pozitiv yoxdur.