إنجاز المعلم - تطبيق متابعة أداء المعلمين
تطبيق React Native متكامل لإدارة ومتابعة أداء المعلمين في المدارس، مع واجهة مستخدم عربية وميزات متقدمة.
🚀 الميزات الرئيسية
📊 متابعة الأداء
- تقييم شامل لأداء المعلمين
- إدارة الخطط العلاجية
- تتبع تقدم الطلاب
- تقارير تفاعلية مفصلة
👥 إدارة الطلاب
- إضافة وتعديل بيانات الطلاب
- تصنيف الطلاب حسب المستوى
- إدارة الغياب والحضور
- خطط علاجية مخصصة
📅 إدارة الوقت
- تقويم مدرسي متكامل
- إدارة العطل الرسمية
- جدول زمني للمعلمين
- تذكيرات وإشعارات
🔔 نظام التنبيهات
- إشعارات مهمة وعاجلة
- تصنيف حسب الأولوية
- إدارة التنبيهات
📱 واجهة مستخدم
- تصميم عصري ومتجاوب
- دعم كامل للغة العربية
- اتجاه من اليمين إلى اليسار (RTL)
- تجربة مستخدم محسنة
🛠️ التقنيات المستخدمة
- React Native - إطار العمل الأساسي
- Expo - منصة التطوير والنشر
- TypeScript - لكتابة كود آمن ومنظم
- Supabase - قاعدة البيانات والخدمات السحابية
- AsyncStorage - التخزين المحلي
- React Navigation - إدارة التنقل
📦 التثبيت والتشغيل
المتطلبات الأساسية
- Node.js (v16 أو أحدث)
- npm أو yarn
- Expo CLI
- Android Studio (للتطوير على Android)
- Xcode (للتطوير على iOS)
خطوات التثبيت
- استنساخ المشروع
git clone <repository-url>
cd enjaz-almualm
- تثبيت التبعيات
npm install
# أو
yarn install
- إعداد Supabase
- إنشاء مشروع جديد في Supabase
- نسخ URL و API Key
- تحديث
config/supabase.ts
- تشغيل التطبيق
npm start
# أو
expo start
🔧 الإعدادات
إعداد قاعدة البيانات
راجع ملف SUPABASE_SETUP.md للحصول على تعليمات مفصلة لإعداد قاعدة البيانات.
إعداد التخزين
راجع ملف STORAGE_SETUP.md للحصول على تعليمات إعداد التخزين السحابي.
📱 البناء والنشر
بناء للإنتاج
# بناء لـ Android
eas build --platform android
# بناء لـ iOS
eas build --platform ios
نشر التحديثات
eas update
🧪 الاختبار
تشغيل الاختبارات
npm test
دليل الاختبار السريع
راجع ملف QUICK_TEST_GUIDE.md للحصول على دليل سريع للاختبار.
📚 الوثائق
دليل المطور
TESTING_GUIDE.md - دليل شامل للاختبارQUICK_START_STORAGE.md - دليل سريع للتخزينSUPABASE_SETUP.md - إعداد Supabase
دليل المستخدم
- واجهة التطبيق سهلة الاستخدام
- دعم كامل للغة العربية
- تعليمات واضحة لكل ميزة
🔒 الأمان
- تشفير البيانات الحساسة
- مصادقة آمنة
- حماية من الهجمات الشائعة
- تحديثات أمنية منتظمة
🤝 المساهمة
نرحب بالمساهمات! يرجى اتباع الخطوات التالية:
- Fork المشروع
- إنشاء branch جديد للميزة
- Commit التغييرات
- Push إلى Branch
- إنشاء Pull Request
📄 الترخيص
هذا المشروع مرخص تحت رخصة MIT.
📞 الدعم
للحصول على الدعم أو الإبلاغ عن مشاكل:
- إنشاء Issue في GitHub
- التواصل عبر البريد الإلكتروني
- مراجعة الوثائق المتوفرة
🔄 التحديثات
الإصدار الحالي: 1.0.0
- واجهة مستخدم محسنة
- إصلاح الأخطاء
- تحسينات الأداء
- ميزات جديدة
ملاحظة: هذا التطبيق مصمم خصيصاً للبيئة التعليمية العربية ويحتوي على ميزات مخصصة لاحتياجات المعلمين في المنطقة.
