متغيرات البيئة
كل إعداد في ملف .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 (أسعار البيع والإيجار الشهري بالريال)، فعدّلها لتناسب سوقك.