Často kladené otázky¶

Všeobecné otázky¶

Čo je GitPulse?¶

GitPulse je nástroj na automatickú analýzu aktivity študentov na GitLab projektoch. Poskytuje objektívne metriky pre hodnotenie tímovej spolupráce a DevOps praktík.

Kto môže GitPulse používať?¶

GitPulse je určený primárne pre učiteľov a cvičiacich. Prihlásenie prebieha cez školský GitLab (OAuth) - účet sa vytvorí automaticky pri prvom prihlásení. Rolu (napr. inštruktor) môže zmeniť administrátor.

Aké dáta GitPulse zbiera?¶

GitPulse zbiera verejne dostupné dáta z GitLab projektov:

• Commit históriu
• Merge requesty a code review komentáre
• Pipeline výsledky a test coverage
• Issues
• Členov projektu/skupiny

Import a synchronizácia¶

Ako importovať kurz z GitLabu?¶

1. Na dashboarde kliknite "Import z GitLabu"
2. Vložte URL:
   • URL skupiny - importuje všetky podskupiny (tímy) a projekty
   • URL projektu - importuje iba jeden projekt
3. Vyplňte názov kurzu a semester
4. Kliknite "Importovať"

Prečo sa importoval celý rodičovský group?¶

Ak vložíte URL skupiny, GitPulse importuje všetky podskupiny ako tímy. Ak chcete importovať iba jeden projekt, uistite sa, že vkladáte URL konkrétneho projektu, nie skupiny.

Prečo nevidím aktivitu tímu?¶

Možné príčiny:

1. Synchronizácia ešte neprebehla
2. Skontrolujte globálny status bar - synchronizácia môže ešte prebiehať

3. Kliknite "Synchronizovať" na stránke kurzu

4. Projekt nie je v kurze

5. Skontrolujte, či je projekt pridaný v GitPulse

6. Oneskorenie spracovania

7. Pri vysokej záťaži môže byť oneskorenie do niekoľkých minút

Čo synchronizácia sťahuje?¶

• Commity, Merge Requests, Issues, Pipeline výsledky
• Členov projektu (automatická detekcia študentov)
• Code review komentáre
• Test coverage dáta

Prečo status bar ukazuje zlé čísla?¶

Status bar sa aktualizuje každé 2 sekundy. Staré úlohy (staršie ako 3 minúty) sú automaticky vyčistené. Ak vidíte nesprávne počty, obnovte stránku.

Metriky a hodnotenie¶

Čo znamená compliance skóre?¶

Compliance skóre (0-100 %) vyjadruje, nakoľko tím dodržiava definované DevOps praktiky. Skladá sa z 13 vstavaných kontrol (R01-R13) plus voliteľných vlastných kontrol.

Sú prahy konfigurovateľné?¶

Áno. V nastaveniach kurzu môžete zmeniť:

• Zelený prah (predvolene 80 %) - tím spĺňa požiadavky
• Žltý prah (predvolene 50 %) - vyžaduje pozornosť
• Zmeny sa okamžite prejavia na dashboarde

Je compliance skóre absolútna známka?¶

Nie. Compliance skóre je len jeden z indikátorov. Mali by ste ho kombinovať s:

• Kvalitou výstupov (demo, kód)
• Prezentáciou projektu
• Individuálnym rozhovorom
• Peer evaluation

Ako interpretovať nízke skóre v jednej kategórii?¶

Nízke skóre v kategórii môže znamenať:

1. Skutočný problém - tím ignoruje danú praktiku
2. Odlišný workflow - legitímny dôvod (napr. pair programming)
3. Technický problém - dáta nie sú správne zbierané
4. Chýbajúca konfigurácia - napr. chýba CI/CD v projekte

Roly a scoring¶

Čo znamenajú farebné odznaky pri menách členov?¶

Odznaky zobrazujú GitLab rolu člena tímu. Farby zodpovedajú úrovni prístupu:

• Owner (žltá) - najvyššia úroveň (50)
• Maintainer (modrá) - úroveň 40
• Developer (šedá) - úroveň 30
• Reporter/Guest (svetlošedá) - úroveň 20/10

