ShopKart E commerce Website

Shopkart: موقع التجارة الإلكترونية

عن

هذا موقع ويب للتجارة الإلكترونية بسيطة يتم تنفيذها باستخدام إطار عمل Spring Boot في Java ، من قبل مجموعة من خمسة أعضاء ، وهي Spring Spartans . تم تعيين مشروع المجموعة هذا ضمن Information Processing for Web في الفصل الدراسي الخامس من BTECH (IT) ، University of Calcutta

حالة المشروع

مكدس التكنولوجيا ‍

الميزات الرئيسية

1. Customer Management - تسجيل الدخول ، التسجيل ، عرض وتحديث الملف الشخصي
2. Product Catalog - عرض المنتجات ، والبحث بالاسم ، وفلتر حسب الفئة
3. Shopping Cart - أضف منتجات إلى العربة وزيادة وتقليل الكمية
4. Order Management* - أوامر مكان من العربة ، وشراء مرة أخرى ، وإلغاء الطلبات ، وقائمة الطلبات التفصيلية وملخصها
5. Admin Dashboard - تسجيل الدخول (مع مفتاح أمان) ، رؤية المبيعات من خلال التحليلات ، إضافة أو تحديث المنتجات ، عرض العملاء ، تحديث الطلبات

* هذا المشروع مصنوع بحتة للأغراض التعليمية وليس المقصود نشره للإنتاج. يفترض أن المدفوعات يتم على الفور على تقديم الطلبات لأن هذا المشروع غير متكامل مع بوابة الدفع.

---

ملخص نقاط النهاية

نقطة النهاية	عرض المقدمة
/	صفحة تسجيل الدخول للعميل
/signup	صفحة التسجيل للعميل
/update	نموذج لتحديث ملف تعريف العميل
/product	كتالوج المنتج
/product/category/{category}	تصفية المنتجات حسب الفئة
/product/search?prefix={prefix}	نتائج البحث عن المنتجات بالاسم
/product/{id}	تفاصيل المنتج
/cartitem/cart	عربة العميل
/order/history	سجل طلب العميل/قائمة
/order/summary/{id}	ملخص الطلب
/admin	صفحة تسجيل الدخول للمسؤول
/admin/dashboard	لوحة معلومات المشرف

---

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

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

• Java Development Kit (JDK) : قم بتنزيل من موقع Oracle الرسمي أو استخدم OpenJDK.
• مافن : قم بتنزيل من موقع Maven الرسمي.
• MySQL : قم بتنزيل من موقع MySQL الرسمي.
• IDE : بيئة تنمية متكاملة (IDE) مثل IntelliJ IDEA أو Eclipse IDE .
• البرنامج المساعد STS (إذا كنت تستخدم Eclipse) : قم بتثبيت البرنامج المساعد STS.

---

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

لاستنساخ المستودع ، اتبع هذه الخطوات:

1. افتح المحطة الخاصة بك (موجه الأوامر ، PowerShell ، أو أي محاكي طرفي).

2. انتقل إلى الدليل حيث تريد استنساخ المشروع.

3. قم بتشغيل الأمر التالي:

   git clone https://github.com/Swarnotaj003/ShopKart-E-commerce-Website.git

4. انتقل إلى دليل المشروع:

    cd ShopKart-E-commerce-Website

5. قم بإعداد قاعدة البيانات الخاصة بك : افتح عميل سطر أوامر MySQL أو Workbench وقم بإنشاء قاعدة بيانات جديدة للمشروع.

    DROP DATABASE IF EXISTS shopkart;
   CREATE DATABASE shopkart ;

   ملاحظة : يمكنك اتباع هذه الخطوة في أي وقت لإعادة تعيين قاعدة البيانات الخاصة بك

6. تكوين إعدادات اتصال قاعدة البيانات : افتح ملف application.properties وتحديث إعدادات اتصال قاعدة البيانات.

    # Database connection settings
   spring.datasource.url =jdbc:mysql://localhost:3306/shopkart
   spring.datasource.username =<your_mysql_username>
   spring.datasource.password =<your_mysql_password>

   استبدل your_mysql_username و your_mysql_password بأوراق اعتماد mySQL الخاصة بك.

7. قم بإعداد مسار المشروع الخاص بك : افتح ملف application.properties وتحديث مسار المشروع.

    # Settings for uploading files
   spring.servlet.multipart.enabled =true
   file.project-path =<your_project_path>
   file.image-path =src\main\resources\static\images

---

تنفيذ المشروع

باستخدام غلاف مافن

يتيح لك غلاف Maven تشغيل أوامر Maven دون الحاجة إلى تثبيت Maven على جهازك. اتبع هذه الخطوات لتشغيل تطبيق SPRING BOOT باستخدام غلاف Maven:

1. افتح المحطة الطرفية الخاصة بك : تأكد من فتح المحطة (موجه الأوامر ، أو PowerShell ، أو أي محاكي طرفي).

2. انتقل إلى دليل المشروع : إذا لم تكن موجودًا بالفعل في دليل المشروع ، فاستخدم أمر cd للتنقل إليه. على سبيل المثال:

    cd path/to/your/ShopKart-E-commerce-Website

3. قم بتشغيل التطبيق باستخدام Maven Wrapper : استخدم الأمر التالي لإنشاء التطبيق وبدء تشغيله:

   ./mvnw spring-boot:run

   على Windows ، استخدم:

   mvnw spring-boot:run

4. انتظر حتى يبدأ التطبيق. يجب أن ترى الإخراج في المحطة التي تشير إلى أن التطبيق يعمل ، إلى جانب رقم المنفذ (الافتراضي هو 8080).

5. بمجرد بدء التطبيق ، افتح متصفح الويب الخاص بك وانتقل إلى:

    http://localhost:8080
   

باستخدام IDE

يمكنك أيضًا تشغيل تطبيق SPRING BOOT مباشرة من IDE. اتبع هذه الخطوات بناءً على IDE المفضل لديك:

1. إطلاق IDE واستيراد المشروع.

2. حدد موقع فئة التطبيق الرئيسية المسماة ShopkartApplication.java في دليل src/main/java .

   • انقر بزر الماوس الأيمن على ملف الفئة الرئيسية وحدد Run As > Spring Boot Application .

3. بمجرد بدء التطبيق ، افتح متصفح الويب الخاص بك وانتقل إلى:

    http://localhost:8080