Jinsi ya Kufanya Mapitio Yaliyopangwa ya Git na Misingi ya Msimbo kwa Jev Review

Jev Review Hufanya Nini

Jev Review ni mtiririko mdogo wa ukaguzi wa msimbo uliojengwa kwa kutumia TypeSafe Jev. Unaweza kukagua tofauti ya Git au kuchanganua kila faili ya msimbo wa chanzo ambayo haijapuuzwa ndani ya eneo lililochaguliwa, kisha kuwasilisha matokeo kwenye dashibodi tulivu ya ndani.

Mtiririko huu huweka uratibu na sera kwenye msimbo wa programu, huku ukitumia Jev kwa hukumu zenye mipaka na muundo maalum. Matokeo yamekusudiwa kuwa vidokezo vya ukaguzi badala ya uthibitisho wa moja kwa moja kwamba kasoro ipo.

Jinsi Mtiririko wa Ukaguzi Unavyofanya Kazi

Jev Review hufuata mchakato wa hatua kadhaa ulioundwa kupunguza eneo la umakini kabla ya kugawa athari:

1. Jenga matriki ya hatari.
2. Chagua na pima wasifu wa faili.
3. Chagua ushahidi unaohusiana.
4. ainisha utaratibu wa msingi.
5. Pima ukali.
6. Elekeza matokeo yaliyochaguliwa kwa mkaguzi inapohitajika na mtiririko wa kazi.

Mkaguzi huchunguza usahihi, usalama, kutegemeka, uoanifu, na ufunikaji wa majaribio. Anapohukumu mapengo ya majaribio, anaweza kutumia majaribio yaliyobadilishwa au yanayohusiana kama muktadha. Pia huchagua vipande halisi vya diff au maeneo ya msimbo wa chanzo kabla ya kupima athari, huku akitumia vidokezo vya muundo, mifano kinzani, mipaka ya maamuzi, vizingiti, na sera ya mtiririko wa kazi.

Mahitaji ya Awali na Usakinishaji

Kabla ya kuanza, sakinisha Node.js 24 au toleo jipya zaidi pamoja na Git. Pia unahitaji ufunguo wa API wa TypeSafe.

Clone au pata mradi kwa njia nyingine, kisha sakinisha utegemezi wake:

npm install

Unda faili la mazingira kutoka kwenye mfano uliotolewa:

cp .env.example .env

Fungua .env na uongeze ufunguo wako wa API:

TYPESAFE_API_KEY=your_api_key

Usifichue faili hili kupitia dashibodi. Jev Review hufunga dashibodi kwenye 127.0.0.1 na haitoi faili za mazingira.

Kagua Git Diff ya Sasa

Ili kuchapisha ukaguzi wa Git diff ya sasa kama JSON, endesha amri ya ukaguzi wa mabadiliko na utoe njia ya kuelekea kwenye hazina ya Git:

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

Hali hii ni muhimu unapotaka maoni yanayolenga mabadiliko yaliyopo sasa kwenye hazina.

Ili kuhifadhi matokeo kwa ajili ya kuyaangalia baadaye kwenye dashibodi, tumia toleo la kuhifadhi:

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

Changanua Msingi Mzima wa Msimbo

Kwa ukaguzi mpana zaidi, changanua kila faili ya msimbo wa chanzo ambayo haijapuuzwa chini ya eneo la hazina au kifurushi:

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

Amri hii huchapisha uchanganuzi kamili wa msingi wa msimbo kama JSON. Ili kuhifadhi ripoti kwa ajili ya dashibodi badala yake, endesha:

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

Tumia sehemu ya kuanzia ya ukaguzi wa mabadiliko unapohitaji ukaguzi unaolenga marekebisho yanayoendelea, na utumie sehemu ya kuanzia ya msingi mzima wa msimbo unapotaka kukagua faili za msimbo wa chanzo zinazopatikana katika eneo lililochaguliwa.

Fungua Dashibodi ya Ndani

Baada ya kuhifadhi ukaguzi wa mabadiliko au uchanganuzi wa msingi wa msimbo, anzisha dashibodi ya ndani:

