← المفاهيم

المفاتيح والبيئات

يُصدر مشروع Langsys نوعين من مفاتيح API. يعتمد اختيارك لأحدهما على ما إذا كنت تكتشف عبارات جديدة (التطوير) أو تعرض ترجمات جاهزة فقط (الإنتاج). يتم إنشاء كليهما في لوحة التحكم، ويشرح دليل البدء السريع الخطوات.

مفتاحان، ومهمتان

سير العمل المعتاد

1. طوّر باستخدام مفتاح الكتابة. أثناء بناء الواجهة، تُكتشف العبارات الجديدة وتُسجَّل وتُترجم آليًا إلى لغاتك المحلية المستهدفة.
2. بعد استقرار النص، حوّل التطبيق المنشور إلى مفتاح للقراءة فقط.
3. يجلب المستخدمون الفهرس الجاهز، ولا شيء بحوزتهم يمكنه تغيير مشروعك.

# .env.local — development
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key   # discovers + registers new phrases

# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key   # only fetches — safe to ship

ما الذي يحتويه المشروع

يُصادَق على المفتاح مقابل مشروع، وهو الذي يحدد نطاق الترجمة لتطبيقك:

• لغة أساسية — اللغة التي كُتبت بها عباراتك المصدر؛
• مجموعة من اللغات المستهدفة — وهي كل اللغات التي تُترجم إليها العبارات آليًا؛
• إعدادات الترجمة الآلية — مستوى المزوّد، وما إذا كانت العبارات الجديدة تُترجم تلقائيًا.

هل تشغّل هذه العروض التوضيحية محليًا؟ وجّه حزمة SDK إلى نسختك الخاصة بمفتاح للقراءة فقط — راجع الملف .env.example في المشروع. وإلا فستعمل اللوحات في وضع العرض التوضيحي (النص المصدر فقط).