←جميع الوثائق
الدليل الميداني لاستديو البوابة

بني بجرأة ونشر بأمان

مرجع عملي للمديرين الذين يشكلون تجربة العملاء والمطورين الذين يوسعونها، ويوثق البنيان الحقيقي لـ Studio، ومسار الإصدار المنظم، وملكية مركز المساعدة، والهوية، والهجرات، وعقود المكونات، واستعادة القدرة على العمل.

الوثيقة 2مدير + مطورسير العمل في إصدارات المؤسسةUpdated1آب/أغسطس2026
دليل المدير

تعرف ماذا يملك الاستوديو

يملك ستوديو البوابة القشرة التي تواجه العميل: الصفحات، وتوزيع المكونات، ورموز العلامة التجارية، والسلوك الاستجابي، والتصفح، والساق، وعرض الهوية، ورحلات التذاكر والإصدارات. ويملك مركز المساعدة اللغات والفئات والأقسام ومحتوي المقالة. يستهلك ستوديوهات ذلك المحتوى من خلال جسر محمي؛ ولا ينشئ أبداً مخزن مقال ثانٍ.

مركز المساعدة + خدمات التذاكر + الهويةمواءمات البيانات المأمونة من الإذنمشروع الوثيقة (النسخة 2)مترجم وعرض واحدعرض مسبق ونشر البوابة
قاعدة المصدر الواحد: تستخدم الصفحات العامة والصفحة المسبقة نفس عقد الوثيقة/المحول.
خريطة حيز العمل
لوحة حيةأجهزة حاسوب مكتبي
بوابة العميلنفس الوثيقة المرتبة المستخدمة في الاستعراض الأولي والعرض العام
خريطة الواجهة: يستهدف خط العمل، والقماش الحي والمفتش نفس الصفحة المستقرة واختيار العقدة.
بدء

الاستعداد الكامل قبل البناء العميق

  1. مفتوح Portal Studio→ابدأ→الجاهزة.
  2. 1- تأكيد عنوان البوابة الرسمي وفتحه في علامة منفصلة.
  3. حدد الشعار، أيقونة المتصفح، أيقنة اللمس، الصورة الاجتماعية ولون الموضوع.
  4. تأكيد لغات مركز المساعدة؛ تغيير سلطة اللغة في مركز الدعم، وليس في استوديو.
  5. إنشاء هيكل التصفح وتذييل المؤسسة العالمية.
  6. اختار رحلة تذكرة وحدد شكلا واحدا على الأقل من استمارات الطلب.
  7. إبقاء طريقة واحدة على الأقل من طرق الدخول الآمنة نشطة واستعراض عملية اكتشاف الهوية.
  8. إبدأ الجودة وإنشاء المصافحة المسبقة الموقعة.
  9. إنشاء أول إصدار محكم بعد أن يتم إزالة كل بند من بنود الحظر.

تُحسب النسبة المئوية للاستعداد من بيانات مساحة العمل المحفوظة وحالة الاستعراض. ويتم اختيار عنصر ما بصورة مباشرة إلى لوحة ملكه.

مدير