Čo znamená "(not in team score)"?¶

Tento štítok znamená, že člen nie je zahrnutý do tímového compliance skóre. Dôvody:

1. Nízka rola bez aktivity - Guest alebo Reporter, ktorý nevytvoril žiadny commit, MR, issue ani review
2. Dedený prístup bez aktivity - člen zdedil prístup cez nadskupinu, ale nemá žiadnu aktivitu v projekte
3. Inštruktor - učiteľ/cvičiaci pridaný ako is_teacher

Čo je "inherited" členstvo?¶

Člen s odznakom "inherited" získal prístup k projektu/skupine nie priamo, ale zdedením z nadradskupiny GitLab. Ak nemá žiadnu aktivitu, je automaticky vylúčený z tímového skóre.

Prečo má môj tím nižšie skóre ako som čakal?¶

Skontrolujte, či nemáte neaktívnych členov, ktorí znižujú priemer. GitPulse teraz automaticky vylučuje Guest/Reporter bez aktivity a inherited členov bez aktivity, ale Developer+ s nulovou aktivitou sa stále počíta do skóre.

Čo robí tlačidlo "Re-check"?¶

Tlačidlo spustí okamžité prepočítanie compliance metrik tímu. Na rozdiel od bežného prepočtu spúšťa všetky kontroly (R01-R13 + vlastné), aj keď sú niektoré filtované v aktuálnom týždni kurzu.

Gaming a podvody¶

Čo je gaming?¶

Gaming je snaha "oklamať" metriky bez skutočnej práce. Príklady:

• Commit spam - veľa prázdnych/bezvýznamných commitov
• LGTM reviews - falošné code review bez komentárov
• Review rings - vzájomné review bez kontroly (Alice <-> Bob)

Ako GitPulse detekuje gaming?¶

GitPulse používa heuristiky na detekciu podozrivých vzorov:

• Vysoká frekvencia commitov v krátkom čase
• Prázdne alebo generické komentáre v review
• Nerovnomerná distribúcia review párov (Gini > 0.8)

Čo robiť pri detekcii gamingu?¶

1. Overte false positive - skontrolujte detaily na stránke tímu
2. Porozprávajte sa so študentom - možno má vysvetlenie
3. Dokumentujte - pre prípad opakovania
4. Podniknite akciu - podľa závažnosti

Konfigurácia a export¶

Ako zdieľať nastavenia medzi kurzami?¶

Použite JSON export/import:

1. Na zdrojovom kurze kliknite "Export JSON"
2. Na cieľovom kurze kliknite "Import JSON" a nahrajte súbor
3. JSON obsahuje compliance kontroly, rubriku a prahy

Môžem pridávať vlastné kontroly?¶

Áno. GitPulse podporuje vlastné kontroly (C01+) s konfigurovateľnými pravidlami a váhami.

Súkromie a GDPR¶

Aké sú práva študentov?¶

Podľa GDPR majú študenti právo na:

• Prístup - môžu požiadať o svoje dáta
• Opravu - ak sú dáta nesprávne
• Výmaz - v odôvodnených prípadoch
• Prenosnosť - export dát v štandardnom formáte

Ako dlho sa dáta uchovávajú?¶

Dáta sa uchovávajú do konca semestra plus 1 akademický rok pre prípad odvolaní. Potom sú automaticky zmazané.

Čo s AI obohatením a súkromím?¶

AI obohatenie spracováva len agregované metriky (počet commitov, MR, atď.), nie obsah kódu. Osobné údaje študentov (mená, emaily) sú automaticky redakované pred odoslaním do AI modelu.

Problémy a podpora¶

Dashboard je pomalý¶

Riešenia:

1. Obnovte stránku (F5)
2. Vyčistite cache prehliadača
3. Skúste iný prehliadač
4. Nahláste problém administrátorovi

Ako nahlásiť bug?¶

1. Otvorte GitLab Issues
2. Priložte screenshot a kroky na reprodukciu
3. Uveďte prehliadač a operačný systém

Kontakty¶