Defektų fiksavimas

Defektai yra fiksuojami siekiant išsiaiškinti dažniausiai pasitaikančius defektus, kad paskui galima būtų imtis priemonių, kurios apsaugotų nuo jų atsiradimo.

Užfiksuoti defektai Vytautui turi būti pateikiami CSV formato faile, kuriame būtų stulpeliai (šitie yra privalomi, jei yra daugiau, tai jie yra ignoruojami):

• Laikas – defekto aptikimo momentas, formatas: %Y-%m-%d %H:%M:%S;

• Radėjas – defektą radusio nario pilnas vardas ir pavardė, pavyzdžiui „Martynas Budriūnas“;

• Komponentas – sistemos komponentas, kuriame buvo rastas defektas.

• ID – unikalus defekto identifikatorius

• Tipas – defekto tipo numeris (visi tipai turi būti aprašyti lentelėje žemiau);

• Įterptas – ciklas:fazė, kada defektas buvo įterptas;

• Pašalintas – ciklas:fazė, kada defektas buvo pašalintas (bendru atveju, tai yra fazė, kada defektas buvo surastas);

• Trukmė – defekto šalinimo trukmė;

• Aprašymas – trumpas defekto aprašymas.

Defektų tipai:

Numeris	Pavadinimas	Apibūdinimas
10	Dokumentacijos	Funkcija (ar koks nors kitas dokumentuojamas objektas) daro kitką, nei nurodyta dokumentacijoje, arba dokumentacijos nėra iš viso.
20	Modulių sąsajos	Vienas iš jungiamų modulių tikisi kitokios kito modulio elgsenos (arba sąsajos), nei ji yra iš tikrųjų.
30	Jungimo	Vardų kolizijos, taip pat „ld“ klaidos.
40	Naudotojo sąsajos	Neaiškūs, klaidinantys, neišsamūs pranešimai skirti naudotojui. Taip pat pranešimų nebuvimas (apie įvykusias klaidas). Ir visa tai, ką pastebės ŽKS.
50	Tikrinimo	Neapdorojami visi galimi veikimo scenarijai. (Kas bus, jei naudotojas pateiks PNG vietoj ODF, ir panašūs.) Gaudoma daugiau išimčių nei reikia („try“ – „catch“).
60	Duomenų	Duomenų struktūrų defektai, tokie kaip nenormalizuota duombazė, neefektyvus saugojimas ir panašūs.
70	Logikos	Algoritmo realizacijos klaidos.
71	Rinkimo	Teksto rinkimo klaidos.
80	Sistemos	Sistema neoptimaliai sukonfigūruota, ryja daugiau atminties nei turėtų, veikia ilgiau nei turėtų.
90	Aplinkos	Projektavimo, kompiliavimo, testavimo, versijų kontrolės ir kitų pagalbinių sistemų problemos.

Defektų fiksavimui yra pagalbinė programėlė dreg, kurią galima rasti bin kataloge. Prieš naudojantis pirmąjį kartą, reikia nurodyti pradinį defektų id. Tai galima padaryti iš RSys katalogo, įvykdžius:

• Audriui: bin/idreg 0;
• Egidijui: bin/idreg 1000;
• Justinui: bin/idreg 2000;
• Martynui: bin/idreg 3000;
• Vytautui: bin/idreg 4000.

Ši komanda sukuria failą .defects.pickle su paskutinio defekto id ir tuščiu defektų sąrašu.

Radus defektą, reikia įvykdyti komandą:

bin/dreg komponentas tipas įterptas pašalintas aprašymas

čia:

• komponentas yra simbolis žymintis sistemos komponentą, kuriame buvo rastas defektas:

  'e':  'Export',
  'i':  'Import',
  'g':  'Interface',              # g nuo GUI
  'l':  'Logic',
  'p':  'Parse',
  's':  'Store',
  'a':  'All',
  

• tipas yra vienas iš aukščiau lentelėje pateiktų tipų id;

• įterptas yra simbolis žymintis, kurioje fazėje buvo įterptas defektas:

  #'s':  'Strategija',
  #'pl': 'Planavimas',
  'r':  'Reikalavimai',
  'p':  'Projektavimas',
  'k':  'Kodavimas',
  'v':  'Peržiūra',
  't':  'Testavimas',
  'd':  'Dokumentavimas',
  'a':  'Aptarimas',
  

• pašalintas analogiškai įterptas;

• aprašymas – defekto aprašymas.

Programa atspausdins naujai sukurto defekto id. Pataisius defektą, reikia jį išsaugoti, su komanda:

bin/adreg defekto-id trukmė aprašymas

čia:

• trukmė – kiek užtruko defekto šalinimas minutėmis;
• aprašymas – papildoma informacija apie defektą.

Programa išsaugos defekto aprašymą į failą .defects.csv, kurį vėliau reikės išsiųsti Vytautui.

Jei užklupo sklerozė, visų rastų defektų sąrašą galima peržiūrėti įvykdžius komandą bin/ldreg.

Pastaba: Defektai git saugykloje nėra saugomi!