tucnaci

Online test „Tučňáci nejmenší“ (TIMSS 2023, 4. ročník) – specifikace projektu

Stav k 11. 9. 2026. Dokument shrnuje analýzu offline Playeru a dohodnutá rozhodnutí. Slouží jako výchozí zadání pro vývoj (např. v Claude Code).

1. Cíl a rámec

2. Zdrojový balíček

Kořen: G4_USB_TEST_FINAL_PLAYER/ (verze Playeru 3.133.0.59). Offline server: Apache + PHP (Yii 1.x), veškerý obsah je v souborech, žádná databáze. Uložená data žáků balíček neobsahuje.

Co Cesta (od htdocs/)
Obrazovky (HTML, EN + _cs-CZ) web/engine/packages/AssessmentMaster/Items/<složka>/<id>.html
Obrázky k otázkám web/engine/packages/AssessmentMaster/Media/images/ (pokyny v podsložkách 27557, 27561)
Videa web/engine/packages/AssessmentMaster/Media/videos/
Pozadí obrazovek Tučňáků web/engine/packages/TIMSS2023MS/Resources/img/PSI/LittlePenguins/
Styly úlohy web/engine/packages/TIMSS2023MS/Resources/css/sass/PSI/_littlePenguins.scss
Chování úloh (TIMSS vrstva) web/engine/packages/TIMSS2023MS/Resources/js/timss.js
Záznam událostí (obecný) web/engine/packages/common/widgets/eventTracker.js
Struktura sešitů protected/runtime/organisations/<id>.json (sekce children = pořadí, resources = mapování na HTML)

Tučňáci jsou v sešitech A_B06 (18106.json) a A_B07 (18695.json). Referenční sešit pro ID aktivit: A_B07.

3. Obrazovky úlohy

Pravítko i kalkulačka jsou na všech obrazovkách vypnuté. Číselná pole používají virtuální klávesnici math_min: číslice 0–9, desetinná čárka, operátory − + · : =. Identifikátory odpovědí (MQ…) mají číslo o jedno nižší než kód obrazovky (číslují otázky v rámci úlohy).

Obrazovka activity_id (A_B07) Soubor Identifikátory odpovědí Interakce
M71A01 Úvod 155993 93021/228767 Tlačítko pro start úlohy (událost M71A01_NEXT)
M71A02 Obrázky 155994 93026/228936 MQ71A01_T Hottext: výběr obrázku s největším obsahem
M71A03 Výška 155995 93037/228783 MQ71A02A_T, MQ71A02B_T, MQ71A02C_T 3 číselná pole
M71A04 Hmotnost 155996 93033/228779 MQ71A03A_T (řazení, pozice MQ71A03AAAE), MQ71A03B_T Řazení přetahováním + číselné pole
M71A05 Počet tučňáků 155997 93687/250885 MQ71A04AA_T, MQ71A04AB_T (posuvníky 3950–5050, krok 50), MQ71A04B_T 2 posuvníky na rybí číselné ose + číselné pole
M71A06 Potrava 155998 93036/253749 MQ71A05A_T (volby MQ71A05A_T_MQ71A05A__1__4), MQ71A05B_T Výběr jedné možnosti + přetahování obrázků ryb do tabulky
M71A07 Příspěvek 155999 93023/228769 MQ71A06A_T, MQ71A06B_T 2 číselná pole

Poznámky: v _cs-CZ souborech zůstaly některé anglické systémové řetězce (např. „Select ONE statement“), ověřit podle náhledů, zda jsou viditelné. Verze obrázků _RTL nejsou potřeba. Správná řešení a pravidla bodování v balíčku nejsou, je třeba hodnoticí manuál k uvolněným úlohám.

4. Pokyny (zúžené)

Původní activity_id Soubor Rozhodnutí
DIR_START_G4 155928 97530/216851 Nahradit přihlášením / „Začít“
G4_DIR_01 Vítej 155929 98624/233128 Ponechat, text jen o matematice
G4_DIR_02 Hodiny, lišta, pravítko 155930 98626/233129 Bez pravítka; hodiny (18 min) a lišta procházení
G4_DIR_03 Výběr odpovědi 155931 98628/233130 Jen výběr jedné odpovědi + klik na obrázek
G4_DIR_04 Přetahování 155932 98630/233131 Ponechat
G4_DIR_05 Číselná klávesnice 155933 98632/233474 Ponechat, cvičení s celým číslem místo zlomku
G4_DIR_06 Psaní textu 155934 98634/233149 Vypustit
G4_DIR_07 Kreslení čar + video 155935 98636/233151 Vypustit
G4_DIR_08 Tipy (zedy, rolování) 155937 98640/233475 Ponechat
DIR_END_G4 155938 97532/216883 Ponechat

