## 🚀 Muhtasari
**CubeEye** ni programu ya hali ya juu ya Android iliyoundwa kutatua Miche ya Rubik ya 3x3. Inatumia maono ya kompyuta kuchanganua mchemraba halisi na hutoa mwongozo shirikishi na wa uhuishaji wa 3D ili kuutatua kwa kutumia mienendo karibu bora.
## ✨ Vipengele Muhimu
### 📷 Mfumo wa Kuchanganua Mahiri
* **Ugunduzi wa Rangi wa Wakati Halisi:** Hutambua kiotomatiki rangi za uso wa mchemraba kwa kutumia kamera kupitia `ColorAnalyzer` maalum.
* **Uchanganuzi Unaoongozwa:** Ufunikaji wa kiolesura cha mtumiaji unaoeleweka huwaongoza watumiaji kupitia mchakato wa kunasa nyuso zote 6 kwa usahihi.
* **Mantiki ya Uthibitishaji:** `CubeValidator` iliyojengewa ndani inahakikisha hali ya kuchanganua inaweza kutatuliwa kimwili kabla ya kuendelea.
* **Marekebisho ya Mwongozo:** Inajumuisha `ColorPickerDialog` inayowaruhusu watumiaji kurekebisha rangi mwenyewe ikiwa hali ya mwanga huathiri ugunduzi otomatiki.
### 🧩 Kitatuzi Mahiri
* **Algorithimu ya Kociemba:** Huunganisha Algorithimu maarufu ya Awamu Mbili (kupitia maktaba ya *min2phase*) ili kupata suluhisho zinazokaribia kuwa bora zaidi, mara nyingi zinahitaji chini ya hatua 20.
* **Uhesabuji wa Haraka wa Ndani:** Hutatua misukosuko tata kwa sekunde moja kwa moja kwenye kifaa bila kuhitaji muunganisho wa mtandao.
### 🎥 Mwongozo Shirikishi wa 3D
* **Uonyeshaji wa 3D:** Inaangazia onyesho shirikishi la 3D (`Cube3DView`) linaloiga kwa usahihi hali halisi ya mchemraba.
* **Uhuishaji wa Hatua kwa Hatua:** Watumiaji wanaweza kucheza, kusitisha, na kusugua kupitia misukosuko ya suluhisho kwa kasi yao wenyewe.
## 🛠 Mambo Muhimu ya Kiufundi
* **Mrundiko wa Kisasa wa Android:** Imejengwa kabisa kwa kutumia Kotlin na Jetpack Compose (Nyenzo 3).
* **Usanifu Imara:** Hufuata kanuni za Usanifu Safi, kwa kutumia mifumo ya MVVM, Hilt kwa ajili ya kuingiza utegemezi, na Coroutines kwa shughuli zisizofuatana.
* **KameraX:** Hutekeleza msingi thabiti na mzuri wa kamera kwa ajili ya hakikisho la moja kwa moja na uchambuzi wa picha.
* **SceneView:** Hutumia maktaba ya SceneView kwa ajili ya utoaji wa 3D wenye utendaji wa hali ya juu.
## 🐛 Masuala / MABADILIKO Yanayojulikana
* Boresha vizingiti vya kugundua rangi ili kushughulikia vyema hali mbaya za mwanga.
* Boresha ujumuishaji wa maktaba ya "min2phase" kiotomatiki (kwa sasa imejumuishwa kama faili chanzo za mwongozo).
Ilisasishwa tarehe
6 Jan 2026