إنشاء وتشغيل مشروع FacturaScripts باستخدام ServBay

FacturaScripts هو حل برمجي مفتوح المصدر قوي ومرن لإدارة موارد المؤسسة (ERP) وإدارة علاقات العملاء (CRM)، ويعد خيارًا مثاليًا للشركات الصغيرة والمتوسطة والمستقلين. من خلال بيئة تطوير الويب المحلية السهلة التي توفرها ServBay، يمكنك إنشاء واختبار وتشغيل مشاريع FacturaScripts بسهولة على نظام macOS، دون الحاجة إلى إعدادات معقدة.

سيرشدك هذا الدليل بالتفصيل خلال عملية التثبيت والإعداد المحلي لـ FacturaScripts باستخدام ServBay.

نظرة عامة على FacturaScripts

FacturaScripts هو نظام ERP وCRM مفتوح المصدر، مبني باستخدام PHP وإطار Bootstrap. يهدف إلى مساعدة الشركات على إدارة عملياتها الأساسية، بما في ذلك:

• إصدار وإدارة الفواتير
• المحاسبة
• إدارة المخزون
• إدارة العملاء والموردين
• إدارة المشاريع
• والعديد من الوظائف الإضافية المتوفرة عبر الوحدات والإضافات...

يُعد FacturaScripts مشروعًا نشطًا مفتوح المصدر، ويتمتع بدعم مجتمعي قوي، ويسمح للمستخدمين بتوسيع أو تخصيص الوظائف من خلال الإضافات لتلبي مختلف الاحتياجات التجارية.

المميزات والفوائد الرئيسية لـ FacturaScripts

• مفتوح المصدر ومجاني: لا توجد رسوم تراخيص مرتفعة؛ يمكنك استخدامه وتعديله وتوزيعه بحرية تامة.
• وظائف شاملة: يغطي معظم الوظائف الأساسية التي تتطلبها الشركات الصغيرة والمتوسطة في عملياتها اليومية ويوفر حلاً متكاملاً.
• سهل الاستخدام: يتميز بواجهة بديهية وسهلة التعلم للمستخدمين الجدد.
• قابلية توسعة عالية: يتوفر سوق كبير للإضافات وواجهة برمجة تطبيقات (API) مفتوحة، ما يُسهل إضافة ميزات جديدة أو التكامل مع خدمات أخرى.
• إمكانية الوصول عبر المنصات: يعتمد على تقنيات الويب، لذا يمكنك الوصول إليه من أي جهاز يدعم متصفح حديث.
• مجتمع نشط: يمكنك الحصول على الدعم والمساعدة من مجتمع المطورين حول العالم عند الحاجة.
• دعم متعدد اللغات: يتيح واجهات بلغات متعددة لراحة المستخدمين من مناطق مختلفة.

مزايا تشغيل FacturaScripts باستخدام ServBay

ServBay هي بيئة تطوير ويب محلية صُممت خصيصًا للمطورين، وتوفر منصة مثالية لتشغيل تطبيقات PHP مثل FacturaScripts. تدمج جميع المكوّنات اللازمة بما فيها خوادم الويب Apache/Nginx، نسخ متعددة من PHP، قواعد بيانات MySQL/MariaDB/PostgreSQL وأدوات مثل Redis، وكل ذلك تحت إدارة رسومية موحدة وبديهية.

تشمل المزايا الرئيسية لاستعمال ServBay مع FacturaScripts وخطوات العمل:

