Wasla_Project

تطبيق ومشروع "وصلة" (Wasla) هو منصة رقمية تفاعلية قائمة على مفهوم الاقتصاد التشاركي (Sharing Economy)، تُصمّم لتكون "حلقة وصل" بين الأشخاص الذين يمتلكون أدوات ومعدات ولا يستخدمونها باستمرار، وبين الأشخاص الذين يحتاجون لاستعارة هذه الأدوات لفترة مؤقتة.

يهدف المشروع إلى تسهيل عملية استعارة وتبادل الأدوات (مثل: العدد والأدوات اليدوية، الأجهزة الكهربائية والمنزلية، المعدات التقنية، وغيرها) بأسلوب منظم، دقيق، وآمن للطرفين (المُستعير والمالك).

💡 ماذا يقدم نظام "وصلة" بالتفصيل؟

1. نظام طلب واستعارة الأدوات (Borrowing Process)

استكشاف وتصفح الأدوات: يتيح للمستعير البحث عن الأدوات المتاحة حوله وتصفح تفاصيلها، مع معرفة حالة الأداة ومدى توفرها.

تقديم طلب الاستعارة: يقوم المستعير بتحديد فترة الاستعارة المطلوبة (تاريخ ووقت البدء، وتاريخ ووقت الترجيع المخطط له) وإرسال الطلب لمالك الأداة.

2. مرحلة إرجاع الأداة والتأكيد (Return & Verification Flow)

تُعتبر هذه المرحلة من أهم أجزاء النظام لضمان حقوق المالك والمستعير ومنع أي خلافات:

إشعار الترجيع من المستعير (Borrower Return Notification):

عندما ينتهي المستعير من استخدام الأداة، يقوم بالدخول إلى التطبيق والنقر على خيار "إرجاع الأداة" (Return Tool).

يُسجّل النظام في هذه اللحظة الوقت والتاريخ الدقيق لطلب الإرجاع من قبل المستعير.

تأكيد المالك (Owner Confirmation & Verification):

بعد تقديم طلب الإرجاع من المستعير، تصل إشارة/تنبيه للمالك بأن المستعير يُريد إرجاع الأداة.

لا تُعتبر عملية الإرجاع مكتملة رسمياً إلا بعد موافقة وتأكيد المالك.

يقوم المالك بفحص الأداة للتأكد من سلامتها وحالتها الفنية، ثم يقوم بالضغط على "تأكيد استلام وإرجاع الأداة" (Confirm Return) من حسابه.

3. إدارة الوقت والمدة الزمنية (Time & Duration Tracking)

تسجيل الوقت الفعلي: يحسب النظام الوقت والتاريخ بدقة لحظة تسليم الأداة ولحظة إرجاعها وتأكيد المالك.

متابعة التأخير: في حال تأخر المستعير عن موعد الإرجاع المتفق عليه، يقوم النظام بتنبيه الطرفين ورصد فترة التأخير بدقة.

4. توثيق حالة الأداة والتقييم (Condition & Feedback)

تتبّع حالة الأداة: إمكانية تسجيل وتوثيق حالة الأداة قبل وبعد الاستعارة لضمان عودتها بنفس الحالة التشغيلية.

التقييم والتغذية الراجعة: يتيح النظام لكل من المالك والمستعير تقييم التجربة بناءً على الالتزام بالمواعيد وسلامة الأداة وسهولة التعامل.

🎯 الهدف الأساسي من "وصلة"

توفير بيئة موثوقة ومُؤتمتة بالكامل تُنظّم عملية استعارة الأدوات، وتحفظ حقوق المالك من خلال اشتراط تأكيده الشخصي على الإرجاع والوقت، وتمنح المستعير وسيلة سهلة للوصول إلى الأدوات وتوثيق إرجاعها بدقة.

Wasla API (وصلة - الواجهة البرمجية)

📌 عن المشروع (Project Overview)

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

تم إعداد وتصميم المشروع باتباع أحدث الممارسات المعمارية لمطوري .NET لضمان سهولة التوسع (Scalability)، المرونة في التعديل، والأداء العالي.

🚀 الميزات الأساسية (Key Features)

RESTful Architecture: توفير نقاط نهاية (Endpoints) منظمّة وموثقة للتعامل مع البيانات.

Modern .NET Core Base: الاستفادة من أحدث الميزات في منصة .NET والأداء المتقدم.

Environment Configuration: دعم كامل لضبط إعدادات بيئات العمل المختلفة (Development & Production) عبر ملفات appsettings.json.

Security & Identity Integration: الجاهزية لدعم وإدارة الهوية والتحقق من المستخدمين والتكامل مع Azure Core / Azure Identity.

Localization Ready: دعم متعدد اللغات للنظام والرسائل من خلال الموارد البرمجية الجاهزة (Localization Support).

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

Framework: .NET 10 Web API

Language: C#

Configuration: JSON File Configuration Management

Cloud & Identity Integration: Azure.Core, Azure.Identity

📦 متطلبات التشغيل (Prerequisites)

قبل تشغيل المشروع، تأكد من تثبيت المتطلبات التالية على بيئة التطوير:

.NET 10 SDK (أو الإصدار المدعوم في بيئتك)

أي بيئة تطوير متكاملة مدعومة مثل Visual Studio 2022+ أو VS Code

⚙️ طريقة التشغيل (How to Run)

استคลون المستودع (Clone Repository):

Bash

git clone <REPOSITORY_URL>

cd WebApplication1/WaslaApi

استعادة الحزم والاعتماديات (Restore Packages):

Bash

dotnet restore

تشغيل المشروع (Run Project):

Bash

dotnet run

الوصول للخدمة:

سيتم تشغيل الـ API محلياً عبر المسار المكتوب في المخرجات (مثال: https://localhost:7071 أو http://localhost:5000).