Jev Review کے ساتھ منظم Git اور کوڈ بیس جائزے کیسے کریں

Jev Review کیا کرتا ہے

Jev Review ایک مختصر کوڈ ریویو ورک فلو ہے جو TypeSafe Jev کے ساتھ بنایا گیا ہے۔ یہ Git diff کا جائزہ لے سکتا ہے یا منتخب دائرۂ کار میں موجود ہر ایسی سورس فائل کو اسکین کر سکتا ہے جسے نظر انداز نہیں کیا گیا، پھر نتائج ایک سادہ مقامی ڈیش بورڈ میں دکھاتا ہے۔

یہ ورک فلو آرکیسٹریشن اور پالیسی کو ایپلیکیشن کوڈ میں رکھتا ہے، جبکہ محدود اور منظم فیصلوں کے لیے Jev استعمال کرتا ہے۔ نتائج کو ریویو کے اشاروں کے طور پر سمجھنا چاہیے، نہ کہ اس قطعی ثبوت کے طور پر کہ کوئی خرابی موجود ہے۔

ریویو ورک فلو کیسے کام کرتا ہے

Jev Review ایک مرحلہ وار عمل کی پیروی کرتا ہے جو اثر کا تعین کرنے سے پہلے توجہ کو محدود کرنے کے لیے بنایا گیا ہے:

1. خطرات کی میٹرکس بنائیں۔
2. فائل پروفائلز منتخب کر کے ان کے اسکور مقرر کریں۔
3. متعلقہ شواہد منتخب کریں۔
4. بنیادی طریقۂ کار کی درجہ بندی کریں۔
5. شدت کا اسکور مقرر کریں۔
6. جب ورک فلو کے مطابق ضرورت ہو تو منتخب نتائج کو ریویوئر کے پاس بھیجیں۔

ریویوئر درستگی، سیکیورٹی، قابلِ اعتماد کارکردگی، مطابقت، اور ٹیسٹ کوریج کا جائزہ لیتا ہے۔ ٹیسٹ کی کمیوں کا جائزہ لیتے وقت یہ تبدیل شدہ یا متعلقہ ٹیسٹس کو سیاق و سباق کے طور پر استعمال کر سکتا ہے۔ اثر کا اسکور مقرر کرنے سے پہلے یہ ٹھوس diff حصے یا سورس کے مقامات بھی منتخب کرتا ہے، جبکہ منظم اشارے، جوابی مثالیں، فیصلہ کن حدود، حدیں، اور ورک فلو پالیسی لاگو کرتا ہے۔

ضروریات اور انسٹالیشن

شروع کرنے سے پہلے Node.js 24 یا بعد کا ورژن اور Git انسٹال کریں۔ آپ کو ایک TypeSafe API key بھی درکار ہوگی۔

پروجیکٹ کو کلون کریں یا کسی اور طریقے سے حاصل کریں، پھر اس کی dependencies انسٹال کریں:

npm install

فراہم کردہ مثال سے environment فائل بنائیں:

cp .env.example .env

.env کھولیں اور اپنی API key شامل کریں:

TYPESAFE_API_KEY=your_api_key

اس فائل کو ڈیش بورڈ کے ذریعے ظاہر نہ کریں۔ Jev Review ڈیش بورڈ کو 127.0.0.1 سے منسلک کرتا ہے اور environment فائلیں فراہم نہیں کرتا۔

موجودہ Git Diff کا ریویو

موجودہ Git diff کا ریویو JSON کے طور پر پرنٹ کرنے کے لیے change-review کمانڈ چلائیں اور Git repository کا راستہ فراہم کریں:

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

یہ موڈ اس وقت مفید ہے جب آپ repository میں موجودہ تبدیلیوں پر مرکوز رائے چاہتے ہوں۔

نتیجہ بعد میں ڈیش بورڈ میں دیکھنے کے لیے محفوظ کرنے کی خاطر save variant استعمال کریں:

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

مکمل کوڈ بیس اسکین کریں

وسیع تر ریویو کے لیے repository یا package scope کے تحت موجود ہر ایسی سورس فائل اسکین کریں جسے نظر انداز نہیں کیا گیا:

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

یہ کمانڈ مکمل codebase scan کو JSON کے طور پر پرنٹ کرتی ہے۔ رپورٹ کو ڈیش بورڈ کے لیے محفوظ کرنے کے بجائے یہ چلائیں:

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

جب آپ کو فعال تبدیلیوں کا مرکوز ریویو درکار ہو تو change-review entry point استعمال کریں، اور جب منتخب دائرۂ کار میں دستیاب سورس فائلوں کا جائزہ لینا ہو تو complete-codebase entry point استعمال کریں۔

مقامی ڈیش بورڈ کھولیں

change review یا codebase scan محفوظ کرنے کے بعد مقامی ڈیش بورڈ شروع کریں:

npm run dashboard

