الحقول
| الحقل | ملاحظات |
|---|---|
| الغرض | 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>. إزالة صورة من عقار لا تحذف ملفها (فقد يكون مستخدماً في مكان آخر)، فنظّف المجلد بين حين وآخر إن كانت المساحة تهمك.