NOVA — Full-Stack E-Commerce Platform

# NOVA — Full-Stack E-Commerce Platform

تطوير منصة تجارة إلكترونية متكاملة لعلامة أزياء **Futuristic Streetwear**، تجمع بين تجربة تسوق حديثة وتفاعلية للمستخدمين، ونظام Backend قوي وقابل للتوسع، بالإضافة إلى **Admin Dashboard** لإدارة المنتجات والمخزون والطلبات والمستخدمين.

تم بناء المشروع كمنظومة **Full-Stack E-Commerce** حقيقية، بدايةً من استعراض المنتجات واختيار الـVariants والمقاسات، مرورًا بعربة التسوق وعمليات الـCheckout وإدارة المخزون، وصولًا إلى إدارة المنصة بالكامل من خلال لوحة تحكم مخصصة.

### Frontend

* تطوير الواجهة باستخدام **React 19 + Vite**.

* بناء نظام تصميم متجاوب باستخدام **Tailwind CSS v4**.

* تنفيذ Animations وMicro-interactions باستخدام **Framer Motion وGSAP وLenis**.

* بناء تجربة مستخدم حديثة تناسب هوية العلامة التجارية وتدعم مختلف أحجام الشاشات.

* إدارة حالة المستخدم والمصادقة عبر **React Context**.

* ربط الواجهة بالكامل مع REST APIs الخاصة بالـBackend.

### Backend

* تطوير RESTful API باستخدام **ASP.NET Core 9 Web API**.

* تطبيق **Clean Architecture** لفصل المسؤوليات وتحسين قابلية الصيانة والتوسع والاختبار.

* استخدام **SQL Server + Entity Framework Core 9** لإدارة البيانات.

* تطبيق **ASP.NET Identity** مع **JWT Authentication** وRefresh Tokens.

* استخدام **FluentValidation** للتحقق من صحة البيانات.

* استخدام **AutoMapper** لإدارة Mapping بين Entities وDTOs.

* إضافة **Serilog** للـLogging والمراقبة.

* توثيق واختبار الـAPIs باستخدام **Swagger / OpenAPI**.

### Architecture

تم تقسيم الـBackend إلى طبقات مستقلة:

**Domain**

تحتوي على الـEntities والـEnums وقواعد المجال الأساسية.

**Application**

مسؤولة عن الـDTOs والـInterfaces والـValidators ومنطق التطبيق.

**Infrastructure**

تتعامل مع الخدمات والبنية التحتية الخارجية، بما في ذلك Authentication وJWT.

**Persistence**

مسؤولة عن Database Access وEF Core وRepositories وUnit of Work وSeed Data.

**API**

تمثل طبقة الـPresentation وتحتوي على Controllers وإعدادات الـAuthentication وCORS وSwagger.

### Core E-Commerce Features

* Catalog ديناميكي للمنتجات والتصنيفات.

* دعم **Product Variants** والمقاسات.

* إدارة دقيقة للمخزون على مستوى الـVariant.

* إخفاء المقاسات غير المتوفرة تلقائيًا.

* إظهار **Low Stock Indicators** عند انخفاض المخزون.

* Cart system لإضافة المنتجات بالمقاس والكمية المطلوبة.

* Checkout workflow مع التحقق من توفر المخزون.

* تنفيذ عمليات المخزون داخل **Transactional Workflow** لتقليل احتمالية حدوث Inconsistent Stock Data.

* إنشاء الطلبات وتسجيل عمليات الدفع.

* تسجيل **Stock Transactions** لمتابعة تغيرات المخزون.

* Authentication وAuthorization للمستخدمين.

* صلاحيات منفصلة للمستخدمين والإدارة.

### Admin Dashboard

تم تطوير لوحة تحكم متكاملة تتيح للإدارة:

* إنشاء وتعديل وحذف المنتجات.

* إدارة Product Variants والمخزون.

* متابعة المنتجات منخفضة المخزون.

* إدارة الطلبات.

* إدارة المستخدمين.

* متابعة المبيعات والأرباح والإحصائيات.

* التحكم في بيانات المتجر من خلال واجهة إدارية موحدة.

### Project Outcome

المشروع يمثل **Production-Ready E-Commerce Architecture** وليس مجرد واجهة متجر، حيث تم ربط الـFrontend بالـBackend APIs بشكل كامل، وتنفيذ Business Logic الخاص بالطلبات والمخزون والمصادقة، مع تنظيم النظام باستخدام Clean Architecture ليكون قابلًا للتطوير والصيانة مستقبلًا.

**Project Type:** Full-Stack E-Commerce Platform

**Industry:** Fashion / Streetwear

**Architecture:** Clean Architecture

**Frontend:** React 19, Vite, Tailwind CSS, Framer Motion, GSAP, Lenis

**Backend:** ASP.NET Core 9 Web API, EF Core 9, SQL Server

**Authentication:** ASP.NET Identity, JWT, Refresh Tokens

**Key Focus:** E-Commerce, Inventory Management, Authentication, Admin Dashboard, REST APIs