الكتاب المبين هو تطبيق ويب شامل ومتطور يهدف إلى توفير منصة متكاملة للمعرفة الإسلامية. يجمع التطبيق بين التراث الإسلامي الأصيل والتكنولوجيا الحديثة لتقديم تجربة تعليمية وروحانية فريدة.
- مجموعة ضخمة من الكتب الإسلامية (القرآن، الحديث، الفقه، العقيدة، السيرة)
- أكثر من 1000 كتاب مُصنف ومُنظم بدقة
- إمكانية القراءة المباشرة مع قارئ متطور
- تحميل الكتب بصيغ مختلفة (PDF, EPUB)
- نظام بحث ذكي وفلترة متقدمة
- تلاوات القرآن الكريم بأصوات أشهر القراء
- محاضرات ودروس إسلامية صوتية
- كتب صوتية للسيرة النبوية والفقه
- مشغل صوتي متطور مع قوائم تشغيل
- مواقيت الصلاة الدقيقة حسب الموقع
- التقويم الهجري التفاعلي
- الأذكار والأدعية اليومية
- دليل الصلاة التفصيلي
- أركان الإسلام الخمسة
- مساعد ذكي مدعوم بالذكاء الاصطناعي
- إجابات على الأسئلة الإسلامية
- تفسير الآيات والأحاديث
- إرشادات فقهية موثوقة
- تصميم متجاوب يدعم جميع الأجهزة
- دعم كامل للغة العربية (RTL)
- وضع ليلي/نهاري
- واجهة سهلة الاستخدام
- React 18 - مكتبة واجهة المستخدم
- TypeScript - للتطوير الآمن والمُنظم
- Vite - أداة بناء سريعة
- Tailwind CSS - إطار عمل CSS الحديث
- Wouter - مكتبة التوجيه البسيطة
- Tanstack Query - إدارة حالة الخادم
- Framer Motion - الرسوم المتحركة
- Radix UI - مكونات واجهة المستخدم
- Node.js - بيئة تشغيل JavaScript
- Express.js - إطار عمل خادم الويب
- TypeScript - للتطوير الآمن
- Drizzle ORM - إدارة قاعدة البيانات
- PostgreSQL - قاعدة البيانات الرئيسية
- Zod - التحقق من صحة البيانات
- Google Gemini API - المساعد الذكي
- معالجة النصوص العربية - تحليل المحتوى الإسلامي
elkitab-almubeen/
├── client/ # تطبيق الواجهة الأمامية
│ ├── src/
│ │ ├── components/ # مكونات React
│ │ │ ├── Library/ # مكونات المكتبة
│ │ │ ├── ui/ # مكونات واجهة المستخدم
│ │ │ └── ...
│ │ ├── pages/ # صفحات التطبيق
│ │ ├── hooks/ # React Hooks مخصصة
│ │ ├── contexts/ # Context providers
│ │ ├── services/ # خدمات API
│ │ ├── utils/ # أدوات مساعدة
│ │ ├── data/ # بيانات ثابتة
│ │ └── locales/ # ملفات الترجمة
│ └── public/ # الملفات العامة
├── server/ # خادم Backend
│ ├── index.ts # نقطة دخول الخادم
│ ├── routes.ts # مسارات API
│ └── ...
├── shared/ # كود مشترك
│ └── schema.ts # مخططات قاعدة البيانات
└── docs/ # التوثيق
- Node.js (18+)
- npm أو yarn
- PostgreSQL (14+)
-
استنساخ المستودع
git clone https://github.com/yourusername/elkitab-almubeen.git cd elkitab-almubeen -
تثبيت التبعيات
npm install
-
إعداد متغيرات البيئة
cp .env.example .env
قم بتحديث متغيرات البيئة:
DATABASE_URL=postgresql://username:password@localhost:5432/elkitab_db VITE_GEMINI_API_KEY=your_gemini_api_key NODE_ENV=development
-
إعداد قاعدة البيانات
npm run db:push
-
تشغيل التطبيق
npm run dev
التطبيق سيكون متاحاً على:
http://localhost:5000
- id: معرف فريد
- title: عنوان الكتاب
- author: المؤلف
- category: التصنيف
- language: اللغة
- format: نوع الملف
- downloadUrl: رابط التحميل
- coverImage: صورة الغلاف
- tags: علامات البحث
- rating: التقييم
- downloads: عدد التحميلات- id: معرف فريد
- title: عنوان المقطع
- reciter: القارئ/المحاضر
- type: نوع المحتوى
- totalDuration: المدة الإجمالية
- downloadUrl: رابط التحميل- userId: معرف المستخدم
- bookId: معرف الكتاب
- currentPage: الصفحة الحالية
- readingTime: وقت القراءة
- bookmarks: الإشارات المرجعية- عرض بطاقة الكتاب
- أزرار القراءة والتحميل
- معلومات التقييم والإحصائيات
- قارئ الكتب التفاعلي
- تحكم في حجم الخط والوضع
- نظام الإشارات المرجعية
- تتبع تقدم القراءة
- مشغل الصوتيات المتقدم
- قوائم التشغيل
- تحكم في السرعة والصوت
- إدارة التحميلات
- تتبع التقدم
- إحصائيات التحميل
- إدارة عمليات التحميل
- تتبع التقدم
- تخزين الحالة محلياً
- التكامل مع Gemini AI
- معالجة الاستفسارات الإسلامية
- توليد الإجابات الذكية
- العربية (اللغة الأساسية)
- الإنجليزية
- الفرنسية
- الأوردو
- إنشاء ملف ترجمة في
client/src/locales/ - إضاف�� اللغة في
LanguageContext - تحديث أعلام اللغات في المكونات
- تصميم متجاوب لجميع الأحجام
- دعم كامل للقراءة من اليمين لليسار (RTL)
- تباين ألوان عالي
- دعم قارئات الشاشة
- تنقل لوحة المفاتيح
- تشفير البيانات الحساسة
- مصادقة آمنة للمستخدمين
- حماية من هجمات XSS و CSRF
- إدارة الجلسات الآمنة
- Lazy Loading للمكونات الثقيلة
- Code Splitting لتقليل حجم الحزم
- Image Optimization لتحسين الصور
- Caching للبيانات المتكررة
- Progressive Web App (PWA) ready
# تشغيل الاختبارات
npm run test
# تغطية الاختبارات
npm run test:coverage
# اختبارات التكامل
npm run test:e2enpm run buildvercel --prodnetlify deploy --prodنرحب بمساهماتكم! يرجى اتباع الخطوات التالية:
- Fork المستودع
- إنشاء branch جديد (
git checkout -b feature/amazing-feature) - Commit التغييرات (
git commit -m 'إضافة ميزة رائعة') - Push إلى Branch (
git push origin feature/amazing-feature) - فتح Pull Request
- كود نظيف ومُوثق
- اختبارات شاملة
- التزام بمعايير التصميم
- دعم اللغة العربية
- تطبيق الهاتف المحمول (React Native)
- المزيد من الكتب والمصادر
- نظام تقييم وتعليقات المستخدمين
- مجموعات دراسية تفاعلية
- إشعارات أوقات الصلاة
- وضع عدم الاتصال (Offline Mode)
- مزامنة السحابة للبيانات
- تكامل مع منصات التواصل الاجتماعي
- البريد الإلكتروني: support@elkitab-almubeen.com
- GitHub Issues: رفع تقرير خطأ
- التوثيق: docs.elkitab-almubeen.com
هذا المشروع مرخص تحت رخصة MIT - انظر ملف LICENSE للتفاصيل.
- مجمع الملك فهد لطباعة المصحف الشريف - للمصاحف والتفاسير
- موقع الوقفية - للكتب الإسلامية المجانية
- Archive.org - للمصادر الرقمية
- جميع العلماء والمؤلفين الذين ساهموا في إثراء المكتبة الإسلامية
﴿ وَقُل رَّبِّ زِدْنِي عِلْمًا ﴾
"And say: My Lord, increase me in knowledge"
📖 الكتاب المبين - بوابتك إلى المعرفة الإسلامية الأصيلة