الإعداد اليدوي والنشر

كل خطوة من خطوات الإعداد على حدة، والبدء دون بيانات تجريبية، واختيار قاعدة البيانات.

الأمر npm run setup اختصار. في هذه الصفحة الخطوات نفسها يدوياً، لتغيّر منها ما تشاء.

١. عميل قاعدة البيانات

npx prisma generate

يقرأ prisma/schema.prisma ويكتب عميلاً بأنواع TypeScript في node_modules/@prisma/client. أعد تشغيله بعد كل تعديل على المخطط.

٢. الجداول

npx prisma db push

ينشئ الجداول أو يحدّثها في قاعدة البيانات المحددة في DATABASE_URL، وهي مع الإعداد الافتراضي الملف prisma/dar.db. تبقى البيانات الموجودة كما هي، ويتوقف Prisma ويسألك قبل أي تغيير قد يضيّع بيانات.

٣. البيانات الأولى

node prisma/seed.mjs

لا يملأ هذا الأمر إلا الجداول الفارغة:

الجدول فارغ؟ ما يضيفه
Setting اسم الوكالة وبيانات التواصل والعملة (الريال العُماني بثلاث خانات عشرية)
Area المناطق الثماني مع نص «تخيّل حياتك هنا» والأماكن القريبة
StaffUser المالك من OWNER_EMAIL وOWNER_PASSWORD، ثم أربعة موظفين تجريبيين
Property ٢٤ عقاراً تجريبياً مع صورها
Lead ١٥ استفساراً و٩ معاينات

البدء دون العقارات التجريبية

تحتاج الوكالة الحقيقية غالباً إلى الإعدادات والمناطق وحساب المالك فقط. قبل أول تشغيل للأمر افتح prisma/sample-data.mjs، وأفرغ المصفوفات agents وproperties وleads، وغيّر agency وareas إلى بياناتك، ثم شغّله. ويمكنك حذف الصور التجريبية من public/images.

٤. البناء والتشغيل

npm run build
npm start          # يعمل على المنفذ 3303

يشغّل npm start الأمر next start -p 3303، ويمكنك تغيير المنفذ في package.json.

اختيار قاعدة البيانات

تكفي SQLite لوكالة واحدة بعدد قليل من الموظفين، والوكالة كلها ملف واحد تنسخه متى شئت. استخدم PostgreSQL إن شغّلت أكثر من نسخة من الخادم أو أردت قاعدة بيانات مُدارة:

  1. في prisma/schema.prisma غيّر provider = "sqlite" إلى provider = "postgresql".
  2. اضبط DATABASE_URL="postgresql://user:password@host:5432/dar".
  3. أعد الخطوات من ١ إلى ٣.

لا يتغير شيء آخر، فالأسعار أعداد صحيحة والبحث النصي يستخدم contains الذي تدعمه القاعدتان.

الصور المرفوعة

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