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

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

الإعدادات الخاصة بالخادم (الأسرار والمفاتيح والعناوين) مكانها ملف .env. أما ما يغيّره صاحب المتجر في عمله اليومي (اسم المتجر، والتوصيل، والضريبة، وطرق الدفع، والهدف الشهري) فمكانه اللوحة > الإعدادات ويُحفظ في قاعدة البيانات. أعد تشغيل الخادم بعد أي تعديل على .env.

إعدادات لا بد منها

المتغير مثال وظيفته
DATABASE_URL file:./souq.db الاتصال بقاعدة البيانات. ملف SQLite بجانب prisma/schema.prisma افتراضيًا، أو رابط postgresql:// لـPostgreSQL (المتطلبات).
SITE_URL https://shop.example.om العنوان العام دون شرطة مائلة في آخره. تعتمد عليه روابط العودة من «ثواني» وخريطة الموقع والروابط الأساسية وبيانات المنتجات المنظمة.
AUTH_SECRET 64 حرفًا عشوائيًا يوقّع ملفات جلسات اللوحة والعملاء. 16 حرفًا على الأقل، و32 فأكثر في الإنتاج. تغييره يُخرج الجميع من حساباتهم.

المالك الأول

المتغير الافتراضي وظيفته
OWNER_EMAIL owner@souq.test بريد حساب المالك الذي ينشئه npm run db:seed إن لم يوجد أي حساب في اللوحة.
OWNER_PASSWORD souq-demo-2026 كلمة مروره. تُقرأ في تلك اللحظة فقط، وتغييرها لاحقًا لا أثر له.

مساعدات العرض التجريبي (لا تُستخدم في متجر حقيقي)

المتغير الافتراضي وظيفته
DEMO_HINT 0 القيمة 1 تُظهر بريد المالك وكلمة مروره في صفحة دخول اللوحة.
SEED_DEMO_SHOPPER 0 القيمة 1 تجعل التعبئة تنشئ حساب عميل بطلبين وقائمة مفضلة.
DEMO_SHOPPER_EMAIL shopper@souq.test بريد هذا العميل.
DEMO_SHOPPER_PASSWORD souq-shopper-2026 كلمة مروره.

الوقت

المتغير الافتراضي وظيفته
STORE_TIMEZONE Asia/Muscat المنطقة الزمنية لـ«اليوم» وأشهر النظرة العامة ونهاية صلاحية الكوبونات والتواريخ المعروضة.

الدفع بالبطاقة (ثواني)

المتغير الافتراضي وظيفته
THAWANI_MODE uat uat بيئة الاختبار لدى «ثواني»، وlive للمدفوعات الحقيقية.
THAWANI_SECRET_KEY فارغ المفتاح السري من بوابة التاجر. يبقى على الخادم فقط.
THAWANI_PUBLISHABLE_KEY فارغ المفتاح العام، يُستخدم في رابط صفحة الدفع.

لا يظهر الدفع بالبطاقة إلا إذا وُجد المفتاحان، وفُعّل الخيار في الإعدادات، وكانت العملة الريال العماني. التفاصيل في الدفع.

الذكاء الاصطناعي (اختياري)

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

راجع الذكاء الاصطناعي.

إعدادات مكانها اللوحة لا ملف ‎.env

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