# ? المساعد العقاري الذكي — Smart Real Estate Agent
## الوصف
منصة **SaaS** متكاملة تحوّل واتساب الشركات العقارية إلى **محرك مبيعات ذكي يعمل 24/7**. النظام يستقبل استفسارات العملاء عبر واتساب، يفهمها بالعربي بذكاء اصطناعي متقدم، يبحث عن العقارات المناسبة تلقائياً، ويحجز المعاينات — كل ذلك بدون تدخل بشري.
---
## ? التقنيات
| التقنية | الإصدار |
|---|---|
| Next.js | 16.2.1 |
| React | 19.2.4 |
| TypeScript | 5 (Strict) |
| TailwindCSS | 3.4.1 |
| Supabase (PostgreSQL) | + RLS |
| OpenAI GPT | Function Calling |
| Wasender | WhatsApp API |
| Zod | 4.3.6 |
---
## ? كيف يعمل البوت
```
العميل يرسل رسالة واتساب
↓
Webhook يستقبل → تحقق الأمان
↓
تصنيف النية (Intent Classification)
↓
اختيار وكيل AI متخصص (من 5 وكلاء):
? وكيل المحادثة العقارية
? وكيل المواعيد
? وكيل التأهيل
? وكيل التصعيد البشري
? وكيل تحويل الصوت
↓
Function Calling (بحث، تفاصيل، حجز، تصعيد)
↓
إرسال الرد (نص + صور + موقع + PDF)
↓
تحديث CRM + إشعار الفريق
```
---
## ? مميزات لوحة التحكم (15 شاشة)
| الشاشة | الوظيفة |
|---|---|
| **الرئيسية** | إحصائيات + رسوم بيانية + 8 ويدجت قابلة للسحب |
| **العقارات** | إدارة كاملة + رفع صور + PDF + استيراد CSV |
| **المحادثات** | عرض الدردشة + إرسال يدوي + ملاحظات |
| **العملاء** | CRM كامل — حالات (6) + أولويات (Hot/Warm/Cold) |
| **المواعيد** | جدولة + تأكيد + تقييم |
| **الفريق** | أعضاء + أدوار (4) + دعوات + صلاحيات |
| **التحليلات** | معدل التحويل + أداء الفريق + AI Analytics |
| **الإعدادات** | معلومات الشركة + SEO + نطاقات + أمان |
| **إعدادات البوت** | ترحيب + قوائم + توزيع + جودة الوسائط |
| **الردود التلقائية** | كلمات مفتاحية + مطابقة + أولويات |
| **قاعدة المعرفة** | مقالات + تصنيفات + AI يستخدمها تلقائياً |
| **ربط واتساب** | QR Code + حالة الاتصال + اختبار |
| **الفواتير** | 3 خطط + ROI Calculator + سجل |
| **التقارير** | تصدير + نسخ احتياطي |
| **سجل التدقيق** | من عدّل + متى + ماذا |
---
## ? الأدوار (4 مستويات)
| الدور | الصلاحيات |
|---|---|
| **المالك** | كل شيء + فواتير + API + إعدادات |
| **المدير** | عقارات + فريق + محادثات + تحليلات |
| **الوكيل** | عقارات + محادثات + عملاء + مواعيد |
| **المشاهد** | قراءة فقط |
---
## ? الصفحات العامة
- **صفحة هبوط** تسويقية
- **كتالوج عقارات** عام لكل شركة
- **صفحة عقار فردية** مع صور + خريطة + PDF
- **4 رحلات مستخدم** (عميل، وكيل، مسوق، مالك)
- **تسعير** مع 3 خطط
---
## ? الأمان
- Row Level Security (عزل بيانات كل شركة)
- JWT + Refresh Tokens
- تشفير مفاتيح API
- Multi-tenant معزول بالكامل