Pochopenie metrík¶
GitPulse hodnotí váš projekt pomocou 13 compliance pravidiel (R01-R13). Každé pravidlo sleduje konkrétny aspekt tímovej spolupráce a DevOps praktík.
Prehľad pravidiel¶
| Pravidlo | Čo sleduje | Prečo je dôležité |
|---|---|---|
| R01 | Pravidelnosť commitov | Konzistentná práca namiesto poslednej chvíle |
| R02 | Rozdelenie práce v tíme | Každý člen tímu prispieva |
| R03 | Používanie issues | Plánovanie a sledovanie úloh |
| R04 | Prepojenie commitov s issues | Traceabilita zmien |
| R05 | Merge requesty a code review | Kvalita kódu cez peer review |
| R06 | CI/CD pipeline | Automatizované testovanie |
| R07 | Úspešnosť pipeline | Pipeline prechádza bez chýb |
| R08 | README a dokumentácia | Dokumentovanie projektu |
| R09 | Branch stratégia | Používanie vetiev (feature branches) |
| R10 | Kvalita commit správ | Zmysluplné a štruktúrované správy |
| R11 | Veľkosť commitov | Menšie, zamerané commity |
| R12 | Časové rozloženie | Práca nie je len v posledných dňoch |
| R13 | Celková tímová dynamika | Vyvážená spolupráca v tíme |
Compliance skóre¶
Vaše celkové compliance skóre je vážený priemer všetkých pravidiel. Učiteľ určuje váhy jednotlivých pravidiel podľa zamerania kurzu.
Stupňovanie¶
| Úroveň | Skóre | Význam |
|---|---|---|
| Vynikajúce | 80-100 % | Tím dodržiava všetky kľúčové praktiky |
| Primerané | 50-79 % | Niektoré oblasti je potrebné zlepšiť |
| Nedostatočné | 0-49 % | Výrazné nedostatky v spolupráci |
Detaily pravidiel¶
R01 - Pravidelnosť commitov¶
Čo systém kontroluje
Rozloženie commitov počas sledovaného obdobia. Ideálne je pravidelné commitovanie (napríklad niekoľkokrát týždenne).
Ako zlepšiť:
- Commitujte menšie zmeny častejšie
- Nečakajte na posledný deň pred deadline
- Rozdeľte veľké úlohy na menšie časti
R02 - Rozdelenie práce v tíme¶
Čo systém kontroluje
Pomer príspevkov jednotlivých členov tímu. Každý člen by mal prispievať zmysluplne.
Ako zlepšiť:
- Rozdeľte úlohy rovnomerne medzi členov tímu
- Používajte GitLab issues na priradenie úloh
- Kontrolujte prehľad príspevkov na dashboarde
R03 - Používanie issues¶
Čo systém kontroluje
Vytváranie a správa issues v projekte. Issues by mali pokrývať plánované úlohy.
Ako zlepšiť:
- Vytvárajte issue pre každú väčšiu úlohu
- Používajte labels na kategorizáciu
- Uzatvárajte issues po dokončení
R04 - Prepojenie commitov s issues¶
Čo systém kontroluje
Prepojenie commitov s issues cez referencie v commit správach (napr. #123 alebo Closes #123).
Ako zlepšiť:
- Uvádzajte číslo issue v commit správe:
feat: add login form (#42) - Používajte kľúčové slová:
Closes #42,Fixes #42,Resolves #42
R05 - Merge requesty a code review¶
Čo systém kontroluje
Používanie merge requestov a zapojenie iných členov tímu do review.
Ako zlepšiť:
- Pracujte na feature branches, nie priamo na
main - Vytvárajte merge requesty pre integráciu zmien
- Robte code review kolegom pred mergnutím
- Pridávajte zmysluplné komentáre k review
R06 - CI/CD pipeline¶
Čo systém kontroluje
Prítomnosť a konfiguráciu CI/CD pipeline v projekte (.gitlab-ci.yml).
Ako zlepšiť:
- Vytvorte
.gitlab-ci.ymlsúbor v koreňovom adresári - Nastavte minimálne jednu build a test fázu
- Uistite sa, že pipeline pokrýva hlavné vetvy
R07 - Úspešnosť pipeline¶
Čo systém kontroluje
Pomer úspešných a neúspešných pipeline bežaní.
Ako zlepšiť:
- Opravujte zlyhané pipeline čo najskôr
- Spúšťajte testy lokálne pred pushnutím
- Neignorujte zlyhané buildy
R08-R13 - Ďalšie pravidlá¶
Pravidlá R08-R13 sledujú ďalšie aspekty ako dokumentáciu, branch stratégiu, kvalitu commit správ, veľkosť commitov, časové rozloženie a celkovú tímovú dynamiku. Princíp je vždy rovnaký - dodržiavanie osvedčených DevOps praktík.
Často kladené otázky o metrikách¶
Môžem vidieť, ako sa moje skóre počíta?
Áno, na dashboarde kliknutím na compliance skóre zobrazíte rozpis podľa jednotlivých pravidiel vrátane váh.
Prečo mám nízke skóre, aj keď som veľa robil?
Compliance skóre hodnotí praktiky spolupráce, nie objem kódu. Aj keď ste napísali veľa kódu, za nízke skóre môžu byť napríklad chýbajúce issues, žiadne merge requesty, alebo nerovnomerné rozdelenie práce v tíme.
Kedy sa skóre aktualizuje?
Skóre sa aktualizuje automaticky po každej synchronizácii s GitLabom, typicky do niekoľkých minút po push alebo inej akcii.
Počíta sa compliance skóre priamo do známky?
Nie nevyhnutne. Compliance skóre slúži ako podklad pre učiteľa, ktorý rozhoduje o konečnom hodnotení. Učiteľ môže zohľadniť aj ďalšie faktory.