إنشاء وتشغيل مشروع FacturaScripts

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

ستوجهك هذه الدليل خلال العملية الكاملة لتثبيت وتكوين FacturaScripts باستخدام ServBay.

ما هو FacturaScripts؟

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

• إصدار الفواتير وإدارتها
• المحاسبة
• التحكم في المخزون
• إدارة العملاء والموردين
• إدارة المشاريع
• وغيرها الكثير...

كمشروع مفتوح المصدر، يتمتع بدعم مجتمع نشط ويسمح للمستخدمين بتوسيع الوظائف وتخصيصها من خلال ملحقات.

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

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

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

يوفر ServBay بيئة محلية مثالية لتشغيل التطبيقات المبنية على PHP (مثل FacturaScripts). يتكامل مع Nginx/Apache، مجموعة متنوعة من إصدارات PHP، خدمات MySQL/MariaDB/PostgreSQL، ويقدم واجهة رسومية للإدارة.

تشمل الخطوات الرئيسية لتشغيل FacturaScripts باستخدام ServBay ما يلي:

1. تحميل الشيفرة المصدرية لـ FacturaScripts.
2. إنشاء مجلد المشروع في الدليل الذي يديره ServBay.
3. إنشاء قاعدة بيانات MySQL والمستخدم الضروري لـ FacturaScripts.
4. تكوين خادم الويب Apache عبر ServBay ليشير إلى مجلد المشروع.
5. الوصول إلى المشروع عبر المتصفح وإكمال معالج التثبيت لـ FacturaScripts.

إنشاء مشروع FacturaScripts (على أساس تحميل الحزمة zip)

تعد هذه واحدة من أشهر طرق التثبيت المحلية.

