متغيرات البيئة

كل إعداد في ملف .env، ووظيفته، وقيمته الافتراضية.

انسخ .env.example إلى .env وعدّله، وأعد تشغيل الخادم بعد كل تغيير. أما الإعدادات التي تغيّرها الوكالة في عملها اليومي (الاسم والهاتف والعنوان وساعات العمل والعملة) فمكانها قاعدة البيانات، في اللوحة ‹ الإعدادات.

الأساسيات

المتغير الافتراضي وظيفته
DATABASE_URL file:./dar.db الاتصال بقاعدة البيانات: ملف SQLite بجانب المخطط، أو رابط PostgreSQL (انظر الإعداد اليدوي).
SITE_URL http://localhost:3303 العنوان العام دون شرطة مائلة في آخره، ويُستخدم في الروابط الأساسية وsitemap.xml وJSON-LD وروابط المشاركة.
AUTH_SECRET لا يوجد (إلزامي) يوقّع ملف جلسة الموظفين. 16 حرفاً على الأقل، ويُفضّل 64 حرفاً عشوائياً. تغييره يُخرج الجميع من اللوحة.
AGENCY_TIMEZONE Asia/Muscat المنطقة الزمنية لمعنى «اليوم» ولتواريخ المعاينات وأسبوع اللوحة.

الحسابات الأولى (عند التعبئة فقط)

المتغير الافتراضي وظيفته
OWNER_EMAIL owner@dar.test حساب المالك الذي يُنشأ حين لا يوجد أي حساب موظف.
OWNER_PASSWORD dar-demo-2026 كلمة مروره. غيّرها قبل أول تعبئة، أو لاحقاً من اللوحة ‹ حسابي.
SEED_STAFF_PASSWORD dar-demo-2026 كلمة مرور الحسابات التجريبية الأربعة.

العرض التجريبي

المتغير الافتراضي وظيفته
DEMO_MODE false القيمة true تجعل كل تعديل في اللوحة يرد بـ 403 demo_mode وتُظهر شريط تنبيه. انظر وضع العرض التجريبي.
DEMO_HINT 0 القيمة 1 تعرض بريد المالك وكلمة مروره في صفحة الدخول، للعروض العامة فقط.

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

المتغير الافتراضي وظيفته
UPLOAD_DIR storage/uploads مكان حفظ الصور المرفوعة من اللوحة، والمسار النسبي يبدأ من مجلد المشروع.
UPLOAD_MAX_MB 8 أكبر حجم مقبول للصورة بالميغابايت.

المساعد الذكي (اختياري)

المتغير الافتراضي وظيفته
AI_BASE_URL فارغ (معطّل) رابط أساسي متوافق مع OpenAI، مثل https://api.openai.com/v1 أو http://localhost:11434/v1 لـ Ollama.
AI_API_KEY فارغ يُرسل في ترويسة Authorization: Bearer ...، ويُترك فارغاً لخادم محلي دون مفاتيح.
AI_MODEL gpt-4o-mini اسم النموذج لكتابة الإعلانات وللأسئلة عن العقارات.

استوديو التأثيث (اختياري)

المتغير الافتراضي وظيفته
AI_IMAGE_URL فارغ (معطّل) الرابط الكامل لواجهة صور متوافقة مع OpenAI، ويُفضّل .../images/edits لتبقى الغرفة الحقيقية كما هي.
AI_IMAGE_KEY فارغ مفتاح تلك الواجهة، وإن تُرك فارغاً يُستخدم AI_API_KEY.
AI_IMAGE_MODEL gpt-image-1 اسم النموذج المرسل مع الطلب.
AI_IMAGE_SIZE 1536x1024 مقاس الصورة الناتجة.

العملة

العملة ليست متغير بيئة، بل إعداد في اللوحة ‹ الإعدادات (للمالك فقط). تُحفظ الأسعار أعداداً صحيحة بأصغر وحدة، أي البيسة للريال العُماني، فسعر 285000 ريال يُحفظ 285000000. اضبط عدد الخانات العشرية قبل إضافة العقارات، لأن تغييره لاحقاً لا يحوّل الأسعار المحفوظة.

خطوات الميزانية في البحث

خطوات الأسعار في نماذج البحث موجودة في src/lib/price-steps.ts (أسعار البيع والإيجار الشهري بالريال)، فعدّلها لتناسب سوقك.