• بيئة متكاملة: يأتي ServBay مزودًا بجميع المكوّنات الأساسية المطلوبة لتشغيل FacturaScripts (خادم الويب، PHP، قاعدة البيانات)، مما يوفر عناء الترقيع والتنصيب اليدوي لكل أداة على حدة.
• إدارة الإصدارات: تبديل إصدارات PHP بسهولة من أجل تلبية متطلبات إصدار معينة من FacturaScripts أو لاختبار التوافق.
• إدارة قواعد البيانات: أدوات مدمجة في ServBay مثل phpMyAdmin أو Adminer تُسهّل إنشاء وإدارة قواعد البيانات والمستخدمين الضروريين لـ FacturaScripts.
• إعداد مواقع الويب بسهولة: يمكنك إنشاء مواقع محلية جديدة، وإعداد أسماء النطاقات، وتحديد المجلد الجذري، وخادم الويب، وإصدار PHP عبر الواجهة الرسومية.
• إدارة ملف Hosts تلقائيًا: ServBay يدير ملف Hosts المحلي تلقائيًا، ما يُمكِّنك من استخدام نطاقات مخصصة مثل facturascripts.servbay.demo للوصول إلى المشاريع محليًا.
• دعم SSL: يتيح لك ServBay ضبط شهادات SSL/HTTPS للمواقع المحلية باستخدام CA المدمج أو خدمات ACME العامة لمحاكاة بيئة الإنتاج.

الخطوات الرئيسية لتشغيل FacturaScripts على ServBay باختصار:

1. تحميل الشيفرة المصدرية لـ FacturaScripts.
2. إنشاء مجلد المشروع في المسار الجذري لمواقع ServBay.
3. إنشاء قاعدة البيانات المطلوبة ومستخدم جديد عبر MySQL.
4. إعداد خادم الويب (Apache أو Nginx) عبر ServBay لتوجيهه إلى مجلد المشروع.
5. التأكد من تفعيل الامتدادات البرمجية اللازمة لـ PHP.
6. الدخول عبر المتصفح إلى النطاق المحلي وإكمال معالج التنصيب التفاعلي لـ FacturaScripts.

المتطلبات الأساسية

قبل أن تبدأ، تأكد من توفر النقاط التالية:

• تم تحميل وتثبيت وبدء تشغيل ServBay بنجاح على نظام macOS لديك. يمكنك زيارة الموقع الرسمي لـ ServBay لتحميل أحدث إصدار.
• تم تهيئة وتشغيل حزم ServBay الأساسية (مثل خادم الويب Apache أو Nginx، إصدار PHP الذي تنوي استخدامه، وقاعدة بيانات MySQL أو MariaDB) من خلال واجهة البرنامج.
• لديك معرفة أساسية بمفاهيم تطوير الويب وقواعد البيانات.

إنشاء مشروع FacturaScripts (عن طريق حزمة Zip)

هذه واحدة من أكثر الطرق شيوعًا وسرعة لتثبيت FacturaScripts في بيئتك المحلية.

1. تحميل FacturaScripts:

   • توجه إلى صفحة التحميل في الموقع الرسمي لـ FacturaScripts: https://facturascripts.com/descargar.
   • ابحث عن أحدث إصدار مستقر بامتداد .zip وقم بتحميله على جهازك بنظام macOS.

2. إنشاء مجلد المشروع:

   • افتح Finder وانتقل إلى المجلد الجذري الذي يُخزن فيه ServBay ملفات المواقع المحلية. المسار الافتراضي والموصى به هو /Applications/ServBay/www/.
   • أنشئ مجلدًا جديدًا داخل هذا المسار ليحوي ملفات مشروع FacturaScripts، مثلاً يمكنك تسميته facturascripts_project.
   • مثال لمسار المشروع الكامل: /Applications/ServBay/www/facturascripts_project

3. فك ضغط الملفات:

   • حدد ملف FacturaScripts بامتداد .zip الذي تم تحميله، وانقر عليه مزدوجًا لفك ضغطه.
   • قم بنسخ أو نقل كافة الملفات والمجلدات الناتجة (مثل index.php, Core, Dinamic, Plugins وغيرها) إلى المجلد الجديد /Applications/ServBay/www/facturascripts_project.

الإعداد الأولي (تكوين قاعدة بيانات MySQL)

يحتاج FacturaScripts إلى قاعدة بيانات لحفظ البيانات التجارية والمستخدمين والإعدادات وغيرها. سنستخدم MySQL أو MariaDB المدمجين مع ServBay لهذا الغرض. يدعم ServBay كلا النظامين الكاملين.