Volitelně: krátké cvičení na posuvník (typ z obrazovky M71A05).

5. Časový limit

6. Přihlášení, začátek testu a pořadí obrazovek

6.1 Celkové pořadí

# Obrazovka Předloha v originálu Poznámka
1 Přihlášení žáka web/engine/packages/TIMSS/login.html + TIMSS2023MS/Resources/js/login.js, css/login.css ID + heslo
2 Začátek pokynů DIR_START_G4 (97530/216851), activity 155928 Heslo od zadavatele, „Začít“
3–8 Pokyny 1–5 a 8 (zúžené) viz kap. 4  
9 Konec pokynů DIR_END_G4 (97532/216883), activity 155938  
10 Začátek testu PT2_START_G4 (97541/228926), activity 155965 Text upravit na 18 minut a bez „Části 2“; heslo od zadavatele; start časovače
11–17 M71A01–M71A07 viz kap. 3  
18 Konec testu PT2_END_G4 (97542/216877), activity 155976 Možnost vrátit se k otázkám, pak odeslat
19 Odhlášení Logoff (AssessmentMaster/logoff.html), activity 175685  

6.2 Přihlašovací okno

6.3 Okna s heslem od zadavatele (začátek pokynů, začátek testu)

7. Procesní data – shodně s originálem

7.1 Struktura události

Každá událost se v originálu odesílá jako:

{
  "activity_id": 155996,
  "event_data": {
    "trackId": "MQ71A03A_T",
    "startTime": 1789160412345,
    "data": { }
  }
}

7.2 Katalog událostí relevantních pro test

trackId Kdy data
SCREEN_LOADED Načtení obrazovky loadedScreenSequence, loadedScreenId, timeStamp
NAV_NEXT, NAV_BACK, NAV_PROG Další / zpět / skok přes lištu departureScreenSequence, destinationScreenSequence, departureScreenId, destinationScreenId
M71A01_NEXT Start úlohy tlačítkem na úvodní obrazovce
DIRECTIONS_START, PART2_START Zadání hesla na začátku pokynů / testu Booklet Part, login success, incorrect attempts
POPUP_PW_INCORRECT_OPEN / _CLOSE Upozornění na chybné heslo – (klíč timeStamp)
PART2_CLOCK_START, PART2_CLOCK_STOP Start a konec měření času
POPUP_FIVE_MINUTES_OPEN / _CLOSE Upozornění na 5 minut (close: volitelně data)
POPUP_TIME_UP_OPEN / _CLOSE Vypršení času event_attribute
SCROLL_ACTIVE Zda je na obrazovce posuvník "Y" / "N"
SCROLL_START, SCROLL_STOP, SCROLL_DRAG_START / _STOP Rolování ScrollTop, Clientheight, TotalUIHeight resp. scrollFrom, scrollTo
MQ71A01_T… (hottext) Klik na obrázek (M71A02) při zrušení výběru cleared: true
NUMBERPAD_OPEN Otevření číselné klávesnice
<id pole> např. MQ71A02A_T Fokus / opuštění číselného pole type: "focus"; při blur navíc response (LaTeX)
MQ71A03A_T Přetažení při řazení (M71A04) dragged, dropped, endTime, response (položka → dropzone)
MQ71A04AA_T, MQ71A04AB_T Puštění posuvníku (M71A05) response (hodnota)
MQ71A05A_T_MQ71A05A__n Klik na volbu (M71A06 A) response nebo cleared: true, response: ""
MQ71A05B_T Přetažení obrázku ryby (M71A06 B) dragged (+ doplnit dle komponenty drag&drop)

7.3 Výstupy

8. Plán práce

  1. Příprava projektu: GitHub repozitář (soukromý), struktura složek, lokální spuštění.
  2. Extrakce obsahu (obrazovky 1–19 z kap. 6.1) do datových souborů (JSON) + kopie potřebných obrázků; ruční doplnění textů přihlašovacího okna z náhledů.
  3. Vlastní webový engine: pořadí obrazovek, navigace, lišta, okna s heslem, časovač 18 min, 6 typů interakcí (hottext, číselné pole s klávesnicí, řazení, posuvník, výběr jedné možnosti, drag&drop do tabulky).
  4. Záznam procesních dat přesně podle kap. 7, zpočátku export do souboru ke stažení.
  5. Kontrola vzhledu a chování proti náhledům obrazovek originálu.
  6. Generátor ID a hesel, napojení na úložiště (backend podle zvoleného hostingu).
  7. Pilotáž ve škole, poté ostrý sběr.

9. Otevřené otázky