اللغة والعملة
الهدف
ضبط كيفية تخزين وعرض الأموال واللغات والتقويمات وتنسيقات التاريخ/الأرقام — مقسّمة بشكل صحيح بين إعدادات المنشأة وإعداد التوطين.
لمن
مسؤولو المنشأة. العرض يحتاج tenant.view / localization.view؛ الحفظ يحتاج tenant.manage / localization.admin. المستخدمون يغيّرون فقط لغة الواجهة من مبدّل اللغة في الشريط العلوي (يجب أن تكون ضمن enabled_locales).
المتطلبات
- تعرف العملة الأساسية والمنطقة الزمنية واللغات التي يجب أن تدعمها المستندات وترجمات الحقول.
- التغييرات الحساسة (بما فيها العملة الأساسية وبداية السنة المالية) قد تتطلب حوار سبب مُدقَّق.
تقسيم المسؤولية (لا تخلط بينهما)
| الموضوع | الشاشة | المسار | الصلاحية |
|---|---|---|---|
| العملة الأساسية، العملات المفعّلة، المنطقة الزمنية | إعدادات المنشأة ← تبويب التوطين | /settings | tenant.view / tenant.manage |
| اللغات المفعّلة، اللغة الافتراضية، التقويمات وتنسيقات التاريخ/الأرقام | إعداد التوطين | /localization/setup | localization.view / localization.admin |
| لغة الواجهة الشخصية | مبدّل اللغة في الشريط العلوي | — | مصادق |
تظهر إعدادات المنشأة التلميح بأن اللغات والتنسيقات تُدار في إعداد التوطين. استخدم فتح إعداد التوطين عند الحاجة.
الخطوات — العملة والمنطقة الزمنية
- افتح إعدادات المنشأة (
/settings). - افتح تبويب التوطين.
- عيّن العملة الأساسية والعملات المفعّلة والمنطقة الزمنية.
- احفظ — تظهر تم حفظ الإعدادات. المبالغ المرحّلة تاريخياً تبقى بعملتها؛ المستندات الجديدة تستخدم العملة الأساسية.
الخطوات — اللغات والتنسيقات
- افتح إعداد التوطين (
/localization/setup). - في الخيارات عيّن اللغات المفعّلة واللغة الافتراضية (يجب أن تكون الافتراضية ضمن المفعّلة).
- اضبط التقويمات وتنسيقات العرض حسب الحاجة.
- احفظ — تظهر تم حفظ إعدادات التوطين.
الخطوات — لغة واجهتك
- استخدم مبدّل اللغة في الشريط العلوي.
- يستدعي العميل
PATCH /auth/locale. إذا لم تكن اللغة مفعّلة للمنشأة → خطأ تحقق.
النتيجة
- النماذج التي تستخدم
TranslatableInputتعرض شرائح لكل لغة مفعّلة. - القوائم والمستندات تنسّق التاريخ والأرقام والأموال حسب تفضيلات المنشأة.
- خرائط ترجمة الحقول تقبل فقط مفاتيح
enabled_locales.
توقفات صارمة
default_localeليست ضمنenabled_locales→default_not_enabled.- لغة المستخدم خارج المجموعة المفعّلة →
locale_not_enabled. - رموز عملة غير مدعومة → 422.
- تغيير العملة الأساسية / بداية السنة المالية قد يتطلب تأكيداً بسبب تدقيقي.