1. التأكد من تشغيل قاعدة البيانات:

   • افتح برنامج ServBay.
   • من القائمة الجانبية، اختر "الحزم" ثم "MySQL" أو "MariaDB" (اختَر القاعدة التي تفضّلها).
   • تأكد من أن الحزمة المختارة تعمل. إذا لم تكن كذلك، اضغط زر التشغيل بجانبها.

2. إنشاء قاعدة البيانات والمستخدم:

   • يمكنك استخدام أداة إدارة قواعد البيانات المدمجة مثل phpMyAdmin (المضمنة غالبًا مع حزم MySQL/MariaDB) أو عن طريق الطرفية (Terminal) المدمجة. للمبتدئين، يُنصح باستخدام phpMyAdmin لبساطتها.
   • باستخدام phpMyAdmin (موصى به):
     • من واجهة ServBay، ابحث عن قسم "قاعدة البيانات" واضغط على أيقونة phpMyAdmin بجانب قاعدة البيانات التي تستخدمها.
     • سيفتح لك phpMyAdmin في متصفح الإنترنت. عادةً يمكنك الدخول مستخدمًا اسم المستخدم root وكلمة المرور التي عيّنتها أثناء الإعداد. إذا كنت قد نسيت كلمة مرور root، يمكنك استخدام خاصية إعادة التعيين من صفحة تفاصيل القاعدة في ServBay.
     • بعد الدخول، انقر على علامة التبويب "قواعد البيانات" بالأعلى.
     • أنشئ قاعدة بيانات جديدة، ويفضّل أن تختار اسمًا يعكس المشروع لتفادي التضارب، مثلاً: facturascripts_servbay_db.
     • اختر الترميز المناسب. نوصي باستخدام utf8mb4_general_ci أو utf8mb4_unicode_ci لدعم أوسع للنصوص وإيموجي.
     • اضغط على "إنشاء".
     • إنشاء مستخدم قاعدة بيانات (اختياري لكن موصى به بشدة): لأمان إضافي، أنشئ مستخدمًا مخصصًا بدلاً من استخدام root.
       • عد للصفحة الرئيسية في phpMyAdmin، ثم انقر على "حسابات المستخدمين".
       • اضغط "إضافة حساب مستخدم".
       • أدخل اسم المستخدم، مثل: facturascripts_servbay_user.
       • حدد المضيف كـ localhost أو 127.0.0.1 لجعل الحساب مقصورًا على الاتصالات المحلية.
       • أدخل كلمة مرور قوية واحتفظ بها في مكان آمن.
       • في الأسفل، يمكنك منح المستخدم كافة الصلاحيات لهذه القاعدة عبر خيار "منح كافة الصلاحيات لهذه القاعدة" أو تحديد الصلاحيات يدويًا لقاعدة البيانات التي أنشأتها للتو.
       • اضغط "تنفيذ" لحفظ الحساب.

3. تدوين معلومات الاتصال بقواعد البيانات: ستحتاج إلى هذه البيانات عند تثبيت FacturaScripts لاحقًا:

   • اسم قاعدة البيانات (مثلاً: facturascripts_servbay_db)
   • اسم المستخدم (مثلاً: facturascripts_servbay_user)
   • كلمة المرور (التي وضعتها سابقًا)
   • مضيف القاعدة (غالبًا: localhost أو 127.0.0.1)
   • المنفذ (المبدئي لـ MySQL/MariaDB هو 3306, تحقق منه عبر ServBay عند الشك)

إعداد خادم الويب (Apache أو Nginx)

الآن علينا توجيه ServBay لخدمة ملفات مشروع FacturaScripts من خلال Apache أو Nginx. يدعم ServBay كلا الخيارين.

1. تأكد من تشغيل خادم الويب:

   • تأكد من أن خادم الويب المختار (Apache أو Nginx) قيد التشغيل من واجهة "الحزم" في ServBay.

