الاستفسارات والتقييمات
كيف يصل سؤال الضيف وتقييمه إلى الفريق المضيف، وكيف يعالجها الفريق في لوحة التحكم، والحدود التي تُبقي النماذج نظيفة.
لحزمة الحزمة الكاملة
كيف تصل إلى المضيف
| في الموقع | في لوحة التحكم |
|---|---|
| نموذج التواصل | استفسار، باسم الضيف وبريده وهاتفه الاختياري ورسالته |
| نافذة السؤال في صفحة الإقامة | استفسار عن تلك الإقامة، مع التواريخ وعدد الضيوف المسؤول عنهما |
| تقييم من حجز مكتمل | تقييم، يُنشر في صفحة الإقامة فورًا |
- يُخطِر كل واحد منها، مباشرة، كل مسؤول يستطيع عرض الاستفسارات أو التقييمات، ويصل إلى صفحة الاستفسارات أو التقييمات في لوحة التحكم.
- يرى الضيف تأكيدًا في الصفحة التي هو فيها. رسالة السؤال من 10 إلى 4000 حرف وتعليق التقييم من 10 إلى 2000، ويتحقق الموقع من الاثنين قبل الإرسال، بالحدود نفسها التي تطبقها واجهة API.
- لا يُرسل شيء بالبريد الإلكتروني، لا إلى الضيف ولا إلى المضيف: ليس في القالب خدمة بريد. يرد الفريق من بريده الخاص، ويمكن للمطور إضافة مرسل بجانب الإشعار.
الاستفسارات
| الحالة | المعنى |
|---|---|
| جديد | وصل للتو. يبدأ كل استفسار هنا. |
| تم الرد | أجاب الفريق. |
| مغلق | منتهٍ، أيًّا كانت النتيجة. |
- تصفّي صفحة الاستفسارات بالحالة مع الأعداد، وتبحث بالمرجع (
I001وهكذا) أو الاسم أو البريد أو الإقامة، بعشرين في الصفحة، بجانب الاستفسار المحدد: إقامته، والتواريخ والضيوف المسؤول عنهم، وبيانات الضيف وما كتبه. - تغيّر لوحة التفاصيل الحالة وتحتفظ بملاحظة داخلية لا يراها الضيف.
- لا يمكن حذف الاستفسارات: أغلق ما انتهيت منه.
التقييمات
- يقيّم الضيف إقامة من صفحة حجزه بعد اكتمال الحجز، مرة لكل حجز، بتقدير من 1 إلى 5 بنصف نجمة وتعليق من 10 إلى 2000 حرف.
- يُنشر التقييم في صفحة الإقامة بمجرد كتابته، ويتبعه متوسط الإقامة.
- تسرد صفحة التقييمات ثمانية في الصفحة، مع أعداد المنشورة والمخفية، وبحثًا بالضيف أو التعليق، ومرشحات للحالة والإقامة وأدنى تقدير ومدى حداثتها (7 أو 30 أو 90 أو 365 يومًا). وتغيّر «انشر» و«أخفِ» المتوسط العام للإقامة فورًا.
- لا يمكن حذف التقييمات: أخفِ ما لا يجب عرضه.
إبقاء النماذج نظيفة
- يمكن لكل عنوان إرسال خمسة أسئلة وخمسة تقييمات في عشر دقائق؛ والتالي يُرفض برسالة تطلب الانتظار. والعدّادات محفوظة في ذاكرة واجهة API.
- حقل مخفي يصطاد الروبوتات: السؤال الذي يملؤه يُجاب كالمعتاد ولا يُخزَّن في أي مكان.
- يحمل كل سؤال رمزًا لمرة واحدة، فتخزّن النقرة المزدوجة أو إعادة الإرسال استفسارًا واحدًا لا اثنين.
- خلف وكيل عكسي، اضبط
TRUST_PROXY=1في.envالخاص بواجهة API، وإلا شارك كل زائر حدّ الوكيل.
من يستطيع فعل ماذا
| الصلاحية | يتيح |
|---|---|
inquiries.view | قراءة الاستفسارات، وتلقي إشعار بالجديد منها |
inquiries.edit | تغيير حالة الاستفسار وملاحظته |
reviews.view | قراءة التقييمات، وتلقي إشعارات الجديدة منها |
reviews.moderate | نشر التقييمات وإخفاؤها |
الدوران المضافان، Super Admin وManager، يملكان الأربع كلها.
المسارات خلفها
POST /api/inquiries عام: name وemail وmessage (10 إلى 4000 حرف) وclient_token، واختياريًا phone وstay_slug وcheck_in وcheck_out وguests. والتقييم هو POST /api/bookings/:reference/review مع رمز الحجز أو بريده، وrating وcomment، وتقييمات الإقامة المنشورة هي GET /api/stays/:slug/reviews. وتقرأ لوحة التحكم الاستفسارات وتحدّثها بـ GET وPATCH /api/inquiries/:id (status وadmin_notes)، والتقييمات بـ GET /api/reviews/manage وPATCH /api/reviews/manage/:id (status: published أو hidden).