## 🚀 نظرة عامة
**CubeEye** هو تطبيق أندرويد متطور مصمم لحل مكعبات روبيك 3x3. يستخدم التطبيق تقنية رؤية الكمبيوتر لمسح مكعب حقيقي، ويوفر دليلاً ثلاثي الأبعاد تفاعليًا ومتحركًا لحله بحركات شبه مثالية.
## ✨ الميزات الرئيسية
### 📷 نظام مسح ذكي
* **الكشف عن الألوان في الوقت الفعلي:** يحدد التطبيق ألوان أوجه المكعب تلقائيًا باستخدام الكاميرا عبر محلل الألوان المخصص.
* **المسح الموجه:** واجهة مستخدم سهلة الاستخدام ترشد المستخدمين خلال عملية التقاط جميع الأوجه الستة بشكل صحيح.
* **منطق التحقق:** يضمن مدقق المكعب المدمج إمكانية حل المكعب الممسوح ضوئيًا قبل المتابعة.
* **التصحيح اليدوي:** يتضمن مربع حوار لاختيار الألوان يسمح للمستخدمين بتعديل الألوان يدويًا إذا أثرت ظروف الإضاءة على الكشف التلقائي.
### 🧩 مُحلِّل ذكي
* **خوارزمية كوتشيمبا:** يدمج خوارزمية المرحلتين الشهيرة (عبر مكتبة *min2phase*) لإيجاد حلول شبه مثالية، وغالبًا ما تتطلب أقل من 20 حركة.
* **حساب محلي سريع:** يحل مسائل الخلط المعقدة في ثوانٍ مباشرةً على الجهاز دون الحاجة إلى اتصال بالإنترنت.
### 🎥 دليل ثلاثي الأبعاد تفاعلي
* **عرض ثلاثي الأبعاد:** يتميز بعرض ثلاثي الأبعاد تفاعلي بالكامل (`Cube3DView`) يُحاكي بدقة حالة المكعب الحقيقي.
* **رسوم متحركة خطوة بخطوة:** يمكن للمستخدمين تشغيل وإيقاف وتقديم خطوات الحل بالسرعة التي تناسبهم.
## 🛠 أبرز الميزات التقنية
* **مكدس أندرويد حديث:** تم بناؤه بالكامل باستخدام Kotlin وJetpack Compose (Material 3).
مُصمم بالكامل باستخدام Kotlin وJetpack Compose (Material 3). * **بنية قوية:** تتبع مبادئ البنية النظيفة، باستخدام أنماط MVVM، وHilt لحقن التبعيات، وCoroutines للعمليات غير المتزامنة.
* **CameraX:** توفر بنية كاميرا مستقرة وفعالة للمعاينة المباشرة وتحليل الصور.
* **SceneView:** تستخدم مكتبة SceneView لعرض ثلاثي الأبعاد عالي الأداء.
## 🐛 المشكلات المعروفة / المهام المتبقية
* تحسين عتبات اكتشاف الألوان للتعامل بشكل أفضل مع ظروف الإضاءة القصوى.
* أتمتة دمج مكتبة "min2phase" (مضمنة حاليًا كملفات مصدر يدوية).
تاريخ التحديث
06/01/2026