Имплементација
Иза сваког окрета коцке стоји сопствени систем: математички модел, 3D механизам и решавач који узима у обзир циљеве лекције. Android апликација користи Kotlin и Jetpack Compose.
Пресек пројекта
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 и Material 3 одређују компоненте и теме интерфејса. Adaptive одговара за распоред према величини прозора, а Navigation 3 за навигацију и обнову екрана. Стање стиже преко Coroutines и Flow; Hilt повезује модуле апликације.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileИнтерфејс, доменски уговори и подаци су у засебним модулима; Hilt повезује имплементације. Compose добија непроменљиво стање и експлицитне догађаје. Room чува историју и напредак учења, DataStore подешавања, а Navigation 3 обнавља стекове одељака.
android-ux.md
Cubiq примењује приступе које Google истиче у Apps Experience Program: Compose, прилагодљив распоред и edge-to-edge.
engine.glsl
GLSL шејдери израчунавају PBR материјале, храпавост и осветљење окружењем. Модел и анимација су усклађени: корак назад примењује обрнути потез, а камера узима у обзир простор између панела.
Типизирана нотација претвара се у потезе и усклађена стања коцке. Ред renderer механизма анимира окрете слојева, чувајући идентитет делова и facelet елемената. Формула се репродукује као низ стварних потеза, са покретањем, паузом и подешавањем темпа.
Корак напред анимира нов потез; корак назад примењује обрнути потез. Прелазак на позицију обнавља основну сцену и циљни низ. Отказивање зауставља издавање следећих потеза; започети окрет се завршава. Животни циклус EGL обрађује pause/release; без GL пут учења остаје доступан без 3D.
solver.kt
Сопствени решавач гради решење од формула и помоћних потеза текуће лекције. SolverRequest садржи стање коцке, циљне делове, закључане циљеве, дозвољене формуле, случајеве и оријентацију. Планер поштује редослед наставних циљева и штити већ сложене делове.
Планирање по фазама користи ограничени BFS, претрагу снопом и препознавање F2L случајева. Валидација проверава састав делова, превртања, увијања и паритет пермутација. Правила претраге ограничавају дубину и ширину снопа. Промена лекције отказује претрагу и спречава застарели резултат.
Резултат је PracticePlan: кораци, референце на формуле, временска линија приказа и временска линија извршавања. Објашњење чува наставну оријентацију; механизам добија пун низ за извршавање. Исходи: plan / solved / invalid input / no constrained path.
content.md
Теорија је у 756 Markdown докумената, а пракса је описана у 336 локализованих сценарија. Gradle проверава структуру превода и референце на 316 ауторских илустрација. Графика је припремљена у Blender/Cycles; Android механизам користи засебну процедуралну геометрију.
workflow.md
AGENTS.mdREADME.mdРепозиторијум је организован за развој са агентима: хијерархија AGENTS.md одређује одговорности, архитектонска ограничења и валидационе провере; README.md описују уговоре модула, KDoc API и инваријанте.
Уговори архитектуре, дизајна и локализације верзионишу се уз код. PLAN.md бележи обим и предају рада; промене уговора ажурирају надлежну документацију. Провере и генерисање иду кроз Gradle; CI гради обе варијанте за продавнице.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationТестови обухватају немогућа стања коцке, очување сложених слојева, планове учења, отказивање застарелих захтева, обнову сесија и увоз података. CI гради обе варијанте за продавнице; провере издања укључују R8, APK/AAB, контролне суме и поравнање native библиотека за странице од 16 KB.
Обим Kotlin кода броји физичке редове, укључујући коментаре, празне редове, buildSrc и benchmark код, без тестних директоријума. Број тестова означава 1 343 JVM декларација и 281 Android декларација, а не извршавања. Документи укључују резервни текст; постојање сценарија не значи вежбу у свакој лекцији.
baselineprofile · @TestУкупан текст броји физичке редове у праћеним UTF-8 датотекама: изворном коду, тестовима, XML/JSON ресурсима, Markdown садржају, локализацији, документацији, build алатима и web изворима. Укључује коментаре, празне редове и језичке копије. Искључује медије, генерисане и build излазе, код добављача, конфигурације сервиса и привремени PLAN.md. То је обим текстуалних улаза пројекта, а не извршиви LOC.