Interpretácia výsledkov¶

Táto stránka vám pomôže správne interpretovať metriky a identifikovať skutočné problémy v tímoch.

Základné princípy¶

Čo metriky hovoria¶

Compliance skóre¶

Interpretácia celkového skóre¶

flowchart LR
    A["Compliance 90-100%"] -->|"Výborňý tím"| B["Monitorovať"]
    C["Compliance 70-90%"] -->|"Dobrý tím"| D["Občasná kontrola"]
    E["Compliance 50-70%"] -->|"Problémy"| F["Aktívna intervencia"]
    G["Compliance < 50%"] -->|"Kritické"| H["Okamžitá akcia"]

Kontext je kľúčový¶

Interpretácia jednotlivých metrík¶

R01: Issue Assigned¶

Čo meriame: Študent má priradenú aspoň 1 issue v projekte

Zdravé vzory:

• Každý študent pracuje na vlastnej issue
• Issue je vytvorená pred začatím práce

Varovné signály:

• Študent nemá priradenú žiadnu issue -> skóre 0 %
• Issue priradená iba formálne, bez skutočnej práce

R02: Branch + MR Created¶

Čo meriame: Vetva MR dodržiava konvenciu pomenovania (predvolene issue-123-popis)

Zdravé vzory:

• Vetva pomenovaná podľa konvencie: issue-5-add-search
• MR vytvorený z feature vetvy

Varovné signály:

• Vetva pomenovaná genericky: my-branch, fix, test
• Priame pushovanie do main bez MR

R03: Tests Written¶

Čo meriame: Aspoň 1 MR obsahuje zmeny v testových súboroch

Konfigurácia: Vzory testových súborov sa nastavujú v test_file_patterns

R04: MR Linked to Issue¶

