Cube Eye

Drew Developer

Бул оюн тууралуу

## 🚀 Жалпы маалымат

**CubeEye** - бул 3x3 Рубик кубиктерин чечүү үчүн иштелип чыккан өркүндөтүлгөн Android тиркемеси. Ал физикалык кубикти сканерлөө үчүн компьютердик көрүү мүмкүнчүлүгүн колдонот жана аны дээрлик оптималдуу кыймылдар менен чечүү үчүн интерактивдүү, анимацияланган 3D көрсөтмөсүн берет.

## ✨ Негизги функциялары

### 📷 Акылдуу сканерлөө системасы

* **Реалдуу убакыттагы түстү аныктоо:** Ыңгайлаштырылган `ColorAnalyzer` аркылуу камераны колдонуп, кубдун бетинин түстөрүн автоматтык түрдө аныктайт.
* **Жетектелген сканерлөө:** Интуитивдик UI катмары колдонуучуларга бардык 6 бетти туура тартуу процессинде жетекчилик кылат.
* **Текшерүү логикасы:** Орнотулган `CubeValidator` сканерленген абалды улантуудан мурун физикалык жактан чечиле тургандыгын камсыз кылат.
* **Кол менен оңдоо:** `ColorPickerDialog` камтылган, бул колдонуучуларга жарыктандыруу шарттары автоматтык түрдө аныктоого таасир этсе, түстөрдү кол менен тууралоого мүмкүндүк берет.

### 🧩 Акылдуу чечим

* **Кочиемба алгоритми:** Атактуу эки фазалуу алгоритмди (*min2phase* китепканасы аркылуу) интеграциялап, көбүнчө 20дан аз кыймылды талап кылат.
* **Тез жергиликтүү эсептөө:** Тармакка туташпастан, түз эле түзмөктө татаал скребдерди бир нече секунданын ичинде чечет.

### 🎥 Интерактивдүү 3D колдонмо

* **3D визуализация:** Чыныгы кубдун абалын так туураган толугу менен интерактивдүү 3D рендерингди (`Cube3DView`) камтыйт.
* **Кадам сайын анимация:** Колдонуучулар чечим кыймылдарын өз темпинде ойной, тындыра жана сүртүп көрө алышат.

## 🛠 Техникалык өзгөчөлүктөрү

* **Заманбап Android Stack:** Толугу менен Kotlin жана Jetpack Compose (Материал 3) колдонуп курулган.
* **Бекем архитектура:** MVVM үлгүлөрүн, көз карандылыкты киргизүү үчүн Hiltти жана асинхрондук операциялар үчүн Coroutinesти колдонуп, Таза архитектура принциптерин карманат.
* **CameraX:** Түз эфирде алдын ала көрүү жана сүрөттөрдү талдоо үчүн туруктуу жана натыйжалуу камера негизин ишке ашырат.
* **SceneView:** Жогорку өндүрүмдүү 3D рендеринг үчүн SceneView китепканасын колдонот.

## 🐛 Белгилүү көйгөйлөр / TODOлор

* Өтө жарык шарттарын жакшыраак башкаруу үчүн түстөрдү аныктоо босоголорун оптималдаштырыңыз.
* "min2phase" китепканасын интеграциялоону автоматташтырыңыз (учурда кол менен булак файлдары катары кошулган).

Эмне жаңылык

This is our very first release!