Implementasi
Setiap putaran kubus bergantung pada sistem buatan sendiri: model matematika, mesin 3D, dan pemecah yang mempertimbangkan tujuan pelajaran. Aplikasi Android ditulis dengan Kotlin dan Jetpack Compose.
Cuplikan proyek
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 dan Material 3 menentukan komponen dan tema antarmuka. Adaptive menangani tata letak sesuai ukuran jendela, sedangkan Navigation 3 menangani navigasi dan pemulihan layar. Keadaan disampaikan melalui Coroutines dan Flow; Hilt menghubungkan modul aplikasi.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileAntarmuka, kontrak domain, dan data dipisahkan ke modul tersendiri; Hilt menghubungkan implementasinya. Compose menerima keadaan yang tidak dapat diubah dan peristiwa eksplisit. Room menyimpan riwayat dan kemajuan belajar, DataStore menyimpan pengaturan, dan Navigation 3 memulihkan tumpukan bagian.
android-ux.md
Cubiq menerapkan pendekatan yang disorot Google dalam Apps Experience Program: Compose, tata letak adaptif, dan edge-to-edge.
engine.glsl
Shader GLSL menghitung material PBR, kekasaran, dan pencahayaan lingkungan. Model dan animasi selaras: mundur satu langkah menerapkan gerakan kebalikan, dan kamera mempertimbangkan ruang di antara panel.
Notasi bertipe diubah menjadi gerakan dan keadaan kubus yang konsisten. Antrean renderer menganimasikan putaran lapisan sambil mempertahankan identitas bagian dan facelet. Rumus diputar sebagai urutan gerakan nyata, dengan putar, jeda, dan pengaturan tempo.
Langkah maju menganimasikan gerakan baru; langkah mundur menerapkan gerakan kebalikan. Lompat posisi memulihkan adegan dasar dan urutan sasaran. Pembatalan menghentikan pengiriman gerakan berikutnya; putaran yang sudah dimulai diselesaikan. Siklus hidup EGL menangani pause/release; tanpa GL, jalur belajar tetap tersedia tanpa 3D.
solver.kt
Pemecah buatan sendiri menyusun solusi dari rumus dan gerakan bantu pelajaran saat ini. SolverRequest mencakup keadaan kubus, bagian sasaran, sasaran terkunci, rumus yang diizinkan, kasus, dan orientasi. Perencana mengikuti urutan tujuan pembelajaran dan melindungi bagian yang sudah tersusun.
Perencanaan per fase memakai BFS berbatas, beam search, dan pengenalan kasus F2L. Validasi memeriksa komposisi bagian, pembalikan, puntiran, dan paritas permutasi. Kebijakan pencarian membatasi kedalaman dan lebar beam. Pergantian pelajaran membatalkan pencarian dan mencegah hasil usang.
Hasilnya PracticePlan: langkah, referensi rumus, lini masa tampilan, dan lini masa eksekusi. Penjelasan mempertahankan orientasi pembelajaran; mesin menerima urutan eksekusi lengkap. Hasil: plan / solved / invalid input / no constrained path.
content.md
Teori disimpan dalam 756 dokumen Markdown, dan latihan ditentukan dalam 336 skenario yang dilokalkan. Gradle memvalidasi struktur terjemahan dan referensi ke 316 ilustrasi asli. Grafik disiapkan dengan Blender/Cycles; mesin Android memakai geometri prosedural terpisah.
workflow.md
AGENTS.mdREADME.mdRepositori disusun untuk pengembangan dengan agen: hierarki AGENTS.md menetapkan kepemilikan, batasan arsitektur, dan gerbang validasi; README.md menjelaskan kontrak modul, KDoc menjelaskan API dan invarian.
Kontrak arsitektur, desain, dan lokalisasi dikelola versinya bersama kode. PLAN.md mencatat lingkup dan serah terima; perubahan kontrak memperbarui dokumentasi pemiliknya. Pemeriksaan dan generasi melalui Gradle; CI membangun kedua varian toko.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationPengujian mencakup keadaan kubus yang mustahil, mempertahankan lapisan yang sudah tersusun, rencana belajar, pembatalan permintaan usang, pemulihan sesi, dan impor data. CI membangun kedua varian toko; pemeriksaan rilis meliputi R8, APK/AAB, checksum, dan penyelarasan pustaka native untuk halaman 16 KB.
Jumlah Kotlin menghitung baris fisik, termasuk komentar, baris kosong, buildSrc, dan kode benchmark, tanpa direktori pengujian. Jumlah pengujian berarti 1 343 deklarasi JVM dan 281 deklarasi Android, bukan eksekusi. Dokumen memuat teks fallback; adanya skenario tidak berarti setiap pelajaran memiliki latihan.
baselineprofile · @TestTotal teks menghitung baris fisik dalam berkas UTF-8 yang dilacak: sumber, pengujian, sumber daya XML/JSON, konten Markdown, lokalisasi, dokumentasi, alat build, dan sumber web. Komentar, baris kosong, dan salinan bahasa termasuk. Media, keluaran generasi/build, kode vendor, konfigurasi layanan, dan PLAN.md sementara dikecualikan. Ini volume masukan teks proyek, bukan LOC yang dapat dieksekusi.