اللغات

كيف يعمل الموقع ولوحة التحكم بالإنجليزية والعربية، وكيف تغيّر أي نص، وما الذي تترجمه واجهة API، وما الذي تغيّره لإضافة لغة.

لحزمة الحزمة الكاملة

اللغات المتوفرة

الإنجليزية والعربية، في التطبيقات الثلاثة. تضع العربية الواجهة كلها من اليمين إلى اليسار، بخطوطها الخاصة، ويبقى اسم المنتج Northstack بالأحرف اللاتينية في اللغتين. تُكتب الأسعار في الموقع بالطريقة نفسها في اللغتين، وعلامة الدولار أولًا بالأرقام اللاتينية.

التطبيق	الإنجليزية	العربية
الموقع	`/en/…`	`/ar/…`
لوحة التحكم	`/en/…`	`/ar/…`
API	`Accept-Language: en`	`Accept-Language: ar`

الإنجليزية هي الافتراضية. الفرنسية والإسبانية ولغات أخرى غير مضمَّنة؛ وتوضح الأقسام أدناه ما تحتاجه إضافة لغة.

كيف تُختار اللغة

اللغة هي الجزء الأول من العنوان. تبدّلها قائمة اللغة وتُبقي الصفحة.
الموقع: المسار بلا لغة يرسله next-intl إلى اختيار الزائر السابق أو إلى لغة متصفحه إذا كانت الإنجليزية أو العربية، وإلى /en في غير ذلك. تسرد خريطة الموقع كل صفحة باللغتين، ولكل منها بديلها.
لوحة التحكم: المسار بلا لغة يُفتح باللغة التي قدّمت بها لوحة التحكم آخر مرة في ذلك المتصفح (كوكي NEXT_LOCALE)، وبالإنجليزية في غير ذلك، والعنوان المجرد يفتح /<language>/dashboard. يرسل كل طلب تقدّمه لغة الصفحة إلى واجهة API في Accept-Language.
يفتح رابط إعادة ضبط بيانات الدخول لوحة التحكم باللغة التي طُلبت بها إعادة الضبط، وتفتح صفحات العودة من الدفع بالترخيص باللغة التي دفع بها المشتري.

غيّر نصًا

كل كلمة ظاهرة موجودة في messages/<namespace>/en.json وar.json، في مجلد كل واجهة أمامية. غيّر القيمة، وأبقِ المفتاح، وغيّرها في الملفين.

التطبيق	مساحات الأسماء
الموقع	`layout` و`home` و`pricing` و`checkout` و`docs` و`blog` و`changelog` و`contact` و`legal` و`sampleData`. نصوص التوثيق والمدونة وسجل التغييرات في `src/content/docs/` و`src/content/journal/` و`src/content/changelog/`، في كل منها ملف `en.json` وملف `ar.json`.
لوحة التحكم	`ai-assistant` و`auth` و`common` و`dashboard` (مع مجلد لكل منطقة: `activity` و`billing` و`overview` و`platform` و`projects` و`roles` و`settings` مع `adminmanagement` و`adminroles` و`appsettings` و`profile` و`security`، و`team` و`ui-component` و`users`) و`invitation` و`layouts` و`metadata` (عناوين التبويبات) و`onboarding`

المفتاح الناقص في ar.json يظهر كرسالة ناقصة في الجهة العربية، لذلك أبقِ الملفين متطابقين.
النص داخل الأقواس {curly} يملؤه التطبيق، مثل {count} أو {license}. أبقِ هذه الكلمات كما هي في اللغتين، وأبقِ الوسوم داخل الرسالة، مثل <code> أو <card>، حول نصها.

النص الذي تخزّنه مساحة العمل باللغتين

يُحفظ اسم المشروع ووصفه، وعنوان المهمة ووصفها، لكل لغة، بصيغة translations: { en, ar }. الاسم أو العنوان الإنجليزي مطلوب؛ والعربي اختياري، وتعرض لوحة التحكم العربية النص الإنجليزي أينما كان العربي فارغًا. تملأ عملية الملء الأولى اللغتين لكل مشروع ومهمة تجريبيين.
تحمل صلاحيات المنصة وإعداداتها تسمياتها وأوصافها باللغتين أيضًا.
لغة مساحة العمل في الإعدادات هي لغة رسائلها البريدية لكل من لم يختر لغة خاصة به. أما لغة الشاشات فهي دائمًا اللغة الموجودة في العنوان.
يجيب المساعد الذكي بلغة الصفحة التي سُئل منها، ما لم يكتب الشخص بلغة أخرى.

ما تترجمه واجهة API

