هذا المشروع يمثل الواجهة الخلفية (Backend) لمنصة إدارة عرض العقارات، حيث يسهل على المستخدمين البحث عن عقارات للبيع أو للإيجار، ويمكّن المالكين من إدارة قوائم ممتلكاتهم بطريقة فعّالة وآمنة.
الفكرة الأساسية
إنشاء منصة حديثة، سريعة، وآمنة تعمل كحلقة وصل موثوقة بين ملاك العقارات والمشترين أو المستأجرين، مع إدارة متكاملة لجميع العمليات الخلفية.
تم تطوير هذا المشروع كنموذج أولي عملي (MVP) باستخدام أحدث التقنيات لضمان أداء عالي، قابلية للتوسع، وسهولة الاختبار والتكامل مع الخدمات الخارجية.
المميزات الأساسية
1. بوابة المستخدمين المتقدمة
البحث عن العقارات باستخدام فلاتر متعددة: السعر، الموقع، عدد الغرف، المساحة، نوع العقار.
عرض قوائم العقارات بشكل مفصل، مع صور عالية الجودة ومعلومات شاملة.
2. لوحة تحكم الملاك
إضافة العقارات وإدارتها بسهولة (تعديل، تحديث، حذف).
إدارة الصور والبيانات المرفقة بالعقار بشكل سلس وآمن.
3. مصادقة وحماية عالية
نظام تسجيل دخول آمن يعتمد على JWT.
فصل الصلاحيات بين المستخدمين والملاك لضمان حماية البيانات.
4. تكامل مع الخدمات الخارجية
دعم خدمات تخزين الصور مثل Cloudinary وAWS S3.
تنفيذ الطلبات بشكل غير متزامن بالكامل (Fully Async) للتعامل مع آلاف الطلبات في الثانية.
5. أداء ومعمارية متقدمة
تطبيق CQRS لفصل عمليات القراءة عن الكتابة، وضمان أقصى أداء تحت الضغط.
تصميم معماري مرن يدعم التوزيع الأفقي (Horizontal Scaling).
قابلية عالية للاختبار، تشمل:
اختبارات وحدة شاملة لكل ميزة.
اختبارات تكامل مع الخدمات الخارجية.
التقنيات المستخدمة
Python 3.12+ مع FastAPI لبناء واجهة API سريعة وموثوقة.
PostgreSQL قاعدة بيانات علائقية قابلة للتوسع.
SQLModel لإدارة قاعدة البيانات بشكل آمن ومرن.
Pydantic للتحقق من صحة البيانات.
JWT لتأمين عمليات المصادقة.
pytest لإجراء اختبارات شاملة وضمان جودة النظام.
معمارية حديثة: CQRS Vertical Slice لسهولة الصيانة والتطوير.