نظرة عامة

«دار» قالب لوكالات العقار: موقع عام بلغتين، ولوحة تحكم للوكالة، وواجهة برمجية، في مشروع Next.js واحد.

صُمّم «دار» لوكالة تبيع وتؤجّر الفلل والشقق والتاون هاوس والأراضي والمكاتب. تعمل الوكالة التجريبية في مسقط (القرم، الموج، مدينة السلطان قابوس، بوشر، السيب، مسقط هيلز) وفي صحار وصلالة، والأسعار بالريال العُماني والإيجار شهري. وكل ذلك قابل للتغيير.

ماذا يتضمن القالب

الجزء ما يقدّمه
الموقع العام بحث في البيع والإيجار، وصفحة لكل عقار فيها معرض صور وقسم «تخيّل حياتك هنا»، وطلب معاينة، واستفسار، وحفظ البيوت، ومقارنة حتى ثلاثة بيوت، وصفحتا الوكالة والتواصل. العربية لغة أساسية (من اليمين إلى اليسار) والإنجليزية.
لوحة الوكالة نظرة عامة، العقارات بصورها وحالاتها، مسار الاستفسارات، تقويم المعاينات، استوديو التأثيث، المساعد الذكي، المناطق، الفريق، الأدوار، الإعدادات. ثلاثة أدوار: المالك والمدير والوسيط.
الواجهة البرمجية اثنتان وأربعون نقطة JSON (في ٣١ مساراً) يستخدمها الموقع واللوحة، مع التحقق من الأدوار والمدخلات وحدود الطلبات، ويمكن أن يستخدمها تطبيق جوال.
البيانات التجريبية ٨ مناطق، و٢٤ عقاراً لكل منها من ٣ إلى ٤ صور، و٤ موظفين، و١٥ استفساراً، و٩ معاينات.

الحزم

يمكن تصفية قائمة التوثيق الجانبية حسب الحزمة:

  • الحزمة الكاملة: كل ما يلي.
  • الموقع العام: صفحات الزوار في src/app/[locale]/(site).
  • لوحة الوكالة: src/app/[locale]/dashboard وsrc/components/dash.
  • الواجهة البرمجية: src/app/api وsrc/lib.

التقنيات

Next.js 16 وReact 19 وTypeScript وTailwind CSS 4، ومكتبة next-intl للغتين، وPrisma 6 مع SQLite (أو PostgreSQL بتغيير سطر واحد)، وzod للتحقق من المدخلات، وjose لجلسة الموظفين. لا خرائط ولا أدوات تتبّع من أطراف خارجية.

خريطة المجلدات

docs/                 هذا التوثيق (ar + en)
messages/             نصوص الواجهة: ar.json وen.json
prisma/               schema.prisma وseed.mjs وsample-data.mjs
public/images/        الصور التجريبية المولّدة (عقارات، مساحات داخلية، مناطق)
scripts/              e2e_api.py (اختبار شامل للواجهة البرمجية) وgen_images.py
src/app/[locale]/     الصفحات: (site) الموقع العام، dashboard، docs
src/app/api/          الواجهة البرمجية
src/components/       مكوّنات site/ وdash/
src/lib/              قواعد العمل، الوصول إلى قاعدة البيانات، الذكاء الاصطناعي، تحسين الظهور
tests/                اختبارات الوحدات للقواعد (npm test)

من أين تبدأ

  1. التثبيت: تشغيل المشروع على جهازك في خمس دقائق.
  2. متغيرات البيئة: كل الإعدادات.
  3. الهوية والألوان: اسمك وألوانك وشعارك وصورك.
  4. النشر على خادم: خادمك الخاص مع HTTPS.