الترجمة

تعمل الترجمة على طبقتين: ملفات JSON القاموس للواجهة الثابتة (تطابق ar/en يفرضه اختبار في CI) ومحرك localize() المُجمَّع لمحتوى قاعدة البيانات الديناميكي عبر مخبأ ثلاثي الطبقات (ذاكرة LRU ← جدول Translation ← Google Translate). لم يعد بإمكان الانحراف أن يصل للإنتاج: تطابق مفاتيح en/ar، والبقايا غير المترجمة، وعدّادات السلاسل المكتوبة يدويًا، وفئات RTL الفيزيائية كلها محروسة ضمن pnpm test وضمن CI. المتبقي هو مسح السلاسل اليدوية الذي تتعقبه أرقام الأساس — شغّل npx tsx scripts/i18n-hardcoded-ratchet.ts --by-dir للعدد الحيّ.

البنية المعمارية

ملفات البنية التحتية

فجوات التغطية

عناصر sidebar Cards وLab تفتقد أيضاً مفاتيح القاموس. شغّل /i18n-check للعدد الحالي لكل منطقة.

ترتيب الأولويات

1. نص الأزرار — المفاتيح موجودة بالفعل في dictionary.common.*.
2. تسميات مجموعات المعالج — رؤية عالية.
3. تسميات النماذج — أكبر أثر على UX.
4. خيارات select — يحتاج مصنع config.
5. التحقّق — يحتاج إعادة هيكلة بمصنع schema.
6. أخطاء server actions — يحتاج نمط رمز خطأ.
7. الحالات الفارغة.
8. رسائل Toast — يحتاج توصيل القاموس.
9. توسيع getText لبقية ملفات المحتوى.

نمط النموذج

مرّر شرائح القاموس إلى نماذج العميل.

Copy// content.tsx
const dictionary = await getDictionary(lang)
return <StudentForm dictionary={dictionary.school.students} />
 
// form.tsx
<FormLabel>{dictionary.form.name}</FormLabel>
<Input placeholder={dictionary.form.namePlaceholder} {...field} />

نمط Select

صدّر مصانع خيارات، لا مصفوفات ثابتة.

Copyexport const getGenderOptions = (d: Dictionary["school"]) => [
  { value: "male", label: d.students.gender.male },
  { value: "female", label: d.students.gender.female },
]

نمط التحقّق

تتحوّل schemas إلى مصانع تستقبل ValidationHelper. يعمل بالفعل في onboarding وauth.

Copyimport { getValidationMessages } from "@/components/internationalization/helpers"
 
export const createStudentSchema = (
  v: ReturnType<typeof getValidationMessages>
) =>
  z.object({
    name: z.string().min(1, v.required()),
    email: z.string().email(v.email()),
    phone: z.string().min(10, v.minLength(10)),
  })

العائق: ملفات التحقّق عبر اللوحة بحاجة للتحوّل من schemas على مستوى الوحدة إلى مصانع.

نمط Toast

Copyimport { getToastMessages } from "@/components/internationalization/helpers"
 
const t = useMemo(() => getToastMessages(dictionary), [dictionary])
 
if (result.success) toast.success(t.success.student.created())
else toast.error(t.error.student.createFailed())

العائق: toasts تعمل على العميل؛ ToastHelper يحتاج القاموس في نطاقه.

نمط أخطاء server action

أعِد رموز أخطاء؛ ترجِم على العميل.

Copy// actions.ts
if (!session?.user) return { success: false, errorCode: "NOT_AUTHENTICATED" }
if (!schoolId) return { success: false, errorCode: "MISSING_SCHOOL_CONTEXT" }
 
// form.tsx
const ERROR_MAP: Record<string, string> = {
  NOT_AUTHENTICATED: dictionary.messages.errors.auth.notAuthenticated,
  MISSING_SCHOOL_CONTEXT:
    dictionary.messages.errors.tenant.missingSchoolContext,
}
toast.error(
  ERROR_MAP[result.errorCode] ?? dictionary.messages.errors.server.internalError
)

الحالة لكل منطقة

كل المناطق الـ21 (Dashboard، Students، Teachers، Classes، Subjects، Announcements، Events، Assignments، Parents، Grades، Classrooms، Exams، Finance، Attendance، Timetable، Profile، Settings، Notifications، Admission، School Config، Reports) تستخدم القاموس لرؤوس الجداول وsidebar لكنها جزئية على getText، النماذج، الـselects، التحقّق، الـtoasts، والإجراءات. Students/Teachers/Classes/Subjects/Announcements/Parents/Classrooms/Exams/Attendance/Profile تستخدم getText لبعض الأسطح؛ الباقي بانتظار display-text.

مسارات المعالج (/students/add، /teachers/add، /exams/manage، /exams/qbank، /finance/invoice) فيها نماذج، selects، تحقّق، toasts، وأخطاء إجراءات مكتوبة يدوياً.

الحواجز الواقية

انظر أيضاً

• تعدد المستأجرين
• الأنماط
• التحقّق
• النماذج