ecommerce website shopfinity

شوبفينيتي

مرحبًا بك في Shopfinity ، تطبيق التجارة الإلكترونية المتقدم المصمم بأحدث التقنيات. يقدم Shopfinity حلاً شاملاً للتسوق عبر الإنترنت، بما في ذلك مصادقة المستخدم وإدارة المنتجات ومعالجة الدفع ولوحة تحكم إدارية بديهية.

سمات

• Next.js 14 : يستخدم أحدث جهاز توجيه للتطبيقات والميزات من Next.js للحصول على تطبيقات ويب سريعة ومتوافقة مع تحسين محركات البحث ومقدمة من جانب الخادم.
• MongoDB : قاعدة بيانات NoSQL لتخزين البيانات واسترجاعها بكفاءة.
• Auth.js (Next-Auth) : حلول مصادقة آمنة وقابلة للتطوير.
• Stripe : بوابة دفع متكاملة للتعامل مع المعاملات.
• لوحة تحكم المشرف : إدارة المنتجات والأوامر والمستخدمين بسلاسة.
• تصميم سريع الاستجابة : يضمن تجربة مستخدم رائعة على جميع الأجهزة.
• جمع عناوين الشحن : جمع وإدارة تفاصيل الشحن بسهولة.
• Tailwind CSS : لتصميم فعال وقابل للتخصيص.

ابدء

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

• Node.js (الإصدار 14.x أو الأحدث)
• npm (الإصدار 6.x أو الأحدث) أو الغزل (الإصدار 1.x أو الأحدث)
• مثيل MongoDB
• حساب الشريط ومفاتيح API

تثبيت

1. استنساخ المستودع

   git clone https://github.com/yourusername/shopfinity.git
   cd shopfinity

2. تثبيت التبعيات

   npm install
   # or
   yarn install

3. متغيرات البيئة

   قم بإنشاء ملف .env.local في الدليل الجذر وأضف متغيرات البيئة التالية:

    MONGODB_URI=your_mongodb_connection_string
   AUTH_SECRET=your_auth_secret
   AUTH_GITHUB_ID=your_github_client_id
   AUTH_GITHUB_SECRET=your_github_client_secret
   AUTH_GOOGLE_ID=your_google_client_id
   AUTH_GOOGLE_SECRET=your_google_client_secret
   NEXT_STRIPE_SECRET_KEY=your_stripe_secret_key
   NEXT_STRIPE_PUBLIC_KEY=your_stripe_public_key
   STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret
   RESEND_API_KEY=your_resend_api_key
   NEXT_ADMIN_EMAIL=your_admin_email
   AUTH_TRUST_HOST=true
   

4. قم بتشغيل خادم التطوير

   npm run dev
   # or
   yarn dev

   افتح http://localhost:3000 باستخدام متصفحك لترى النتيجة.

هيكل المشروع

• /app : يحتوي على كافة المسارات.
• /components : مكونات React القابلة لإعادة الاستخدام.
• /lib : تكوين MongoDB والشريط والمصادقة.
• /lib/models : نماذج Mongoose لـ MongoDB.
• /utils : وظائف الأداة المساعدة.

الاستخدام

المصادقة

• يمكن للمستخدمين التسجيل وتسجيل الدخول باستخدام البريد الإلكتروني الخاص بهم أو مزودي الطرف الثالث (Google، GitHub، وما إلى ذلك).
• يمكن للمستخدمين المصادق عليهم الوصول إلى ملفاتهم الشخصية وسجل الطلبات والمزيد.

لوحة تحكم المشرف

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

المدفوعات

• متكامل مع Stripe لمعالجة الدفع الآمن.
• يمكن للمستخدمين إضافة عناصر إلى سلة التسوق والمتابعة إلى الخروج.
• جمع عنوان الشحن أثناء الخروج.

الريح الخلفية CSS

• يتم استخدام Tailwind CSS للتصميم. يمكنك تخصيص الأنماط عن طريق تحرير ملف tailwind.config.js وإضافة فئات CSS المخصصة في ملف styles/globals.css .

المساهمة

نحن نرحب بالمساهمات! يرجى اتباع الخطوات التالية للمساهمة:

1. شوكة المستودع.
2. قم بإنشاء فرع جديد ( git checkout -b feature/your-feature ).
3. قم بإجراء التغييرات الخاصة بك.
4. قم بإجراء تغييراتك ( git commit -am 'Add new feature' ).
5. ادفع إلى الفرع ( git push origin feature/your-feature ).
6. إنشاء طلب سحب جديد.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT. راجع ملف الترخيص لمزيد من التفاصيل.

شكر وتقدير

• Next.js
• MongoDB
• Auth.js (المصادقة التالية)
• شريط
• الريح الخلفية CSS

---

العرض المباشر

تحقق من العرض المباشر لـ Shopfinity هنا.

لا تتردد في تخصيص ملف README.md هذا وفقًا لمتطلبات مشروعك المحددة. استمتع بالبناء مع Shopfinity!