تأتي رسائل الخطأ بلغة الترويسة Accept-Language، وكذلك message عند نجاح تسجيل الدخول أو تغيير الملف الشخصي أو الموظفين أو الأدوار أو الإعدادات. أما الردود الأخرى فتحمل رمزًا ثابتًا (مثل checkout_started) تصيغه الواجهة الأمامية بكلماتها. تُعدّ ar-SA عربية، وأي لغة لا تعرفها واجهة API تعود إلى الإنجليزية.
نصوصها الخاصة ملفات JSON في back-end/src/i18n/translations/en/ وar/، ملف لكل مجال: admin وauth وcommon وmail وproject وroles وsettings وtasks وusers.
تعود المشاريع والمهام باللغتين معًا، بصيغة { "en": {…}, "ar": {…} }، وتختار لوحة التحكم إحداهما.
تُكتب رسائل البريد الخاصة بمساحة العمل (الدعوات والملخص الأسبوعي ورسائل الفوترة) من mail.json بلغة المستلم: لغته التي اختارها، وإلا لغة مساحة العمل، وإلا الإنجليزية (back-end/src/modules/mail/recipient-locale.ts). أما رسالة إعادة تعيين كلمة المرور (back-end/src/modules/auth/account.service.ts) وإيصال الترخيص (back-end/src/modules/licenses/services/license-checkout.service.ts) فتُكتبان بالإنجليزية، وروابطهما بلغة القارئ. ترجمهما هناك إذا كان عملاؤك يحتاجون إلى نسخ عربية.

أضف لغة إلى الموقع

اللغتان مكتوبتان في عدة ملفات، لذلك تمسّ إضافة لغة ثالثة كل واحد منها. المسارات داخل website/.

أضف الرمز إلى locales في src/i18n/routing.ts. تحدد هذه القائمة العناوين الموجودة، وما تدرجه خريطة الموقع، واللغة التي يذهب إليها مسار بلا لغة.
انسخ كل ملف messages/<namespace>/en.json إلى ملف باسم الرمز الجديد، وترجم القيم. يحمّل src/i18n/request.ts ملفًا واحدًا لكل مساحة أسماء ولكل لغة، فلا يجوز أن ينقص أي ملف.
افعل الشيء نفسه مع src/content/docs/ وsrc/content/journal/ وsrc/content/changelog/، وأضف الملف الجديد إلى جدول byLocale في ملف index.ts بكل مجلد.
إذا كانت اللغة تُكتب من اليمين إلى اليسار، فوسّع سطر dir في src/app/[locale]/layout.tsx الذي لا يعرف إلا ar، وأعطها خطًا في src/styles/fonts.css.
يرسل الدفع en أو ar إلى واجهة API (src/features/checkout/hooks/useCheckoutForm.ts)، ولا تقبل واجهة API غيرهما. ابحث في src/ عن "ar" وعالج الرمز الجديد هناك أيضًا.

أضف لغة إلى لوحة التحكم

أضف الرمز إلى locales في src/config/i18n.ts وفي src/proxy.ts، وإذا كانت اللغة تُكتب من اليمين إلى اليسار فأضفه إلى RTL_LOCALES في src/app/layout.tsx وإلى الفحص في src/hooks/locale/useDirection.ts.
انسخ كل ملف messages/**/en.json إلى ملف باسم الرمز الجديد، وترجم القيم.
ابحث في src/ عن "ar": التواريخ والمخططات وأدوات المساعد وبعض الإعدادات تختار بين اللغتين مباشرة، وتختار pickLocale في src/lib/api/shared.ts نصًا مخزنًا بالإنجليزية أو بالعربية.
يطلب نموذجا المشروع والمهمة النصين الإنجليزي والعربي. وإضافة لغة ثالثة إلى النصوص المخزنة تتطلب أيضًا أن تقبلها واجهة API.

أضف لغة إلى واجهة API

تعرف واجهة API القيمتين en وar في supportedLocales داخل back-end/src/i18n/i18n.service.ts. أضف الرمز الجديد هناك، وانسخ src/i18n/translations/en/ إلى مجلد باسمه، وترجم الملفات. النصوص المخزنة زوج { en, ar } تتحقق منه فئات الترجمات في src/modules/projects/dto/project.dto.ts وsrc/modules/tasks/dto/task.dto.ts، لذلك فإن إضافة لغة ثالثة في البيانات تغيّر تلك الفئات والكيانات وأدوات المساعد الذكي والبيانات الأولية. ويقبل دفع الترخيص en أو ar في src/modules/licenses/dto/start-license-checkout.dto.ts.