Poktco

Poktco هي منصة تجارة إلكترونية متكاملة طورتُها لتقديم تجربة تسوق إلكتروني احترافية داخل المملكة العربية السعودية. اشتغلت على الـ Backend بالكامل باستخدام ASP.NET Core Web API مع اعتماد Clean Architecture لتوفير كود منظم، قابل للاختبار، وسهل التوسعة. النظام جاهز للاستهلاك من أي واجهة Frontend (ويب أو موبايل) ويتضمن أدوات إدارة كاملة للمنتجات، الطلبات، المستخدمين، والمراجعات.

المميزات والوظائف الأساسية (Detailed Features)

إدارة المستخدمين والحسابات

تسجيل حساب جديد وتفعيل البريد (Register + Email verification).

تسجيل دخول وحصول على JWT لتأمين الـ API.

إدارة الصلاحيات (Roles): Admin, User, Seller.

صفحة ملف المستخدم: تعديل المعلومات الشخصية، رفع صورة، إدارة العناوين.

استرجاع كلمة المرور (Reset Password) عبر الإيميل.

إدارة المنتجات

CRUD كامل للمنتجات (إنشاء، قراءة، تعديل، حذف).

حقول المنتج: اسم، وصف طويل/قصير، سعر، كمية، SKU، خصم اختياري، حالة التوفر، خامات/ماركة، خصائص ديناميكية.

رفع صور متعددة لكل منتج مع تمييز الصورة الرئيسية (Main Image).

تصنيفات شجرية (Categories) وعناوين فرعية (Subcategories).

البحث المتقدم: بحث نصي، فلتر بالسعر، التقييم، التصنيف، والـ pagination للنتائج.

دعم الـ sorting (الأحدث، الأقل سعراً، الأعلى تقييماً).

عربة التسوق والـ Checkout

نظام Cart على مستوى المستخدم (حفظ داخل DB أو session حسب إعدادات).

إنشاء أمر شراء (Order) يحتوي OrderItems، حساب المجموع (subtotal, tax, shipping, total).

حالات الطلب (enum): Pending, Processing, Shipped, Delivered, Cancelled.

واجهات لإدارة حالة الطلب من قبل الـ Admin أو Seller.

إدارة الطلبات والمدفوعات (مهيأ للتكامل)

CRUD لطلبات الإدارة مع فلترة حسب التاريخ، الحالة، المستخدم.

إمكانية دمج بوابات دفع (قابلة للإضافة لاحقًا) مثل PayPal / Stripe / بوابات محلية.

حفظ بيانات فاتورة شحن وعنوان الشحن منفصلًا عن عنوان المستخدم.

المراجعات والتقييمات

نظام تقييم النجوم وكتابة مراجعة لكل منتج.

عرض متوسط التقييم وعدد المراجعات لكل منتج.

صلاحيات تعديل/حذف المراجعات من قبل صاحب المراجعة أو Admin.

لوحة تحكم إدارية (API-ready)

Endpoints لإدارة المنتجات، المستخدمين، الطلبات، التصنيفات، المراجعات، التقارير الأساسية (مبيعات يومية/شهرية).

توثيق عبر Swagger جاهز للإظهار على لوحة الإدارة

رفع الملفات والتعامل مع الوسائط

رفع صور وفيديوهات المنتج إلى مجلد منظم داخل wwwroot/uploads/... (قابل للاستبدال بخدمات سحابيّة مثل Azure Blob أو AWS S3).

تخزين المسارات في قاعدة البيانات مع دعم حذف واستبدال الصور.

التقنية المستخدمة (Tech Stack)

اللغة/الإطار: C# / ASP.NET Core (Web API)

قاعدة البيانات: Microsoft SQL Server (EF Core — Code First)

ORM: Entity Framework Core

هوية/أمان: ASP.NET Identity + JWT Authentication

Mapping: AutoMapper

التحقق: FluentValidation

اللوغ والـ Logging: Serilog (حفظ إلى ملف/console أو sinks خارجية حسب الطلب)

توثيق API: Swagger / OpenAPI

نشر: خادم Windows/IIS أو VPS (إمكانية التهيئة لـ Docker أو App Service لاحقًا)

تصميم معماري: Clean Architecture (Presentation, Application, Domain, Infrastructure)

نمط الوصول للبيانات: Repository + Unit of Work (قابل للاختبار، DI)

الأمان والاختبارات

أمان: تخزين كلمات المرور بشكل مشفّر، استخدام JWT مع expiry مناسب، Role-based وPolicy-based authorization، حماية من هجمات CSRF/XSS عبر أفضل ممارسات الـ Frontend وـCORS مضبوط.

الاختبارات: Unit Tests للخدمات والـRepositories، Integration Tests على Endpoints حرصًا على استقرار النظام.

إعدادات Rate Limiting وInput Validation لمنع الـ abuse.

النشر والـ DevOps

نشر على خادم VPS أو خادم IIS، مع إعدادات بيئة (appsettings.Production.json).

دعم إعداد CI/CD بسيط (GitHub Actions / Azure DevOps) لنشر تلقائي عند الـ push على الفرع الرئيسي إن رغب العميل.

إعدادات Backups لقاعدة البيانات وجدولة snapshots.

المخرجات (Deliverables) التي أقدّمها عند التسليم

كود مصدر مرتب ومفصول حسب Clean Architecture (مستودع Git).

قاعدة بيانات SQL Server (Migration scripts — EF Migrations).

توثيق API كامل عبر Swagger/OpenAPI

ملف ReadMe يشرح كيفية إعداد المشروع محليًا ونشره.

إرشادات دمج الواجهة الأمامية (مثال للـ requests والأساليب).

اختبارات Unit + Integration أساسية.

إعدادات نشر (Deployment guide) والـ appsettings للبيئات.

إذا طُلب — إعداد CI/CD بسيط ونصائح لتخزين الوسائط سحابيًا.