1. تحميل FacturaScripts:

   • انتقل إلى الموقع الرسمي لـ FacturaScripts (https://facturascripts.com/).
   • انتقل إلى منطقة التنزيل، وابحث عن النسخة المستقرة الأخيرة من حزمة .zip وحمّلها.

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

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

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

   • قم بفك ضغط ملف FacturaScripts الذي تم تحميله إلى مجلد facturascripts_project الذي أنشأته.
   • بعد الفك، ينبغي أن يحتوي مجلد facturascripts_project على ملفات ودلائل مثل index.php، config.php (قد يتم إنشاؤه بعد التثبيت)، Core، Dinamic، Plugins وغيرها.

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

تحتاج FacturaScripts إلى قاعدة بيانات لتخزين جميع البيانات. سنستخدم خدمة MySQL المُدارة بواسطة ServBay.

1. تأكد من تشغيل خدمة MySQL:

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

2. إنشاء قاعدة بيانات:

   • يمكنك استخدام أدوات إدارة البيانات المدمجة في ServBay (مثل phpMyAdmin) أو إنشاء قاعدة البيانات عبر سطر الأوامر.
   • باستخدام phpMyAdmin (مستحسن):
     • في واجهة ServBay، ابحث عن "قاعدة البيانات" - "MySQL"، وانقر على phpMyAdmin في الزاوية العلوية اليمنى.
     • سجل الدخول إلى phpMyAdmin (عادةً باستخدام مستخدم root وكلمة المرور التي قمت بإعدادها في ServBay).
     • انقر على علامة التبويب "قاعدة البيانات".
     • في حقل "إنشاء قاعدة بيانات"، أدخل اسم قاعدة البيانات، مثل facturascripts_db.
     • اختر مجموعة الأحرف المناسبة، من المستحسن استخدام utf8mb4_general_ci أو utf8mb4_unicode_ci.
     • انقر على "إنشاء".
   • إنشاء مستخدم قاعدة بيانات (اختياري ولكن مستحسن): لأغراض الأمان، يُنصح بإنشاء مستخدم قاعدة بيانات مخصص لـ FacturaScripts، بدلاً من استخدام مستخدم root.
     • في phpMyAdmin، ارجع إلى الصفحة الرئيسية، وانقر على علامة التبويب "حسابات المستخدمين".
     • انقر على "إضافة حساب مستخدم".
     • أدخل اسم المستخدم (مثل facturascripts_user).
     • اختر اسم المضيف localhost.
     • قم بإنشاء أو إدخال كلمة مرور قوية، وتأكد من تدوين هذه الكلمة.
     • اختر "إنشاء قاعدة بيانات باسم المستخدم ومنح كل الصلاحيات" أو انتقل يدويًا إلى قسم "قاعدة البيانات" ومنح المستخدم الجديد جميع الصلاحيات على قاعدة البيانات facturascripts_db (ALL PRIVILEGES).
     • انقر على "تنفيذ" في أسفل الصفحة.

3. تدوين معلومات قاعدة البيانات: قم بتدوين ما أنشأته:

   • اسم قاعدة البيانات (facturascripts_db)
   • اسم مستخدم قاعدة البيانات (facturascripts_user)
   • كلمة مرور مستخدم قاعدة البيانات (الكلمة التي قمت بإعدادها)
   • مضيف قاعدة البيانات (عادةً ما يكون localhost أو 127.0.0.1)
   • منفذ قاعدة البيانات (افتراضي MySQL هو 3306، يمكنك تأكيده في قائمة خدمات ServBay)

ستُستخدم هذه المعلومات أثناء عملية تثبيت FacturaScripts.

تكوين خادم الويب (استنادًا إلى Apache)

الآن نحتاج إلى إخبار ServBay بكيفية تقديم مشروع FacturaScripts الخاص بنا عبر خدمة Apache.

1. تأكد من تشغيل خدمة Apache:

   • في واجهة "الخدمات" في ServBay، تأكد من أن خدمة Apache قد بدأت.

2. إضافة مضيف:

   • اختر "المواقع" من القائمة الجانبية لـ ServBay.
   • انقر على زر "+" على الجهة اليمنى.
   • في نافذة التكوين المنبثقة، املأ المعلومات التالية:
     • الاسم (Name): امنح هذا التكوين اسمًا وصفيًا مثل FacturaScripts Demo.
     • اسم النطاق (Domain): أدخل اسم النطاق الذي ترغب في استخدامه للوصول إلى موقع FacturaScripts المحلي. وفقًا لمتطلباتنا، سنستخدم facturascripts.demo.
     • نوع الموقع (Website Type): اختر PHP، مما يشير إلى أنه موقع ويب ديناميكي باستخدام PHP.
     • الدليل الجذري (Root Directory): انقر على زر "تصفح" أو "اختر" للانتقال إلى المجلد الذي أنشأت فيه وفككت ضغط ملفات FacturaScripts (/Applications/ServBay/www/facturascripts_project).
     • خادم الويب (Web Server): اختر Apache والإصدار الذي ترغب في استخدامه.
     • إصدار PHP (PHP Version): اختر إصدار PHP متوافق مع إصدار FacturaScripts الذي تم تنزيله (يرجى مراجعة متطلبات نظام FacturaScripts، وعادةً ما يُوصى بإصدار مستقر أحدث مثل PHP 8.1 أو 8.2).
     • الإعدادات الأخرى: عادةً ابقها على الوضع الافتراضي، ما لم يكن لديك احتياجات خاصة.

3. حفظ التكوين:

   • انقر على زر "إضافة".
   • سيقوم ServBay تلقائيًا بتكوين المضيف الظاهري لـ Apache، وقد يُطلب منك منح إذن المسؤول لتعديل ملف hosts في النظام، حتى يشير facturascripts.demo إلى عنوان IP المحلي (127.0.0.1). يرجى السماح بذلك.

4. التحقق من ملحقات PHP:

   • قد تحتاج FacturaScripts إلى ملحقات PHP معينة للعمل بشكل صحيح (مثل pdo_mysql، gd، intl، zip وغيرها).
   • في ServBay، يمكنك إدارة ملحقات PHP المثبتة. عادةً ما تكون الملحقات التي قام ServBay بتثبيتها افتراضيًا كافية، ولكن إذا تلقيت إشعارًا بخصوص مفقودات الملحقات أثناء التثبيت، يمكنك تفعيلها في قسم تكوين PHP في ServBay.

الوصول إلى الموقع

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

1. افتح المتصفح: افتح متصفح الويب الذي تفضله (مثل Chrome، Firefox، Safari).

2. ادخل العنوان: أدخل https://facturascripts.demo في شريط العناوين واضغط Enter.

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

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

4. اكتمل التثبيت:

   • بعد نجاح التثبيت، ستحصل عادةً على رسالة تطلب منك حذف دليل install (إذا كان موجودًا ويظهر التنبيه، وذلك لأغراض الأمان).
   • ينبغي أن تتمكن الآن من الوصول إلى صفحة تسجيل الدخول في FacturaScripts عبر http://facturascripts.demo. استخدم حساب المسؤول الذي قمت بإعداده للتو لبدء استكشاف واستخدام FacturaScripts!

---

تهانينا! لقد نجحت في إنشاء وتشغيل مشروع FacturaScripts في بيئة macOS المحلية باستخدام ServBay. قد سهل ServBay إعداد وإدارة بيئة الخادم المحلي، مما يتيح لك التركيز بشكل أكبر على تطوير واستخدام FacturaScripts نفسها.