npm run dashboard

Fungua http://127.0.0.1:4317 kwenye kivinjari chako. Ripoti kubwa huonyeshwa katika sehemu zinazoweza kukunjwa, hivyo kurahisisha kuvinjari matokeo bila kuondoka kwenye mazingira ya ndani.

Marejeleo ya Amri

• npm run review:changes -- <path> huchapisha ukaguzi wa diff ya sasa kama JSON.
• npm run review:changes:save -- <path> huhifadhi ukaguzi wa diff ya sasa kwa ajili ya dashibodi.
• npm run review:codebase -- <path> huchapisha uchanganuzi kamili wa msingi wa msimbo kama JSON.
• npm run review:codebase:save -- <path> huhifadhi uchanganuzi kamili wa msingi wa msimbo kwa ajili ya dashibodi.
• npm run dashboard huanzisha dashibodi ya ndani.
• npm run check hukagua aina za mradi, huthibitisha mtiririko wa utegemezi, na hukagua sintaksia ya mteja wa dashibodi.

Elewa Muundo wa Mradi

Utekelezaji umepangwa chini ya src/ katika tabaka zinazotegemea tabaka za chini pekee:

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/

Tabaka hizo zina majukumu yafuatayo:

• Domain: usanidi wa pamoja, aina za ripoti, sera, na uchanganuzi wa diff.
• Adapters: ugunduzi wa Git na wa msimbo kamili wa chanzo, pamoja na kuhifadhi na kupakia ripoti kwa uadilifu.
• Review: mitiririko ya kazi maalum kwa hali, miito ya Jev, na uratibu wa hatua kadhaa.
• CLI: sehemu za kuanzia za ukaguzi na uhifadhi zilizo wazi.
• Dashboard: seva ya HTTP ya ndani pekee na mteja wa kawaida.

Uagizaji hupita chini kutoka cli na dashboard kwenda review, kisha kwenda adapters na domain. Tabaka za dashibodi na CLI haziagizani.

Matumizi ya Juu na Ukaguzi wa Mradi

Endesha ukaguzi wa mradi kabla ya kutegemea mabadiliko ya mtiririko wa kazi au kuchangia marekebisho ya usanifu:

npm run check

Amri hii hukagua aina, huthibitisha mtiririko wa utegemezi, na hukagua sintaksia ya mteja wa dashibodi. Hati ya utegemezi hushindwa inapogundua uagizaji wa kwenda juu, uagizaji kati ya cli na dashboard, au mizunguko ya utegemezi.

Kwa ukaguzi unaolenga zaidi, hifadhi ripoti ya mabadiliko baada ya kufanya mabadiliko husika ya Git na uikague kupitia dashibodi. Kwa uchunguzi mpana zaidi, toa njia ya hazina au upeo wa kifurushi unaotaka kuchanganua. Sehemu hizi mbili za kuanzia hutenganisha mtiririko unaolenga mabadiliko na mtiririko wa chanzo kizima.

Kumbuka kwamba Jev Review ni jaribio la kuunda tathmini zenye aina maalum kwa haraka. Kwa sasa haiunganishi uchunguzi wa mkusanyaji, vichanganua tuli, uorodheshaji wa hazina, au maelezo yanayotengenezwa kiotomatiki. Chukulia matokeo yake kama vidokezo vya ukaguzi wa kibinadamu, hasa kabla ya kufanya mabadiliko yanayotegemea tu ukali ulioripotiwa.

Hitimisho

Jev Review hutoa njia mbili za vitendo za ukaguzi: uchanganuzi unaolenga tofauti ya sasa ya Git na uchanganuzi wa upeo kamili wa msimbo ambao haujapuuzwa. Sakinisha vitegemezi, sanidi TYPESAFE_API_KEY, hifadhi ripoti, na fungua dashibodi ya ndani ili kukagua matokeo yaliyopangwa. Tathmini zake za hatua kwa hatua, uteuzi wa ushahidi, na sera yake ya mtiririko iliyo wazi huifanya kuwa jaribio la ndani lenye manufaa la kupanga ukaguzi wa msimbo unaosaidiwa na AI.