Souq artisian

Lebanon Bazaar - Full-Stack Multi-Vendor Marketplace

نظرة عامة على المشروع:

منصة تجارة إلكترونية متكاملة بمستوى الإنتاج (Production-Grade)، مصممة لدعم الحرفيين المحليين. يوفر النظام دورة حياة كاملة تبدأ من تسجيل البائع وإدارة المنتجات، إلى معالجة الطلبات وإدارة المحافظ المالية. النظام مبني بالكامل باستخدام TypeScript ويدعم اللغتين العربية والإنجليزية، مع لوحة تحكم إدارية شاملة.

التقنيات المستخدمة:

- الواجهة الخلفية (Backend): Node.js, Express, PostgreSQL, Drizzle ORM, Zod, JWT

- الواجهة الأمامية (Frontend): React 18, Vite, TanStack Query, Tailwind CSS, shadcn/ui

- هندسة النظام: RESTful API, End-to-End Type Safety, Role-Based Access Control (RBAC)

أبرز الإنجازات والقرارات الهندسية:

- السلامة المالية والمعاملات الذرية (Atomic Transactions): هندسة العمليات الحساسة (مثل تأكيد الطلبات وتحديث أرصدة البائعين) باستخدام المعاملات الذرية لقاعدة البيانات لضمان دقة العمليات المالية بنسبة 100٪ ومنع أي أخطاء أو عمليات غير مكتملة.

- إدارة الحالات المتقدمة (State Machines): تطبيق آلات حالة صارمة في الواجهة الخلفية للتحكم في دورة حياة الطلبات (معلق، مؤكد، مشحون، تم التوصيل) وحالات البائعين، لمنع أي تلاعب أو انتقالات غير منطقية للبيانات.

- أمان متقدم ونظام صلاحيات صارم (Security & RBAC): بناء نظام أمان يعتمد على JWT مع هيكلة دقيقة للصلاحيات (مشتري، بائع معتمد، مدير). يتضمن النظام حماية البيانات الحساسة عبر تصميم (SafeUser Types) لضمان عدم تسريب بيانات المصادقة.

- حماية العمليات الحسابية (Server-Side Calculation): تأمين النظام ضد التلاعب بالأسعار من خلال تجاهل مدخلات المستخدم وتطبيق حساب الإجماليات والعمولات حصرياً على الخادم بناءً على بيانات قاعدة البيانات الموثوقة.

- معمارية رفع الملفات القابلة للتوسع (Presigned-URL Uploads): تصميم نظام رفع ملفات آمن يحاكي بنية AWS S3 لتقليل الحمل على الخادم الرئيسي وحماية النظام من الثغرات الأمنية مثل (Path Traversal).

- أمان الأنواع الشامل (End-to-End Type Safety): توحيد الأنواع (Types) ومخططات التحقق (Zod) بين الواجهة الأمامية والخلفية، مما رفع من استقرار الكود وقلل من الأخطاء البرمجية بشكل كبير.

- تكامل البيانات (Data Integrity): تطبيق آلية الحذف المرن (Soft Deletes) للحفاظ على البيانات التاريخية للطلبات، مع بناء سجل تدقيق (Audit Log) آلي لتتبع كافة الإجراءات الإدارية وتوفير الشفافية الكاملة.