Začíname s GitPulse¶

Táto stránka vás prevedie prvými krokmi pri používaní GitPulse.

1. Prihlásenie¶

1. Otvorte GitPulse dashboard na adrese poskytnutej administrátorom
2. Kliknite "Prihláste sa pomocou GitLab" - budete presmerovaní na váš GitLab server
3. Autorizujte aplikáciu a po úspešnom prihlásení uvidíte prehľad vašich kurzov

2. Vytvorenie kurzu¶

Možnosť A - Nový kurz¶

1. Na hlavnom dashboarde kliknite "Vytvoriť kurz"
2. Vyplňte:

1. Kliknite "Vytvoriť"

Možnosť B - Import z GitLabu¶

1. Kliknite "Import z GitLabu"
2. Vložte GitLab URL:
   • URL skupiny - importuje všetky podskupiny a projekty (napr. https://git.kpi.fei.tuke.sk/zsi-labs/assignments-2025/a3)
   • URL projektu - importuje iba jeden projekt (napr. https://git.kpi.fei.tuke.sk/zsi-labs/assignments-2025/a3/mines-11679)
3. Vyplňte kód, názov a semester
4. Zaškrtnite "Automatická synchronizácia" pre okamžité stiahnutie dát
5. Kliknite "Importovať"

Možnosť C - Import JSON konfigurácie¶

1. Kliknite "Import JSON"
2. Nahrajte JSON súbor s kompletnou konfiguráciou kurzu
3. JSON obsahuje nastavenia, compliance kontroly, rubriku a prahy

3. Pridanie projektov¶

Automatický import zo skupiny¶

Ak máte projekty organizované v GitLab skupine:

1. Na stránke kurzu kliknite "Import z GitLabu"
2. Zadajte URL skupiny (napr. https://git.kpi.fei.tuke.sk/zsi-labs/assignments-2025/a3)
3. GitPulse automaticky nájde všetky projekty a vytvorí tímy

Import jedného projektu¶

1. Použite "Import z GitLabu" s URL jednotlivého projektu
2. Systém vytvorí jeden tím s priradením daného projektu
3. Študenti sú automaticky detekovaní z členov projektu

flowchart LR
    A["URL skupiny"] -->|Import| B["GitPulse Kurz"]
    C["URL projektu"] -->|Import| B
    D["JSON konfig"] -->|Import| B
    B --> E["Tímy + Projekty + Študenti"]

4. Synchronizácia dát¶

Po importe je potrebné synchronizovať dáta z GitLabu:

1. GitPulse automaticky začne synchronizáciu ak ste zaškrtli "Automatická synchronizácia"
2. Alebo kliknite "Synchronizovať všetko" na stránke kurzu
3. Sledujte priebeh v globálnom status bare (navrchu stránky)
4. Po dokončení sa aktualizujú metriky a compliance skóre

5. Import študentov (Roster)¶

Automatická detekcia¶

Študenti sú automaticky importovaní z členov GitLab skupiny/projektu počas importu. Nie je potrebný manuálny zásah.

CSV import (voliteľné)¶

Pre presnejšie priradenie môžete nahrať CSV:

1
2
3

gitlab_username,full_name,email,team
alice,Alice Smith,alice@example.com,Team Alpha
bob,Bob Jones,bob@example.com,Team Alpha

1. V nastaveniach kurzu -> záložka "Súpiska"
2. Nahrajte CSV súbor
3. Skontrolujte mapovanie
4. Kliknite "Importovať"

6. Nastavenie compliance kontrol¶

Vstavaných 13 kontrol (R01-R13)¶

Kontroly sú rozdelené do 4 kategórií: Issue, MR, Review a CI.

Konfigurácia prahov¶

V nastaveniach kurzu -> záložka "Nastavenia" -> sekcia "Compliance":

• Zelený prah (predvolene 80 %) - tím spĺňa požiadavky
• Žltý prah (predvolene 50 %) - vyžaduje pozornosť
• Pod žltým prahom - červený stav

Vlastné kontroly¶

GitPulse podporuje aj vlastné kontroly (C01+) pre špecifické požiadavky kurzu.

7. Prvá kontrola¶

Po synchronizácii:

1. Otvorte stránku kurzu - uvidíte tabuľku tímov so semaforovým stavom
2. Kliknite na tím pre zobrazenie detailov (compliance, rubrika, analytiky)
3. Kliknite na študenta pre individuálne metriky (commity, issues, MR, komentáre)

Kontrolný zoznam¶

• Prihlásenie cez GitLab OAuth
• Vytvorený / importovaný kurz
• Importované projekty a študenti
• Vykonaná synchronizácia dát
• Nastavené compliance kontroly a prahy
• Skontrolovaný dashboard - metriky sa zobrazujú správne

Ďalšie kroky¶

• Dashboard a metriky - Naučte sa čítať metriky
• Interpretácia výsledkov - Pochopte význam skóre
• FAQ - Riešenie bežných problémov