جمع القمامه

Clean City - Smart Multi-Vendor Waste Collection Platform

نظام خلفي (Backend Web API) متكامل ومبني باستخدام أحدث تقنيات مايكروسوفت ASP.NET Core (.NET 8)، مخصص لإدارة عمليات جمع النفايات الذكية لنظام متعدد البائعين (Multi-Vendor). يتيح النظام تنسيق العمليات بين المواطنين، إدارة شركات النفايات، والسائقين بكفاءة عالية مع معالجة منطق الأعمال المالي والإداري بدقة.

الهندسة المعمارية وتقنيات البناء:

N-Tier Architecture: تطبيق فصل صارم بين الطبقات (API / BLL / DAL / Domain) باستخدام نمط Repository Pattern لضمان عدم ارتباط طبقة منطق الأعمال بقواعد البيانات مباشرة، مما يجعل الكود قابلاً للاختبار والصيانة.

ORM: استخدام Entity Framework Core (Code First) مع قواعد بيانات SQL Server.

الأمان والحماية: تطبيق مصادقة JWT Bearer Authentication مع نظام صلاحيات صارم يعتمد على الأدوار (Role-Based Authorization) لثلاثة أنواع من المستخدمين (Citizen, VendorAdmin, Driver).

اختبارات الوحدة (Unit Testing): تغطية المشروع باختبارات وحدة شاملة باستخدام xUnit، Moq، وFluentAssertions للتحقق من سيناريوهات العمل وحالات الحافة (Edge Cases).

أبرز قواعد الأعمال والخصائص التقنية:

حساب الأسعار الديناميكي (Dynamic Pricing): احتساب التكلفة بناءً على القاعدة (BasePricePerKg × Weight) مضافاً إليها رسوم الوزن أو المسافة المطابقة لقواعد التسعير.

قواعد الشاحنات الخاصة (Special-Truck Rules): التحقق التلقائي من مطابقة نوع النفايات التي تتطلب شاحنة خاصة مع الشاحنة المخصصة للسائق.

العمولات والمدفوعات: اقتطاع عمولة المنصة تلقائياً بنسبة 15% عند إتمام السائق لعملية الجمع، مع تجميع الأرباح الشهرية للبائعين باستخدام LINQ (GroupBy) ومنع تكرار المدفوعات الشهرية.

إدارة النطاقات الجغرافية: ضمان رؤية البائعين لطلبات الاستلام الخاصة بنطاقهم التشغيلي فقط (Case-Insensitive Area Matching).