الاستفسارات والمعاينات
كيف يصل نموذج التواصل وطلبات المعاينة في الموقع إلى الوكالة، وكيف يعالجها الفريق في لوحة التحكم، والحدود التي تُبقي النماذج نظيفة.
لحزمة الحزمة الكاملة
كيف يصل الطلب إلى الوكالة
| في الموقع | في لوحة التحكم |
|---|---|
| نموذج التواصل | استفسار، يُعلَّم «تواصل»، أو «سؤال» عندما أُرسل عن عقار |
| طلب معاينة في صفحة عقار | طلب معاينة، ومعه استفسار يُعلَّم «معاينة» |
- يُشعِر كل منها مباشرة كل مسؤول يستطيع عرض الاستفسارات أو المعاينات، ويصل إلى صفحة الاستفسارات أو المعاينات في لوحة التحكم.
- يرى الزائر تأكيدًا في الصفحة: يعرض طلب المعاينة مرجعه ويبقى بانتظار التأكيد حتى تؤكده الوكالة.
- لا يُرسل شيء بالبريد الإلكتروني، لا للزائر ولا للوكالة: فالقالب بلا خدمة بريد. يمكن للمطوّر إضافة واحدة بجانب الإشعار.
الاستفسارات
| الحالة | المعنى |
|---|---|
| جديد | وصل للتو. يبدأ كل استفسار هنا. |
| تم التواصل | ردّت الوكالة. |
| مؤهل | مشترٍ أو مستأجر جاد. |
| مغلق | منتهٍ، أيًّا كانت النتيجة. |
- تصفّي صفحة الاستفسارات بالحالة وتبحث، عشرة في الصفحة، بجانب الاستفسار المحدد: عقاره وبيانات الزائر وما طلبه (شراء أو إيجار، والمنطقة، والميزانية، والرسالة).
- تغيّر لوحة التفاصيل الحالة وتحفظ ملاحظة داخلية، حتى 2000 حرف، لا يراها الزائر أبدًا.
- لا يمكن حذف الاستفسارات: أغلق ما انتهيت منه.
المعاينات
| الحالة | المعنى | الخطوات التالية |
|---|---|---|
| مطلوبة | أُرسلت من الموقع، في الوقت الذي فضّله الزائر | أكّد، أو ألغِ |
| مؤكد | اتفقت الوكالة على موعد | أكّد مرة أخرى في وقت آخر، أو أكمل، أو ألغِ |
| مكتملة | تمت الزيارة | لا شيء |
| ملغاة | لن تتم | لا شيء |
- لصفحة المعاينات تبويب لكل حالة مع أعدادها. تسرد المعاينات المطلوبة الأقرب أولًا، والمؤكدة الموعد التالي أولًا.
- يُبقي التأكيد الوقت الذي فضّله الزائر، أو يضبط تاريخًا ووقتًا آخرين بالمنطقة الزمنية للوكالة، كل نصف ساعة من 08:00 إلى 20:00.
- تحتفظ كل معاينة بملاحظة داخلية حتى 500 حرف. لا يمكن حذف المعاينات: ألغِ التي لن تتم.
- يُعرض كل وقت ويُدخَل بتوقيت الوكالة،
Asia/Dubai، مهما كانت ساعة الحاسوب نفسها. يعرض الموقع من 09:00 إلى 18:00 ويرفض وقتًا أقل من ساعة قادمة.
إبقاء النماذج نظيفة
- يمكن لكل عنوان إرسال خمسة نماذج تواصل وخمسة طلبات معاينة في عشر دقائق؛ ويُرفض التالي برسالة تطلب الانتظار. العدّادات محفوظة في ذاكرة واجهة API.
- حقل مخفي يصطاد الروبوتات: يُجاب الإرسال الذي يملؤه كالمعتاد ولا يُخزَّن في أي مكان.
- يحمل كل إرسال رمزًا لمرة واحدة، فالنقر المزدوج أو إعادة الإرسال يخزّن استفسارًا واحدًا لا اثنين.
- خلف وكيل عكسي، اضبط
TRUST_PROXY=1في.envالخاص بواجهة API، وإلا شارك كل زائر حدّ الوكيل.
من يستطيع فعل ماذا
| الصلاحية | يتيح |
|---|---|
leads.view | قراءة الاستفسارات، وتلقي إشعار بالجديد منها |
leads.edit | تغيير حالة الاستفسار وملاحظته |
viewings.view | قراءة طلبات المعاينة، وتلقي إشعار بالجديد منها |
viewings.edit | تأكيد المعاينات وإكمالها وإلغاؤها، وملاحظتها |
الدوران الأوليان، المدير العام والوكيل، يملكان الأربع كلها.
المسارات خلفها
POST /api/leads وPOST /api/viewings عامان، ويردّان 201 مع إيصال: معرّف الاستفسار ووقته، أو مرجع المعاينة وحالتها ووقتها المفضل مع منطقته الزمنية. وتقرأهما لوحة التحكم وتحدّثهما بـ GET وPATCH /api/leads/:id و/api/viewings/:id؛ وتتحرك المعاينة بـ { "action": "confirm" } أو complete أو cancel، ويُرفض أي إجراء من حالة غير مناسبة.