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

نموذج البيانات

الجداول في prisma/schema.prisma والعلاقات بينها.

Setting (صف واحد)

Area 1───* Property *───1 StaffUser (الوسيط)
              │  1
              ├──* PropertyImage
              ├──* Lead *───1 StaffUser (الوسيط)
              │      ├──* LeadNote
              │      └──* Viewing
              └──* Viewing *───1 StaffUser (الوسيط)

Setting (الإعدادات)

صف واحد (id = 1) يُحرَّر من اللوحة ‹ الإعدادات: الاسم والشعار النصي باللغتين، والهاتف، وواتساب، والبريد، والعنوان، وساعات العمل، ورقم الترخيص، وcurrency (رمز ISO) وcurrencyDecimals.

Area (المنطقة)

slug وnameAr وnameEn وgovernorate (إحدى المحافظات الإحدى عشرة في src/lib/oman.ts) وdescAr/descEn وlifeAr/lifeEn («تخيّل حياتك هنا») وplaces (مصفوفة JSON من {kind, nameAr, nameEn, minutes}، وأنواعها في PLACE_KINDS) وimage وsort وactive. المنطقة غير الظاهرة تخفي عقاراتها عن الموقع.

StaffUser (الموظف)

slug وname وnameAr وemail (فريد) وpasswordHash (scrypt) وrole (OWNER أو ADMIN أو AGENT) وactive وshowOnSite، والمسمى الوظيفي والنبذة باللغتين، وphone وwhatsapp وphoto وlanguages (رموز تفصلها فواصل).

Property (العقار)

العمود النوع ملاحظات
slug وref نص فريد ref مثل DAR-1025
titleAr/En وdescAr/En نص
purpose SALE / RENT
type VILLA / APARTMENT / TOWNHOUSE / LAND / OFFICE
status DRAFT / PUBLISHED / UNDER_OFFER / SOLD / RENTED
price عدد صحيح بأصغر وحدة، والإيجار شهري
bedrooms وbathrooms وareaM2 وplotM2 وyearBuilt عدد صحيح
furnished UNFURNISHED / SEMI / FURNISHED
amenities نص JSON مصفوفة مفاتيح من AMENITIES
addressAr/En وareaId وagentId الوسيط قد يكون فارغاً
featured وpublishedAt وcreatedAt وupdatedAt

فهارس على (status, purpose, type) وareaId وagentId.

PropertyImage (صورة العقار)

propertyId وurl (/images/... أو /uploads/... أو https://...) وvirtual (صُنعت في استوديو التأثيث) وsort (الصفر هو الغلاف). تُحذف مع العقار.

Lead (الاستفسار)

code (فريد، يبدأ بـ IQ- أو VW-) وkind (INQUIRY / VIEWING) وpropertyId? وagentId? وname وphone وemail وmessage وstatus (NEW / CONTACTED / QUALIFIED / WON / LOST) وlocale. يحتفظ بسجله إذا حُذف العقار.

LeadNote (ملاحظة الاستفسار)

leadId وauthor (اسم الموظف) وbody وcreatedAt. تُكتب فيها تغييرات الحالة والإسناد تلقائياً.

Viewing (المعاينة)

leadId? وpropertyId وagentId? وname وphone وdate (YYYY-MM-DD) وtime (HH:MM) بتوقيت الوكالة، وstatus (REQUESTED / CONFIRMED / DONE / NO_SHOW / CANCELLED) وnote.

لماذا النصوص بدلاً من التعدادات وJSON

لا يدعم Prisma مع SQLite أعمدة التعداد أو JSON. يتحقق zod من القيم المسموحة في src/lib/*، وهي مذكورة في src/lib/rules.ts، ومع PostgreSQL يمكنك تحويلها إلى تعدادات دون تغيير الواجهة البرمجية.