​

إدارة الإعدادات

​

1. إعداد لوحة الإدارة (افتراضي)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # افتراضي

1. الوصول إلى نسخة Twenty الخاصة بك (عادة http://localhost:3000)
2. اذهب إلى الإعدادات / لوحة الإدارة / متغيرات التكوين
3. اضبط التكاملات، والبريد الإلكتروني، والتخزين، والمزيد
4. تسري التغييرات على الفور (خلال 15 ثانية لعمليات النشر متعددة الحاويات)

• المصادقة - Google/Microsoft OAuth، إعدادات كلمة المرور
• البريد الإلكتروني - إعدادات SMTP، القوالب، التحقق
• التخزين - تكوين S3، مسارات التخزين المحلية
• التكاملات - Gmail، تقويم Google، خدمات Microsoft
• حدود التشغيل ومعدل التكنولوجيا - حدود التنفيذ، API الحد من السرعة
• والمزيد من الأمور…

​

2. إعداد بيئي فقط

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

1. قم بتعيين IS_CONFIG_VARIABLES_IN_DB_ENABLED=false في ملف .env الخاص بك
2. أضف جميع متغيرات الإعداد إلى ملف .env الخاص بك
3. أعد تشغيل الحاويات لتصبح التغييرات نافذة
4. ستظهر لوحة الإدارة القيم الحالية لكنها لن تتمكن من تعديلها

​

وضع تعدد مساحات العمل

​

وضع مساحة العمل الواحدة (الافتراضي)

IS_MULTIWORKSPACE_ENABLED=false  # default

• مساحة عمل واحدة لكل مثيل من Twenty
• أول مستخدم يصبح تلقائيًا مشرفًا مع صلاحيات كاملة (canImpersonate وcanAccessFullAdminPanel)
• يتم تعطيل عمليات التسجيل الجديدة بعد إنشاء مساحة العمل الأولى
• بنية URL بسيطة: https://your-domain.com

​

تمكين وضع تعدد مساحات العمل

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

• يمكن إنشاء مساحات عمل متعددة على نفس المثيل
• تحصل كل مساحة عمل على نطاق فرعي خاص بها (مثل: sales.your-domain.com، marketing.your-domain.com)
• يسجل المستخدمون ويقومون بتسجيل الدخول عبر {DEFAULT_SUBDOMAIN}.your-domain.com (مثل: app.your-domain.com)
• لا توجد صلاحيات مشرف تلقائية — أول مستخدم في كل مساحة عمل يكون مستخدمًا عاديًا
• إعدادات خاصة بمساحة العمل مثل النطاق الفرعي والنطاق المخصص تصبح متاحة ضمن إعدادات مساحة العمل

​

تكوين DNS لوضع تعدد مساحات العمل

*.your-domain.com -> your-server-ip

​

تقييد إنشاء مساحات العمل

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

​

تكامل Gmail و Google Calendar

​

إنشاء مشروع Google Cloud

1. اذهب إلى وحدة تحكم السحابة من Google
2. أنشئ مشروعًا جديدًا أو اختر أحد المشاريع الموجودة
3. قم بتفعيل هذه الـ APIs:

• Gmail API
• Google Calendar API
• People API

​

تكوين OAuth

1. اذهب إلى بيانات اعتماد
2. قم بإنشاء معرف عميل OAuth 2.0
3. أضف هذه الـ URIs لإعادة التوجيه:
   • https://{your-domain}/auth/google/redirect (لتسجيل الدخول الفردي)
   • https://{your-domain}/auth/google-apis/get-access-token (للتكاملات)

​

الإعداد في Twenty

1. اذهب إلى الإعدادات → لوحة الإدارة → متغيرات التكوين
2. ابحث بسهولة عن قسم Google Auth
3. حدد هذه المتغيرات:
   • MESSAGING_PROVIDER_GMAIL_ENABLED=true
   • CALENDAR_PROVIDER_GOOGLE_ENABLED=true
   • AUTH_GOOGLE_CLIENT_ID={client-id}
   • AUTH_GOOGLE_CLIENT_SECRET={client-secret}
   • AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect
   • AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token

• https://www.googleapis.com/auth/calendar.events
• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/profile.emails.read

​

إذا كان تطبيقك في وضع الاختبار

​

تكامل Microsoft 365

​

إنشاء مشروع في Microsoft Azure

​

تمكين APIs

• Microsoft Graph: Mail.ReadWrite
• Microsoft Graph: Mail.Send
• Microsoft Graph: Calendars.Read
• Microsoft Graph: User.Read
• Microsoft Graph: openid
• Microsoft Graph: email
• Microsoft Graph: profile
• Microsoft Graph: offline_access

​

URIs لإعادة التوجيه المصرح بها

• https://{your-domain}/auth/microsoft/redirect إذا كنت تريد استخدام تسجيل الدخول الفردي في Microsoft
• https://{your-domain}/auth/microsoft-apis/get-access-token

​

الإعداد في Twenty

1. اذهب إلى الإعدادات → لوحة الإدارة → متغيرات التكوين
2. ابحث عن قسم Microsoft Auth
3. حدد هذه المتغيرات:
   • MESSAGING_PROVIDER_MICROSOFT_ENABLED=true
   • CALENDAR_PROVIDER_MICROSOFT_ENABLED=true
   • AUTH_MICROSOFT_ENABLED=true
   • AUTH_MICROSOFT_CLIENT_ID={client-id}
   • AUTH_MICROSOFT_CLIENT_SECRET={client-secret}
   • AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect
   • AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token

​

تكوين النطاقات

• ‘openid’
• ‘البريد الإلكتروني’
• ‘profile’
• ‘offline_access’
• ‘Mail.ReadWrite’
• ‘Mail.Send’
• ‘Calendars.Read’

​

إذا كان تطبيقك في وضع الاختبار

​

مهام الخلفية للتقويم والمراسلة

# from your worker container
yarn command:prod cron:messaging:messages-import
yarn command:prod cron:messaging:message-list-fetch
yarn command:prod cron:calendar:calendar-event-list-fetch
yarn command:prod cron:calendar:calendar-events-import
yarn command:prod cron:messaging:ongoing-stale
yarn command:prod cron:calendar:ongoing-stale
yarn command:prod cron:workflow:automated-cron-trigger

​

تكوين البريد الإلكتروني

1. اذهب إلى الإعدادات → لوحة الإدارة → متغيرات التكوين
2. ابحث عن قسم Email
3. قم بضبط إعدادات SMTP الخاصة بك:

​

الوظائف المنطقية

​

برامج التشغيل المتاحة

​

التكوين الموصى به

SERVERLESS_TYPE=LOCAL  # default

SERVERLESS_TYPE=LAMBDA
SERVERLESS_LAMBDA_REGION=us-east-1
SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key

SERVERLESS_TYPE=DISABLED