اپنے براؤزر میں http://127.0.0.1:4317 کھولیں۔ بڑی رپورٹس کو کھلنے اور بند ہونے والے حصوں میں دکھایا جاتا ہے، جس سے مقامی ماحول سے باہر جائے بغیر نتائج میں نیویگیٹ کرنا آسان ہو جاتا ہے۔

کمانڈ ریفرنس

• npm run review:changes -- <path> موجودہ diff کا ریویو JSON کے طور پر پرنٹ کرتی ہے۔
• npm run review:changes:save -- <path> موجودہ diff کا ریویو ڈیش بورڈ کے لیے محفوظ کرتی ہے۔
• npm run review:codebase -- <path> مکمل codebase scan کو JSON کے طور پر پرنٹ کرتی ہے۔
• npm run review:codebase:save -- <path> مکمل codebase scan ڈیش بورڈ کے لیے محفوظ کرتی ہے۔
• npm run dashboard مقامی ڈیش بورڈ شروع کرتی ہے۔
• npm run check پروجیکٹ کی type checking کرتی ہے، dependency flow کی تصدیق کرتی ہے، اور ڈیش بورڈ کلائنٹ کی syntax checking کرتی ہے۔

پروجیکٹ کی ساخت سمجھیں

عمل درآمد src/ کے تحت ان تہوں میں منظم ہے جو صرف نچلی تہوں پر منحصر ہیں:

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/

تہوں کی ذمہ داریاں یہ ہیں:

• Domain: مشترکہ configuration، رپورٹ کی اقسام، پالیسی، اور diff parsing۔
• Adapters: Git اور مکمل سورس کی دریافت، نیز رپورٹس کو ایٹامک طریقے سے محفوظ اور لوڈ کرنا۔
• Review: موڈ کے لحاظ سے ورک فلو، Jev calls، اور مرحلہ وار orchestration۔
• CLI: واضح ریویو اور save entry points۔
• Dashboard: صرف مقامی HTTP server اور سادہ کلائنٹ۔

Imports cli اور dashboard سے نیچے کی سمت review، پھر adapters اور domain کی طرف جاتی ہیں۔ ڈیش بورڈ اور CLI تہیں ایک دوسرے کو import نہیں کرتیں۔

اعلیٰ استعمال اور پروجیکٹ چیکس

ورک فلو میں تبدیلی پر انحصار کرنے یا آرکیٹیکچرل ترمیم میں حصہ لینے سے پہلے پروجیکٹ چیکس چلائیں:

npm run check

یہ کمانڈ اقسام کی جانچ کرتی ہے، انحصاری بہاؤ کی تصدیق کرتی ہے، اور ڈیش بورڈ کلائنٹ کے نحوی ڈھانچے کی جانچ کرتی ہے۔ انحصار کی اسکرپٹ اس وقت ناکام ہو جاتی ہے جب اسے اوپر کی سمت درآمدات، cli اور dashboard کے درمیان درآمدات، یا انحصار کے چکروں کا پتا چلتا ہے۔

زیادہ مرکوز جائزوں کے لیے، متعلقہ Git تبدیلیاں کرنے کے بعد تبدیلیوں کی رپورٹ محفوظ کریں اور ڈیش بورڈ کے ذریعے اس کا معائنہ کریں۔ وسیع تر تحقیقات کے لیے، اس ریپوزٹری یا پیکیج کے دائرہ کار کا راستہ فراہم کریں جسے آپ اسکین کرنا چاہتے ہیں۔ یہ دونوں داخلی راستے تبدیلی پر مبنی اور مکمل ماخذ والے ورک فلو کو الگ رکھتے ہیں۔

یاد رکھیں کہ Jev Review تیز رفتار، ٹائپ شدہ فیصلوں کو یکجا کرنے کا ایک تجربہ ہے۔ یہ فی الحال کمپائلر تشخیصی معلومات، جامد تجزیہ کاروں، ریپوزٹری اشاریہ سازی، یا تیار کردہ وضاحتوں کے ساتھ مربوط نہیں ہے۔ اس کے نتائج کو انسانی جائزے کے لیے اشاروں کے طور پر لیں، خاص طور پر اس سے پہلے کہ صرف رپورٹ کردہ شدت کی بنیاد پر تبدیلیاں کریں۔

نتیجہ

Jev Review جائزے کے دو عملی طریقے فراہم کرتا ہے: موجودہ Git ڈِف کا مرکوز تجزیہ، اور مکمل غیر نظرانداز شدہ کوڈ بیس کے دائرہ کار کا اسکین۔ انحصارات انسٹال کریں، TYPESAFE_API_KEY کو ترتیب دیں، رپورٹ محفوظ کریں، اور ساخت یافتہ نتائج کا معائنہ کرنے کے لیے مقامی ڈیش بورڈ کھولیں۔ اس کے مرحلہ وار فیصلے، شواہد کا انتخاب، اور واضح ورک فلو پالیسی اسے AI کی مدد سے کوڈ کے جائزے کو منظم کرنے کے لیے ایک مفید مقامی تجربہ بناتے ہیں۔