TruckProSource | منصة تجارة إلكترونية لقطع الشاحنات الثقيلة (China Edition) — دفع فوري لكل منتج + لوحات تحكم متعددة الأدوار
تفاصيل العمل
TruckProSource هو مشروع Full-Stack لتجارة إلكترونية مخصص لقطاع قطع الشاحنات الثقيلة، موجّه للسوق الصيني والمستثمرين، ويعتمد نموذج “الدفع الفوري لكل منتج” بدل سلة المشتريات: العميل يشتري المنتج مباشرة من صفحة التفاصيل عبر WeChat Pay أو Alipay , PayPal(حسب ما يدعمه المتجر).
✅ أبرز ما تم إنجازه
- نموذج Checkout فوري لكل منتج (Per-Item Instant Checkout) مع إظهار أزرار الدفع بشكل شرطي حسب وسائل الدفع المتاحة لدى كل متجر.
- نظام عمولة تلقائي: عند نجاح الدفع يتم إنشاء الطلب وتسجيل المعاملة، واحتساب العمولة تلقائياً مع حفظ Snapshot للمنتج/العميل/العمولة داخل الطلب لضمان الثبات التاريخي للبيانات.
- أدوار وصلاحيات (RBAC) كاملة:
• عميل: تصفح/بحث/فلترة، لايكات عامة، تتبع الطلبات وحالات التوصيل، تقييمات بنجوم + نص (ودعم صور)، وسجل طلبات مع بيانات Snapshot.
• صاحب متجر: إدارة المنتجات (صور، موديل/Brand، مواصفات ديناميكية، سعر/مخزون/شحن)، إدارة الطلبات (شحن/ETA)، رفع كتيبات PDF وروابط فيديو/YouTube، ومراسلة العميل عبر نظام بريد داخلي (Async).
• Admin: لوحة تحكم عامة، ضبط نسبة العمولة، إدارة المتاجر (قبول/تعليق/حظر)، moderation للبلاغات والمنتجات، سجلات تدقيق للأفعال الحساسة، وإدارة مفاتيح API/Webhooks.
- واجهات حديثة Responsive 100% (موبايل/تابلت/ديسكتوب) مع مكونات UI آمنة وقابلة لإعادة الاستخدام.
- أمان عالي على مستوى التطبيق والـAPI:
• تشفير كلمات المرور باستخدام Hashing قوي + Salt.
• حماية البيانات الحساسة واتباع مبدأ “عدم تخزين أي بيانات دفع حساسة”.
• تأمين طبقة الـAPI (تحقق صارم من المدخلات + صلاحيات) + Rate Limiting وحدود للطلبات لمنع الإساءة وDoS.
• سجلات تدقيق (Audit Logs) للعمليات الحساسة.
- بنية قابلة للتوسع: Outbox/Domain Events لمعالجة الإيميلات والويبهوكس بشكل موثوق مع Retry/Backoff عند الفشل، وOptimistic Locking لتجنب مشاكل التزامن.
- أداء وتجربة تطوير سريعة:
• زمن البناء الأولي ~12s، ثم ~2s بعد تكرار البناء (Turbo)، ثم تحديثات لاحقة وصلت ~150ms.
• تحسينات بحث وأداء (FTS/Indexing) + Caching للحد من ضغط قاعدة البيانات.
- فحص أمان الاعتمادات:
• pnpm audit → No known vulnerabilities found.
- ستاك وتقنيات: Next.js + TypeScript + Tailwind + shadcn/ui، Backend بـ tRPC، Prisma + PostgreSQL، Monorepo بـ Turborepo، ورفع ملفات (Images/PDF) مع إدارة ميتاداتا للملفات.