Реалізація
За кожним поворотом куба стоїть власна система: математична модель, 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-контенті, локалізації, документації, інструментах збирання та web-коді. Включено коментарі, порожні рядки й копії локалей. Виключено медіа, згенеровані результати та вихід збирання, код постачальників, конфігурації сервісів і тимчасовий PLAN.md. Це обсяг текстових входів проєкту, а не виконувані LOC.