🇨🇳 بوت تعلم اللغة الصينية

بوت تليجرام تفاعلي ومتطور لتعلم اللغة الصينية مع نظام نقاط ومستويات وميزات تحفيزية للطلاب.

✨ الميزات

🎯 للمستخدمين

• 📚 محتوى تعليمي شامل: دروس HSK من المستوى 1 إلى 6
• 🕌 القرآن الكريم: باللغة الصينية
• 🗂️ قاموس عربي-صيني: للمفردات والعبارات
• 📖 قصص تعليمية: لتحسين الفهم
• 🔤 دروس القواعد: شرح مفصل للقواعد الصينية
• 💬 محادثات يومية: عبارات وحوارات عملية
• 🃏 بطاقات تعليمية (Flashcards): للحفظ والمراجعة
• ❓ اختبارات تفاعلية: لقياس التقدم

🎮 نظام التحفيز والنقاط

• 💎 نظام النقاط: احصل على 5 نقاط عند إكمال كل درس
• ⭐ المستويات: ارتقِ بمستواك مع كل 100 نقطة
• 🔥 السلسلة اليومية: حافظ على نشاطك اليومي
• 🏆 الإنجازات: اكسب شارات وإنجازات
• 👤 الملف الشخصي: تابع تقدمك وإحصائياتك
• 📊 إحصائيات مفصلة: راقب أداءك ونموك

🛠️ للمشرفين

• ➕ إضافة محتوى: أضف دروساً وملفات جديدة
• 📝 إدارة المحتوى: استعرض وعدل المحتوى الموجود
• ❌ حذف المحتوى: احذف العناصر غير المرغوبة
• 📁 رفع الملفات: ادعم PDF، صور، فيديو، وصوت
• 📊 الإحصائيات: راقب استخدام البوت والمستخدمين
• 👥 إدارة المستخدمين: شاهد أفضل المستخدمين والنشاط

🚀 التثبيت والتشغيل

المتطلبات

• Python 3.8 أو أحدث
• حساب تليجرام
• بوت تليجرام (احصل على التوكن من @BotFather)

خطوات التثبيت

1. استنساخ المشروع

git clone https://github.com/adbhelx/web.git
cd web

2. تثبيت المكتبات المطلوبة

pip install -r requirements.txt

3. إعداد الإعدادات
   • افتح ملف config.py
   • ضع توكن البوت الخاص بك
   • أضف معرف المستخدم الخاص بك (User ID) للحصول على صلاحيات المشرف

TOKEN = "YOUR_BOT_TOKEN_HERE"
ADMIN_USER_IDS = [123456789]  # ضع معرفك هنا

ملاحظة: للحصول على معرف المستخدم الخاص بك، أرسل /start إلى @userinfobot

4. تشغيل البوت

python bot.py

🌐 النشر على استضافة مجانية

الخيار 1: Render.com (موصى به)

1. إنشاء حساب على Render

2. إنشاء Web Service جديد

   • اختر "New +" → "Web Service"
   • اربط مستودع GitHub الخاص بك
   • اختر الفرع (Branch): main

3. إعدادات الخدمة

   • Name: chinese-learning-bot
   • Environment: Python 3
   • Build Command: pip install -r requirements.txt
   • Start Command: python bot.py

4. إضافة متغيرات البيئة

   • TELEGRAM_TOKEN: توكن البوت الخاص بك
   • ADMIN_USER_IDS: [123456789] (ضع معرفك)

5. انقر على "Create Web Service"

الخيار 2: Railway.app

1. إنشاء حساب على Railway

2. إنشاء مشروع جديد

   • اختر "New Project"
   • اختر "Deploy from GitHub repo"
   • حدد المستودع الخاص بك

3. إضافة متغيرات البيئة

   • انتقل إلى "Variables"
   • أضف TELEGRAM_TOKEN و ADMIN_USER_IDS

4. النشر التلقائي

   • سيتم نشر البوت تلقائياً

الخيار 3: PythonAnywhere

1. إنشاء حساب على PythonAnywhere

2. رفع الملفات

   • استخدم لوحة التحكم لرفع ملفات المشروع

3. تثبيت المكتبات

pip3 install --user -r requirements.txt

4. تشغيل البوت
   • أنشئ "Always-on task" لتشغيل bot.py

📱 الأوامر المتاحة

• /start - بدء البوت وعرض القائمة الرئيسية
• /help - عرض دليل الاستخدام
• /stats - عرض إحصائيات البوت
• /cancel - إلغاء العملية الحالية

🎨 مقترحات التطوير المستقبلية

ميزات مقترحة للنسخة القادمة:

1. 🎯 اختبارات تفاعلية: أسئلة متعددة الخيارات مع تصحيح فوري
2. 🗣️ تمارين النطق: تسجيلات صوتية للكلمات والجمل
3. 📅 تذكيرات يومية: إشعارات للمستخدمين للحفاظ على السلسلة
4. 🏅 لوحة المتصدرين: منافسة بين المستخدمين
5. 🎁 نظام المكافآت: جوائز للمستخدمين النشطين
6. 📚 مكتبة الموارد: روابط لمصادر خارجية
7. 💬 غرف الدردشة: للتواصل بين المتعلمين
8. 🤖 الذكاء الاصطناعي: مساعد ذكي للإجابة على الأسئلة
9. 📊 تقارير التقدم: تقارير أسبوعية وشهرية
10. 🌙 الوضع الليلي: واجهة مريحة للعين

🤝 المساهمة

نرحب بمساهماتكم! إذا كان لديك اقتراحات أو تحسينات:

1. Fork المشروع
2. أنشئ فرعاً جديداً (git checkout -b feature/AmazingFeature)
3. Commit التغييرات (git commit -m 'Add some AmazingFeature')
4. Push إلى الفرع (git push origin feature/AmazingFeature)
5. افتح Pull Request

📄 الترخيص

هذا المشروع مفتوح المصدر ومتاح للجميع للاستخدام والتطوير.

📧 التواصل

إذا كان لديك أي أسئلة أو اقتراحات، لا تتردد في فتح Issue على GitHub.

🙏 شكر وتقدير

شكراً لكل من ساهم في تطوير هذا البوت ولجميع المستخدمين الذين يدعمون المشروع!

---

صُنع بـ ❤️ للمتعلمين العرب للغة الصينية

🌟 لا تنسَ إعطاء المشروع نجمة (Star) إذا أعجبك!