jelmer/topoquiz

Watch

Fork 0

Gameplay-design: Geobas 7 & 8 — sequentiële fases met 3 visuele primitieven #58

New issue

Closed

opened 2026-04-09 08:47:01 +02:00 by Ghost · 1 comment

Ghost commented

2026-04-09 08:47:01 +02:00

(Migrated from codeberg.org)

Uitgangspunt

Een kind ziet altijd één primitief op de kaart. Landen zijn gekleurde vormen, steden zijn stippen, rivieren zijn lijnen. Binnen één ronde oefen je altijd één type, zodat je leert vergelijken en nooit door elkaar gegooid wordt.

Het cruciale inzicht — drie primitieven volstaan

Alle tien elementtypen uit Geobas 7/8 zijn terug te voeren op één van drie visuele primitieven die al in de app bestaan:

Primitief	Elementtypen	Bestaand voorbeeld
Punt	Stad, hoofdstad, klein eiland, bergtop	Groningen, Texel
Polygoon	Land, gewest/regio, groot eiland, zee, meer, woestijn, gebergte-gebied	Provincies, Waddenzee
Lijn	Rivier, kanaal, zeestraat	Rijn, Nieuwe Waterweg

Géén tien nieuwe quizTypes nodig — alleen country (polygoon) als nieuwe rendering. De rest past in bestaande place / water mechaniek.

Pedagogisch uitgangspunt

Geobas-hoofdstukken zijn één A4 met blanco kaart + gelabelde kaart. Kinderen leren door herhaald wijzen op een kaart. Dat betekent:

Kaart is primary UI (is al zo)
3 bestaande modi (MC, typen, klik) dekken alles
Kinderen leren conceptuele onderscheidingen: land = vorm, stad = plek, rivier = route

```
Startscherm
├─ Dagelijkse uitdaging
├─ [Groep 5] [Groep 6] [Groep 7] [Groep 8] ← groepselectie (#39)
└─ Bonus level

Na "Groep 7":
├─ 7.1 Landen van Europa
├─ 7.2 België en Luxemburg
├─ ...
└─ 7.9 Zuidoost-Europa

Na "7.4 Duitsland":
├─ "Dit hoofdstuk bevat: 18 steden, 6 regio's, 3 rivieren"
└─ [Meerkeuze] [Typen] [Klik op kaart] ← bestaande 3 knoppen
```

