الأمر 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 إن شغّلت أكثر من نسخة من الخادم أو أردت قاعدة بيانات مُدارة:
- في
prisma/schema.prismaغيّرprovider = "sqlite"إلىprovider = "postgresql". - اضبط
DATABASE_URL="postgresql://user:password@host:5432/dar". - أعد الخطوات من ١ إلى ٣.
لا يتغير شيء آخر، فالأسعار أعداد صحيحة والبحث النصي يستخدم contains الذي تدعمه القاعدتان.
الصور المرفوعة
تُحفظ الصور المرفوعة من اللوحة في UPLOAD_DIR (افتراضياً storage/uploads) ويقدّمها التطبيق على /uploads/<file>. وضعناها خارج public/ عمداً، لأن Next.js لا يقدّم إلا الملفات التي كانت في public/ وقت البناء. انسخ هذا المجلد احتياطياً مع قاعدة البيانات. الخطوة التالية: النشر على خادم.