مشروع تطبيق تعلم الإنجليزية بالذكاء الاصطناعي

فكرة المشروع

مساعد تعلم إنجليزية بالذكاء الاصطناعي، موجّه لمتعلمين عرب بمستوى A2 — شرح قواعد، أسئلة اختيار من متعدد بتقييم فوري، تمارين ترجمة بالاتجاهين، وتدريب نطق بتسجيل صوتي وتقييم. بدون حسابات أو تخزين دائم — كل التفاعل جلسة واحدة، وبيعتمد على OpenAI في كل خطوة توليد أو تقييم.

ما الذي تعرضه الواجهة

لوحة الترحيب والمساعد بالوضعين الداكن والفاتح، درس “المضارع البسيط” الكامل بالوضعين، رد مساعد حقيقي مكتمل، اختبار اختيار من متعدد بتقييم أخضر صحيح، تمرين ترجمة بتقييم ناجح، وشاشة تدريب نطق بميكروفون.

دوري وقراراتي

لاحظت إن بناء التطبيق كان بيفشل على Heroku برسائل H10/H503، وتتبعت السبب لملف next.config.ts نفسه — Next.js كان بيحاول يقيّم إعدادات TypeScript وقت التشغيل مش وقت البناء بس، فاستبدلته بـnext.config.js عادي وحل المشكلة. اكتشفت كمان إن عميل OpenAI كان بيتبنى وقت تحميل الموديول، يعني أي بناء بدون مفتاح API كان هيفشل حتى لو التطبيق مش هيستخدمه فورًا — أجّلت إنشاء العميل لداخل الـhandler نفسه، فبقى البناء ممكن ينجح من غير مفتاح، والمفتاح بيتطلب بس وقت الاستخدام الفعلي. ومشكلة تقنية تالتة: التسجيل الصوتي كان بيفشل على iOS تحديدًا، فحوّلت المنطق يتفاوض على صيغة الصوت (WebM/MP4/OGG) حسب دعم المتصفح بدل ما يفترض صيغة واحدة.

الجوانب التقنية

Next.js App Router بواجهة عربية RTL ثابتة (بدون تبديل لغة واجهة، رغم إن المحتوى التعليمي ثنائي اللغة)، MUI مع RTL Emotion cache، ووضع داكن/فاتح حقيقي بحفظ التفضيل. ثلاث نقاط تكامل مع OpenAI: توليد نص (gpt-4o-mini)، وتحويل كلام لنص (whisper-1). صورة Docker متعددة المراحل بدون صلاحيات جذر (non-root).

قيمة المشروع داخل المعرض

بيوضح تشخيص مشاكل نشر حقيقية ومحدَّدة (فشل بناء، تهيئة عميل خارجي وقت غلط)، وحل توافق منصة (iOS) بحل عام (تفاوض الصيغة) بدل حل خاص بحالة واحدة.