Groep-selectie (#39) beperkt de lijst tot ~9 levels per groep
Mode-select houdt dezelfde structuur als nu: één titel, drie modus-knoppen. Géén tabs.
Set-beschrijving toont vooraf welke categorieën het level bevat

2. Set-indeling — sequentiële fases in één sessie

Elke set is een geordende reeks fases. Een fase = homogene pool van items van hetzelfde type. Bij het starten doorloop je de fases automatisch op volgorde: pas als fase 1 voltooid is, begint fase 2.

Volgorde van fases — van groot naar klein / bekend naar detail:

Landen (grootste vormen)
Provincies / regio's / gewesten
Steden (hoofdsteden + grote steden)
Gebergten / woestijnen / eilanden
Wateren (rivieren, zeeën, meren, kanalen)

Deze volgorde past bij hoe Geobas het zelf presenteert: eerst grof oriënteren, dan inzoomen.

Voorbeeld 7.1 — Landen van Europa:
```
Set 7.1 — één sessie, twee fases op volgorde
Fase 1: Landen → 20 landen (polygoon)
↓ bij voltooiing → tussenscherm "🎉 Landen af! Nu de hoofdsteden →"
Fase 2: Hoofdsteden → 20 hoofdsteden (punt)
↓ bij voltooiing → eindscherm
```

Voorbeeld 7.4 — Duitsland:
```
Set 7.4 — één sessie, drie fases op volgorde
Fase 1: Steden → 18 steden (punt)
Fase 2: Regio's → 6 regio's (polygoon)
Fase 3: Rivieren → 3 rivieren (lijn)
```

Hoe het kind het beleeft:

Kiest set 7.4 → ziet intro "Dit hoofdstuk bevat steden, regio's en rivieren"
Kiest modus (bijv. Meerkeuze)
Quiz start met eerste stad (fase "Steden"). Voortgangbalk: "Steden 0/18"
Na alle 18 mastered: korte transitie "🎉 Steden af! Nu de regio's →" (~1.5s)
Quiz gaat door met de eerste regio (polygoon op de kaart)
Enz. tot alle fases voltooid → eindscherm met totaalscore

Voortgang en pauzeren:

Per item wordt streak/mastery bijgehouden zoals nu
Een fase is voltooid als alle items ervan `streak >= mastery`
Voortgang bewaard per set+modus; bij terugnavigatie start je bij het huidige item in de huidige fase

Voordelen van sequentieel boven tabs:

UI blijft identiek aan nu — geen extra tab-laag
Eén doorlopende sessie matcht het Geobas-oefenblad
Pedagogisch natuurlijke volgorde van groot naar klein
Kind hoeft geen keuzes te maken — minder cognitieve belasting
Distractors blijven automatisch binnen huidige fase (geen type-mix)
Homogene sets (enkele fase) zijn impliciet — geen aparte code-paden

3. Rendering per primitief

Punt (steden, kleine eilanden): blauwe dot, oranje halo als actief — zoals nu bij plaatsen.

Polygoon (landen, regio's, zeeën, meren, woestijnen, gebergten): blauwe vulkleur bij 35% opacity, donkerblauwe rand, mastered = grijs — zoals nu bij provincies.

Lijn (rivieren, kanalen, zeestraten): dikke blauwe lijn, gloei-effect bij highlight — zoals nu bij wateren.

4. Quiz-modi per primitief

De drie modi werken voor alle primitieven; alleen de interactie verschilt:

Modus	Punt	Polygoon	Lijn
Meerkeuze	Stip knippert → kies naam	Vorm licht op → kies naam	Lijn licht op → kies naam
Typen	Stip + hint → typ naam	Vorm + hint → typ naam	Lijn + hint → typ naam
Klik op kaart	Klik nabij het punt (<drempel km)	Klik ín het polygoon (0 km = correct)	Klik nabij de lijn (<drempel km)

Klik-drempels schalen met set-viewport:

Nederland-set: 20 km correct / 60 km bijna (huidig — ongewijzigd)
Europa-set: 100 km correct / 300 km bijna
Wereld-set: 250 km correct / 700 km bijna

5. Visuele overzichtelijkheid

Binnen een fase is alles homogeen — geen menging van stippen + polygonen + lijnen tegelijk
Mastered items blijven zichtbaar maar vervagen (grijstint)
Bij klik-op-kaart modus: niet-geraden items verbergen (net als nu bij water)
Viewport past zich aan aan set-bounds (Europa voor 7.x, wereld voor 8.x), niet op NL
Eén highlight tegelijk — het huidige item springt eruit

6. Wat dit NIET doet

Geen nieuwe modi toevoegen — MC/typen/klik zijn genoeg
Geen visuele gamification (geen badges, geen sterren tijdens de quiz) — Geobas-focus blijft
Geen gemengde-type vragen ("is dit een land of een rivier?")
Geen "world tour" supersets — elk Geobas-hoofdstuk blijft zijn eigen set

Gerelateerd

Technische uitwerking: nieuwe tech-infra issue (volgt)
Pilot/validatie: nieuwe Baltische-staten test-level issue (volgt)
Groep-selectiescherm: #39
Alle 18 levels: #40–#57

## Uitgangspunt > *Een kind ziet altijd één primitief op de kaart. Landen zijn gekleurde vormen, steden zijn stippen, rivieren zijn lijnen. Binnen één ronde oefen je altijd één type, zodat je leert vergelijken en nooit door elkaar gegooid wordt.* ## Het cruciale inzicht — drie primitieven volstaan Alle tien elementtypen uit Geobas 7/8 zijn terug te voeren op één van drie visuele primitieven die **al in de app bestaan**: | Primitief | Elementtypen | Bestaand voorbeeld | |-----------|-------------|---------------------| | **Punt** | Stad, hoofdstad, klein eiland, bergtop | Groningen, Texel | | **Polygoon** | Land, gewest/regio, groot eiland, zee, meer, woestijn, gebergte-gebied | Provincies, Waddenzee | | **Lijn** | Rivier, kanaal, zeestraat | Rijn, Nieuwe Waterweg | Géén tien nieuwe quizTypes nodig — alleen `country` (polygoon) als nieuwe rendering. De rest past in bestaande `place` / `water` mechaniek. ## Pedagogisch uitgangspunt Geobas-hoofdstukken zijn één A4 met blanco kaart + gelabelde kaart. Kinderen leren door herhaald wijzen op een kaart. Dat betekent: - Kaart is primary UI (is al zo) - 3 bestaande modi (MC, typen, klik) dekken alles - Kinderen leren conceptuele onderscheidingen: land = vorm, stad = plek, rivier = route ## 1. Menu-structuur — drie lagen (geen tabs) \`\`\` Startscherm ├─ Dagelijkse uitdaging ├─ [Groep 5] [Groep 6] [Groep 7] [Groep 8] ← groepselectie (#39) └─ Bonus level Na "Groep 7": ├─ 7.1 Landen van Europa ├─ 7.2 België en Luxemburg ├─ ... └─ 7.9 Zuidoost-Europa Na "7.4 Duitsland": ├─ "Dit hoofdstuk bevat: 18 steden, 6 regio's, 3 rivieren" └─ [Meerkeuze] [Typen] [Klik op kaart] ← bestaande 3 knoppen \`\`\` - Groep-selectie (#39) beperkt de lijst tot ~9 levels per groep - Mode-select houdt **dezelfde structuur als nu**: één titel, drie modus-knoppen. Géén tabs. - Set-beschrijving toont vooraf welke categorieën het level bevat ## 2. Set-indeling — sequentiële fases in één sessie Elke set is een **geordende reeks fases**. Een fase = homogene pool van items van hetzelfde type. Bij het starten doorloop je de fases **automatisch op volgorde**: pas als fase 1 voltooid is, begint fase 2. **Volgorde van fases** — van groot naar klein / bekend naar detail: 1. Landen (grootste vormen) 2. Provincies / regio's / gewesten 3. Steden (hoofdsteden + grote steden) 4. Gebergten / woestijnen / eilanden 5. Wateren (rivieren, zeeën, meren, kanalen) Deze volgorde past bij hoe Geobas het zelf presenteert: eerst grof oriënteren, dan inzoomen. **Voorbeeld 7.1 — Landen van Europa:** \`\`\` Set 7.1 — één sessie, twee fases op volgorde Fase 1: Landen → 20 landen (polygoon) ↓ bij voltooiing → tussenscherm "🎉 Landen af! Nu de hoofdsteden →" Fase 2: Hoofdsteden → 20 hoofdsteden (punt) ↓ bij voltooiing → eindscherm \`\`\` **Voorbeeld 7.4 — Duitsland:** \`\`\` Set 7.4 — één sessie, drie fases op volgorde Fase 1: Steden → 18 steden (punt) Fase 2: Regio's → 6 regio's (polygoon) Fase 3: Rivieren → 3 rivieren (lijn) \`\`\` **Hoe het kind het beleeft:** 1. Kiest set 7.4 → ziet intro "Dit hoofdstuk bevat steden, regio's en rivieren" 2. Kiest modus (bijv. Meerkeuze) 3. Quiz start met eerste stad (fase "Steden"). Voortgangbalk: *"Steden 0/18"* 4. Na alle 18 mastered: korte transitie *"🎉 Steden af! Nu de regio's →"* (~1.5s) 5. Quiz gaat door met de eerste regio (polygoon op de kaart) 6. Enz. tot alle fases voltooid → eindscherm met totaalscore **Voortgang en pauzeren:** - Per item wordt streak/mastery bijgehouden zoals nu - Een fase is voltooid als alle items ervan \`streak >= mastery\` - Voortgang bewaard per set+modus; bij terugnavigatie start je bij het huidige item in de huidige fase **Voordelen van sequentieel boven tabs:** - UI blijft identiek aan nu — geen extra tab-laag - Eén doorlopende sessie matcht het Geobas-oefenblad - Pedagogisch natuurlijke volgorde van groot naar klein - Kind hoeft geen keuzes te maken — minder cognitieve belasting - Distractors blijven automatisch binnen huidige fase (geen type-mix) - Homogene sets (enkele fase) zijn impliciet — geen aparte code-paden ## 3. Rendering per primitief **Punt** (steden, kleine eilanden): blauwe dot, oranje halo als actief — zoals nu bij plaatsen. **Polygoon** (landen, regio's, zeeën, meren, woestijnen, gebergten): blauwe vulkleur bij 35% opacity, donkerblauwe rand, mastered = grijs — zoals nu bij provincies. **Lijn** (rivieren, kanalen, zeestraten): dikke blauwe lijn, gloei-effect bij highlight — zoals nu bij wateren. ## 4. Quiz-modi per primitief De drie modi werken voor alle primitieven; alleen de interactie verschilt: | Modus | Punt | Polygoon | Lijn | |-------|------|----------|------| | **Meerkeuze** | Stip knippert → kies naam | Vorm licht op → kies naam | Lijn licht op → kies naam | | **Typen** | Stip + hint → typ naam | Vorm + hint → typ naam | Lijn + hint → typ naam | | **Klik op kaart** | Klik nabij het punt (<drempel km) | Klik ín het polygoon (0 km = correct) | Klik nabij de lijn (<drempel km) | **Klik-drempels schalen met set-viewport:** - Nederland-set: 20 km correct / 60 km bijna (huidig — ongewijzigd) - Europa-set: 100 km correct / 300 km bijna - Wereld-set: 250 km correct / 700 km bijna ## 5. Visuele overzichtelijkheid 1. **Binnen een fase is alles homogeen** — geen menging van stippen + polygonen + lijnen tegelijk 2. **Mastered items blijven zichtbaar** maar vervagen (grijstint) 3. **Bij klik-op-kaart modus**: niet-geraden items verbergen (net als nu bij water) 4. **Viewport past zich aan** aan set-bounds (Europa voor 7.x, wereld voor 8.x), niet op NL 5. **Eén highlight tegelijk** — het huidige item springt eruit ## 6. Wat dit NIET doet - Geen nieuwe modi toevoegen — MC/typen/klik zijn genoeg - Geen visuele gamification (geen badges, geen sterren tijdens de quiz) — Geobas-focus blijft - Geen gemengde-type vragen ("is dit een land of een rivier?") - Geen "world tour" supersets — elk Geobas-hoofdstuk blijft zijn eigen set ## Gerelateerd - Technische uitwerking: nieuwe tech-infra issue (volgt) - Pilot/validatie: nieuwe Baltische-staten test-level issue (volgt) - Groep-selectiescherm: #39 - Alle 18 levels: #40–#57

Ghost commented

2026-04-14 23:09:41 +02:00

(Migrated from codeberg.org)

Gameplay-design volledig gerealiseerd in v2.0.0. Alle ontwerp-pijlers zijn live:

Menu-structuur: groep-selectie (#39), mode-select zonder tabs, set-beschrijving vooraf
Sequentiële fases: phases array in SETS, fase-overgang met transitiescherm, voortgang per fase bewaard
Drie primitieven: place (punt), province/country (polygoon), water (lijn/polygoon)
Drie modi × drie primitieven: meerkeuze, typen en klik werken voor alle primitieven, met set-specifieke klik-drempels (clickCorrectKm / clickCloseKm)
Visuele regels: binnen fase homogeen, mastered vervaagt, één highlight tegelijk, viewport volgt bounds

Gevalideerd via set 7.1 (#40), 7.2 (#41) en 7.3 (#42). De pilot (#61) is in v2.0.1 opgeruimd.

Gameplay-design volledig gerealiseerd in v2.0.0. Alle ontwerp-pijlers zijn live: - **Menu-structuur**: groep-selectie (#39), mode-select zonder tabs, set-beschrijving vooraf - **Sequentiële fases**: `phases` array in SETS, fase-overgang met transitiescherm, voortgang per fase bewaard - **Drie primitieven**: `place` (punt), `province`/`country` (polygoon), `water` (lijn/polygoon) - **Drie modi × drie primitieven**: meerkeuze, typen en klik werken voor alle primitieven, met set-specifieke klik-drempels (`clickCorrectKm` / `clickCloseKm`) - **Visuele regels**: binnen fase homogeen, mastered vervaagt, één highlight tegelijk, viewport volgt `bounds` Gevalideerd via set 7.1 (#40), 7.2 (#41) en 7.3 (#42). De pilot (#61) is in v2.0.1 opgeruimd.