BilgymFlow — Porovnanie Rozvrhov

📖 Ako stiahnuť stály rozvrh — inštrukcie klikni pre rozbalenie ▾

Čo je cieľ tejto stránky?
Táto stránka porovnáva rozvrh uložený v BilgymFlow databáze s „čistým" rozvrhom stiahnutým priamo z EduPage. Slúži na kontrolu, či sú rozvrhy synchronizované.

Stiahnuť stály rozvrh musíš vždy ručne — buď cez GitHub Actions (normálny plán) alebo lokálne zo svojho Macu (núdzové riešenie).

☁️ Možnosť A — GitHub Actions (odporúčané, normálny plán)

Kedy: Vždy, keď sa zmení školský rozvrh (nový semester, nové skupiny…).
Čo treba: Nič špeciálne — len klikni tlačidlo ⬇ Stiahnuť nižšie. Systém spustí GitHub Actions workflow, ktorý stiahne rozvrh z EduPage (~2–3 min).
Podmienka: GitHub secret GITHUB_PAT_WORKFLOW musí byť nastavený (ak si ho nastavil raz, funguje ďalej).

Krok 1: Zadaj dátum nad tlačidlom — vyber týždeň aspoň 3–4 týždne dopredu (kde ešte nie sú zadané suplovanie).
Krok 2: Klikni ⬇ Stiahnuť stály rozvrh z EduPage.
Krok 3: Počkaj ~3 minúty. Stránka sa sama obnoví, keď prídu nové dáta.

🖥 Možnosť B — Lokálny Mac (núdzové riešenie, ak GitHub Actions zlyhá)

Kedy: Ak GitHub Actions zlyháva alebo nemáš nastavený PAT token.
Čo treba: Tvoj Mac musí byť zapnutý a musíš spustiť malý lokálny server raz pred kliknutím tlačidla.

⚙️ Nastavenie — urob to raz:

Krok 1 — Nainštaluj Python knižnice:
Otvor Terminal a spusti:

pip3 install azure-storage-blob "edupage-api==0.12.4"

Toto treba urobiť raz — knižnice zostanú nainštalované natrvalo.
(Ak pip3 nie je k dispozícii, nainštaluj Python 3 z python.org)

Krok 2 — Skopíruj konfiguračný súbor:
V Terminali napíš:

cd ~/Github/bilgymflow
cp .env.example .env

Krok 3 — Vyplň prihlasovacie údaje:
Otvor súbor .env v TextEdit alebo VS Code a vyplň:

EDUPAGE_USERNAME=tvoj-email@bilgym.sk
EDUPAGE_PASSWORD=tvoje-heslo-do-edupage
EDUPAGE_SUBDOMAIN=bilgym
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...

Connection string nájdeš v: Azure Portal → Storage accounts → bilgymsupl → Access keys → Connection string.
⚠️ Pozor: Musí to byť connection string pre bilgymsupl (nie bilgymflow!).

⚠️ DÔLEŽITÉ: Súbor .env je tajný — nikdy ho necommituj do gitu!

▶️ Spustenie — urob to každý raz keď chceš stiahnuť:

Krok 1 — Spusti lokálny server v Terminali:

cd ~/Github/bilgymflow
python3 local_server.py

Uvidíš: 🚀 Server beží na http://localhost:7700
Nechaj toto okno Terminalu otvorené!

Krok 2 — Vráť sa na túto stránku:
Odznak vedľa tlačidla sa prepne na 🖥 Lokálny server.

Krok 3 — Klikni ⬇ Stiahnuť stály rozvrh z EduPage.
Skript pobeží ~1,5 minúty. Výstup sleduj v Terminali.

Krok 4 — Zastaviť server: V Terminali stlač Ctrl+C.

📡 Stály rozvrh z EduPage

Čo je „stály rozvrh"? EduPage API vždy vracia rozvrh pre konkrétny týžden. Ak stiahneš rozvrh pre týždeň ďaleko v budúcnosti (kde ešte nikto nezadal suplovanie), dostaneš základný stály rozvrh — bez dočasných zmien.
Odporúčanie: Zvoľ dátum aspoň 3–4 týždne dopredu, kde s najväčšou pravdepodobnosťou ešte nie sú zadané suplovanie.

Posledný fetch

—

Učitelia (EduPage)

—

Mapovanie

—

učiteľov prepojených

DB rozvrh

—

hodín v DB

Týždeň:

⚖️ Porovnanie hodín

Legenda:

Zhoda (rovnaký predmet)

Rozdiel (iný predmet)

Len v DB

Len v EduPage

DB = BilgymFlow DB EP = EduPage

Čo porovnáva táto tabuľka?
DB = záznamy v BilgymFlow databáze (Cosmos DB, kolekcia schedules) — to čo učitelia vidia na portáli
EP = záznamy zo stiahnutého EduPage stáleho rozvrhu (blob edupage-stable-rozvrh.json)
Klikni na hodinu DB ✏️ pre úpravu. Tlačidlo ⬇ Importovať nahradí DB dáta učiteľa EP dátami.

Filter:

Zobraziť učiteľa:

Načítavam dáta…