Knus & Krokant — Projectoverzicht

1. Architectuur in het kort

Onderdeel	Rol
`useGameState.ts` (~5.800 regels)	De kern: alle game-state en -logica in één `useGameLoop`-hook (tick, acties, opslag).
`App.tsx`	Zones, meubels, sprite-plaatsing, personeel-routes, modals.
`components/` (26)	UI: klanten, stations, café-tafels, SVG-art, modals.
`logic/` (13 modules, 11 tests)	Pure, geteste spel-logica losgetrokken uit de kern.
`constants.ts`	~80 producten, level-drempels, festivals, marketing, decoraties.

Voortgang zit in één state-object in LocalStorage (bakery-sim-save-v2), via een opslag-abstractie zodat op Android een native driver kan worden ingeplugd. Pure logica (voorraad, missies, klant-orders, mixer, weer, dag-thema's, deals, foodtruck) heeft 64 Vitest-tests.

2. Functionaliteit

Kern-gameloop & zones

Dag/nacht-cyclus met spelklok: overdag klanten, om 18:00 sluiting; 's avonds menu + upgrades, daarna start je zelf de volgende dag.
Zes zones (snap-scroll): kantine + magazijn → keuken → winkel → café → terras → straat. Ontgrendelen op niveau (café 2, terras 3, bezorging 7).

Bakken & stations

Ovens met tray-systeem, prep-taps, garneren en aanbranden; upgradebaar.
Koffiemachine, koelkast (rijzen/houdbaarheid), werkbank (assemblage), deegmixer (kneedt deeg, auto door keukenhulp).

Producten (~80)

Brood, gebak & zoet (croissants, koeken, vlaaien, eclairs, tompouce, brownies).
Taarten in twee stappen: oven bakt een bodem (halffabricaat), de werkbank maakt af.
Hartig: 2 tosti's + 4 panini's (grill-stap) + 6 koude broodjes uit broodbodem + beleg.
Dranken: koffievarianten, thee, warme chocolademelk, koude dranken.
Consistente yields per bakplaat (×2 met brede-tray-upgrade).

Klanten & verkoop

Klant-state-machine (waiting → leaving) met netjes weglopen en een tevreden/boze afloop.
Kanalen: toonbank, café-tafels, terras, bezorging (SVG-scooter, lvl 7) en afhaal.
Speciale klanten (grote order, gulle fooi, ongeduldig, koninklijk, feestje) + kortingslogica voor bijna-bedorven voorraad.

Personeel

Rollen: kassamedewerker, keukenhulp, bediening, barista, robot, bezorger.
Stamina, moraal, staking, pauze in de kantine; aannemen, opslag (+€5), trainen (+1 niveau). Robot laadt 's nachts op.

Economie & progressie

Munten als valuta; tokens (diamanten) voor missies/events.
XP & niveaus 1–8 (8 = Meesterbakker); gebalanceerde prijzen (winst schaalt met niveau + moeite).

Dagmenu & deals

Dagmenu samenstellen (vanaf niveau 3) + één dagspecial (extra vraag + fooi) + plan-streak.
Dag-thema's (Brooddag, Zoete Dag, Koffie & Gebak, Hartige Dag, Gemengd) geven een categorie extra vraag.
Combo-deal: twee producten samen voor een combiprijs (−15%); bulk-deal: staffelkorting op een staple.

Weer & foodtruck

Weer-pil in de header met voorspelling; beïnvloedt de vraag en staat in het dagmenu.
Foodtruck (lvl 7): 1× per week naar een markt/festival (4 types met productvoorkeuren); komt een dag later terug met de opbrengst.

Beloningen, events & begeleiding

Marketing, reputatie (sterren), missies, dagelijkse bonus, offline-opbrengst, ~15 prestaties.
Seizoens-events (feestdag-bonus + confetti) en random events (rat-invasie, UFO's, kernoorlog …).
Coach-hint (1 tip/dag) + onboarding-checklist.

Eindspel & stijl

Eindspel-scherm (Meesterbakker) bij het hoogste niveau, met levensloop-statistieken + confetti; daarna endless doorspelen.
Cozy pixel-art/SVG-stijl, sfeerlaag (stofdeeltjes, vignette, schermtrilling), portret-afdwinging.
Platform: web + Android (Capacitor: opslag-driver, safe-areas, terug-knop, statusbalk, lokale notificaties).

3. Ontwikkelingsgeschiedenis

Fase 0 — Fundament & pixel-art 12 juni

Projectopzet (React + TS + Vite). Pixel-art overhaul, gameplay-balans en UX-verbeteringen; eerste random-events en het opschonen van personeel-/klant-fysica.

Fase 1 — Game feel, routes & sfeer 12–15 juni

De zaak ging leven: personeelsmoraal, coach-hints, onboarding, loon & staking; café & terras met tafels/parasols; loop-routes (klanten lopen netjes weg, deuren openen, baksels op de balie, personeel draagt producten). Veel bediening-fixes; eerste CLAUDE.md.

Fase 2 — Retentie & systemen 17 juni

Startgids met opdrachten per fase, prestaties/achievements, offline-opbrengst met welkom-terug-scherm, seizoens-events met confetti, en zones die vergrendeld al zichtbaar zijn.

Fase 3 — Refactor + verbeterplannen 19–21 juni

Pure logica naar src/logic/ met de eerste tests. Uitvoerbare plannen 01–06: valuta-opschoning, tekst & copy.ts, dagmenu-ritueel, visuele laag (sfeer + emoji→SVG), en de deegmixer (station → kopen → auto-kneden).

Fase 4 — Inhoud, balans, rebrand & Android 22–26 juni

Gerechten-balans (yields + taarten in twee stappen), tosti's/panini's/broodjes, Android via Capacitor (opslag → platform → icoon → safe-areas/terug-knop → notificaties), rebrand naar "Knus & Krokant", en een economie/progressie-herijking.

Fase 5 — Nieuwe features & eindspel 27 juni

Plan 08: weer prominent + voorspelling, rijker dagmenu (thema's + combo + bulk-deals), foodtruck, en het eindspel-scherm (Meesterbakker) + documentatie-opschoning.

4. Huidige status & open punten

Vrijwel alles uit de plannen is afgerond. Wat resteert:

Android-uitrol: code klaar; resteert een lokale APK/AAB-build (Android Studio + JDK + SDK), een performance-pass en de Play Store-listing. Optioneel: cloud-save en monetisatie.
Bewust geparkeerd: refactor van de grote stateful kern (laag rendement, hoog risico) en enkele optionele visuele details.

🥐 Knus & Krokant — Projectoverzicht