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