EduConnect Egypt | إيدو كونكت مصر

Egypt's Premier Thanaweya Amma Educational Support Platform منصة الدعم التعليمي الأولى للثانوية العامة في مصر

English | العربية

---

English

🌟 Project Overview

EduConnect Egypt is a specialized educational platform designed exclusively for Egyptian Thanaweya Amma students, providing affordable, high-quality supplemental education aligned with the Egyptian Ministry of Education curriculum.

🎯 Mission Statement

To empower Egyptian Thanaweya Amma students to achieve their academic dreams through high-quality, affordable educational support that respects Egyptian culture and Islamic values.

✨ Key Features

🇪🇬 Egyptian-Focused

• Thanaweya Amma curriculum aligned with Ministry of Education standards
• Egyptian teachers with Ministry certification
• 24 Egyptian governorates coverage from Cairo to Aswan
• EGP pricing with mobile wallet payment support

🌍 Arabic-First Design

• RTL interface optimized for Arabic users
• Arabic curriculum with Ministry reference codes
• Bilingual content (Arabic primary, English secondary)
• Islamic calendar integration with prayer times

💰 Affordable Education

• 60-70% cost savings compared to traditional private tutoring
• Flexible payment methods (Vodafone Cash, Orange Money, Fawry)
• Family billing for multiple students
• Governorate-based pricing adjustments

🎓 Ministry Integration

• Official curriculum mapping for 8 core subjects
• Teacher certification validation with Ministry licenses
• Grade progression logic (Grades 1-3 Secondary)
• Academic year management (2024-2025)

🏗️ Technical Architecture

Backend Stack

Framework: Laravel 12 with PHP 8.4+
Database: MySQL 8.0+ with UTF8MB4 Arabic support
Cache: Redis with Arabic key support
Queue: Laravel Queue for lesson notifications
Real-time: Laravel Reverb for Arabic notifications
API: Laravel Sanctum with Arabic responses

Frontend Stack

Framework: Laravel Livewire 3.0 + Alpine.js (RTL)
CSS: Tailwind CSS 4.0 with RTL directives
Build: Vite 5.x with Arabic font optimization
PWA: Progressive Web App for Egyptian networks

Egyptian Integrations

Payments: Vodafone Cash, Orange Money, etisalat Cash, Fawry
Calendar: Islamic calendar with Hijri dates
Geography: 24 Egyptian governorates with regions
Curriculum: Ministry of Education curriculum alignment

📚 Curriculum Coverage

8 Core Subjects (8 مواد أساسية)

1. Mathematics (الرياضيات) - Basic to Calculus
2. Physics (الفيزياء) - Classical to Modern Physics
3. Chemistry (الكيمياء) - Atomic Structure to Organic
4. Biology (الأحياء) - Cell Biology to Genetics
5. Arabic Language (اللغة العربية) - Grammar to Literature
6. English Language (اللغة الإنجليزية) - Comprehension to Writing
7. History (التاريخ) - Ancient Egypt to Modern
8. Geography (الجغرافيا) - Egypt to World Geography

Grade Progression

• Grade 1 Secondary (الصف الأول الثانوي) - Foundation (Basic → Intermediate)
• Grade 2 Secondary (الصف الثاني الثانوي) - Specialization (Intermediate → Advanced)
• Grade 3 Secondary (الصف الثالث الثانوي) - University Preparation (Advanced)

🚀 Quick Start

Prerequisites

• PHP 8.4+
• MySQL 8.0+
• Composer
• Node.js & npm
• Laravel Herd (recommended)

Installation

# Clone the repository
git clone https://github.com/yourusername/EduConnect-Egypt.git
cd EduConnect-Egypt

# Install PHP dependencies
composer install

# Install Node dependencies
npm install

# Environment setup
cp .env.example .env
php artisan key:generate

# Database setup with Egyptian data
php artisan migrate
php artisan db:seed --class=GovernorateSeeder
php artisan db:seed --class=SubjectSeeder
php artisan db:seed --class=CurriculumTopicSeeder

# Build assets
npm run build

# Start development server
php artisan serve

Verify Arabic Support

# Test Arabic content in Tinker
php artisan tinker
>>> App\Models\Subject::first()->name_ar
=> "الرياضيات"
>>> App\Models\Governorate::where('code', 'CAI')->first()->name_ar
=> "القاهرة"

🧪 Testing

Run Tests

# All tests
php artisan test

# Arabic content tests
php artisan test --filter=ArabicContent

# Egyptian features tests
php artisan test --filter=Egyptian

Test Coverage

• ✅ Arabic content storage and retrieval
• ✅ Egyptian governorate relationships
• ✅ Curriculum progression logic
• ✅ Teacher certification validation
• ✅ Islamic calendar integration

📖 Documentation

• API Documentation
• Egyptian Curriculum Guide
• Deployment Guide
• Contributing Guidelines

🤝 Contributing

We welcome contributions from Egyptian developers and educators! Please read our Contributing Guidelines for details.

