Jev Review yordamida Git va kod bazasini tizimli ko‘rib chiqish

Jev Review nima qiladi

Jev Review — TypeSafe Jev yordamida yaratilgan kichik kodni ko‘rib chiqish ish jarayoni. U Git diff’ini ko‘rib chiqishi yoki tanlangan qamrovdagi e’tiborga olinmaydigan fayllardan tashqari barcha manba fayllarini skanerlashi, so‘ng natijalarni sokin mahalliy boshqaruv panelida ko‘rsatishi mumkin.

Ish jarayoni orkestratsiya va siyosatni ilova kodida saqlaydi, Jev’dan esa chegaralangan, tuzilmali xulosalar uchun foydalanadi. Topilmalar nuqson mavjudligining qat’iy isboti emas, balki ko‘rib chiqish uchun tavsiyalar sifatida mo‘ljallangan.

Ko‘rib chiqish ish jarayoni qanday ishlaydi

Jev Review ta’sir darajasini belgilashdan oldin e’tiborni toraytirish uchun ishlab chiqilgan bosqichma-bosqich jarayonga amal qiladi:

1. Xavf matritsasini tuzish.
2. Fayl profillarini tanlash va baholash.
3. Tegishli dalillarni tanlash.
4. Asosiy mexanizmni tasniflash.
5. Jiddiylik darajasini baholash.
6. Ish jarayoni talab qilganda tanlangan topilmalarni ko‘rib chiquvchiga yuborish.

Ko‘rib chiquvchi to‘g‘rilik, xavfsizlik, ishonchlilik, moslik va test qamrovini tekshiradi. Testlardagi bo‘shliqlarni baholashda u o‘zgartirilgan yoki bog‘liq testlardan kontekst sifatida foydalanishi mumkin. Shuningdek, ta’sirni baholashdan oldin aniq diff bo‘laklari yoki manba hududlarini tanlaydi hamda tuzilmali ko‘rsatmalar, qarshi misollar, qaror chegaralari, ostonalar va ish jarayoni siyosatini qo‘llaydi.

Talablar va o‘rnatish

Boshlashdan oldin Node.js 24 yoki undan keyingi versiyasini va Git’ni o‘rnating. Shuningdek, sizga TypeSafe API kaliti kerak bo‘ladi.

Loyihani klonlang yoki boshqa usulda oling, so‘ng uning bog‘liqliklarini o‘rnating:

npm install

Atrof-muhit faylini taqdim etilgan namunadan yarating:

cp .env.example .env

.env faylini ochib, API kalitingizni qo‘shing:

TYPESAFE_API_KEY=your_api_key

Bu faylni boshqaruv paneli orqali oshkor qilmang. Jev Review boshqaruv panelini 127.0.0.1 manziliga bog‘laydi va atrof-muhit fayllarini taqdim etmaydi.

Joriy Git diff’ini ko‘rib chiqish

Joriy Git diff’ining JSON formatidagi ko‘rib chiqish natijasini chiqarish uchun o‘zgarishlarni ko‘rib chiqish buyrug‘ini ishga tushiring va Git omboriga yo‘lni ko‘rsating:

npm run review:changes -- /path/to/git/repository

Bu rejim omborda hozir mavjud bo‘lgan o‘zgarishlarga qaratilgan fikr-mulohazani olish uchun foydalidir.

Natijani keyinroq boshqaruv panelida ko‘rish uchun saqlash variantidan foydalaning:

npm run review:changes:save -- /path/to/git/repository

To‘liq kod bazasini skanerlash

Kengroq ko‘rib chiqish uchun ombor yoki paket qamrovi ostidagi e’tiborga olinmaydigan fayllardan tashqari barcha manba fayllarini skanerlang:

npm run review:codebase -- /path/to/git/repository-or-package

Bu buyruq to‘liq kod bazasi skanerlash natijasini JSON formatida chiqaradi. Hisobotni boshqaruv paneli uchun saqlash uchun quyidagini ishga tushiring:

npm run review:codebase:save -- /path/to/git/repository-or-package

Faol o‘zgarishlarni yo‘naltirilgan tarzda ko‘rib chiqish kerak bo‘lganda o‘zgarishlarni ko‘rib chiqish kirish nuqtasidan, tanlangan qamrovdagi mavjud manba fayllarini tekshirish kerak bo‘lganda esa to‘liq kod bazasi kirish nuqtasidan foydalaning.

Mahalliy boshqaruv panelini ochish

O‘zgarishlarni ko‘rib chiqish yoki kod bazasini skanerlash natijasini saqlaganingizdan so‘ng, mahalliy boshqaruv panelini ishga tushiring:

npm run dashboard

