Implementácia
Za každým otočením kocky stojí vlastný systém: matematický model, 3D engine a riešič zohľadňujúci ciele lekcie. Aplikácia pre Android používa Kotlin a Jetpack Compose.
Snímka 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émy rozhrania. Adaptive rieši rozloženie podľa veľkosti okna a Navigation 3 navigáciu a obnovu obrazoviek. Stav prichádza cez Coroutines a Flow; Hilt prepája moduly aplikácie.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileRozhranie, doménové kontrakty a údaje sú v oddelených moduloch; Hilt prepája implementácie. Compose prijíma nemenný stav a explicitné udalosti. Room ukladá históriu a pokrok v učení, DataStore nastavenia a Navigation 3 obnovuje zásobníky sekcií.
android-ux.md
Cubiq používa prístupy, ktoré Google zdôrazňuje v Apps Experience Program: Compose, adaptívne rozloženie a edge-to-edge.
engine.glsl
GLSL shadery počítajú materiály PBR, drsnosť a osvetlenie prostredím. Model a animácia sú zosúladené: krok späť vykoná inverzný ťah a kamera zohľadňuje voľné miesto medzi panelmi.
Typovaná notácia sa prevádza na ťahy a konzistentné stavy kocky. Front rendereru animuje otáčanie vrstiev a zachováva identity dielikov a faceletov. Algoritmus sa prehráva ako postupnosť skutočných ťahov s prehrávaním, pauzou a nastavením tempa.
Krok vpred animuje nový ťah; krok späť použije inverzný ťah. Presun na pozíciu obnoví základnú scénu a cieľovú postupnosť. Zrušenie zastaví vydávanie ďalších ťahov; už začaté otočenie sa dokončí. Životný cyklus EGL spracúva pause/release; bez GL zostáva výučba dostupná bez 3D.
solver.kt
Vlastný riešič skladá riešenie z algoritmov a pomocných ťahov aktuálnej lekcie. SolverRequest obsahuje stav kocky, cieľové dieliky, uzamknuté ciele, povolené algoritmy, prípady a orientáciu. Plánovač dodržiava poradie výučbových cieľov a chráni už zložené dieliky.
Plánovanie podľa fázy používa obmedzené BFS, lúčové prehľadávanie a rozpoznávanie prípadov F2L. Validácia kontroluje zloženie dielikov, preklopenia, pootočenia a paritu permutácií. Politika hľadania obmedzuje hĺbku a šírku lúča. Zmena lekcie zruší hľadanie a zabráni zastaranému výsledku.
Výsledkom je PracticePlan: kroky, odkazy na algoritmy, časová os zobrazenia a časová os vykonávania. Vysvetlenie zachováva výučbovú orientáciu; engine dostáva úplnú postupnosť vykonávania. Výsledky: plan / solved / invalid input / no constrained path.
content.md
Teória je uložená v 756 dokumentoch Markdown a prax je opísaná v 336 lokalizovaných scenároch. Gradle overuje štruktúru prekladov a odkazy na 316 autorských ilustrácií. Grafika bola pripravená v Blender/Cycles; engine pre Android používa samostatnú procedurálnu geometriu.
workflow.md
AGENTS.mdREADME.mdRepozitár je usporiadaný pre vývoj s agentmi: hierarchia AGENTS.md určuje zodpovednosti, architektonické obmedzenia a validačné brány; README.md opisujú kontrakty modulov, KDoc API a invarianty.
Kontrakty architektúry, dizajnu a lokalizácie sa verzujú spolu s kódom. PLAN.md zaznamenáva rozsah a odovzdanie práce; zmeny kontraktov aktualizujú ich príslušnú dokumentáciu. Kontroly a generovanie prebiehajú cez Gradle; CI zostavuje obe varianty pre obchody.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationTesty pokrývajú nemožné stavy kocky, zachovanie zložených vrstiev, výučbové plány, rušenie zastaraných požiadaviek, obnovu relácií a import údajov. CI zostavuje obe varianty pre obchody; kontroly vydania zahŕňajú R8, APK/AAB, kontrolné súčty a zarovnanie natívnych knižníc pre stránky 16 KB.
Objem Kotlin sa počíta vo fyzických riadkoch vrátane komentárov, prázdnych riadkov, buildSrc a benchmarkového kódu, bez testovacích adresárov. Počet testov znamená 1 343 deklarácií JVM a 281 deklarácií Android, nie spustení. Dokumenty zahŕňajú náhradný text; prítomnosť scenára neznamená cvičenie v každej lekcii.
baselineprofile · @TestCelkový text počíta fyzické riadky verzovaných súborov UTF-8: zdrojov, testov, prostriedkov XML/JSON, obsahu Markdown, lokalizácie, dokumentácie, nástrojov zostavenia a webových zdrojov. Zahŕňa komentáre, prázdne riadky a jazykové kópie. Vynecháva médiá, generované a zostavené výstupy, kód dodávateľov, konfiguráciu služieb a dočasný PLAN.md. Ide o objem textových vstupov projektu, nie spustiteľné LOC.