CalenPro
نظام حجوزات المواعيد الاحترافي
وصف النظام
CalenPro نظام حجوزات مواعيد احترافي متكامل مبني على Laravel 12، مصمم خصيصاً للمراكز الطبية والعيادات، مراكز الخدمات، والمعاهد التدريبية. يتيح للمؤسسة إنشاء الخدمات وتعيين الموظفين وجدولة أوقاتهم وجداول الراحة والإجازات، بينما يحجز العملاء بسلاسة عبر واجهة عامة متعددة الخطوات (بيانات العميل ← التاريخ والوقت ← الموظف ← اختيار الخدمة) دون الحاجة لتسجيل الدخول. يدعم النظام إصدار الفواتير وتتبع المدفوعات وتصدير PDF، مع لوحة منفصلة لكل موظف لعرض حجوزاته وتحديث حالاتها. النظام مهيأ بعدة لغات ويدعم بالكامل: العربية، الإنجليزية، الإسبانية، الفرنسية، الألمانية، والإيطالية، مع دعم كامل لاتجاه الكتابة من اليمين لليسار (RTL) للغات العربية.
ما يغطيه النظام
الصفحة الرئيسية
واجهة الترحيب القابلة للتخصيص مع نبذة عن المركز وزر الحجز المباشر. تدعم تعديل النصوص والعناصر من لوحة الإدارة دون لمس الكود.
معرض تعديل الصفحة الرئيسية
أداة داخل لوحة الإدارة لتخصيص محتوى الصفحة الرئيسية: العنوان، الوصف، الأزرار، والعناصر المرئية للزوار.
لوحة التحكم
نظرة عامة على إحصائيات الحجوزات، المواعيد القادمة، والإيرادات. نقطة الانطلاق لإدارة كامل النظام.
إدارة الحجوزات
قائمة شاملة بجميع الحجوزات مع إمكانية البحث والتصفية وتحديث الحالة (مؤكد، ملغي، مكتمل) وإضافة ملاحظات.
تقويم الحجوزات (شهري)
عرض تقويمي شهري للحجوزات يوضح المواعيد وتوزيعها على الأيام لتخطيط الموارد بسهولة.
تقويم الحجوزات (أسبوعي)
عرض تقويمي أسبوعي مفصل للحجوزات يسهّل متابعة الجدول اليومي والتحقق من الفراغات.
الخدمات
إدارة الخدمات المعروضة: الاسم، المدة، السعر، الوصف، وربطها بالموظفين القادرين على تقديمها.
الموظفون
إدارة فريق العمل: البيانات، الجداول، فترات الراحة، والإجازات. كل موظف يمتلك لوحة لعرض حجوزاته فقط.
الفواتير
إنشاء الفواتير، تسجيل المدفوعات، وتصدير PDF للعميل وللأرشفة. ربط تلقائي بالحجوزات عند التفعيل.
واجهات النظام
الصفحة الرئيسية
واجهة الترحيب للموقع مع زر الحجز والمحتوى القابل للتخصيص
تعديل الصفحة الرئيسية
معرض إدارة محتوى الصفحة الرئيسية من لوحة التحكم
لوحة التحكم
نظرة عامة على الإحصائيات والحجوزات القادمة
قائمة الحجوزات
عرض وإدارة جميع الحجوزات مع البحث والتصفية
تقويم الحجوزات (شهري)
عرض الحجوزات بتقويم شهري
تقويم الحجوزات (أسبوعي)
عرض الحجوزات بتقويم أسبوعي تفصيلي
إدارة الخدمات
إضافة وتعديل الخدمات والمدة والسعر
إدارة الموظفين
إدارة فريق العمل والجداول وفترات الراحة
الفواتير
إنشاء الفواتير وتسجيل المدفوعات وتصدير PDF
واجهة الحجز العامة - اختيار الخدمة
الخطوة الأولى: اختيار الخدمة المراد حجزها
واجهة الحجز العامة - اختيار الموظف
الخطوة الثانية: اختيار الموظف أو مقدم الخدمة
واجهة الحجز العامة - اختيار التاريخ والوقت
الخطوة الثالثة: اختيار اليوم والوقت المناسب من الأوقات المتاحة
واجهة الحجز العامة - بيانات العميل
الخطوة الرابعة: إدخال الاسم وبيانات التواصل
واجهة الحجز العامة - التأكيد
الخطوة الأخيرة: مراجعة الحجز والتأكيد دون الحاجة لتسجيل دخول
المميزات
- حجز عام متعدد الخطوات: خدمة → موظف → تاريخ ووقت → عميل
- لوحة إدارة: خدمات، موظفين، جداول، فواتير وإعدادات
- لوحة الموظفين: عرض وإدارة الحجوزات الخاصة بهم
- فواتير ومتابعة مدفوعات مع تصدير PDF
- دعم متعدد اللغات: العربية، الإنجليزية، الإسبانية، الفرنسية، الألمانية، الإيطالية
- نظام ترخيص مع خادم اختياري وفترة سماح
- تحديثات: التحقق والتطبيق من لوحة التحكم
التقنيات المستخدمة
متطلبات التشغيل
طريقة التثبيت
رفع المشروع وتثبيت الاعتماديات
composer install
cp .env.example .env
php artisan key:generate
npm install && npm run buildقبل فتح معالج التثبيت، عيّن INSTALLER_ENABLED=true وضع قيمة قوية في INSTALLER_TOKEN داخل ملف .env
تشغيل معالج الإعداد
- افتح /install?token=YOUR_INSTALLER_TOKEN في المتصفح (مرة واحدة فقط)
- اتبع المعالج: التحقق من المتطلبات → إعداد قاعدة البيانات → إنشاء حساب المدير → تفعيل الترخيص
- بعد اكتمال التثبيت عطّل المعالج بإرجاع INSTALLER_ENABLED=false
لا تعرّض رمز المعالج في التذاكر أو لقطات الشاشة. للتركيب عبر سكريبت استخدم الهيدر X-Install-Token.
التحديث والتراجع
التحديث والتراجع
- التحقق: لوحة الإدارة > التحديثات أو php artisan app:update:check
- التطبيق: من الواجهة أو php artisan app:update:apply <version>
- التراجع: راجع storage/app/updates/last_rollback_hint.txt ثم php artisan migrate:rollback --step=1