Implementace
Za každým otočením kostky stojí vlastní systém: matematický model, 3D engine a řešič zohledňující cíle lekce. Aplikace pro Android používá Kotlin a Jetpack Compose.
Snímek projektu
test* / androidTest* · @Teststack.kt
| Kotlin | 2.4.21 |
|---|---|
| Compose BOM | 2026.09.00 |
| Material 3 | 1.5.0-beta01 |
| Adaptive | 1.3.0 |
| Navigation 3 | 1.2.0 |
| AGP | 9.4.1 |
| KSP | 2.3.12 |
| Gradle | 9.7.0 |
Jetpack Compose a Material 3 určují komponenty a témata rozhraní. Adaptive řeší rozložení podle velikosti okna a Navigation 3 navigaci a obnovu obrazovek. Stav přichází přes Coroutines a Flow; Hilt propojuje moduly aplikace.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileRozhraní, doménové kontrakty a data jsou v oddělených modulech; Hilt propojuje implementace. Compose přijímá neměnný stav a explicitní události. Room ukládá historii a postup učení, DataStore nastavení a Navigation 3 obnovuje zásobníky sekcí.
android-ux.md
Cubiq používá přístupy, které Google zdůrazňuje v Apps Experience Program: Compose, adaptivní rozložení a edge-to-edge.
engine.glsl
GLSL shadery počítají materiály PBR, drsnost a osvětlení prostředím. Model a animace jsou sladěné: krok zpět provede inverzní tah a kamera zohledňuje volné místo mezi panely.
Typovaná notace se převádí na tahy a konzistentní stavy kostky. Fronta rendereru animuje otáčení vrstev a zachovává identity dílků a faceletů. Algoritmus se přehrává jako posloupnost skutečných tahů s přehráváním, pauzou a nastavením tempa.
Krok vpřed animuje nový tah; krok zpět použije inverzní tah. Přesun na pozici obnoví základní scénu a cílovou posloupnost. Zrušení zastaví vydávání dalších tahů; již zahájené otočení se dokončí. Životní cyklus EGL zpracovává pause/release; bez GL zůstává výuka dostupná bez 3D.
solver.kt
Vlastní řešič skládá řešení z algoritmů a pomocných tahů aktuální lekce. SolverRequest obsahuje stav kostky, cílové dílky, uzamčené cíle, povolené algoritmy, případy a orientaci. Plánovač dodržuje pořadí výukových cílů a chrání již složené dílky.
Plánování podle fáze používá omezené BFS, paprskové prohledávání a rozpoznávání případů F2L. Validace kontroluje složení dílků, překlopení, pootočení a paritu permutací. Politika hledání omezuje hloubku a šířku paprsku. Změna lekce zruší hledání a zabrání zastaralému výsledku.
Výsledkem je PracticePlan: kroky, odkazy na algoritmy, časová osa zobrazení a časová osa provádění. Vysvětlení zachovává výukovou orientaci; engine dostává úplnou posloupnost provádění. Výsledky: plan / solved / invalid input / no constrained path.
content.md
Teorie je uložena v 756 dokumentech Markdown a praxe je popsána v 336 lokalizovaných scénářích. Gradle ověřuje strukturu překladů a odkazy na 316 autorských ilustrací. Grafika byla připravena v Blender/Cycles; engine pro Android používá samostatnou procedurální geometrii.
workflow.md
AGENTS.mdREADME.mdRepozitář je uspořádán pro vývoj s agenty: hierarchie AGENTS.md určuje odpovědnosti, architektonická omezení a validační brány; README.md popisují kontrakty modulů, KDoc API a invarianty.
Kontrakty architektury, designu a lokalizace se verzují spolu s kódem. PLAN.md zaznamenává rozsah a předání práce; změny kontraktů aktualizují jejich příslušnou dokumentaci. Kontroly a generování probíhají přes Gradle; CI sestavuje obě varianty pro obchody.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTesty pokrývají nemožné stavy kostky, zachování složených vrstev, výukové plány, rušení zastaralých požadavků, obnovu relací a import dat. CI sestavuje obě varianty pro obchody; kontroly vydání zahrnují R8, APK/AAB, kontrolní součty a zarovnání nativních knihoven pro stránky 16 KB.
Objem Kotlin se počítá ve fyzických řádcích včetně komentářů, prázdných řádků, buildSrc a benchmarkového kódu, bez testovacích adresářů. Počet testů znamená 1 343 deklarací JVM a 281 deklarací Android, nikoli spuštění. Dokumenty zahrnují náhradní text; přítomnost scénáře neznamená cvičení v každé lekci.
baselineprofile · @TestCelkový text počítá fyzické řádky verzovaných souborů UTF-8: zdrojů, testů, prostředků XML/JSON, obsahu Markdown, lokalizace, dokumentace, sestavovacích nástrojů a webových zdrojů. Zahrnuje komentáře, prázdné řádky a jazykové kopie. Vynechává média, generované a sestavené výstupy, kód dodavatelů, konfiguraci služeb a dočasný PLAN.md. Jde o objem textových vstupů projektu, ne spustitelné LOC.