Dashboard a metriky¶
Táto stránka vysvetľuje jednotlivé časti dashboardu a význam zobrazovaných metrík.
Prehľad dashboardu¶
flowchart TB
subgraph Dashboard["Dashboard"]
A["Navigácia"]
B["Prehľad kurzu"]
C["Zoznam tímov"]
D["Detail tímu"]
E["Detail študenta"]
F["Detail projektu"]
end
A --> B
B --> C
C --> D
D --> E
D --> F Navigácia¶
Hlavné sekcie¶
| Sekcia | Popis |
|---|---|
| Kurzy | Zoznam vašich kurzov |
| Tímy | Prehľad všetkých tímov v kurze |
| Nastavenia | Konfigurácia kurzu, compliance kontroly, rubrika |
Globálny status bar¶
Na vrchu každej stránky sa zobrazuje globálny sync status bar, ktorý informuje o prebiehajúcich synchronizáciách:
- Počet čakajúcich, bežiacich a dokončených úloh
- Automaticky sa aktualizuje každé 2 sekundy
- Zmizne po dokončení všetkých úloh
Filtrovanie a vyhľadávanie¶
- Vyhľadávanie: Nájdite tím alebo študenta podľa mena
- Filtrovanie: Zobrazenie podľa stavu (OK, Warning, Critical)
- Triedenie: Podľa compliance skóre, názvu, aktivity
Prehľad kurzu¶
Súhrnné metriky¶
Na stránke kurzu uvidíte:
- Počet tímov, študentov a projektov
- Priemerné compliance skóre s trendom oproti minulému týždňu
- Zoznam tímov so semaforovým stavom
- Upozornenia na tímy vyžadujúce pozornosť
Statusy tímov¶
| Status | Popis | Compliance |
|---|---|---|
| Zelený | Tím pracuje dobre | ≥ zelený prah (predvolene 80 %) |
| Žltý | Potrebuje pozornosť | medzi žltým a zeleným prahom |
| Červený | Vážne problémy | < žltý prah (predvolene 50 %) |
Dynamické prahy
Zelený a žltý prah sú konfigurovateľné v nastaveniach kurzu. Zmeny sa ihneď prejavia na dashboarde.
Zoznam tímov¶
Tabuľka tímov¶
| Stĺpec | Popis |
|---|---|
| Tím | Názov tímu (kliknuteľný) |
| Compliance | Celkové compliance skóre s farebným indikátorom |
| Posledná aktivita | Čas posledného commitu/MR |
| Členovia | Počet študentov v tíme |
| Akcie | Tlačidlá pre synchronizáciu, detail |
Detail tímu¶
Sekcie detailu¶
1. Compliance prehľad¶
Semaforový stav pre každú z 13 vstavaných kontrol (R01-R13) plus vlastné kontroly (C01+).
pie title Compliance rozdelenie
"Issue (R01)" : 8
"MR (R02-R05, R10-R11)" : 42
"Review (R06-R09)" : 43
"CI (R12)" : 7 2. Rubrika¶
Váhované skóre podľa kategórií rubriky. Každá kategória zobrazuje:
- Aktuálne skóre (%)
- Farebný indikátor (zelená / žltá / červená)
- Zoznam kontrol v kategórii
3. Časová os aktivity¶
Interaktívny graf zobrazujúci aktivitu tímu v čase - commity, MR, issues.
4. Gaming flagy¶
| Flag | Závažnosť | Popis |
|---|---|---|
| Review ring | Medium | Vzájomné review bez diverzity |
| Commit spam | High | Veľký počet bezvýznamných commitov |
| LGTM reviews | Medium | Prázdne approval bez komentárov |
5. Štatistiky¶
- Počet commitov, MR, issues, komentárov
- Review coverage (% MR s review)
- Pipeline úspešnosť
- Test coverage
Detail študenta¶
Individuálne metriky¶
| Metrika | Popis |
|---|---|
| Commity | Celkový počet commitov |
| MR vytvorené | Počet merge requestov |
| Code review | Počet review komentárov |
| Issues | Vytvorené a zatvorené issues |
Všetky metriky zobrazujú porovnanie s priemerom tímu.
Stránkovanie sekcií¶
Detail študenta obsahuje 8 sekcií s klientským stránkovaním:
- Commity
- Merge Requests
- Issues
- Komentáre
- Pipeline výsledky
- Review aktivita
- Časová os
- AI obohatenie
Compliance metriky (R01-R13)¶
Kategória: Issue¶
| Kód | Metrika | Váha | Popis |
|---|---|---|---|
| R01 | Issue Assigned | 8 % | Študent má priradenú aspoň 1 issue |
Kategória: MR¶
| Kód | Metrika | Váha | Popis |
|---|---|---|---|
| R02 | Branch + MR Created | 6 % | Vetva MR dodržiava konvenciu pomenovania |
| R03 | Tests Written | 10 % | Aspoň 1 MR obsahuje zmeny v testových súboroch |
| R04 | MR Linked to Issue | 8 % | Popis MR odkazuje na issue |
| R05 | MR Description | 5 % | Popis MR obsahuje povinné sekcie |
| R10 | Merged by Author | 7 % | Autor sám zmergoval svoj MR |
| R11 | MR + Issue Closed | 6 % | MR aj issue sú uzavreté |
Kategória: Review¶
Kontroly R06-R09 podporujú čiastočné skóre - skóre = váha × pomer splnenia.
| Kód | Metrika | Váha | Popis |
|---|---|---|---|
| R06 | Code Review Received | 12 % | MR študenta dostala review od ≥ N rôznych recenzentov |
| R07 | Code Review Given | 12 % | Študent zmysluplne recenzoval ≥ N rôznych MR kolegov |
| R08 | Review Response | 10 % | Autor odpovedal na review vlákna a odkazuje na commity |
| R09 | MR Approved | 9 % | MR študenta získala ≥ N schválení |
Kategória: CI¶
| Kód | Metrika | Váha | Popis |
|---|---|---|---|
| R12 | Pipeline Green | 7 % | Aspoň 1 pipeline prebehla úspešne s testovým jobom |
Export a import konfigurácie¶
JSON export¶
Exportujte kompletnú konfiguráciu kurzu vrátane:
- Nastavenia kurzu
- Compliance kontroly a prahy
- Rubrika a kategórie
- Vlastné kontroly
JSON import¶
Importujte konfiguráciu do nového alebo existujúceho kurzu. Užitočné pre:
- Klonovanie nastavení medzi kurzami
- Zdieľanie konfigurácie medzi učiteľmi
- Zálohovanie a obnovu
AI obohatenie¶
GitPulse poskytuje LLM-generované zhrnutia pre:
- Tím - celkový prehľad silných stránok a oblastí na zlepšenie
- Študent - individuálna analýza príspevkov
Súkromie
AI obohatenie spracováva len agregované metriky, nie obsah kódu. Osobné údaje študentov sú automaticky redakované.
GitLab role a scoring¶
Role badges¶
Na stránke detailu tímu sa pri každom členovi zobrazuje farebný odznak podľa jeho GitLab roly:
| Rola | Farba | Access Level |
|---|---|---|
| Owner | Warning (žltá) | 50 |
| Maintainer | Info (modrá) | 40 |
| Developer | Secondary (šedá) | 30 |
| Reporter | Grey | 20 |
| Guest | Grey | 10 |
Členovia s inherited membershipom (z nadskupiny) majú dodatočný odznak "inherited".
Neprispievajúci členovia¶
Členovia, ktorí sú vylúčení z tímového skóre, majú štítok (not in team score). Vylúčenie nastáva keď:
- Nízka rola + nulová aktivita - Guest alebo Reporter bez commitov, MR, issues alebo reviews
- Dedený prístup + nulová aktivita - inherited group member bez akejkoľvek aktivity, bez ohľadu na rolu
- Inštruktor - učitelia označení ako
is_teacher=true
Force Recheck
Tlačidlo "Re-check" na stránke tímu spustí okamžité prepočítanie metrik - vrátane všetkých kontrol bez ohľadu na týždenné filtrovanie.
Ďalšie čítanie¶
- Interpretácia výsledkov - Ako správne čítať metriky
- FAQ - Často kladené otázky