## 🚀 ទិដ្ឋភាពទូទៅ
**CubeEye** គឺជាកម្មវិធី Android កម្រិតខ្ពស់ដែលត្រូវបានរចនាឡើងដើម្បីដោះស្រាយគូប Rubik's Cubes 3x3។ វាប្រើប្រាស់ចក្ខុវិស័យកុំព្យូទ័រដើម្បីស្កេនគូបរូបវន្ត និងផ្តល់នូវមគ្គុទ្ទេសក៍ 3D ដែលមានចលនាអន្តរកម្ម ដើម្បីដោះស្រាយវាដោយប្រើចលនាស្ទើរតែល្អបំផុត។
## ✨ លក្ខណៈពិសេសសំខាន់ៗ
### 📷 ប្រព័ន្ធស្កេនឆ្លាតវៃ
* **ការរកឃើញពណ៌ពេលវេលាជាក់ស្តែង៖** កំណត់ពណ៌មុខគូបដោយស្វ័យប្រវត្តិដោយប្រើកាមេរ៉ាតាមរយៈ `ColorAnalyzer` ផ្ទាល់ខ្លួន។
* **ការស្កេនដែលមានការណែនាំ៖** ផ្ទៃ UI ដ៏វិចារណញាណណែនាំអ្នកប្រើប្រាស់តាមរយៈដំណើរការនៃការចាប់យកមុខទាំង 6 បានត្រឹមត្រូវ។
* **តក្កវិជ្ជាផ្ទៀងផ្ទាត់៖** `CubeValidator` ដែលភ្ជាប់មកជាមួយធានាថាស្ថានភាពស្កេនអាចដោះស្រាយបានមុនពេលបន្ត។
* **ការកែតម្រូវដោយដៃ៖** រួមបញ្ចូល `ColorPickerDialog` ដែលអនុញ្ញាតឱ្យអ្នកប្រើប្រាស់កែតម្រូវពណ៌ដោយដៃ ប្រសិនបើលក្ខខណ្ឌពន្លឺប៉ះពាល់ដល់ការរកឃើញដោយស្វ័យប្រវត្តិ។
### 🧩 កម្មវិធីដោះស្រាយឆ្លាតវៃ
* **ក្បួនដោះស្រាយ Kociemba៖** រួមបញ្ចូលក្បួនដោះស្រាយពីរដំណាក់កាលដ៏ល្បីល្បាញ (តាមរយៈបណ្ណាល័យ *min2phase*) ដើម្បីស្វែងរកដំណោះស្រាយដែលស្ទើរតែល្អបំផុត ដែលជារឿយៗតម្រូវឱ្យមានចលនាតិចជាង 20 ។
* **ការគណនាក្នុងស្រុករហ័ស៖** ដោះស្រាយការច្របូកច្របល់ស្មុគស្មាញក្នុងរយៈពេលប៉ុន្មានវិនាទីដោយផ្ទាល់នៅលើឧបករណ៍ដោយមិនចាំបាច់មានការតភ្ជាប់បណ្តាញ។
### 🎥 មគ្គុទ្ទេសក៍ 3D អន្តរកម្ម
* **ការមើលឃើញ 3D៖** មានការបង្ហាញ 3D អន្តរកម្មពេញលេញ (`Cube3DView`) ដែលធ្វើត្រាប់តាមស្ថានភាពគូបពិតប្រាកដបានយ៉ាងត្រឹមត្រូវ។
* **ចលនាមួយជំហានម្តងៗ៖** អ្នកប្រើប្រាស់អាចលេង ផ្អាក និងជូតតាមរយៈចលនាដំណោះស្រាយតាមល្បឿនផ្ទាល់ខ្លួនរបស់ពួកគេ។
## 🛠 ចំណុចសំខាន់ៗបច្ចេកទេស
* **Android Stack ទំនើប៖** បង្កើតឡើងទាំងស្រុងដោយប្រើ Kotlin និង Jetpack Compose (សម្ភារៈ 3)។
* **ស្ថាបត្យកម្មរឹងមាំ៖** អនុវត្តតាមគោលការណ៍ស្ថាបត្យកម្មស្អាត ដោយប្រើប្រាស់លំនាំ MVVM, Hilt សម្រាប់ការចាក់បញ្ចូលភាពអាស្រ័យ និង Coroutines សម្រាប់ប្រតិបត្តិការអសមកាល។
* **CameraX៖** អនុវត្តគ្រឹះកាមេរ៉ាដែលមានស្ថេរភាព និងមានប្រសិទ្ធភាពសម្រាប់ការមើលជាមុនផ្ទាល់ និងការវិភាគរូបភាព។
* **SceneView៖** ប្រើប្រាស់បណ្ណាល័យ SceneView សម្រាប់ការបង្ហាញ 3D ដែលមានដំណើរការខ្ពស់។
## 🐛 បញ្ហាដែលគេស្គាល់ / ការងារត្រូវធ្វើ
* បង្កើនប្រសិទ្ធភាពកម្រិតរកឃើញពណ៌ ដើម្បីដោះស្រាយលក្ខខណ្ឌពន្លឺខ្លាំងបានកាន់តែប្រសើរ។
* ធ្វើឱ្យការរួមបញ្ចូលបណ្ណាល័យ "min2phase" ដោយស្វ័យប្រវត្តិ (បច្ចុប្បន្នរួមបញ្ចូលជាឯកសារប្រភពដោយដៃ)។
បានដំឡើងកំណែនៅ
6 មករា 2026