كيف يعمل Atlas

العناصر البنائية

المفهوم	ما هو
المؤسسة	شركتك. تملك المواقع والأشخاص وخطتها.
الموقع	موقع إلكتروني واحد. لا ينتقل المحتوى والوسائط وصلاحيات الأشخاص والإعدادات بين المواقع أبدًا.
البيئة	لكل موقع بيئتا التطوير والإنتاج. تعمل في التطوير؛ أما الإنتاج فلا يقدّم سوى إصدار معتمد.
عقد الموقع	وصف بصيغة JSON لموقعك: مكوّناته وحقولها مضبوطة الأنواع، وأنواع الصفحات، والمجموعات، والمحتوى العام للرأس والتذييل، وملفات تعريف الوسائط، ورموز التصميم.
الصفحة	مسار في موقعك (مثل /about)، تتكون من أقسام. كل قسم هو أحد مكوّنات عقدك مع قيم حقوله.
العنصر	عنصر واحد في مجموعة، مثل منتج أو خبر.
المحتوى العام	محتوى مشترك بين الصفحات، مثل رأس الموقع وتذييله.
رمز التسليم	رمز للخادم فقط يستخدمه موقعك لقراءة المحتوى المنشور لبيئة واحدة.

كيف يصل المحتوى إلى موقعك

 Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision
                                                                     │
                       your website server ◀── Delivery API (HTTPS, delivery token)
                               │
                       your components render it ──▶ visitors

1. يصف مطوروك الموقع في عقد الموقع. ويفعّله مسؤول الموقع في Studio.
2. ينشئ المحررون الصفحات والعناصر ويغيّرونها كـمسودات. لا تظهر المسودات أبدًا على الموقع العام.
3. يعاين المحررون المسودة داخل تصميم موقعك الفعلي، ثم ينشرونها. كل عملية نشر هي مراجعة غير قابلة للتغيير، فيمكنك التراجع.
4. يقرأ موقعك المحتوى المنشور من Delivery API باستخدام رمز التسليم، ومن شيفرة الخادم فقط.
5. يرسل Atlas webhook موقّعًا عند النشر، فيحدّث موقعك الصفحات المتأثرة فقط.

التطوير والإنتاج

• يبدأ كل موقع جديد في التطوير. يُحرَّر المحتوى وينشر هناك.
• الإنتاج متوقف إلى أن يفعّله مسؤول الموقع، بعد أن يجتاز الإصدار جميع الفحوصات ويعتمده شخص يملك صلاحية الموافقة.
• لا يقدّم الإنتاج سوى إصداره الحي الموقّع: لقطة مجمدة من المحتوى المعتمد. تحرير التطوير لا يغيّر الإنتاج أبدًا حتى الإصدار المعتمد التالي.
• تبديل البيئة في Studio يغيّر ما تنظر إليه فقط. ولا يغيّر المحتوى أبدًا.

المزيد: التطوير والإنتاج.

ما الذي يجب أن يفعله موقعك

لا يعمل Atlas على موقعك. يضيف مطوروك قدرًا صغيرًا من الشيفرة:

• عميل للخادم فقط لـ Delivery API؛
• عرض الأقسام عبر مكوّناتك الحالية؛
• محتوى احتياطي: إذا تعذّر الوصول إلى Atlas أو لم يكن فيه شيء منشور لصفحة ما، يقدّم الموقع محتواه المضمّن؛
• مسار لمعاينة المسودات، ومستقبل webhook، وتقرير بناء.

يشرح دليل الربط كلًا منها خطوة بخطوة.