Triển khai
Mỗi lần xoay khối lập phương dựa trên một hệ thống tự xây dựng: mô hình toán học, bộ máy 3D và bộ giải tính đến mục tiêu bài học. Ứng dụng Android được viết bằng Kotlin và Jetpack Compose.
Ảnh chụp trạng thái dự án
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 và Material 3 định nghĩa thành phần và chủ đề giao diện. Adaptive xử lý bố cục theo kích thước cửa sổ, còn Navigation 3 xử lý điều hướng và khôi phục màn hình. Trạng thái được truyền qua Coroutines và Flow; Hilt kết nối các mô-đun ứng dụng.
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofileGiao diện, hợp đồng miền và dữ liệu được chia thành các mô-đun riêng; Hilt kết nối các phần triển khai. Compose nhận trạng thái bất biến và sự kiện tường minh. Room lưu lịch sử và tiến độ học, DataStore lưu cài đặt, còn Navigation 3 khôi phục ngăn xếp của từng phần.
android-ux.md
Cubiq triển khai các cách tiếp cận được Google nhấn mạnh trong Apps Experience Program: Compose, bố cục thích ứng và edge-to-edge.
engine.glsl
Shader GLSL tính vật liệu PBR, độ nhám và ánh sáng môi trường. Mô hình và hoạt ảnh đồng bộ: lùi một bước áp dụng nước đi đảo ngược, còn camera tính đến khoảng trống giữa các bảng.
Ký hiệu có kiểu được chuyển thành nước đi và trạng thái khối lập phương nhất quán. Hàng đợi renderer tạo hoạt ảnh xoay tầng, giữ nguyên danh tính của mảnh và facelet. Công thức phát thành chuỗi nước đi thực, với phát, tạm dừng và chỉnh tốc độ.
Tiến một bước tạo hoạt ảnh nước đi mới; lùi một bước áp dụng nước đi đảo ngược. Chuyển đến vị trí khôi phục cảnh cơ sở và chuỗi đích. Hủy dừng việc gửi nước đi tiếp theo; lượt xoay đã bắt đầu sẽ hoàn tất. Vòng đời EGL xử lý pause/release; khi không có GL, lộ trình học vẫn dùng được mà không cần 3D.
solver.kt
Bộ giải tự xây dựng tạo lời giải từ công thức và nước đi phụ của bài học hiện tại. SolverRequest gồm trạng thái khối lập phương, mảnh đích, mục tiêu khóa, công thức được phép, trường hợp và hướng. Bộ lập kế hoạch tuân theo thứ tự mục tiêu học và bảo vệ mảnh đã giải.
Lập kế hoạch theo giai đoạn dùng BFS có giới hạn, tìm kiếm chùm và nhận diện trường hợp F2L. Kiểm tra xác minh thành phần mảnh, lật, xoắn và tính chẵn lẻ của hoán vị. Chính sách tìm kiếm giới hạn độ sâu và độ rộng chùm. Đổi bài học hủy tìm kiếm và ngăn kết quả lỗi thời.
Kết quả là PracticePlan: bước, tham chiếu công thức, dòng thời gian hiển thị và dòng thời gian thực thi. Giải thích giữ định hướng học tập; bộ máy nhận toàn bộ chuỗi thực thi. Kết quả: plan / solved / invalid input / no constrained path.
content.md
Lý thuyết được lưu trong 756 tài liệu Markdown, phần luyện tập được định nghĩa trong 336 kịch bản bản địa hóa. Gradle kiểm tra cấu trúc bản dịch và tham chiếu đến 316 hình minh họa tự tạo. Đồ họa được chuẩn bị bằng Blender/Cycles; bộ máy Android dùng hình học thủ tục riêng.
workflow.md
AGENTS.mdREADME.mdKho mã được tổ chức để phát triển với tác nhân: phân cấp AGENTS.md xác định quyền sở hữu, giới hạn kiến trúc và cổng kiểm tra; README.md mô tả hợp đồng mô-đun, KDoc mô tả API và bất biến.
Hợp đồng kiến trúc, thiết kế và bản địa hóa được quản lý phiên bản cùng mã. PLAN.md ghi phạm vi và bàn giao; thay đổi hợp đồng cập nhật tài liệu chịu trách nhiệm. Kiểm tra và sinh mã đi qua Gradle; CI build cả hai biến thể cửa hàng.
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentationKiểm thử bao gồm trạng thái khối lập phương không thể tồn tại, giữ nguyên các tầng đã giải, kế hoạch học, hủy yêu cầu lỗi thời, khôi phục phiên và nhập dữ liệu. CI build cả hai biến thể cửa hàng; kiểm tra phát hành gồm R8, APK/AAB, tổng kiểm tra và căn chỉnh thư viện native cho trang 16 KB.
Quy mô Kotlin được đếm theo dòng vật lý, gồm chú thích, dòng trống, buildSrc và mã benchmark, không gồm thư mục kiểm thử. Số kiểm thử là 1 343 khai báo JVM và 281 khai báo Android, không phải số lần chạy. Tài liệu gồm văn bản dự phòng; có kịch bản không có nghĩa mọi bài học đều có luyện tập.
baselineprofile · @TestTổng văn bản đếm dòng vật lý trong tệp UTF-8 được theo dõi: mã nguồn, kiểm thử, tài nguyên XML/JSON, nội dung Markdown, bản địa hóa, tài liệu, công cụ build và nguồn web. Bao gồm chú thích, dòng trống và bản sao ngôn ngữ. Loại trừ media, đầu ra sinh tự động/build, mã bên cung cấp, cấu hình dịch vụ và PLAN.md tạm thời. Đây là quy mô đầu vào văn bản của dự án, không phải LOC thực thi.