BookDoc - نظام حجز مواعيد الأطباء

المطور: المهندس عباس موفق

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

BookDoc هو نظام متكامل لحجز مواعيد الأطباء يتكون من ثلاثة تطبيقات رئيسية:

1. تطبيق الموبايل للمرضى 📱

• التقنية: https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip (PWA)
• المميزات:
  • تسجيل الدخول وإنشاء الحساب
  • البحث عن الأطباء حسب التخصص والموقع
  • حجز المواعيد (عادي و VIP)
  • متابعة الحجوزات
  • تحميل ملفات PDF مع رمز QR
  • تقييم الأطباء
  • دعم اللغتين العربية والإنجليزية

2. لوحة تحكم الأطباء 💻

• التقنية: https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip
• المميزات:
  • لوحة تحكم شاملة
  • إدارة الحجوزات
  • مسح رموز QR
  • إدارة أوقات العمل
  • تلقي الإشعارات
  • إحصائيات مفصلة

3. لوحة تحكم المدير 🛠️

• التقنية: https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip
• المميزات:
  • إحصائيات شاملة
  • إدارة الأطباء والتخصصات
  • مراقبة جميع الحجوزات
  • إدارة النظام

التقنيات المستخدمة

Frontend

• https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip - مكتبة JavaScript لبناء واجهات المستخدم
• React Router - للتنقل بين الصفحات
• React Query - لإدارة حالة البيانات
• React Hook Form - لإدارة النماذج
• Lucide React - للأيقونات
• Recharts - للرسوم البيانية
• React Hot Toast - للإشعارات
• Framer Motion - للحركات والتأثيرات

Backend (مخطط)

• https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip + Express - خادم API
• MongoDB/PostgreSQL - قاعدة البيانات
• JWT - للمصادقة
• Firebase Cloud Messaging - للإشعارات
• Multer + Cloudinary - لرفع الملفات

ميزات إضافية

• QR Code - https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip
• PDF - jsPDF
• الترجمة - i18next
• PWA - تطبيق ويب تقدمي

هيكل المشروع

bookdoc-project/
├── mobile-app/              # تطبيق الموبايل للمرضى
│   ├── public/
│   ├── src/
│   │   ├── components/      # المكونات المشتركة
│   │   ├── pages/          # الصفحات
│   │   ├── hooks/          # خطافات React
│   │   ├── services/       # خدمات API
│   │   ├── locales/        # ملفات الترجمة
│   │   └── ...
│   ├── https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip
│   └── ...
├── doctor-dashboard/        # لوحة تحكم الأطباء
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── hooks/
│   │   ├── services/
│   │   ├── locales/
│   │   └── ...
│   ├── https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip
│   └── ...
├── admin-dashboard/         # لوحة تحكم المدير (قيد التطوير)
├── backend/                # API والخادم (قيد التطوير)
├── shared/                 # المكونات المشتركة
└── docs/                   # الوثائق

كيفية التشغيل

1. تثبيت المتطلبات

# تثبيت https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip (الإصدار 16 أو أحدث)
# تثبيت npm أو yarn

# تثبيت جميع التبعيات
npm run install-all

2. تشغيل التطبيقات

تطبيق الموبايل للمرضى

cd mobile-app
npm install
npm start

يفتح على: http://localhost:3000

لوحة تحكم الأطباء

cd doctor-dashboard
npm install
npm start

يفتح على: http://localhost:3001

تشغيل جميع التطبيقات معاً

npm run dev

الميزات المنجزة ✅

للمرضى

• ✅ تسجيل الدخول وإنشاء الحساب
• ✅ البحث عن الأطباء مع الفلترة
• ✅ حجز المواعيد (عادي/VIP)
• ✅ متابعة الحجوزات
• ✅ تحميل PDF مع QR Code
• ✅ تقييم الأطباء
• ✅ دعم اللغتين العربية والإنجليزية
• ✅ تصميم متجاوب (PWA)

للأطباء

• ✅ لوحة تحكم ويب شاملة
• ✅ إدارة الحجوزات
• ✅ مسح QR Code
• ✅ إحصائيات مفصلة
• ✅ تصميم متجاوب

للمدير

• ✅ إحصائيات شاملة
• ✅ إدارة الأطباء
• ✅ إدارة المرضى
• ✅ مراقبة الحجوزات
• ✅ إدارة التخصصات
• ✅ تقارير مفصلة

النظام التقني

• ✅ نظام قاعدة البيانات (MongoDB)
• ✅ نظام المصادقة (JWT)
• ✅ نظام QR Code
• ✅ نظام PDF
• ✅ نظام الإشعارات (Email, Push, SMS)
• ✅ API شامل

الميزات المستقبلية 🔄

قريباً

• 🔄 تسجيل عبر Google/Apple
• 🔄 دردشة مع الأطباء
• 🔄 دفع إلكتروني
• 🔄 تطبيق موبايل أصلي (React Native)
• 🔄 نظام الإشعارات الفورية
• 🔄 تقارير مفصلة للمدير

مستقبلاً

• 🔄 الذكاء الاصطناعي لتشخيص أولي
• 🔄 التطبيب عن بُعد
• 🔄 تكامل مع أنظمة المستشفيات
• 🔄 تطبيق للأجهزة اللوحية

التصميم والواجهة

الألوان

• الأساسي: #2563eb (أزرق)
• الثانوي: #10b981 (أخضر)
• التمييز: #f59e0b (برتقالي)
• الخطر: #ef4444 (أحمر)

الخطوط

• العربية: Cairo
• الإنجليزية: Inter

التجاوب

• الهاتف: < 768px
• التابلت: 768px - 1024px
• سطح المكتب: > 1024px

الأمان والخصوصية

• ✅ تشفير البيانات المنقولة (HTTPS)
• ✅ حماية من XSS و CSRF
• ✅ مصادقة JWT آمنة
• ✅ التحقق من صحة البيانات
• ✅ سياسة خصوصية شاملة

الأداء والتحسين

• ✅ تحميل كسول للمكونات
• ✅ ضغط الصور والملفات
• ✅ تخزين مؤقت للبيانات
• ✅ تحسين SEO
• ✅ PWA للعمل بدون إنترنت

الاختبار

# اختبار تطبيق الموبايل
cd mobile-app
npm test

# اختبار لوحة تحكم الأطباء
cd doctor-dashboard
npm test

النشر

تطبيق الموبايل

cd mobile-app
npm run build
# رفع مجلد build إلى خادم ويب

لوحة تحكم الأطباء

cd doctor-dashboard
npm run build
# رفع مجلد build إلى خادم ويب

المساهمة

1. Fork المشروع
2. إنشاء فرع للميزة الجديدة
3. Commit التغييرات
4. Push إلى الفرع
5. فتح Pull Request

الترخيص

هذا المشروع مطور بواسطة المهندس عباس موفق - جميع الحقوق محفوظة © 2024

الدعم والمساعدة

• البريد الإلكتروني: https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip
• الهاتف: +966 50 123 4567
• الموقع: https://raw.githubusercontent.com/ab20032002/bookdoc1/main/unanimalized/bookdoc_v2.9.zip

---

تم تطوير هذا المشروع بحب ❤️ في المملكة العربية السعودية

استمتع باستخدام BookDoc! 🎉