Brauzeringizda http://127.0.0.1:4317 manzilini oching. Katta hisobotlar yig‘iladigan bo‘limlarda ko‘rsatiladi, bu esa mahalliy muhitdan chiqmasdan topilmalar bo‘ylab harakatlanishni osonlashtiradi.

Buyruqlar ma’lumotnomasi

• npm run review:changes -- <path> joriy diff ko‘rib chiqilishini JSON formatida chiqaradi.
• npm run review:changes:save -- <path> joriy diff ko‘rib chiqilishini boshqaruv paneli uchun saqlaydi.
• npm run review:codebase -- <path> to‘liq kod bazasi skanerlash natijasini JSON formatida chiqaradi.
• npm run review:codebase:save -- <path> to‘liq kod bazasi skanerlash natijasini boshqaruv paneli uchun saqlaydi.
• npm run dashboard mahalliy boshqaruv panelini ishga tushiradi.
• npm run check loyiha turlarini tekshiradi, bog‘liqliklar oqimini tasdiqlaydi va boshqaruv paneli mijoz kodining sintaksisini tekshiradi.

Loyiha tuzilmasini tushunish

Amalga oshirish src/ ostida faqat quyi qatlamlarga bog‘liq qatlamlar shaklida tashkil etilgan:

src/
  domain/      config.ts, types.ts, patch.ts
  adapters/    git.ts, repository-files.ts
               report-store.ts
  review/      changes.ts, codebase.ts
               *-judgments.ts, workflow.ts
  cli/         review-*.ts, save-*.ts
  dashboard/   server.ts, public/

Qatlamlarning vazifalari quyidagilardan iborat:

• Domain: umumiy konfiguratsiya, hisobot turlari, siyosat va diff tahlili.
• Adapters: Git va to‘liq manbani aniqlash, shuningdek hisobotlarni atomik saqlash va yuklash.
• Review: rejimga xos ish jarayonlari, Jev chaqiruvlari va bosqichma-bosqich orkestratsiya.
• CLI: aniq ko‘rib chiqish va saqlash kirish nuqtalari.
• Dashboard: faqat mahalliy muhitda ishlaydigan HTTP serveri va oddiy mijoz.

Importlar cli va dashboard qatlamlaridan review qatlamiga, undan esa adapters va domain qatlamlariga qarab oqadi. Boshqaruv paneli va CLI qatlamlari bir-birini import qilmaydi.

Ilg‘or foydalanish va loyiha tekshiruvlari

Ish jarayonidagi o‘zgarishga tayanish yoki arxitekturaga oid o‘zgartirish kiritishdan oldin loyiha tekshiruvlarini ishga tushiring:

npm run check

Bu buyruq turlarni tekshiradi, bog‘liqliklar oqimini tasdiqlaydi va dashboard klientining sintaksisini tekshiradi. Bog‘liqliklar skripti yuqoriga yo‘nalgan importlarni, cli va dashboard o‘rtasidagi importlarni yoki bog‘liqliklar sikllarini aniqlasa, xatolik bilan yakunlanadi.

Yanada yo‘naltirilgan ko‘rib chiqishlar uchun tegishli Git o‘zgarishlarini kiritgandan so‘ng o‘zgarishlar hisobotini saqlang va uni dashboard orqali tekshiring. Kengroq tekshiruvlar uchun skanerlamoqchi bo‘lgan repozitoriy yoki paket doirasi yo‘lini kiriting. Ikki kirish nuqtasi o‘zgarishlarga yo‘naltirilgan va to‘liq manba kodi bilan ishlash jarayonlarini alohida saqlaydi.

Jev Review tezkor, tiplashtirilgan xulosalarni birlashtirish tajribasi ekanini unutmang. Hozircha u kompilyator diagnostikasi, statik analizatorlar, repozitoriy indeksatsiyasi yoki avtomatik yaratilgan tushuntirishlar bilan integratsiyalanmagan. Uning xulosalarini inson tomonidan ko‘rib chiqish uchun tavsiyalar sifatida qabul qiling, ayniqsa faqat bildirilgan jiddiylik darajasiga asoslanib o‘zgarishlar kiritishdan oldin.

Xulosa

Jev Review ikkita amaliy ko‘rib chiqish rejimini taqdim etadi: joriy Git diff’ining yo‘naltirilgan tahlili va e’tiborga olinmaydigan fayllardan tashqari to‘liq kod bazasi doirasini skanerlash. Bog‘liqliklarni o‘rnating, TYPESAFE_API_KEY ni sozlang, hisobotni saqlang va strukturaviy xulosalarni tekshirish uchun mahalliy dashboard’ni oching. Uning bosqichma-bosqich xulosalari, dalillarni tanlashi va aniq ish jarayoni siyosati uni sun’iy intellekt yordamidagi kod ko‘rib chiqishni tashkil etish uchun foydali mahalliy tajribaga aylantiradi.