Čo meriame: Popis MR odkazuje na issue (napr. Closes #5, Fixes #12)

R05: MR Description¶

Čo meriame: Popis MR obsahuje povinné sekcie (predvolene ## Description a ## Testing)

R06: Code Review Received (čiastočné skóre)¶

Čo meriame: MR študenta dostala review od ≥ N rôznych recenzentov

Čiastočné skóre: Ak študent potrebuje 2 recenzentov a má 1, dostane 50 % váhy.

Zdravé vzory:

• Každý člen reviewuje aj je reviewovaný
• Konštruktívne komentáre (≥ 30 slov)
• Rôzni revieweri (nie vždy tá istá osoba)

Gaming detection:

• LGTM reviews - Prázdne approval bez komentárov
• Review rings - Alice reviewuje Boba, Bob reviewuje Alice, nikto iný

flowchart TB
    subgraph "Zdravý Review "
        A1["Alice"] -->|review| B1["Bob's MR"]
        B2["Bob"] -->|review| C1["Carol's MR"]
        C2["Carol"] -->|review| A2["Alice's MR"]
    end

    subgraph "Review Ring "
        X1["Alice"] <-->|"vždy"| Y1["Bob"]
        Z1["Carol"] -.->|"žiadne review"| X1
    end

R07: Code Review Given (čiastočné skóre)¶

Čo meriame: Študent zmysluplne recenzoval ≥ N rôznych MR kolegov

Minimálna dĺžka review: 30 slov (konfigurovateľné cez min_review_word_count)

R08: Review Response (čiastočné skóre)¶

Čo meriame: Autor odpovedal na review vlákna a odkazuje na commity

R09: MR Approved (čiastočné skóre)¶

Čo meriame: MR študenta získala ≥ N schválení

R10: Merged by Author¶

Čo meriame: Autor sám zmergoval svoj MR (nie iný člen tímu)

R11: MR + Issue Closed¶

Čo meriame: MR aj prepojená issue sú uzavreté

R12: Pipeline Green¶

Čo meriame: Aspoň 1 pipeline prebehla úspešne s testovým jobom

Neprispievajúci členovia¶

Kedy je člen vylúčený z tímového skóre?¶

Compliance engine používa trojúrovňovú klasifikáciu členov:

1. Inštruktori (is_teacher=true) - vygeneruje sa im individuálny snapshot, ale nikdy nie sú zahrnutí v tímovom agregáte
2. Neprispievajúci - Guest/Reporter bez aktivity ALEBO inherited členovia bez aktivity -> dostanú individuálny snapshot, ale sú vylúčení z tímového priemeru
3. Študenti - Developer+ alebo akýkoľvek člen s aktivitou -> zahrnutí v tímovom skóre

Čo sa považuje za "aktivitu"?¶

Aktivita znamená, že člen má aspoň jednu z nasledujúcich:

• Vytvorený merge request
• Priradenú issue
• Danú code review
• Spustenú pipeline

Týždenné filtrovanie kontrol¶

Ak kurz používa weekly_deadlines s expected_checks, engine hodnotí len kontroly relevantné pre aktuálny týždeň. To zabraňuje penalizácii študentov za kontroly, ktoré ešte neboli zavedené v kurikule.

Gaming Detection¶

Typy gamingu¶

1. Commit Spam¶

Definícia: Veľké množstvo bezvýznamných commitov

Signály: - >30 commitov za hodinu - Commit správy: "fix", "update", ".", "asdf" - Zmeny iba whitespace alebo komentáre

Príklad:

1
2
3
4
5
6

10:00 - "fix"
10:01 - "update"
10:02 - "changes"
10:03 - "more changes"
...
10:30 - "final fix"

2. LGTM Reviews¶

Definícia: Code review bez skutočnej kontroly

Signály: - Komentáre len: "LGTM", "", "ok" - Review trvá <1 minúta - Approval bez akýchkoľvek komentárov

3. Review Rings¶

Definícia: Vzájomné review bez diverzity

Signály: - Gini koeficient review párov > 0.8 - Vždy rovnaké páry - Žiadne cross-review s inými členmi

Ako reagovať na gaming¶

flowchart TD
    A["Detekovaný gaming"] --> B{"Závažnosť"}
    B -->|"Nízka"| C["Upozornenie na dashboarde"]
    B -->|"Stredná"| D["Email študentom"]
    B -->|"Vysoká"| E["Osobný rozhovor"]

    E --> F{"Opakovanie?"}
    F -->|"Áno"| G["Penalizácia"]
    F -->|"Nie"| H["Monitorovanie"]

Kontextové faktory¶

Kedy metriky môžu klamať¶

Otázky na overenie¶

Pred vyvodením záverov si položte:

1. Je tento vzor konzistentný? (nie jednorazová anomália)
2. Ovplyvňujú ho externé faktory? (skúškové, sviatky)
3. Zodpovedá workflow tímu? (pair programming, mob programming)
4. Čo hovorí kód? (nie len metriky)

Praktické príklady¶

Príklad 1: Nízka aktivita jedného člena¶

Situácia: David má 5 commitov za semester, ostatní 50+

Možné príčiny: - David nerobí - David robí code review (nie commity) - David robí dokumentáciu offline - David má osobné problémy

Akcia: Pozrieť review aktivitu, porovnať s issues, prípadne rozhovor

Príklad 2: Vysoké compliance, ale slabý výsledok¶

Situácia: Tím má 90% compliance, ale projekt nefunguje

Možné príčiny: - Gaming metrík - Dobrý proces, zlá implementácia - Technické dlhy

Akcia: Review kódu, demo projektu, technický rozhovor

Príklad 3: Burst aktivita pred deadline¶

Situácia: 80% commitov v posledné 2 dni

Možné príčiny: - Zlý time management - Podceňovanie úlohy - Externé faktory (iné projekty) - Bežné pri niektorých typoch úloh

Akcia: Diskusia o plánovaní, mentoring

Checklist pre hodnotenie¶

• Porovnal som tím s priemerom kurzu
• Pozrel som trend, nie len aktuálny stav
• Overil som gaming flagy
• Zvážil som kontext (typ projektu, fáza semestra)
• Pozrel som kód, nie len metriky
• Mám dostatočné dáta pre záver

Ďalšie čítanie¶

• Pilotné nasadenie - Systematické vyhodnocovanie
• FAQ - Bežné situácie a riešenia