Document Technické vybavení units 1–3 in the README.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
pepaskopec-blip 2026-09-11 21:11:28 +02:00
commit 99486b75b1

105
README.md
View file

@ -32,6 +32,9 @@ GTK 4 interface.
- **Správa počítačových sítí / Computer Network Administration** is open too - **Správa počítačových sítí / Computer Network Administration** is open too
(shown with a Wi-Fi icon) and leads to a 30-unit computer-networks path; (shown with a Wi-Fi icon) and leads to a 30-unit computer-networks path;
**units 1–10 are playable**, units 11–30 are locked placeholders **units 1–10 are playable**, units 11–30 are locked placeholders
- **Technické vybavení / Computer Hardware** is open (chip icon) and leads
to a 10-unit hardware path; **units 1–3 are playable**, units 4–10 are
locked placeholders
- the remaining subjects are dimmed/locked placeholders until their content - the remaining subjects are dimmed/locked placeholders until their content
is added is added
- layout folds into multiple rows when the window is narrow - layout folds into multiple rows when the window is narrow
@ -74,15 +77,24 @@ GTK 4 interface.
10. Model ISO/OSI a TCP/IP – slides + quiz 10. Model ISO/OSI a TCP/IP – slides + quiz
Progress for networks is saved to `progress/net.conf` (one flag per unit); Progress for networks is saved to `progress/net.conf` (one flag per unit);
completed network units show a checkmark on the path and count in Statistics completed network units show a checkmark on the path and count in Statistics
- **Computer hardware path** – three unlocked units (theory slides + quiz):
1. **Architektura počítače / Computer architecture** – von Neumann, the
von Neumann model (ALU, control unit, memory, I/O), then a quiz
2. **Historie počítačů / History of computers** – generations 0–4 (vacuum
tubes, transistors, ICs, microprocessors and milestones), then a quiz
3. **Zobrazování dat / Data representation** – bit and byte, then a quiz
Progress for hardware is saved to `progress/hw.conf`; completed units show
a checkmark on the path and count in Statistics
- **Progress tracking** – completed exercises are marked green; progress is - **Progress tracking** – completed exercises are marked green; progress is
saved per unit to `progress/unit1.conf`, `progress/unit2.conf` and saved per unit to `progress/unit1.conf`, `progress/unit2.conf` and
`progress/unit3.conf` and restored on startup `progress/unit3.conf` and restored on startup
- **Statistics** – chart icon in the header opens a per-subject progress - **Statistics** – chart icon in the header opens a per-subject progress
overview: summary totals (exercises done, percent, finished units) at the overview: summary totals (exercises done, percent, finished units) at the
top, then every subject with its own progress bar (subjects without tracked top, then every subject with its own progress bar (subjects without tracked
content yet are shown as locked; **networks** use lesson completion from content yet are shown as locked; **networks** and **hardware** use lesson
`progress/net.conf`), and a per-unit breakdown with progress bars for completion from `progress/net.conf` / `progress/hw.conf`), and a per-unit
Deutsch; numbers update as soon as you finish an exercise breakdown with progress bars for Deutsch; numbers update as soon as you
finish an exercise
- **Settings** – gear icon in the top-right header opens a panel where you can - **Settings** – gear icon in the top-right header opens a panel where you can
choose: choose:
- **mode**: dark or light, as a segmented control - **mode**: dark or light, as a segmented control
@ -276,9 +288,9 @@ Follow these steps to compile and run on Windows.
When launched, the application shows the welcome screen. From there: When launched, the application shows the welcome screen. From there:
1. Click **"Pokračuj" / "Continue"** to open the **Předměty / Subjects** map. 1. Click **"Pokračuj" / "Continue"** to open the **Předměty / Subjects** map.
2. Click the **Deutsch** bubble (German flag) to open the German learning 2. Click the **Deutsch** bubble (German flag) for the German path, the **Wi-Fi**
roadmap, or the **IP** bubble ("Správa počítačových sítí") for the bubble ("Správa počítačových sítí") for networks, or the **chip** bubble
computer-networks path. Other subjects are still locked. ("Technické vybavení") for hardware. Other subjects are still locked.
3. Browse the units along the path; the roadmap reflows into rows and scrolls 3. Browse the units along the path; the roadmap reflows into rows and scrolls
if the window is too narrow. if the window is too narrow.
4. Click the **"Neue Freunde"** node to open unit 1, **"Aus aller Welt"** for 4. Click the **"Neue Freunde"** node to open unit 1, **"Aus aller Welt"** for
@ -291,19 +303,24 @@ When launched, the application shows the welcome screen. From there:
a multiple-choice quiz (basic concepts, client–server/cloud, transmission a multiple-choice quiz (basic concepts, client–server/cloud, transmission
security, signals, path/channel/circuit, multiplexing, switching, layered security, signals, path/channel/circuit, multiplexing, switching, layered
models, ISO/OSI & TCP/IP). Units 11–30 stay locked placeholders. models, ISO/OSI & TCP/IP). Units 11–30 stay locked placeholders.
6. Use the **back button** in the top-left corner to return to the previous 6. On the hardware path, units **1–3** are open (architecture / von Neumann,
computer history generations, bit & byte), each with slides and a quiz.
Units 4–10 stay locked.
7. Use the **back button** in the top-left corner to return to the previous
screen. screen.
7. Open **Statistiky / Statistics** (chart icon, top-right) to see progress 8. Open **Statistiky / Statistics** (chart icon, top-right) to see progress
grouped per subject (overall totals plus, for Deutsch, a per-unit grouped per subject (overall totals plus, for Deutsch, a per-unit
breakdown). Network lesson completion is included in the subject totals. breakdown). Network and hardware lesson completion is included in the
8. Open **Nastavení / Settings** (gear icon, top-right) to switch dark/light subject totals.
9. Open **Nastavení / Settings** (gear icon, top-right) to switch dark/light
mode, pick a color theme, or change the interface language. mode, pick a color theme, or change the interface language.
German units 1–3 and network units 1–10 are currently implemented. Locked German units 1–3, network units 1–10 and hardware units 1–3 are currently
nodes do nothing – they are placeholders until lessons are added. Completed implemented. Locked nodes do nothing – they are placeholders until lessons are
Deutsch exercises stay green and are saved per unit to `progress/unit1.conf` / added. Completed Deutsch exercises stay green and are saved per unit to
`progress/unit2.conf` / `progress/unit3.conf`. Completed network units are `progress/unit1.conf` / `progress/unit2.conf` / `progress/unit3.conf`.
saved to `progress/net.conf`. Completed network units are saved to `progress/net.conf`; hardware units to
`progress/hw.conf`.
#### Keyboard shortcuts #### Keyboard shortcuts
@ -319,7 +336,7 @@ maturita.h shared types, macros, globals and prototypes
globals.c shared global state (window, stack, units, theme, …) globals.c shared global state (window, stack, units, theme, …)
theme.c theme palettes, stylesheet injection and settings file theme.c theme palettes, stylesheet injection and settings file
i18n.c Czech/English translation tables and language switching i18n.c Czech/English translation tables and language switching
icons.c Cairo-drawn vector icons (check, lock, wifi, gear, …) icons.c Cairo-drawn vector icons (check, lock, wifi, chip, …)
util.c small helpers (answer normalisation, feedback, umlaut note) util.c small helpers (answer normalisation, feedback, umlaut note)
progress.c per-unit exercise progress (load/save/completion) progress.c per-unit exercise progress (load/save/completion)
stats.c statistics page and progress aggregation stats.c statistics page and progress aggregation
@ -334,6 +351,8 @@ exercise_u3.c unit 3 ("Bei uns zu Hause") exercises
settings.c settings popover (mode, theme, language) settings.c settings popover (mode, theme, language)
net.c computer-networks path (30 nodes), units 1–10 slides net.c computer-networks path (30 nodes), units 1–10 slides
and exercises (unit 1: VLSM practice; 2–10: MC quizzes) and exercises (unit 1: VLSM practice; 2–10: MC quizzes)
hw.c computer-hardware path (10 nodes), units 1–3 slides
and quizzes (architecture, history, bit/byte)
main.c application entry point and page wiring main.c application entry point and page wiring
style.css GTK stylesheet (palette colors are injected at runtime) style.css GTK stylesheet (palette colors are injected at runtime)
Makefile build & run targets (Linux, macOS, MSYS2); `make bundle` on Windows Makefile build & run targets (Linux, macOS, MSYS2); `make bundle` on Windows
@ -348,6 +367,7 @@ progress/ created at runtime
unit2.conf unit 2 exercise completion state unit2.conf unit 2 exercise completion state
unit3.conf unit 3 exercise completion state unit3.conf unit 3 exercise completion state
net.conf computer-networks lesson completion net.conf computer-networks lesson completion
hw.conf computer-hardware lesson completion
settings.conf theme, dark/light mode and language preference settings.conf theme, dark/light mode and language preference
``` ```
@ -384,6 +404,7 @@ German in both languages.
- [x] Unit 3 ("Bei uns zu Hause") – 15 interactive exercises - [x] Unit 3 ("Bei uns zu Hause") – 15 interactive exercises
- [x] Computer networks units 1–10 (IP/VLSM + nine theory units with quizzes) - [x] Computer networks units 1–10 (IP/VLSM + nine theory units with quizzes)
- [x] Progress tracking / statistics for the networks path - [x] Progress tracking / statistics for the networks path
- [x] Technické vybavení units 1–3 (architecture, history, bit/byte + quizzes)
- [ ] Lesson progression and unlock system for the remaining units - [ ] Lesson progression and unlock system for the remaining units
- [ ] Add audio pronunciation features - [ ] Add audio pronunciation features
- [x] Add user settings panel (theme, dark/light mode, language) - [x] Add user settings panel (theme, dark/light mode, language)
@ -434,6 +455,9 @@ moderním GTK 4 rozhraním stylovaným přes CSS.
- **Správa počítačových sítí** je také otevřená (ikona Wi‑Fi) a vede na cestu - **Správa počítačových sítí** je také otevřená (ikona Wi‑Fi) a vede na cestu
s 30 jednotkami; **jednotky 1–10 jsou hratelné**, 11–30 jsou zamčené s 30 jednotkami; **jednotky 1–10 jsou hratelné**, 11–30 jsou zamčené
placeholdery placeholdery
- **Technické vybavení** je otevřené (ikona čipu) a vede na cestu
s 10 jednotkami; **jednotky 1–3 jsou hratelné**, 4–10 jsou zamčené
placeholdery
- ostatní předměty jsou ztmavené / zamčené placeholdery - ostatní předměty jsou ztmavené / zamčené placeholdery
- při úzkém okně se mapa zalomí do více řad - při úzkém okně se mapa zalomí do více řad
- **Učební cesta** – přizpůsobivá cesta s 10 jednotkami - **Učební cesta** – přizpůsobivá cesta s 10 jednotkami
@ -469,13 +493,22 @@ moderním GTK 4 rozhraním stylovaným přes CSS.
10. Model ISO/OSI a TCP/IP – snímky + kvíz 10. Model ISO/OSI a TCP/IP – snímky + kvíz
Postup u sítí se ukládá do `progress/net.conf` (příznak na jednotku); Postup u sítí se ukládá do `progress/net.conf` (příznak na jednotku);
dokončené jednotky mají fajfku na cestě a počítají se ve Statistikách dokončené jednotky mají fajfku na cestě a počítají se ve Statistikách
- **Cesta technického vybavení** – tři odemčené jednotky (snímky + kvíz):
1. **Architektura počítače** – von Neumann, Von Neumannovo schéma (ALS,
řadič, paměť, V/V) a kvíz
2. **Historie počítačů** – generace 0–4 (elektronky, tranzistory, IO,
mikroprocesory a milníky) a kvíz
3. **Zobrazování dat v počítači** – bit a byte a kvíz
Postup se ukládá do `progress/hw.conf`; dokončené jednotky mají fajfku
na cestě a počítají se ve Statistikách
- **Ukládání postupu** – hotová cvičení zezelenají; stav se ukládá do - **Ukládání postupu** – hotová cvičení zezelenají; stav se ukládá do
`progress/unit1.conf`, `progress/unit2.conf` a `progress/unit3.conf` a při `progress/unit1.conf`, `progress/unit2.conf` a `progress/unit3.conf` a při
startu se načte zpět startu se načte zpět
- **Statistiky** – ikona grafu v hlavičce ukáže postup po předmětech (součty, - **Statistiky** – ikona grafu v hlavičce ukáže postup po předmětech (součty,
procenta, dokončené jednotky), progress bary u každého předmětu (předměty procenta, dokončené jednotky), progress bary u každého předmětu (předměty
bez trackovaného obsahu jsou zamčené; **sítě** berou dokončení lekcí z bez trackovaného obsahu jsou zamčené; **sítě** a **technické vybavení**
`progress/net.conf`) a rozpad po jednotkách u Deutsch berou dokončení lekcí z `progress/net.conf` / `progress/hw.conf`) a rozpad
po jednotkách u Deutsch
- **Nastavení** – ozubené kolečko vpravo nahoře: - **Nastavení** – ozubené kolečko vpravo nahoře:
- **režim**: tmavý / světlý - **režim**: tmavý / světlý
- **téma**: 10 barevných palet - **téma**: 10 barevných palet
@ -670,9 +703,10 @@ Po spuštění se zobrazí úvodní obrazovka. Odtud:
1. Klikněte na **"Pokračuj" / "Continue"** a otevře se mapa **Předměty / 1. Klikněte na **"Pokračuj" / "Continue"** a otevře se mapa **Předměty /
Subjects**. Subjects**.
2. Klikněte na bublinu **Deutsch** (německá vlajka) pro německou cestu, nebo 2. Klikněte na bublinu **Deutsch** (německá vlajka) pro německou cestu, na
na bublinu **IP** („Správa počítačových sítí“) pro síťovou cestu. Ostatní bublinu **Wi‑Fi** („Správa počítačových sítí“) pro sítě, nebo na bublinu
předměty jsou zatím zamčené. **čipu** („Technické vybavení“) pro hardware. Ostatní předměty jsou zatím
zamčené.
3. Procházejte jednotky po cestě; při úzkém okně se cesta zalomí a scrolluje. 3. Procházejte jednotky po cestě; při úzkém okně se cesta zalomí a scrolluje.
4. Otevřete **"Neue Freunde"** (jednotka 1), **"Aus aller Welt"** (2) nebo 4. Otevřete **"Neue Freunde"** (jednotka 1), **"Aus aller Welt"** (2) nebo
**"Bei uns zu Hause"** (3) a vyberte bublinu cvičení. Jednotky 2 a 3 jdou **"Bei uns zu Hause"** (3) a vyberte bublinu cvičení. Jednotky 2 a 3 jdou
@ -683,18 +717,21 @@ Po spuštění se zobrazí úvodní obrazovka. Odtud:
(základní pojmy, klient–server/cloud, zabezpečení přenosu, signály, cesta/ (základní pojmy, klient–server/cloud, zabezpečení přenosu, signály, cesta/
kanál/okruh, multiplex, přepojování, vrstevnaté modely, ISO/OSI a TCP/IP). kanál/okruh, multiplex, přepojování, vrstevnaté modely, ISO/OSI a TCP/IP).
Jednotky 11–30 zůstávají zamčené. Jednotky 11–30 zůstávají zamčené.
6. Tlačítkem **zpět** vlevo nahoře se vrátíte na předchozí obrazovku. 6. Na cestě technického vybavení jsou otevřené jednotky **1–3** (architektura /
7. **Statistiky** (ikona grafu vpravo nahoře) ukazují postup po předmětech von Neumann, historie generací, bit a byte), každá se snímky a kvízem.
(u Deutsch i po jednotkách). Dokončené síťové lekce se započítávají do Jednotky 4–10 zůstávají zamčené.
součů předmětu. 7. Tlačítkem **zpět** vlevo nahoře se vrátíte na předchozí obrazovku.
8. **Nastavení** (ozubené kolečko) – tmavý/světlý režim, barevné téma nebo 8. **Statistiky** (ikona grafu vpravo nahoře) ukazují postup po předmětech
(u Deutsch i po jednotkách). Dokončené síťové a hardwarové lekce se
započítávají do součů předmětu.
9. **Nastavení** (ozubené kolečko) – tmavý/světlý režim, barevné téma nebo
jazyk rozhraní. jazyk rozhraní.
Hotové jsou německé jednotky 1–3 a síťové jednotky 1–10. Zamčené uzly nic Hotové jsou německé jednotky 1–3, síťové jednotky 1–10 a hardwarové jednotky
nedělají – jsou to placeholdery. Dokončená německá cvičení zůstanou zelená a 1–3. Zamčené uzly nic nedělají – jsou to placeholdery. Dokončená německá
ukládají se do `progress/unit1.conf` / `progress/unit2.conf` / cvičení zůstanou zelená a ukládají se do `progress/unit1.conf` /
`progress/unit3.conf`. Dokončené síťové jednotky se ukládají do `progress/unit2.conf` / `progress/unit3.conf`. Dokončené síťové jednotky se
`progress/net.conf`. ukládají do `progress/net.conf`, hardwarové do `progress/hw.conf`.
#### Klávesové zkratky #### Klávesové zkratky
@ -710,7 +747,7 @@ maturita.h sdílené typy, makra, globální proměnné a prototypy
globals.c sdílený globální stav (okno, stack, jednotky, téma, …) globals.c sdílený globální stav (okno, stack, jednotky, téma, …)
theme.c palety témat, vkládání stylu a soubor nastavení theme.c palety témat, vkládání stylu a soubor nastavení
i18n.c české/anglické překlady a přepínání jazyka i18n.c české/anglické překlady a přepínání jazyka
icons.c vektorové ikony kreslené Cairem (fajfka, zámek, wifi, …) icons.c vektorové ikony kreslené Cairem (fajfka, zámek, wifi, čip, …)
util.c pomocné funkce (normalizace odpovědí, feedback, poznámka) util.c pomocné funkce (normalizace odpovědí, feedback, poznámka)
progress.c postup cvičení jednotek (načtení/uložení/dokončení) progress.c postup cvičení jednotek (načtení/uložení/dokončení)
stats.c stránka statistik a agregace pokroku stats.c stránka statistik a agregace pokroku
@ -725,6 +762,8 @@ exercise_u3.c cvičení jednotky 3 („Bei uns zu Hause“)
settings.c panel nastavení (režim, téma, jazyk) settings.c panel nastavení (režim, téma, jazyk)
net.c cesta počítačových sítí (30 uzlů), jednotky 1–10 net.c cesta počítačových sítí (30 uzlů), jednotky 1–10
(1: VLSM cvičení; 2–10: kvízy s výběrem) (1: VLSM cvičení; 2–10: kvízy s výběrem)
hw.c cesta technického vybavení (10 uzlů), jednotky 1–3
(architektura, historie, bit/byte + kvízy)
main.c vstupní bod aplikace a zapojení stránek main.c vstupní bod aplikace a zapojení stránek
style.css GTK styl (barvy palety se vkládají za běhu) style.css GTK styl (barvy palety se vkládají za běhu)
Makefile build & run (Linux, macOS, MSYS2); `make bundle` na Windows Makefile build & run (Linux, macOS, MSYS2); `make bundle` na Windows
@ -739,6 +778,7 @@ progress/ vzniká za běhu
unit2.conf stav cvičení jednotky 2 unit2.conf stav cvičení jednotky 2
unit3.conf stav cvičení jednotky 3 unit3.conf stav cvičení jednotky 3
net.conf dokončení síťových lekcí net.conf dokončení síťových lekcí
hw.conf dokončení hardwarových lekcí
settings.conf téma, režim a jazyk settings.conf téma, režim a jazyk
``` ```
@ -772,6 +812,7 @@ rozhraní.
- [x] Jednotka 3 („Bei uns zu Hause“) – 15 cvičení - [x] Jednotka 3 („Bei uns zu Hause“) – 15 cvičení
- [x] Počítačové sítě: jednotky 1–10 (IP/VLSM + 9 teoretických s kvízy) - [x] Počítačové sítě: jednotky 1–10 (IP/VLSM + 9 teoretických s kvízy)
- [x] Ukládání postupu / statistiky pro síťovou cestu - [x] Ukládání postupu / statistiky pro síťovou cestu
- [x] Technické vybavení: jednotky 1–3 (architektura, historie, bit/byte + kvízy)
- [ ] Postupné odemykání zbývajících jednotek - [ ] Postupné odemykání zbývajících jednotek
- [ ] Audio / výslovnost - [ ] Audio / výslovnost
- [x] Panel nastavení (téma, režim, jazyk) - [x] Panel nastavení (téma, režim, jazyk)