إنشاء صفحات وأقسام قابلة لإعادة الاستخدام

  1. مفتوح البناء→الصفحة واختيار صفحة نظام محمية أو إنشاء صفحة مخصصة.
  2. حدد الطريق، العنوان، طريقة الوصول والسلوك الإقليمي. لا يمكن حذف مسارات النظام المحمية.
  3. مفتوح المكونات)١( انظر الوثيقة A/AC.254/1998/CRP.3، المرفق الثاني.
  4. استخدم مفتش المحتوى والمظهر والتجليد والرؤية وإمكانية الوصول.
  5. استخدام أنماط قابلة لإعادة الاستخدام للهياكل المتكررة؛ والاحتفاظ بالاختلافات التنظيمية أو التجارية في الصيغ المختلفة.
  6. حفظ المسودة والتمرين على تحميل، فارغ، خطأ، ضيف وتسجيل الدخول في الحالات في الاستعراض.
خريطة وصلة بينية معقمة
البحث عن المعارف:: سلامة العملاءشبكة الفئاتمركز المساعدةمتن المادةألف - الترجمة التحريريةاستمارة الطلب:: نُقحتالجدول الزمني للتذاكرتحذيررسم بياني للبيانات:: نشر الوحدات المقررة
خريطة الوصلة البينية: الفئة والتوافق والنضج واضحة قبل وضعها؛ المكونات المخطط لها تعوق النشر؛ مكونات بيتا تتطلب معالجة إصدار صريح.
· العلامة التجارية والاستجابة

رؤية رحلات حقيقية، لا شاشة سعيدة واحدة

  1. اختار دعم الزائر، أو تذكرة موقع عليها، أو الرعاية الفواتير، أو تنظيم أو نقل المعرفة.
  2. تغيير الشخصيات والتنظيم والدور ولغة مركز المساعدة.
  3. تفتيش نقاط الانقطاع المتنقلة، والمتنقلة الكبيرة، واللوحات اللوحية، والحواسيب المحمولة، والمكتبية، والعريضة، والفائقة الاتساع.
  4. التحقق من القيم الموروثة والمستبدلة والمعاد إعدادها؛ وتجنب ازدواج نقاط الانقطاع غير الضرورية.
  5. تشغيل لوحة المفاتيح، و RTL، والحركات المنخفضة، والشحن، والفراغ، وحالات عدم التوفر والتصاريح.
  6. استخدام مختبر الاختبار لمعرفة نتائج الوصول والحمولة والمسار والارتباط وبرنامج عرض البيانات قبل الاستعراض.
ولا يشكل القماش الأخضر قرارا بالإصدار، بل إن الفحص السابق للنشر المنظم وحالة الاستعراض والقدرات وأدلة الإطلاق هي التي تقرر ما إذا كان يمكن نشر البوابة.
الخبرة

تشغيل مركز للمساعدة على مستوى Zendesk دون ازدواجية في المحتوى

  1. إنشاء فئات وأقسام ومقالات وترجمات ومرفقات وقوالب في مركز المساعدة.
  2. لغات تمكينية هناك؛ وتُتبع السلطة نفسها في المزلاجات المحلية، والبحث، والتغذية، و SEO.
  3. في ستوديو، وضع البحث المعرفي، وشبكات الفئات/الموارد، والتغذية الإخبارية، وقائمة الموضوعات، والمقالات، وجدول المحتويات، والردود، والمكونات ذات الصلة، والمكوّنات السابقة/اللاحقة.
  4. تكوين المدخلات الرئيسية والشائعة والحديثة؛ واستخدام المقترحات السياقية في تدفقات التذاكر.
  5. استعراض المقالات التي لا تسفر عن نتائج، والمقالات الطويلة، والضمائم، والتعليقات، ومراقبة/الاشتراك وتسليم التذاكر.
  6. التحقق من مسارات النطاقات المحلية النظيفة، والقواعد/اللغة المرجعية، والبيانات الهيكلية وإبطال ملفات التخزين المؤقت بعد النشر.
حدود السلطة: تعديل محتوى المقال ولغات العملاء في مركز المساعدة. استخدم استوديو البوابة فقط لتكوين كيفية اكتشاف المعرفة وعرضها.
:: الهوية والمنظمات

تكوين الدخول الآمن

  1. مفتوح منظمات الهوية→الهوية وإبقاء مسار دخول واحد على الأقل مُفعَّلاً.
  2. اختار الطريقة الافتراضية، سياسة التسجيل، مدة الجلسة، SSO إنفاذ المجال وسلوك الاكتشاف.
  3. إضافة مقدمي الخدمات مع حقول التوجيه البصرية: النوع، والمجالات، والأولوية، والعرض، والحالة المفعّلة والمتحقق منها.
  4. بالنسبة لـ SCIM، قم بتمكين الإتاحة ونسخ النقطة النهائية لحيز العمل بدقة ودور الرموز.
  5. رسم خريطة المطالبات وعضوية المنظمة، ثم اختبار الإنشاء والتحديث والعضوية في المجموعة وتعطيل العمل مع مستأجر اختبار.
  6. استعراض الضيوف، والعملاء، والمنظمات المفوضة والحالات المحجوبة قبل النشر.
لا ترسل أبداً كعكة الدورة الإستديويةSCIMوهو حامل بلا دورات، ومفتقر للعمل في الفضاءAPI- تناوب a token after accidental exposure.
:: تذاكر السفر

تكوين رحلة الدعم الكاملة

  1. اختار الاستمارة المباشرة، أو الدليل، أو البحث أولاً، أو مركز البيانات، أو مدخل مكتب الخدمات.
  2. إنشاء استمارة طلب مسماة ومصنفة حسب النسخ تتضمن أقساماً وعلامات حقول يمكن الوصول إليها.
  3. بناء الظروف المرئية، الإثارة،SLAخطوات متقدمة للموافقة عليها؛JSONوبالنسبة للتغيرات التي يجري استعراضها للمطورين فقط.
  4. حدد القائمة، التفاصيل، الخيط، الجدول الزمني، المرفقات، الموافقة، SLA والرد أسطح.
  5. اختبار البحث عن الزوار، وطلبات التسجيل، والرؤية المؤسسية، والفشل في تحميل الملفات، والإخطار بالبريد الإلكتروني، وانحراف المعرفة.
  6. حفظ مسودة؛ النشر فقط بعد أن يمر مسار المسار ومسار الإخطار بالتحقق المسبق.
:: استعراض وإصدار

الانتقال من خلال إصدار منظم

مسودة محفوظةقيد الاستعراضالمعتمدالمقررة أو المنشورةالملاحظة أو الإلغاء
  1. تشغيل التحقق ومختبر الاختبار. إصلاح نتائج الحظر؛ الإقرار بالإنذارات المسموح بها مع السياق.
  2. إضافة ملاحظات الإصدار وطلب المراجعة.
  3. ويقوم المعتمدون بتفتيش التباين، والنظر المسبق في الرحلات، وتغييرات الإذن والأدلة.
  4. نشر أو جدولة من خلال العامل الخلفي. مغادرة الاستوديو لا يلغي عمل دائم.
  5. رصد التقدم، والصحة والارتباط هوية. التوقف/إعادة المحاولة فقط من ضوابط العمل.
  6. التحقق من الطرق الحساسة، والهوية، والتذاكر والمعارف. العودة إلى إصدار سابق ثابت عند الاقتضاء.
القدرةالغرض
عرض/تحريرتفتيش أو تغيير المسودات دون سلطة الإفراج.
استعراض/اعتماد:: فصل التعليقات والموافقة عن التأليف.
جدولة/نشر/إلغاءالضوابط المستقلة للإنتاج.
الهوية SCIM المكونات / التشخيصتقييد العمليات الحساسة المتخصصة.
:: نقل وتوسيع

الهجرة مع الأدلة وطريقة العودة

  1. انقر على مخطط مقدم الخدمة واختر اختبارا تجريبيا.
  2. استعراض الإعدادات المكتشفة، والقيم غير المرسومة، وحسابات المحتوى، والتقاط التكافؤ البصري.
  3. أكملوا رسم الخرائط الآمنة وإعادة تشغيل المقارنة المرتبة.
  4. يرجى التقدم بطلب للحصول على مسودة، وتسوية الحسابات واستعراض كل رحلة محمية.
  5. تسجيل القبول المأذون به؛ لا تكتب أبدا فوق الإصدار المنشور الحالي أثناء الاستيراد.
  6. نشر من خلال الحوكمة والاحتفاظ بتقرير الهجرة، ورمز الإطلاق ونقطة الرجوع معاً.
دليل المطورين

تمديد العقود، لا نماذجها

يقوم التوسيع الآمن بتسجيل نوع مكون ومخطط مستقر، ويعلن عن الإذن واحتياجات البيانات، ويعرض من خلال المترجم الأساسي، ويوفر اختبارات/تجهيزات حاسمة. JavaScript إلى البوابة العامة، أو إنشاء مستودع آخر للمقالات، أو تجاوز بوابة الإطلاق.

الوثيقة 2

وتحتوي الصفحات على عقود مستقرة، وفتحات، وخصائص، وربطات، واستبدالات استجابية، وشروط، وبيانات وصفية عن إمكانية الوصول.

قلم المحكمة

ويقوم عقد واحد بتغذية استوديو، ومجمع، وتوثيق، ونقل، والتحقق من النضج.

سجل مصادر البيانات

يستعاض عن التعسفي بقائمة مسموح بها، قراءة فقط، DTOs نطاق الإذن SQL أو الإجراءات الدينامية.

جهاز عرض واحد

تقاسم العرض المسبق والنواتج العامة، والتجميع، والتنظيف، والميزانيات وحالات وقت التشغيل.

عقد المكونات

تعريف حزمة المكونات

استخدم هوية مساحة اسم بحروف صغيرة وإصدارا معنايا. وفر كلا من أسماء خصائص التوافق الموضحة لأن تفتيش الحزم والتحقق الأمني يقومان بعمليات تدقيق مستقلة.

{
  "schema_version": 1,
  "id": "acme.support_health",
  "slug": "acme-support-health",
  "name": "Support health",
  "version": "1.0.0",
  "entry": "renderer.php",
  "renderer": "server",
  "server_renderer": "renderer.php",
  "public_renderer": "public.js",
  "schema": {
    "type": "object",
    "properties": {
      "heading": {"type": "string", "maxLength": 120},
      "showSla": {"type": "boolean", "default": true}
    },
    "additionalProperties": false
  },
  "permissions": ["tickets.read"],
  "data_scopes": ["tickets.mine"],
  "accessibility": {
    "landmark": "section",
    "nameFrom": "heading",
    "emptyState": true,
    "errorState": true
  },
  "performance": {"max_js_bytes": 12000, "max_css_bytes": 8000},
  "performance_budget": {"js": 12000, "css": 8000, "requests": 0}
}

شكل العقدة

{
  "id": "node-support-health",
  "type": "custom.acme_support_health",
  "props": {"heading": "Support health", "showSla": true},
  "bindings": {"requests": {"source": "tickets.mine", "limit": 5}},
  "responsive": {"mobile": {"padding": "16px"}, "desktop": {"padding": "24px"}},
  "conditions": [{"field": "identity.signed_in", "operator": "equals", "value": true}],
  "a11y": {"label": "Support health"}
}
  • تظل الهويات مستقرة عبر التحرير والهجرة.
  • الخصائص ترفض الحقول غير المعلنة وغير الآمنة HTML.
  • كل عرض مرتبط بالبيانات يحدد تحميل، فارغ، الإذن وإعادة محاولة خطأ المخرج.
  • مكونات الحاوية تسمي شقوقها؛ لا يمكن للأوراق قبول أبناء تعسفي.
  • علامة النضج بصدق: الكتل المخططة، تحذيرات بيتا، GA يتطلب دليلا كاملا.
مصادر البيانات والروابط

استخدام أجهزة تحديد المواقع المأمونة

  1. اختار رمزاً قائماً مكوناً من نقاط مثل tickets.mine, knowledge.featured أو customer.profile.
  2. مصادر مجهولة تفشل مع data_source.unknown.
  3. لا تقبل أبدا هوية حيز العمل/الزبون من ملكية غير موثوق بها.
  4. الحدود الواردة في القوائم مقيدة بـ.1–100:: توحيد قيم التصفح واللغة المحلية والبحث.
  5. إذا كان لا بد من وجود مصدر جديد، أضف تعريفه المستقر، ورسم الخرائط الآمنة، والتصاريح، والسلوك الفارغ وتثبيت العرض المسبق معاً.
{
  "success": true,
  "source": "tickets.mine",
  "contract_version": 1,
  "items": [
    {"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
  ]
}
تتطلب الطفرات إجراءً صريحاً مأذوناً به للخدمة، وربط حيز العمل، والتحقق من صحة CSRF/الجلسة أو الحامل، وإمكانية المقارنة عند الضرورة ومظروف خطأ مطبوع.
مطور

إبقى داخل حدود الثقة

الحدودالسلوك المطلوب
مساحة العملحل من المضيف/المسار/الجلسة الموثوقة، ثم نطاق كل قراءة وكتابة قبل التنفيذ.
HTMLاستعملوا المُحرّر البورطي/المُسجّل، لا تُزوّدوا بخصائص غير مُوصّلة.URLs, CSSأو النص.
معاينةتطلب نافذة مصدر ذات منشأ واحد، وإصدار القناة الموقع وعدم وجود.
الهويةSCIM هو مصدق عليه من حامله، وغير مرتبط بالجلسة ومقيد بحيز العمل.
مجموعاترفض المرور، المسارات المطلقة، الروابط/الملفات الخاصة، المحفوظات الكبيرة، عدم توافق مجموع التحقق/التوقيع والحقوق غير المعروفة.
الأخطاءإعادة الشفرة المستقرة، الرسالة الآمنة، قابلية المحاولة مجدداً، التعويض وتحديد الارتباط؛ سجل الاستثناءات الخاصة على جانب الخادم.
المعرفةلا تكتب أبدا أو تكرر مقالات مركز المساعدة في امتداد.
{
  "success": false,
  "error": {
    "code": "studio.permission_denied",
    "message": "You do not have permission to publish the Portal.",
    "retryable": false,
    "correlation_id": "ps_…",
    "meta": {"capability": "publish"}
  }
}
المطور · التجميع والهجرة

التفتيش والتركيب والتحديث على نحو ذري

  1. ضع component.json في جذر ZIP و إبق كل مسار نسبي.
  2. تشغيل التفتيش أولاً. 500 المدخلات والمخرجات 25 MB استخرج؛ التحقق الأمني يضيف حدود مستقلة.
  3. التحقق من SHA-256 المتوقع وتوقيع الحزمة في عملية الإطلاق.
  4. تثبيت في مجلد نسخة. لا تغيّر أبداً النسخة المركّبة في مكانها.
  5. توفير عمليات نقل الممتلكات من أجل كسر التغييرات في المخطط والحفاظ على حقول التوافق غير المعروفة.
  6. فتح المكون في مسودة، وتشغيل كل حالة/منفذ عرض/شخصية تثبيت والنشر من خلال الحوكمة.
  7. يقوم التراجع بتفعيل إصدار العنصر/الوثيقة السابق غير القابل للتغيير؛ ويُحتفظ بأدلة قابليته للتكرار.
الاختبار والإصدار

إثبات الإمتداد على نفس رمز البعثرة للإصدار

php tools/portal_studio_certify.php --source-only --json
php tools/test_portal_studio_contract.php
php tools/test_portal_one_renderer.php
php tools/test_portal_studio_engineer.php
php tools/test_portal_component_contracts.php
php tools/test_portal_one_renderer.php
php tools/test_portal_shell_contract.php
php tools/test_portal_knowledge_contract.php
node node_modules/@playwright/test/cli.js test tests/e2e/portal-studio-shell-visual-contract.spec.js tests/e2e/portal-custom-code-runtime.spec.js

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

  • الوحدة: المخطط، والتنظيف، وشكل نقطة القطع المحددة، والظروف، والهجرات، وأوجه القصور المصنفة.
  • العقد: التحميل/الفراغ/الخطأ/النجاح، الاستحقاق، المواعيد النهائية، الترابطات وتكافؤ المُعدّل الواحد.
  • المتصفح: لوحة المفاتيح، التركيز، الدلالة، RTL، التقريب/إعادة التدفق، الحركة المخفضة وكل نقطة توقف.
  • الأمن: عمليات المسح عبر حيز العمل، والإجراءات المزورة، وهجمات الحزم، والتزوير المبكر، والتسرب السري.
  • العمليات: إحراز تقدم دائم، والخروج/العودة، والتوقف/إعادة المحاولة/اﻻستئناف، ومعدل ضربات القلب في الجدول الزمني واﻹلغاء.
مدير + مطور

حل المشاكل حسب الحالة ورمز التعريف المرتبط

الدولةماذا نفعل
الإذنطلب القدرة المسماة. واجهة المستخدم المخفية هي ميزة؛ الجانب الخلفي دائما يفرضها.
التحققفتح الصفحة/العقدة/الحقل المبلغ عنه، وتصحيحه، ثم إعادة تشغيل الفحص السابق للتحليق.
النزاعأعيد تحميل آخر تنقيح، قارن التغييرات وطبقها مجدداً عن قصد. لا تجبر أبداً على الكتابة فوقها.
غير متصل بالشبكة/قابل لإعادة المحاولةالاحتفاظ بالمسودة، واستعادة الاتصال، وإعادة محاولة الإجراء والتحقق من حالة العمل الدائم.
قاتلة/غير متاحةنسخة من هوية الارتباط و الختم الزمني للدعم. لا تلصق أبدا الأسرار أو نص الاستثناء الخاص.
فشل النشرتفحص مخرجات التحقُّق المسبق/العمل، وإعادة محاولة المراحل القابلة لإعادة المحاولة فقط، أو العودة إلى آخر إصدار سليم.
SCIM 401/403تأكيد نقطة النهاية/حيز العمل، ورمز الحامل، والحالة المفعّلة والتناوب؛ ولا تستخدم أبداً ملفات تعريف ارتباط جلسة المتصفح.
المعرفة قديمةالتحقق من اللغة/النشر في مركز المساعدة، ثم فحص بطلان المخزن المؤقت وتنظيف الطريق المحلي.

هذا الدليل جاهز للطباعة. استخدم الطباعة → حفظ ك PDF لنسخة خارجية خاضعة للمراقبة.