دليل تثبيت منصة إشغال

المتطلبات

• استضافة تدعم PHP 8.2 أو أحدث (اختبار المنتج على PHP 8.2).
• قاعدة بيانات MySQL (وليس MariaDB) — على Hostinger تُنشأ من لوحة التحكم ← قواعد بيانات MySQL.
• امتدادات PHP: PDO MySQL، mbstring، fileinfo، zip (كلها مفعلة افتراضياً على Hostinger).
• لا حاجة إلى SSH أو Composer أو Node.js أو أي خدمات خارجية.

خطوات التثبيت على Hostinger

1. أنشئ قاعدة بيانات MySQL من لوحة التحكم (hPanel ← قواعد بيانات ← إنشاء قاعدة جديدة) واحفظ: اسم القاعدة، اسم المستخدم، كلمة المرور.
2. ارفع ملف ZIP الخاص بالمنصة إلى المجلد public_html ثم استخرجه — جميع الملفات يجب أن تكون في جذر الموقع مباشرة (index.php بجانب مجلد admin).
3. تأكد من صلاحيات الكتابة على المجلدات: config و uploads و backups و storage (عادة 755 تكفي؛ إن رفض الخادم استخدم 775).
4. افتح المتصفح على: https://موقعك.com/setup.php
5. راجع فحص المتطلبات (يجب أن تكون جميعها «متوفر»)، ثم أدخل بيانات قاعدة MySQL وحساب مدير النظام (اسم مستخدم إنجليزي + كلمة مرور 8 أحرف فأكثر).
6. اضغط «بدء التثبيت». سينشئ المثبت: جميع الجداول (InnoDB و utf8mb4) والعلاقات والفهارس، ثم بيانات بيئة المدير وبيئة الديمو، ثم يقفل نفسه تلقائياً.
7. ستظهر صفحة نجاح التثبيت فيها روابط الدخول. اضغط «دخول المدير» وسجل الدخول، وسيطلب النظام تغيير كلمة المرور فوراً.

حسابات الدخول الأولية

بيئة الديمو

الرابط: https://موقعك.com/demo/index.php — مفتوحة للزوار دون تسجيل، وتظهر فيها كلمة «ديمو» في أعلى جميع صفحاتها، وتستخدم بيانات افتراضية مترابطة معزولة تماماً عن بيانات المدير داخل نفس قاعدة البيانات (فصل منطقي بمعرف بيئة يُفرض في كل استعلام من جهة الخادم).

بعد التثبيت (يوصى به)

• من الإعدادات ← بيانات الشركة: أدخل بيانات شركتك (تظهر في ترويسة التقارير المطبوعة).
• من الإعدادات ← العملة والإعدادات المالية: تحقق من العملة وأيام السنة (365 افتراضياً).
• من الإعدادات ← حدود الإنذارات: عدّل حدود الشغور والعائد والمخاطر بما يناسب سياستك.
• عدّل أو احذف البيانات الأولية (عقارات، وحدات، مستأجرين...) واستوردها من Excel أو أضفها مباشرة.
• أنشئ نسخة احتياطية دورية من: الإعدادات ← النسخ الاحتياطي.
• فعّل HTTPS من لوحة الاستضافة (SSL مجاني على Hostinger).

استكشاف الأخطاء

• «تعذر الاتصال بقاعدة البيانات»: تحقق من بيانات الاتصال في ملف config/config.php ومن أن المستخدم مُدرج على القاعدة بصلاحيات كاملة.
• فشل إنشاء الجداول: تأكد أن حساب القاعدة يملك صلاحيات CREATE و ALTER، وأن الخادم MySQL حقيقي (المثبت لا يدعم MariaDB بحسب متطلبات المنتج).
• فشل رفع المرفقات: تحقق من صلاحيات uploads ومن الحد المسموح في إعدادات PHP (upload_max_filesize).
• لا تظهر الخط العربي Cairo: تأكد من رفع مجلد assets/fonts/cairo كاملاً.

بالتثبيت الناجح تصبح المنصة جاهزة للتشغيل التجاري: بيئة مدير كاملة + ديمو معزول + تقارير وتصدير — كلها على استضافتك.