خاص بـ: الحزمة الكاملة · لوحة الوكالة · الواجهة البرمجية

العقارات

الحقول، والصور، والحالات، والتمييز، ومن يحق له تغيير ماذا.

الحقول

الحقل ملاحظات
الغرض SALE للبيع أو RENT للإيجار، والإيجار شهري.
النوع VILLA وAPARTMENT وTOWNHOUSE وLAND وOFFICE. لا غرف نوم للأراضي والمكاتب، ولا أثاث ولا سنة بناء للأراضي.
السعر يُكتب بالريال ويُحفظ بالبيسة (عدد صحيح).
غرف النوم ودورات المياه ومساحة البناء ومساحة الأرض والأثاث وسنة البناء المعلومات الأساسية في صفحة العقار.
المرافق ١٦ مرفقاً (إطلالة بحرية، مسبح خاص، مجلس، غرفة خادمة...)، وعليها يعتمد البحث وقسم «تخيّل حياتك هنا».
المنطقة والعنوان المنطقة تحدد قسم «حول المنطقة».
العنوان والوصف بالعربية والإنجليزية. زر «اكتب بالذكاء الاصطناعي» يكتب مسودة لهما من المعلومات (انظر المساعد الذكي). تُفصل الفقرات بسطر فارغ.
الصور عدة صور دفعة واحدة، بصيغة JPEG أو PNG أو WebP حتى UPLOAD_MAX_MB. الأولى هي الغلاف، ويُغيّر الترتيب بزرّي «اجعلها الغلاف» و«قدّمها».
الوسيط يختاره المدير، أما الوسيط فيملك دائماً ما ينشئه.
مميز للمديرين: يظهر أولاً في الصفحة الرئيسية وفي الترتيب الافتراضي.

يحصل كل عقار عند إنشائه على رقم مرجعي (DAR-1025) وعنوان (/properties/{العنوان-الإنجليزي}-{الرقم}).

مسار الحالات

DRAFT ──> PUBLISHED ──> UNDER_OFFER ──> SOLD    (بيع)
            ^   │            │      └──> RENTED  (إيجار)
            │   └────────────┴──> SOLD / RENTED
            └── عودة من UNDER_OFFER أو SOLD أو RENTED (تعثّرت الصفقة أو انتهى العقد)
  • يبدأ العقار الجديد «مسودة» أو «منشوراً».
  • «مباع» للعقارات المعروضة للبيع فقط، و«مؤجر» للمعروضة للإيجار فقط.
  • يظهر على الموقع ما كان «منشوراً» أو «عليه عرض»، وتردّ البقية بـ 404.
  • عند أول نشر للعقار يُسجَّل تاريخ عرضه.

المسار هو الدالة nextPropertyStatuses() في src/lib/rules.ts. لا يعرض المحرر إلا الخطوات المسموحة، وترفض الواجهة البرمجية ما عداها بالرمز 409 bad_transition.

من يحق له ماذا

الإجراء الوسيط المدير المالك
إنشاء عقار نعم (ويملكه) نعم نعم
التعديل عقاراته الكل الكل
اختيار الوسيط والتمييز لا نعم نعم
الحذف مسوداته أي عقار أي عقار

حذف العقار يحذف سجلات صوره ومعايناته، أما الاستفسارات عنه فتبقى في صندوق الوارد دون الرابط.

الصور على القرص

تُحفظ الصور المرفوعة في UPLOAD_DIR بأسماء عشوائية وتُعرض على /uploads/<file>. إزالة صورة من عقار لا تحذف ملفها (فقد يكون مستخدماً في مكان آخر)، فنظّف المجلد بين حين وآخر إن كانت المساحة تهمك.