जानिए स्टूडियो किस प्रकार का मालिक है?
पोर्टल स्टूडियो ग्राहक-facing शेल का मालिक है: पृष्ठ, घटक प्लेसमेंट, ब्रांड टोकन, उत्तरदायी व्यवहार, नेविगेशन, पाद लेख, पहचान प्रस्तुति, टिकट यात्रा और विज्ञप्ति। मदद केंद्र भाषा, श्रेणियों, अनुभागों और लेख सामग्री का मालिक हैं। स्टूडियो एक संरक्षित पुल के माध्यम से उस सामग्री का उपभोग करता है; यह कभी भी दूसरा लेख स्टोर नहीं बनाता है।
गहराई से निर्माण करने से पहले तत्परता
- खुला पोर्टल स्टूडियो → प्रारंभ → तैयारी.
- कैनोनिकल पोर्टल पते की पुष्टि करें और इसे एक अलग टैब में खोलें।
- लोगो, ब्राउज़र आइकन, टच आइकन, सामाजिक छवि और थीम रंग सेट करें।
- सहायता केंद्र भाषा की पुष्टि करें; मदद सेंटर में भाषा अधिकार बदलें, स्टूडियो नहीं।
- नेविगेशन और वैश्विक उद्यम पाद लेख को कॉन्फ़िगर करें।
- टिकट यात्रा चुनें और कम से कम एक अनुरोध फॉर्म को कॉन्फ़िगर करें।
- कम से कम एक सुरक्षित संकेत-in विधि सक्रिय रखें और पहचान खोज की समीक्षा करें।
- गुणवत्ता को चलाने और हस्ताक्षरित पूर्वावलोकन हैंडशेक की स्थापना।
- प्रत्येक अवरुद्ध आइटम को साफ़ करने के बाद पहली नियंत्रित रिलीज बनाएं।
पठन प्रतिशत की गणना सेव्ड वर्कस्पेस डेटा और पूर्वावलोकन स्टेट से की जाती है। सीधे अपने खुद के पैनल में एक आइटम मार्गों का चयन करना।
पृष्ठों और पुन: प्रयोज्य वर्गों का निर्माण
- खुला निर्माण → पेज और एक संरक्षित सिस्टम पेज का चयन करें या एक कस्टम पृष्ठ बनाएँ।
- मार्ग, शीर्षक, अभिगम मोड और स्थानीय व्यवहार को सेट करें। संरक्षित सिस्टम मार्गों को हटाया नहीं जा सकता है।
- खुला अवयव, नौकरी या परिपक्वता द्वारा फ़िल्टर करें, और एक घटक को संगत स्लॉट में रखें।
- सामग्री, उपस्थिति, बंधन, दृश्यता और पहुंच के लिए निरीक्षक का उपयोग करें।
- बार-बार संरचनाओं के लिए पुन: प्रयोज्य पैटर्न का उपयोग करें; वेरिएंट में संगठन या ब्रांड मतभेदों को बनाए रखें।
- ड्राफ्ट और व्यायाम लोड हो रहा है, खाली, त्रुटि, अतिथि और हस्ताक्षरित राज्यों में पूर्वावलोकन में सहेजें।
वास्तविक यात्राओं का पूर्वावलोकन करें, एक खुश स्क्रीन नहीं है
- अतिथि समर्थन, हस्ताक्षरित टिकट, बिलिंग केयर, संगठन या ज्ञान हथकराना चुनें।
- व्यक्ति, संगठन, भूमिका और सहायता केंद्र भाषा स्विच करें।
- मोबाइल, बड़े मोबाइल, टैबलेट, लैपटॉप, डेस्कटॉप, चौड़े और अल्ट्रावाइड ब्रेकपॉइंट्स का निरीक्षण करें।
- विरासत में मिली, अतिरिक् त और मानों को रीसेट करें; अनावश्यक ब्रेकपॉइंट दोहराव से बचें।
- रन कीबोर्ड, RTL, कम गति, लोड हो रहा है, खाली, अनुपलब्ध और अनुमति राज्यों।
- समीक्षा से पहले अभिगम्यता, पेलोड, मार्ग, बाध्यकारी और रेंडर निष्कर्षों के लिए टेस्ट लैब का उपयोग करें।
बिना किसी डुप्लिकेट सामग्री के Zendesk-level Help Center का संचालन करें
- श्रेणियों, वर्गों, लेखों, अनुवादों, संलग्नक और टेम्पलेट्स में बनाएँ सहायता केंद्र.
- वहाँ भाषाओं को सक्षम करें; स्थानीयकृत स्लग, खोज, फ़ीड, SEO और लेख क्रोम उसी अधिकार का पालन करते हैं।
- स्टूडियो में, स्थान ज्ञान खोज, श्रेणी / संसाधन ग्रिड, फ़ीड, विषय समझौते, लेख, सामग्री की तालिका, प्रतिक्रिया, संबंधित और पिछले/अतिरिक्त घटक।
- चित्रित, लोकप्रिय और हाल के फीड को कॉन्फ़िगर करें; टिकट प्रवाह में संदर्भ सुझावों का उपयोग करें।
- नो-results, लंबे लेख, अटैचमेंट्स, फीडबैक, वॉच / सदस्यता और टिकट हैंडऑफ़ का पूर्वावलोकन करें।
- प्रकाशन के बाद स्वच्छ स्थानीय मार्गों, कैनोनिकल / hreflang, संरचित डेटा और कैश अमान्यता को सत्यापित करें।
साइन-इन को सुरक्षित रूप से कॉन्फ़िगर करें
- खुला Identity and organization → _Identity और कम से कम एक संकेत-in पथ सक्षम रखने के लिए।
- डिफ़ॉल्ट विधि, पंजीकरण नीति, सत्र अवधि, SSO_-Domain प्रवर्तन और खोज व्यवहार चुनें।
- दृश्य रूटिंग क्षेत्रों के साथ प्रदाताओं को जोड़ें: प्रकार, डोमेन, प्राथमिकता, प्रस्तुति, सक्षम और सत्यापित राज्य। राज पहचान सबसिस्टम में रहते हैं।
- SCIM_ के लिए, प्रावधान करने में सक्षम, सटीक कार्यस्थल समापन बिंदु की प्रतिलिपि बनाएँ और टोकन को घुमाएं। IdP में एक बार टोकन स्टोर करें।
- मानचित्र दावे और संगठन की सदस्यता, फिर परीक्षण किरायेदार के साथ निर्माण, अद्यतन, समूह सदस्यता और निष्क्रियता का परीक्षण करें।
- प्रकाशन से पहले अतिथि, ग्राहक, प्रतिनिधि संगठन और अवरुद्ध राज्यों का पूर्वावलोकन करें।
पूर्ण समर्थन यात्रा का पालन करें
- प्रत्यक्ष रूप, विज़ार्ड, खोज-पहली, हब या सर्विस डेस्क प्रविष्टि का चयन करें।
- वर्गों और सुलभ फील्ड लेबल के साथ एक नामित, संस्करण अनुरोध फ़ॉर्म बनाएं।
- दृश्य स्थितियों, रूटिंग, SLA और अनुमोदन चरणों का निर्माण; उन्नत JSON केवल समीक्षा की गई डेवलपर परिवर्तन के लिए है।
- सूची, विस्तार, धागा, समयरेखा, लगाव, अनुमोदन, SLA और उत्तर सतहों को कॉन्फ़िगर करें।
- टेस्ट अतिथि तलाश, हस्ताक्षरित अनुरोधों, संगठन दृश्यता, अपलोड विफलता, ईमेल अधिसूचना और ज्ञान विक्षेपण।
- एक ड्राफ्ट सहेजें; केवल मार्ग एडाप्टर और सूचना पथ के बाद प्रीफ़लाइट पास करें।
एक शासित रिलीज के माध्यम से ले जाएँ
- रन सत्यापन और टेस्ट लैब. फिक्सिंग अवरोध निष्कर्ष; संदर्भ के साथ अनुमति चेतावनी स्वीकार करते हैं।
- रिलीज नोट्स और अनुरोध समीक्षा जोड़ें। समीक्षकों ने स्थिर पृष्ठ / नोड पथ पर टिप्पणी की।
- Approvers diff, पूर्वावलोकन यात्रा, अनुमति परिवर्तन और सबूत का निरीक्षण करते हैं।
- पृष्ठभूमि कार्यकर्ता के माध्यम से प्रकाशित या शेड्यूल करें। लेविंग स्टूडियो एक टिकाऊ काम को रद्द नहीं करता है।
- प्रगति, स्वास्थ्य और सहसंबंध आईडी देखें। केवल नौकरी नियंत्रण से ही बंद / रहें।
- महत्वपूर्ण मार्गों, पहचान, टिकट और ज्ञान को सत्यापित करें। आवश्यकतानुसार एक अपरिवर्तनीय पूर्व रिलीज में वापस रोल करें।
| क्षमता | उद्देश्य |
|---|---|
| देखें / संपादित करें | बिना किसी रिलीज प्राधिकरण के ड्राफ्ट का निरीक्षण या परिवर्तन करना। |
| समीक्षा / स्वीकृति | लेखकिता से अलग प्रतिक्रिया और अनुमोदन। |
| अनुसूची / प्रकाशित / रोलबैक | स्वतंत्र उत्पादन नियंत्रण। |
| पहचान / SCIM / प्रवासी / अवयव / निदान | Restrict संवेदनशील विशेषज्ञ संचालन। |
सबूत और एक रास्ता वापस के साथ प्रवास
- प्रदाता ब्लूप्रिंट का चयन करें और एक सूखी रन बनाएं।
- खोजी गई सेटिंग्स, अनमैप्ड मान, सामग्री गिनती और दृश्य समानता कैप्चर की समीक्षा करें।
- सुरक्षित मैपिंग पूरा करें और संरचित diff को फिर से शुरू करें।
- प्रत्येक संरक्षित यात्रा के लिए ड्राफ्ट, मिलान करने वाली गिनती और पूर्वावलोकन पर लागू करें।
- रिकॉर्ड प्राधिकृत स्वीकृति; आयात के दौरान वर्तमान प्रकाशित रिलीज को कभी भी ओवरराइट नहीं किया जाता है।
- शासन के माध्यम से प्रकाशित करें और प्रवास रिपोर्ट, आईडी जारी करने और रोलबैक प्वाइंट को एक साथ रखें।
अनुबंधों का विस्तार, टेम्पलेट्स नहीं
A safe extension registers a stable component type and schema, declares permissions and data needs, renders through the canonical compiler, and supplies deterministic fixtures/tests. Do not query arbitrary tables, inject editor JavaScript into the public Portal, create another article repository, or bypass the release gate.
पोर्टल दस्तावेज़ v2
पृष्ठों में स्थिर नोड्स, स्लॉट्स, गुण, बाइंडिंग, उत्तरदायी ओवरराइड्स, स्थितियां और अभिगम्यता मेटाडाटा शामिल हैं।
घटक रजिस्ट्री
एक अनुबंध स्टूडियो, कम्पाइलर, प्रलेखन, प्रवासन और परिपक्वता जांच को खिलाता है।
डेटा स्रोत रजिस्ट्री
अनुमति-सूचीबद्ध, केवल पढ़ने के लिए, अनुमति-स्किप डीटीओ को मनमाने ढंग से बदल दिया 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 The number of scentre, and the value of a class.
- यदि कोई नया स्रोत अपरिहार्य है, तो इसकी स्थिर परिभाषा, सुरक्षित मैपिंग, अनुमतियां, खाली व्यवहार और पूर्वावलोकन स्थिरता को एक साथ जोड़ दें।
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
ट्रस्ट सीमाओं के अंदर रहना
| सीमा | आवश्यक व्यवहार |
|---|---|
| वर्कस्पेस | विश्वसनीय होस्ट / रूट / सत्र से हल करें, फिर निष्पादन के पहले प्रत्येक पढ़ने और लिखने का दायरा दें। |
| HTML | पोर्टल sanitizer/parser Allowlist का उपयोग करें। अविश्वासित विशेषताओं को कभी नहीं मिला, URLs, CSS या स्क्रिप्ट। |
| पूर्वावलोकन | उसी ओरिजन स्रोत विंडो, हस्ताक्षरित चैनल संस्करण और नॉन्सी की आवश्यकता है। अज्ञात संदेश |
| पहचान | बाहर के दस्तावेजों को गुप्त रखें। SCIM भालू-authenticated, बिना सत्रीय और कार्यक्षेत्र-आधारित है। |
| पैकेज | Traversal, निरपेक्ष पथ, लिंक / विशेष फ़ाइलों को अस्वीकार करें, अभिलेखागार का oversize, checksum/signature mismatch और अज्ञात अनुमतियों. |
| त्रुटियाँ | स्थिर कोड, सुरक्षित संदेश, पुन: प्रयोज्यता, उपचार और सहसंबंध आईडी लौटाएं; लॉग निजी अपवाद सर्वर-साइड। |
| ज्ञान | HelpCenterBridge. कभी भी लेखक या डुप्लिकेट सहायता केंद्र लेख एक विस्तार में नहीं है। |
{
"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.jsonZIP जड़ पर और हर पथ के सापेक्ष रखें। - पहला निरीक्षण करें। इंस्टॉलर कैप अभिलेखागार पर 500 प्रविष्टियां और प्रविष्टियाँ 25 MB निकाले गए; सुरक्षा सत्यापन स्वतंत्र सीमा को जोड़ता है।
- अपेक्षित SHA- सत्यापित करें256 और रिलीज प्रक्रिया में हस्ताक्षर पैकेज।
- एक संस्करण निर्देशिका में स्थापित करें। कभी भी किसी स्थापित संस्करण को जगह में परिवर्तित नहीं किया जाता है।
- स्कीमा परिवर्तन को तोड़ने और अज्ञात संगतता क्षेत्रों को संरक्षित करने के लिए संपत्ति माइग्रेशन प्रदान करें।
- एक ड्राफ्ट में घटक को खोलें, हर राज्य /व्यूपोर्ट / व्यक्तित्व स्थिरता चलाएं और शासन के माध्यम से प्रकाशित करें।
- रोलबैक पूर्व immutable घटक / दस्तावेज रिलीज सक्रिय करता है; अपने reproducibility सबूत को बनाए रखने।
उसी रिलीज हैश पर विस्तार का प्रयास करें
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
स्रोत द्वार आवश्यक हैं, पर्याप्त नहीं। डेटाबेस / प्रवासन संलग्न करें, वास्तविक ब्राउज़र दृश्य, पहचान प्रदाता, प्राधिकरण-अलगावेशन, अभिगम्यता, प्रदर्शन, क़तार/क्रोन, मेल/attachment, बैकअप/रीस्टोर और तैनाती सबूत समान अचल रिहाई हैश के लिए। अज्ञात आवश्यक साक्ष्य जारी होने में विफल होना चाहिए।
- इकाई: स्कीमा, स्वच्छता, डीटीओ आकार, स्थितियां, माइग्रेशन और टाइप्ड विफलताएं।
- अनुबंध: लोडिंग / खाली / आतंक / असफलता, परिपक्वता, स्लॉट्स, बाइंडिंग और एक-प्रेंडरर समानता।
- ब्राउज़र: कीबोर्ड, फोकस, सेमनेटिक्स, RTL, ज़ूम / रिफ्लो, कम गति और हर ब्रेकपॉइंट।
- सुरक्षा: क्रॉस-वर्कस्पेस जांच, जाली कार्रवाई, पैकेज हमले, पूर्वावलोकन स्पूफिंग और गुप्त रिसाव।
- संचालन: टिकाऊ प्रगति, छुट्टी / वापसी, स्टॉप / रिट्री / रिज्यूम, शेड्यूलर हार्टबीट और रोलबैक।
राज्य और सहसंबंध आईडी द्वारा समस्या निवारण
| राज्य | क्या करना है |
|---|---|
| अनुमति | नाम की क्षमता का अनुरोध करें। हिडन यूआई सुविधा है; बैकेंड हमेशा इसे लागू करता है। |
| मान्यता | रिपोर्ट किए गए पृष्ठ / नोड / क्षेत्र को खोलें, इसे सही करें, फिर प्रीफ़लाइट को फिर से शुरू करें। |
| संघर्ष | नवीनतम संशोधन को फिर से लोड करें, परिवर्तनों की तुलना करें और जानबूझकर पुन: लागू करें। कभी भी अधिक लिखने के लिए मजबूर नहीं होता है। |
| ऑफलाइन / पुन: प्रयोज्य | ड्राफ्ट को रखें, कनेक्टिविटी बहाल करें, कार्रवाई के माध्यम से पुनः प्रयास करें और टिकाऊ नौकरी की स्थिति सत्यापित करें। |
| Fal / 0 | समर्थन के लिए सहसंबंध आईडी और टाइमस्टैम्प की प्रतिलिपि बनाएँ। कभी भी रहस्यों या निजी अपवाद पाठ को पेस्ट न करें। |
| प्रकाशित करना विफल | निरीक्षण प्रीफ़लाइट/जैसा उत्पादन, केवल पुन: प्रयोज्य चरणों को फिर से प्राप्त करें, या अंतिम स्वस्थ रिलीज में वापस रोल करें। |
| SCIM 401/403 | एंडपॉइंट / वर्कस्पेस, बियरर टोकन, सक्षम स्टेट और रोटेशन की पुष्टि करें; कभी भी ब्राउज़र सत्र कुकी का उपयोग नहीं करते। |
| ज्ञान कहानी है | सहायता केंद्र में स्थानीयकरण की पुष्टि करें, फिर कैश अमान्यता और स्वच्छ स्थानीयकृत मार्ग का निरीक्षण करें। |
यह गाइड प्रिंट-ready है। प्रिंट → सेव के रूप में प्रयोग करें PDF एक नियंत्रित ऑफ़लाइन प्रतिलिपि के लिए।