تعرف ماذا يملك الاستوديو
يملك ستوديو البوابة القشرة التي تواجه العميل: الصفحات، وتوزيع المكونات، ورموز العلامة التجارية، والسلوك الاستجابي، والتصفح، والساق، وعرض الهوية، ورحلات التذاكر والإصدارات. ويملك مركز المساعدة اللغات والفئات والأقسام ومحتوي المقالة. يستهلك ستوديوهات ذلك المحتوى من خلال جسر محمي؛ ولا ينشئ أبداً مخزن مقال ثانٍ.
الاستعداد الكامل قبل البناء العميق
- مفتوح Portal Studio→ابدأ→الجاهزة.
- 1- تأكيد عنوان البوابة الرسمي وفتحه في علامة منفصلة.
- حدد الشعار، أيقونة المتصفح، أيقنة اللمس، الصورة الاجتماعية ولون الموضوع.
- تأكيد لغات مركز المساعدة؛ تغيير سلطة اللغة في مركز الدعم، وليس في استوديو.
- إنشاء هيكل التصفح وتذييل المؤسسة العالمية.
- اختار رحلة تذكرة وحدد شكلا واحدا على الأقل من استمارات الطلب.
- إبقاء طريقة واحدة على الأقل من طرق الدخول الآمنة نشطة واستعراض عملية اكتشاف الهوية.
- إبدأ الجودة وإنشاء المصافحة المسبقة الموقعة.
- إنشاء أول إصدار محكم بعد أن يتم إزالة كل بند من بنود الحظر.
تُحسب النسبة المئوية للاستعداد من بيانات مساحة العمل المحفوظة وحالة الاستعراض. ويتم اختيار عنصر ما بصورة مباشرة إلى لوحة ملكه.
إنشاء صفحات وأقسام قابلة لإعادة الاستخدام
- مفتوح البناء→الصفحة واختيار صفحة نظام محمية أو إنشاء صفحة مخصصة.
- حدد الطريق، العنوان، طريقة الوصول والسلوك الإقليمي. لا يمكن حذف مسارات النظام المحمية.
- مفتوح المكونات)١( انظر الوثيقة A/AC.254/1998/CRP.3، المرفق الثاني.
- استخدم مفتش المحتوى والمظهر والتجليد والرؤية وإمكانية الوصول.
- استخدام أنماط قابلة لإعادة الاستخدام للهياكل المتكررة؛ والاحتفاظ بالاختلافات التنظيمية أو التجارية في الصيغ المختلفة.
- حفظ المسودة والتمرين على تحميل، فارغ، خطأ، ضيف وتسجيل الدخول في الحالات في الاستعراض.
رؤية رحلات حقيقية، لا شاشة سعيدة واحدة
- اختار دعم الزائر، أو تذكرة موقع عليها، أو الرعاية الفواتير، أو تنظيم أو نقل المعرفة.
- تغيير الشخصيات والتنظيم والدور ولغة مركز المساعدة.
- تفتيش نقاط الانقطاع المتنقلة، والمتنقلة الكبيرة، واللوحات اللوحية، والحواسيب المحمولة، والمكتبية، والعريضة، والفائقة الاتساع.
- التحقق من القيم الموروثة والمستبدلة والمعاد إعدادها؛ وتجنب ازدواج نقاط الانقطاع غير الضرورية.
- تشغيل لوحة المفاتيح، و RTL، والحركات المنخفضة، والشحن، والفراغ، وحالات عدم التوفر والتصاريح.
- استخدام مختبر الاختبار لمعرفة نتائج الوصول والحمولة والمسار والارتباط وبرنامج عرض البيانات قبل الاستعراض.
تشغيل مركز للمساعدة على مستوى Zendesk دون ازدواجية في المحتوى
- إنشاء فئات وأقسام ومقالات وترجمات ومرفقات وقوالب في مركز المساعدة.
- لغات تمكينية هناك؛ وتُتبع السلطة نفسها في المزلاجات المحلية، والبحث، والتغذية، و SEO.
- في ستوديو، وضع البحث المعرفي، وشبكات الفئات/الموارد، والتغذية الإخبارية، وقائمة الموضوعات، والمقالات، وجدول المحتويات، والردود، والمكونات ذات الصلة، والمكوّنات السابقة/اللاحقة.
- تكوين المدخلات الرئيسية والشائعة والحديثة؛ واستخدام المقترحات السياقية في تدفقات التذاكر.
- استعراض المقالات التي لا تسفر عن نتائج، والمقالات الطويلة، والضمائم، والتعليقات، ومراقبة/الاشتراك وتسليم التذاكر.
- التحقق من مسارات النطاقات المحلية النظيفة، والقواعد/اللغة المرجعية، والبيانات الهيكلية وإبطال ملفات التخزين المؤقت بعد النشر.
تكوين الدخول الآمن
- مفتوح منظمات الهوية→الهوية وإبقاء مسار دخول واحد على الأقل مُفعَّلاً.
- اختار الطريقة الافتراضية، سياسة التسجيل، مدة الجلسة، SSO إنفاذ المجال وسلوك الاكتشاف.
- إضافة مقدمي الخدمات مع حقول التوجيه البصرية: النوع، والمجالات، والأولوية، والعرض، والحالة المفعّلة والمتحقق منها.
- بالنسبة لـ SCIM، قم بتمكين الإتاحة ونسخ النقطة النهائية لحيز العمل بدقة ودور الرموز.
- رسم خريطة المطالبات وعضوية المنظمة، ثم اختبار الإنشاء والتحديث والعضوية في المجموعة وتعطيل العمل مع مستأجر اختبار.
- استعراض الضيوف، والعملاء، والمنظمات المفوضة والحالات المحجوبة قبل النشر.
تكوين رحلة الدعم الكاملة
- اختار الاستمارة المباشرة، أو الدليل، أو البحث أولاً، أو مركز البيانات، أو مدخل مكتب الخدمات.
- إنشاء استمارة طلب مسماة ومصنفة حسب النسخ تتضمن أقساماً وعلامات حقول يمكن الوصول إليها.
- بناء الظروف المرئية، الإثارة،SLAخطوات متقدمة للموافقة عليها؛JSONوبالنسبة للتغيرات التي يجري استعراضها للمطورين فقط.
- حدد القائمة، التفاصيل، الخيط، الجدول الزمني، المرفقات، الموافقة، SLA والرد أسطح.
- اختبار البحث عن الزوار، وطلبات التسجيل، والرؤية المؤسسية، والفشل في تحميل الملفات، والإخطار بالبريد الإلكتروني، وانحراف المعرفة.
- حفظ مسودة؛ النشر فقط بعد أن يمر مسار المسار ومسار الإخطار بالتحقق المسبق.
الانتقال من خلال إصدار منظم
- تشغيل التحقق ومختبر الاختبار. إصلاح نتائج الحظر؛ الإقرار بالإنذارات المسموح بها مع السياق.
- إضافة ملاحظات الإصدار وطلب المراجعة.
- ويقوم المعتمدون بتفتيش التباين، والنظر المسبق في الرحلات، وتغييرات الإذن والأدلة.
- نشر أو جدولة من خلال العامل الخلفي. مغادرة الاستوديو لا يلغي عمل دائم.
- رصد التقدم، والصحة والارتباط هوية. التوقف/إعادة المحاولة فقط من ضوابط العمل.
- التحقق من الطرق الحساسة، والهوية، والتذاكر والمعارف. العودة إلى إصدار سابق ثابت عند الاقتضاء.
| القدرة | الغرض |
|---|---|
| عرض/تحرير | تفتيش أو تغيير المسودات دون سلطة الإفراج. |
| استعراض/اعتماد | :: فصل التعليقات والموافقة عن التأليف. |
| جدولة/نشر/إلغاء | الضوابط المستقلة للإنتاج. |
| الهوية SCIM المكونات / التشخيص | تقييد العمليات الحساسة المتخصصة. |
الهجرة مع الأدلة وطريقة العودة
- انقر على مخطط مقدم الخدمة واختر اختبارا تجريبيا.
- استعراض الإعدادات المكتشفة، والقيم غير المرسومة، وحسابات المحتوى، والتقاط التكافؤ البصري.
- أكملوا رسم الخرائط الآمنة وإعادة تشغيل المقارنة المرتبة.
- يرجى التقدم بطلب للحصول على مسودة، وتسوية الحسابات واستعراض كل رحلة محمية.
- تسجيل القبول المأذون به؛ لا تكتب أبدا فوق الإصدار المنشور الحالي أثناء الاستيراد.
- نشر من خلال الحوكمة والاحتفاظ بتقرير الهجرة، ورمز الإطلاق ونقطة الرجوع معاً.
تمديد العقود، لا نماذجها
يقوم التوسيع الآمن بتسجيل نوع مكون ومخطط مستقر، ويعلن عن الإذن واحتياجات البيانات، ويعرض من خلال المترجم الأساسي، ويوفر اختبارات/تجهيزات حاسمة. 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 يتطلب دليلا كاملا.
استخدام أجهزة تحديد المواقع المأمونة
- اختار رمزاً قائماً مكوناً من نقاط مثل
tickets.mine,knowledge.featuredأوcustomer.profile. - مصادر مجهولة تفشل مع
data_source.unknown. - لا تقبل أبدا هوية حيز العمل/الزبون من ملكية غير موثوق بها.
- الحدود الواردة في القوائم مقيدة بـ.1–100:: توحيد قيم التصفح واللغة المحلية والبحث.
- إذا كان لا بد من وجود مصدر جديد، أضف تعريفه المستقر، ورسم الخرائط الآمنة، والتصاريح، والسلوك الفارغ وتثبيت العرض المسبق معاً.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
إبقى داخل حدود الثقة
| الحدود | السلوك المطلوب |
|---|---|
| مساحة العمل | حل من المضيف/المسار/الجلسة الموثوقة، ثم نطاق كل قراءة وكتابة قبل التنفيذ. |
| 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"}
}
}
التفتيش والتركيب والتحديث على نحو ذري
- ضع
component.jsonفي جذر ZIP و إبق كل مسار نسبي. - تشغيل التفتيش أولاً. 500 المدخلات والمخرجات 25 MB استخرج؛ التحقق الأمني يضيف حدود مستقلة.
- التحقق من SHA-256 المتوقع وتوقيع الحزمة في عملية الإطلاق.
- تثبيت في مجلد نسخة. لا تغيّر أبداً النسخة المركّبة في مكانها.
- توفير عمليات نقل الممتلكات من أجل كسر التغييرات في المخطط والحفاظ على حقول التوافق غير المعروفة.
- فتح المكون في مسودة، وتشغيل كل حالة/منفذ عرض/شخصية تثبيت والنشر من خلال الحوكمة.
- يقوم التراجع بتفعيل إصدار العنصر/الوثيقة السابق غير القابل للتغيير؛ ويُحتفظ بأدلة قابليته للتكرار.
إثبات الإمتداد على نفس رمز البعثرة للإصدار
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 لنسخة خارجية خاضعة للمراقبة.