كل الإعدادات في مكان واحد.

الواجهة البرمجية

تقرأ الواجهة البرمجية الملف back-end/.env.

• PORT: منفذ الواجهة البرمجية، وقيمته الافتراضية 8000.
• DB_TYPE: إما sqlite (الافتراضي، والملف في SQLITE_DATABASE) أو mysql مع DB_HOST وDB_PORT وDB_USERNAME وDB_PASSWORD وDB_DATABASE.
• JWT_SECRET وJWT_EXPIRATION: مفتاح توقيع الجلسات ومدة بقاء الجلسة.
• CORS_ORIGIN: النطاقات المسموح لها بالاتصال بالواجهة البرمجية من المتصفح: الموقع ولوحة التحكم.
• DASHBOARD_URL وPUBLIC_API_URL: العنوانان اللذان يصل منهما الناس إلى لوحة التحكم والواجهة البرمجية، ويُستخدمان في الرسائل والروابط.
• SMTP_HOST وSMTP_PORT وSMTP_SECURE وSMTP_USER وSMTP_PASSWORD وSMTP_FROM: خادم البريد للدعوات واستعادة كلمات المرور. ومن دونها تُكتب كل رسالة في سجل الواجهة البرمجية بدلًا من إرسالها.
• CONTACT_INBOX: العنوان الذي تُحوَّل إليه رسائل نموذج التواصل، وتُحفظ الرسائل في الحالتين.
• BILLING_PROVIDER وSTRIPE_SECRET_KEY وSTRIPE_WEBHOOK_SECRET وBILLING_GRACE_DAYS: راجع الفوترة.
• PAYPAL_CLIENT_ID وPAYPAL_CLIENT_SECRET وPAYPAL_ENV: PayPal لصفحة شراء التراخيص؛ راجع شراء التراخيص.
• R2_ACCESS_KEY_ID وR2_SECRET_ACCESS_KEY وR2_ENDPOINT وR2_BUCKET_NAME وR2_PUBLIC_URL: لتخزين الملفات المرفوعة في Cloudflare R2. وإن لم تُضبط الخمسة كلها، تُحفظ الملفات في MEDIA_UPLOAD_DIR على الخادم.
• GOOGLE_API_KEY وOPENAI_API_KEY وDEEPSEEK_API_KEY: مزوّدو النماذج للمساعد. اتركها فارغة، ويستطيع كل شخص إضافة مفتاحه الخاص.
• DEMO_MODE: راجع وضع العرض.

لوحة التحكم

تقرأ لوحة التحكم الملف dashboard/.env.

• PORT: وقيمته الافتراضية 3031.
• NEXT_PUBLIC_API_BASE_URL: عنوان الواجهة البرمجية، وينتهي بـ /api. اتركه فارغًا لتعمل لوحة التحكم على بياناتها التجريبية المدمجة دون واجهة برمجية: أي كلمة مرور تُدخلك، وكل بريد من البيانات التجريبية يفتح دوره، وتبقى التغييرات في ذلك المتصفح. ويظهر إشعار بيانات تجريبية في كل صفحة، ويحذف yarn remove:mock هذه البيانات.
• NEXT_PUBLIC_WEBSOCKET_BASE_URL: عنوان الواجهة البرمجية دون /api، لتحديثات الصلاحيات الفورية.
• NEXT_PUBLIC_BASE_URL وNEXT_PUBLIC_WEBSITE_URL: عنوان لوحة التحكم نفسها وعنوان هذا الموقع.
• NEXT_PUBLIC_DEMO_MODE: اجعله مساويًا لقيمة DEMO_MODE في الواجهة البرمجية.

الموقع

يقرأ هذا الموقع الملف website/.env.

• NEXT_PUBLIC_SITE_URL: العنوان العام للموقع، ويُستخدم في الروابط الأساسية وخريطة الموقع وبطاقات المشاركة.
• NEXT_PUBLIC_API_BASE_URL: عنوان الواجهة البرمجية، لنموذج التواصل وصفحة شراء التراخيص.
• اترك NEXT_PUBLIC_API_BASE_URL فارغًا ليعمل الموقع على بياناته التجريبية المدمجة دون واجهة برمجية: يُجيب نموذج التواصل وصفحة شراء التراخيص داخل المتصفح، وتفتح صفحة الشراء صفحة الدفع التجريبية الخاصة بالموقع، ولا يُرسل أي شيء. ويذكر ذلك تنبيه «بيانات تجريبية» في كل صفحة.
• NEXT_PUBLIC_DASHBOARD_URL: عنوان لوحة التحكم، لتسجيل الدخول والعرض الحي.
• NEXT_PUBLIC_PURCHASE_URL_SINGLE وNEXT_PUBLIC_PURCHASE_URL_STUDIO: صفحة الدفع في متجر خارجي لكل ترخيص، إن كنت تبيع عبره. وإن تُركا فارغين، يفتح زر المتابعة صفحة الدفع في هذا الموقع.
• NEXT_PUBLIC_DEMO_MODE: يُظهر سطر العرض التجريبي في التذييل.

تُقرأ قيم NEXT_PUBLIC_ عند بناء التطبيق، فإذا غيّرت إحداها فأعد البناء.