پیاده‌سازی
هر چرخش مکعب بر یک سامانهٔ اختصاصی تکیه دارد: مدل ریاضی، موتور 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، زبری و نور محیط را محاسبه می‌کنند. مدل و پویانمایی هماهنگ‌اند: یک گام به عقب، حرکت معکوس را اعمال می‌کند و دوربین فضای خالی میان پنل‌ها را در نظر می‌گیرد.
نمادگذاری نوع‌دار به حرکت‌ها و وضعیت‌های سازگار مکعب تبدیل می‌شود. صف رندرر چرخش لایه‌ها را پویانمایی می‌کند و هویت قطعه‌ها و 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 و کد بنچمارک را در بر می‌گیرد، اما پوشه‌های آزمون را نه. تعداد آزمون‌ها یعنی 1 343 اعلان JVM و 281 اعلان Android، نه تعداد اجراها. سندها متن جایگزین را نیز شامل می‌شوند؛ وجود سناریو به معنی وجود تمرین در هر درس نیست.
baselineprofile · @Testکل متن، خط‌های فیزیکی فایل‌های UTF-8 تحت پیگیری را می‌شمارد: منابع، آزمون‌ها، منابع XML/JSON، محتوای Markdown، بومی‌سازی، مستندات، ابزارهای ساخت و منابع وب. توضیحات، خط‌های خالی و نسخه‌های زبان‌ها دربرگرفته می‌شوند. رسانه، خروجی تولیدشده/ساخت، کد عرضه‌کنندگان، تنظیمات سرویس و PLAN.md موقت کنار گذاشته می‌شوند. این حجم ورودی‌های متنی پروژه است، نه LOC قابل اجرا.