Areas for Contribution

• Arabic content translation and localization
• Egyptian curriculum expansion and verification
• Islamic features enhancement (prayer times, calendar)
• Payment integration with Egyptian gateways
• Mobile optimization for Egyptian networks

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Egyptian Ministry of Education for curriculum standards
• Egyptian developers contributing to education technology
• Laravel community for excellent framework support
• Arabic localization teams for RTL support

---

Arabic

🌟 نظرة عامة على المشروع

إيدو كونكت مصر هي منصة تعليمية متخصصة مصممة حصريًا لطلاب الثانوية العامة المصريين، توفر تعليمًا تكميليًا عالي الجودة وبأسعار معقولة متوافق مع منهج وزارة التربية والتعليم المصرية.

🎯 رسالة المشروع

تمكين طلاب الثانوية العامة المصريين من تحقيق أحلامهم الأكاديمية من خلال دعم تعليمي عالي الجودة وبأسعار معقولة يحترم الثقافة المصرية والقيم الإسلامية.

✨ الميزات الرئيسية

🇪🇬 التركيز المصري

• منهج الثانوية العامة متوافق مع معايير وزارة التربية والتعليم
• معلمون مصريون معتمدون من الوزارة
• تغطية 24 محافظة مصرية من القاهرة إلى أسوان
• أسعار بالجنيه المصري مع دعم المحافظ الإلكترونية

🌍 تصميم عربي أولاً

• واجهة RTL محسنة للمستخدمين العرب
• منهج عربي مع أكواد مرجعية وزارية
• محتوى ثنائي اللغة (العربية أساسي، الإنجليزية ثانوي)
• تكامل التقويم الإسلامي مع أوقات الصلاة

💰 تعليم بأسعار معقولة

• توفير 60-70% مقارنة بالدروس الخصوصية التقليدية
• طرق دفع مرنة (فودافون كاش، أورانج موني، فوري)
• فواتير عائلية لعدة طلاب
• تعديل الأسعار حسب المحافظة

🎓 تكامل وزاري

• خريطة منهج رسمية لـ 8 مواد أساسية
• التحقق من شهادات المعلمين برخص الوزارة
• منطق تقدم الصفوف (الصفوف 1-3 ثانوي)
• إدارة السنة الدراسية (2024-2025)

📚 تغطية المنهج

8 مواد أساسية

1. الرياضيات - من الأساسيات إلى التفاضل والتكامل
2. الفيزياء - من الفيزياء الكلاسيكية إلى الحديثة
3. الكيمياء - من التركيب الذري إلى الكيمياء العضوية
4. الأحياء - من بيولوجيا الخلية إلى الوراثة
5. اللغة العربية - من النحو إلى الأدب
6. اللغة الإنجليزية - من الفهم إلى الكتابة
7. التاريخ - من مصر القديمة إلى العصر الحديث
8. الجغرافيا - من جغرافيا مصر إلى جغرافيا العالم

تدرج الصفوف

• الصف الأول الثانوي - التأسيس (أساسي ← متوسط)
• الصف الثاني الثانوي - التخصص (متوسط ← متقدم)
• الصف الثالث الثانوي - إعداد الجامعة (متقدم)

🚀 البدء السريع

المتطلبات المسبقة

• PHP 8.4+
• MySQL 8.0+
• Composer
• Node.js & npm
• Laravel Herd (مُوصى به)

التثبيت

# استنساخ المستودع
git clone https://github.com/yourusername/EduConnect-Egypt.git
cd EduConnect-Egypt

# تثبيت تبعيات PHP
composer install

# تثبيت تبعيات Node
npm install

# إعداد البيئة
cp .env.example .env
php artisan key:generate

# إعداد قاعدة البيانات مع البيانات المصرية
php artisan migrate
php artisan db:seed --class=GovernorateSeeder
php artisan db:seed --class=SubjectSeeder
php artisan db:seed --class=CurriculumTopicSeeder

# بناء الأصول
npm run build

# بدء خادم التطوير
php artisan serve

التحقق من دعم العربية

# اختبار المحتوى العربي في Tinker
php artisan tinker
>>> App\Models\Subject::first()->name_ar
=> "الرياضيات"
>>> App\Models\Governorate::where('code', 'CAI')->first()->name_ar
=> "القاهرة"

🤝 المساهمة

نرحب بمساهمات المطورين والمعلمين المصريين! يرجى قراءة إرشادات المساهمة للتفاصيل.

مجالات المساهمة

• ترجمة المحتوى العربي والتوطين
• توسيع المنهج المصري والتحقق منه
• تحسين الميزات الإسلامية (أوقات الصلاة، التقويم)
• تكامل الدفع مع البوابات المصرية
• تحسين الهاتف المحمول للشبكات المصرية

---

Made with ❤️ for Egyptian Education صُنع بـ ❤️ للتعليم المصري

Report Bug • Request Feature • Documentation • Community