EcoBridge API

نظام EcoBridge هو منصة واجهة خلفية (Backend API) متطورة تم بناؤها باستخدام أحدث تقنيات .NET 10 لحل مشكلة إهدار الطعام، من خلال الربط الذكي والفعال بين المتبرعين، الجمعيات الخيرية، ومتطوعي التوصيل في بيئة رقمية آمنة ومتكاملة.

أبرز الخصائص والوظائف الأساسية (Core Features)

نظام إدارة أدوار متعدد (Multi-Role RBAC): بيئة عمل مخصصة وآمنة تدعم 4 فئات مختلفة من المستخدمين (المتبرعون، الجمعيات الخيرية، متطوعو التوصيل، ومديرو النظام)، مع تحديد دقيق للصلاحيات والمهام لكل دور.

إدارة دورة حياة التبرع (Donation Lifecycle): إمكانية نشر التبرعات الغذائية المتاحة، إرفاق صورها، استعراضها وقبولها من قِبل الجمعيات الخيرية، وتتبع حالة التبرع خطوة بخطوة حتى وصوله للمستفيدين.

نظام لوجستي لمتطوعي التوصيل (Volunteer Workflows): مسار عمل مخصص للمتطوعين لاستلام مهام التوصيل المتاحة، تأكيد الاستلام، وتحديث حالة التسليم لضمان مرونة وسرعة النقل.

لوحة تحكم وإحصائيات متقدمة (Admin Dashboard): واجهة إدارية تتيح مراقبة النظام بالكامل، إدارة الحسابات، استخراج تقارير الأداء، وعرض إحصائيات دقيقة حول الكميات المستردة ومعدلات تقليل الهدر.

إدارة التخزين السحابي للوسائط: تكامل برمجي متطور مع Cloudinary لرفع ومعالجة صور التبرعات بسرعة وكفاءة عالية دون استهلاك موارد السيرفر المحلي.

التقنيات المستخدمة والهيكلية البرمجية (Tech Stack & Architecture)

اللغة وإطار العمل: C# مع الاعتماد على الإصدار الأحدث .NET 10 / ASP.NET Core Web API لضمان أداء فائق وسرعة معالجة عالية للبيانات.

قواعد البيانات: SQL Server بالاعتماد على Entity Framework Core لإدارة النماذج والترحيل التلقائي للبيانات (Migrations).

الهيكلية البرمجية (N-Tier Architecture): تم تصميم النظام بتقسيم هندسي منظم يفصل بوضوح بين طبقات النظام (Controllers, Services, Domains, DTOs, Data)، مما يضمن كتابة كود نظيف (Clean Code) يسهل اختباره وصيانته وتوسعته مستقبلاً.

الأمان والتوثيق (Security & Authentication): نظام توثيق متعدد الطبقات يعتمد على JWT (JSON Web Tokens) مدعوماً بنظام Refresh Tokens لضمان استمرارية تسجيل الدخول بأمان دون المساومة على حماية الحسابات.

حماية السيرفر والأداء (Rate Limiting): تطبيق نظام حماية متقدم من نوع Sliding-Window Rate Limiting لتنظيم معدل الطلبات (بناءً على عنوان الـ IP وهوية المستخدم) وحماية الـ API من الهجمات أو الضغط المفرط.

التوثيق والاختبار (Documentation & Testing): توثيق شامل ومؤتمت لجميع مسارات الـ API باستخدام Swagger/OpenAPI، مع توفير مجموعات اختبار جاهزة (Postman & Bruno Collections) لتسهيل الفحص والتكامل مع مطوري الواجهات الأمامية.

هذا المشروع يجمع بين التأثير الاجتماعي والبيئي الإيجابي وبين القوة التقنية، حيث يقدم حلاً خادماً (Backend) جاهزاً للإنتاج الفعلي بمواصفات أمنية وبرمجية تطابق أعلى معايير الشركات التقنية.