كيفية إعداد وتشغيل المشروع
المتطلبات الأساسية
تثبيت Node.js:
- قم بتنزيل Node.js وتثبيته من الموقع الرسمي: https://nodejs.org/en/download/
- التحقق من التثبيت:
تثبيت جيت:
- تأكد من تثبيت Git على نظامك: https://git-scm.com/
MongoDB والشريط:
- قم بإعداد قاعدة بيانات MongoDB وحساب Stripe لمعالجة الدفع.
خطوات تشغيل الواجهة الخلفية
- افتح مجلد المشروع في VS Code أو أي محرر أكواد.
- انتقل إلى مجلد
backend
: - تثبيت التبعيات:
- تكوين ملف
.env
:- أضف المتغيرات التالية إلى ملف
backend/.env
: MONGO_URI = mongodb+srv://<username>:<password>@cluster.mongodb.net/<dbname>
STRIPE_SECRET_KEY = your_stripe_secret_key
PORT = 5000
- استبدل
<username>
و <password>
و <dbname>
ببيانات اعتماد MongoDB الخاصة بك. - أضف مفتاحك السري الخاص بـ Stripe.
- بدء تشغيل الخادم الخلفي:
- سيتم تشغيل الواجهة الخلفية على
http://localhost:5000
.
خطوات تشغيل الواجهة الأمامية
- انتقل إلى مجلد
frontend
: - تثبيت التبعيات:
- ابدأ الواجهة الأمامية:
- افتح التطبيق:
- سيتم تشغيل الواجهة الأمامية على
http://localhost:5173
. افتح هذا الرابط في متصفحك.
خطوات تشغيل لوحة الإدارة
- انتقل إلى مجلد
admin
: - تثبيت التبعيات:
- ابدأ لوحة الإدارة:
- افتح لوحة الإدارة:
- سيتم تشغيل لوحة الإدارة على
http://localhost:5174
. افتح هذا الرابط في متصفحك.
ملحوظات
- تأكد من تشغيل خادم الواجهة الخلفية قبل بدء تشغيل الواجهة الأمامية أو لوحة الإدارة.
- إعداد قاعدة البيانات:
- يجب أن يكون MongoDB قيد التشغيل، ويجب أن تحتوي قاعدة بياناتك على المجموعات المناسبة (
users
، products
، orders
).
- المدفوعات الشريطية:
- لن تعمل عمليات الدفع إلا إذا تم تكوين Stripe بشكل صحيح في ملف
.env
.
- متغيرات البيئة:
- تأكد من تعيين كافة المتغيرات المطلوبة بشكل صحيح في ملفات
.env
المعنية.
استكشاف الأخطاء وإصلاحها
- إذا واجهت أية مشكلات، فتحقق من سجلات المحطة الطرفية بحثًا عن الأخطاء.
- تأكد من تثبيت Node.js وMongoDB وتشغيلهما بشكل صحيح.
- امسح ذاكرة التخزين المؤقت للمتصفح في حالة فشل تحميل الواجهة الأمامية أو لوحة الإدارة.
لمزيد من المساعدة، لا تتردد في التواصل معنا!