2. إضافة موقع جديد:

   • من القائمة الجانبية في ServBay، اختر "المواقع".
   • اضغط رمز "+" أعلى قائمة المواقع لإضافة إعداد موقع جديد.
   • عبّئ البيانات التالية في النافذة المنبثقة:
     • الاسم: اسم وصفي، مثلاً "FacturaScripts Demo Site".
     • النطاق: أدخل اسم النطاق المحلي المخصص للمشروع، ويفضل مع اللاحقة .servbay.demo، مثل: facturascripts.servbay.demo.
     • نوع الموقع: اختر "PHP" للدلالة على أن الموقع ديناميكي.
     • المجلد الجذري: اضغط على "استعراض" أو "اختيار" وحدد مجلد FacturaScripts (/Applications/ServBay/www/facturascripts_project). ملحوظة: بعض الأطر تتطلب تحديد مجلد فرعي مثل public أو web كمجلد جذري. FacturaScripts عادة لا يتطلب ذلك، يكفي الجذر.
     • إصدار PHP: اختر نسخة PHP متوافقة مع إصدار FacturaScripts لديك (يُنصح دائمًا باستخدام الإصدارات الأحدث والمدعومة مثل PHP 8.1 أو 8.2 أو أحدث).
     • إعدادات أخرى: يمكنك تركها افتراضية، أو تفعيل إعدادات متقدمة مثل SSL/HTTPS حسب الحاجة.

3. حفظ الإعدادات وتحديث ملف Hosts:

   • بعدما تملأ بيانات الموقع، اضغط "إضافة" أو "حفظ".
   • سيقوم ServBay تلقائيًا بتكوين خادم الويب وربط النطاق المحلي بعنوان IP المحلي (127.0.0.1) عبر ملف hosts (يتطلب ذلك أحيانًا صلاحيات المسؤول). بذلك يمكن الوصول إلى الموقع مباشرة عبر النطاق الذي اخترته دون الحاجة لتعديل ملف hosts يدويًا.

4. فحص وتفعيل امتدادات PHP:

   • FacturaScripts يتطلب مجموعة من الامتدادات (مثل: pdo_mysql, gd, intl, zip, xml, curl وغيرها). كثير منها مفعل افتراضيًا في ServBay، لكن إذا ظهرت رسائل نقص الامتدادات أثناء التثبيت، يمكنك تفعيلها يدويًا.
   • كيفية تفعيل الامتدادات:
     • في ServBay انتقل إلى "اللغات" > "PHP".
     • حدد إصدار PHP المستخدم مع الموقع (مثلاً 8.2).
     • من صفحة تفاصيل الإصدار، ابحث عن "الامتدادات".
     • ستظهر قائمة بالامتدادات المثبتة والمفعلة. إذا احتجت لتفعيل أي منها (مثلاً: opcache)، فعّل خانة التفعيل بجانبها.
     • اضغط "تطبيق" أو "حفظ". قد تحتاج لإعادة تشغيل خدمة PHP من نفس الصفحة ليصبح التغيير ساريًا.

مثال شاشة إعداد مواقع ServBay

الدخول للموقع وإنهاء تثبيت FacturaScripts

الآن بيئة ServBay جاهزة لتشغيل FacturaScripts ويمكنك بدء معالج التثبيت عبر الإنترنت.

1. فتح المتصفح: استخدم متصفحك المفضل مثل Chrome, Firefox أو Safari.

2. أدخل عنوان الموقع: في شريط العنوان اكتب النطاق المحلي الذي أنشأته، مثل: http://facturascripts.servbay.demo. إذا فعلت SSL عبر ServBay (باستخدام CA أو ACME)، يمكنك أيضًا زيارة https://facturascripts.servbay.demo.

