QUICK_START.md

🎯 دليل الإصلاح والتشغيل السريع - SyncMaster Enhanced

Quick Fix and Startup Guide - SyncMaster Enhanced

✅ النظام جاهز للعمل! / System Ready!

تم اختبار جميع المكونات بنجاح ✅ All components tested successfully

🚀 طرق التشغيل / Startup Methods

1. التشغيل التلقائي المتقدم / Advanced Auto-Start (موصى به / Recommended)

python start_debug.py

المزايا / Benefits:

• فحص تلقائي للمشاكل / Automatic problem detection
• إصلاح تضارب المنافذ / Port conflict resolution
• رسائل خطأ واضحة / Clear error messages
• تشغيل آمن / Safe startup

2. التشغيل اليدوي / Manual Startup

# النافذة الأولى / First Terminal
python recorder_server.py

# النافذة الثانية / Second Terminal  
streamlit run app.py --server.port 8501

3. التشغيل السريع / Quick Start (Windows)

start_enhanced.bat

🌐 الروابط / URLs

بعد التشغيل الناجح / After successful startup:

• 🎙️ واجهة التسجيل / Recording Interface: http://localhost:5001
• 💻 التطبيق الرئيسي / Main Application: http://localhost:8501
• 🔄 فحص حالة الخادم / Server Status: http://localhost:5001/record

📋 خطوات الاستخدام / Usage Steps

للطلاب الجدد / For New Users:

1. إعداد اللغة / Language Setup

• اختر اللغة المفضلة (عربي/English)
• فعّل الترجمة التلقائية
• اختر اللغة المستهدفة

2. التسجيل / Recording

• اذهب لتبويب "🎙️ Record Audio"
• اضغط "Start Recording" / "بدء التسجيل"
• تحدث بوضوح
• استخدم "Mark Important" للنقاط المهمة
• اضغط "Stop" عند الانتهاء

3. المعالجة / Processing

• اضغط "Extract Text" / "استخراج النص"
• انتظر المعالجة (قد تستغرق دقائق)
• راجع النص الأصلي والمترجم

4. الحفظ / Saving

• انسخ النص المطلوب
• احفظ ملف JSON للمراجعة لاحقاً

🔧 استكشاف الأخطاء / Troubleshooting

المشكلة الأكثر شيوعاً / Most Common Issue:

Error: Failed to fetch
POST http://localhost:5001/record net::ERR_CONNECTION_REFUSED

الحل السريع / Quick Fix:

# 1. أوقف جميع العمليات / Stop all processes
taskkill /f /im python.exe

# 2. شغّل الاختبار / Run test
python test_system.py

# 3. شغّل النظام / Start system
python start_debug.py

إذا لم يعمل / If Still Not Working:

# فحص المنافذ / Check ports
netstat -an | findstr :5001
netstat -an | findstr :8501

# إعادة تثبيت التبعيات / Reinstall dependencies
pip install --upgrade -r requirements.txt

💡 نصائح مهمة / Important Tips

للحصول على أفضل النتائج / For Best Results:

جودة التسجيل / Recording Quality:

• استخدم سماعة رأس بميكروفون
• اجلس في مكان هادئ
• تحدث بوضوح وبطء نسبي
• تجنب الضوضاء الخلفية

إعدادات الترجمة / Translation Settings:

• للطلاب العرب: فعّل الترجمة للإنجليزية لفهم المصطلحات التقنية
• للطلاب الدوليين: استخدم الترجمة للغتك الأم
• للمحاضرات المختلطة: راجع النص بكلا اللغتين

استخدام العلامات / Using Markers:

• ضع علامة عند المفاهيم الجديدة
• اعلم النقاط المهمة للامتحان
• استخدم العلامات للتنظيم

📱 متطلبات النظام / System Requirements

الحد الأدنى / Minimum:

• Python 3.8+
• 4 GB RAM
• اتصال إنترنت للترجمة
• مساحة 1 GB على القرص الصلب

الموصى به / Recommended:

• Python 3.10+
• 8 GB RAM
• اتصال إنترنت سريع
• SSD للتخزين
• ميكروفون عالي الجودة

🌟 ميزات متقدمة / Advanced Features

اختصارات لوحة المفاتيح / Keyboard Shortcuts:

• Space: بدء/إيقاف التسجيل
• M: وضع علامة مهمة
• P: إيقاف مؤقت/استئناف
• R: إعادة تسجيل

واجهة برمجة التطبيقات / API Features:

• ترجمة نصوص مستقلة
• معالجة مجمعة للملفات
• كشف اللغة التلقائي
• تخصيص إعدادات الصوت

📞 الدعم التقني / Technical Support

أدوات التشخيص / Diagnostic Tools:

# اختبار شامل / Complete test
python test_system.py

# فحص الاتصال / Connection test  
python -c "import requests; print(requests.get('http://localhost:5001/record').status_code)"

# اختبار الترجمة / Translation test
python -c "from translator import AITranslator; t=AITranslator(); print(t.translate_text('Hello', 'ar'))"

ملفات السجل / Log Files:

• تحقق من console المتصفح (F12)
• راجع سجلات الطرفية
• ابحث عن ملفات tmp*.json

🎓 للمدرسين والمحاضرين / For Teachers and Lecturers

إعدادات الفصل / Classroom Setup:

• تأكد من إذن التسجيل
• وضح للطلاب كيفية الاستخدام
• اقترح جلسات تدريبية

نصائح للمحاضرات / Lecture Tips:

• تحدث بوضوح
• اكرر المصطلحات المهمة
• استخدم فترات صمت قصيرة
• اشرح بعدة لغات إذا أمكن

---

🎉 مبروك! / Congratulations!

النظام جاهز للاستخدام! / System is ready to use!

# للبدء الآن / To start now:
python start_debug.py

استمتع بتجربة تعليمية محسنة مع SyncMaster! 🚀 Enjoy an enhanced learning experience with SyncMaster! 🚀

---

📋 Checklist

• ✅ Python مثبت / Python installed
• ✅ التبعيات مثبتة / Dependencies installed
• ✅ مفتاح API مُعد / API key configured
• ✅ اختبار النظام نجح / System test passed
• ✅ جاهز للاستخدام / Ready to use

🎯 التالي: python start_debug.py