3. معالج تثبيت FacturaScripts:

   • إذا كان إعداد الموقع وتعديلات ملف Hosts وخدمات الويب/PHP تعمل بنجاح، ستظهر لك صفحة الترحيب أو شاشة التثبيت الخاصة بـ FacturaScripts.
   • اختيار اللغة: حدد لغة الواجهة التي ترغب بها.
   • فحص النظام: سيقوم معالج التثبيت بالتحقق تلقائيًا من بيئة الخادم (إصدار PHP، الامتدادات، الصلاحيات الكتابية للمجلدات، إلخ). إذا كانت كل المتطلبات مستوفاة، سترى إشعارات خضراء تدل على النجاح. بالنسبة لرسائل الخطأ الحمراء أو التحذيرات الصفراء، راجع سجل الأخطاء أو إعدادات الامتدادات/إصدار PHP، وتأكد أن مجلد المشروع لديه صلاحيات الكتابة الكافية.
   • إعداد قاعدة البيانات: هذه الخطوة أساسية. أدخل بيانات الاتصال التي أنشأتها مسبقًا:
     • نوع القاعدة: MySQL
     • المضيف: localhost أو 127.0.0.1
     • المنفذ: 3306 (أو المنفذ المحدد في ServBay)
     • اسم القاعدة: facturascripts_servbay_db
     • اسم المستخدم: facturascripts_servbay_user
     • كلمة المرور: التي وضعتها للحساب أعلاه
     • بادئة الجداول: يُمكن إبقاء القيمة الافتراضية fs_ أو تغييره حسب الحاجة
   • حساب المدير: أنشئ اسم مستخدم وكلمة مرور وبريد إلكتروني للحساب الإداري للنظام. يُرجى اختيار كلمة مرور قوية وحفظها لأنك ستستخدمها لاحقًا للدخول للنظام كمدير.
   • بدء التثبيت: بعد التأكد من صحة الإدخالات، اضغط زر التثبيت. سيبدأ FacturaScripts بإنشاء الجداول اللازمة وتخزين الإعدادات في القاعدة.

4. انتهاء التثبيت:

   • بعد التثبيت الناجح، قد يطلب منك FacturaScripts ولأسباب أمنية حذف مجلد install من جذر المشروع. يُنصح باتباع التوجيهات وحذف المجلد إذا لزم الأمر.
   • يمكنك الآن الدخول إلى صفحة تسجيل الدخول لـ FacturaScripts عبر http://facturascripts.servbay.demo (أو رابط HTTPS). سجّل دخولك بالحساب الإداري الذي قمت بإنشائه وابدأ باستكشاف النظام!

الأسئلة الشائعة (FAQ)

• س: ماذا أفعل إذا أشار معالج تثبيت FacturaScripts إلى نقص في بعض امتدادات PHP؟
  • ج: توجه إلى برنامج ServBay، اختر "اللغات" > "PHP" ثم إصدار PHP المُستخدم، وبعدها إلى "الامتدادات". فعّل الامتدادات المطلوبة (مثلاً: opcache)، ثم اضغط "تطبيق" وأعد تشغيل الخدمة.
• س: ظهرت لي رسالة "Forbidden" أو صفحة بيضاء عند زيارة facturascripts.servbay.demo؟
  • ج: تحقق أولًا من أن خوادم الويب وPHP في ServBay تعمل. تأكد أن مجلد المشروع المحدد في إعداد الموقع هو مجلد FacturaScripts الصحيح. إذا ظهرت صفحة فارغة فقد تكون هناك أخطاء برمجية—راجع سجلات الخطأ في سيرفر الويب أو PHP. إذا ظهرت رسالة "Forbidden"، تأكد من صلاحيات مجلدات وملفات المشروع وإمكانية الكتابة في مجلدات مثل Dinamic.
• س: فشل الاتصال بقاعدة البيانات أثناء التثبيت؟
  • ج: تحقق من تشغيل MySQL/MariaDB في ServBay واستعمل المنفذ الصحيح. راجع أيضًا بيانات الاتصال المدخلة وتأكد أنها تطابق تمامًا ما أدخلته في إعدادات القاعدة والمستخدم.

الخلاصة

بفضل بيئة ServBay المتكاملة والقوية، أصبح تثبيت وتشغيل FacturaScripts على نظام macOS أمرًا في غاية السهولة. حيث توفر لك ServBay جميع الاعتمادات البرمجية الأساسية (خادم الويب، PHP، قاعدة البيانات) مع واجهة رسومية تسهل إعداد المشاريع دون عناء. باتباع هذا الدليل، ستتمكن من بناء بيئة تطوير أو اختبار محلية لـ FacturaScripts بسرعة، والتركيز على إدارة أعمالك واكتشاف ميزات FacturaScripts المتقدمة. مرونة ServBay وسهولة استخدامه سترفع إنتاجيتك في تطوير التطبيقات المحلية بشكل ملحوظ.