Víš, co Studio vlastní
Portal Studio vlastní mušle, která je určena pro zákazníky: stránky, umístění komponentů, značkové žetony, citlivé chování, navigace, footer, prezentace identity, letenky a výjezdy. Centrum nápovědy vlastní jazyky, kategorie, sekce a obsah článku. Studio spotřebovává tento obsah přes chráněný most; nikdy nevytváří druhý obchod s články.
Kompletní připravenost před hlubokým budováním
- Otevřít Portálový ateliér → Začít → Reakční.
- Potvrďte kanonickou adresu portálu a otevřete ji v samostatném záložce.
- Nastavte logo, ikonu prohlížeče, dotykovou ikonu, sociální image a barvu motivu.
- Potvrďte Jazyky centra nápovědy; změňte jazykovou autoritu v centru nápovědy, ne Studio.
- Nastavit navigaci a globální podnik footer.
- Vyberte si cestu a nastavte alespoň jeden formulář žádosti.
- Uchovejte alespoň jeden bezpečný indikátor v metodě aktivní a zhodnotit objevení identity.
- Spustit kvalitu a vytvořit podepsaný náhled podání ruky.
- Vytvořit první regulované vydání po každém blokování položky je jasné.
Procento připravenosti se počítá ze uložených dat pracovního prostoru a stavu náhledu. Výběr položek přímo do jeho vlastnického panelu.
Vybudovat stránky a opakovaně použitelné sekce
- Otevřít Vybudovat → Stránky a vyberte chráněnou systémovou stránku nebo vytvořte vlastní stránku.
- Nastavte trasu, název, přístupový režim a místní chování. Chráněné systémové trasy nelze smazat.
- Otevřít Součásti, filtrovat podle práce nebo splatnosti a umístit složku do kompatibilní slot.
- Pro obsah, vzhled, vazbu, viditelnost a dostupnost použijte inspektora.
- Používejte opakovaně použitelné vzory pro opakované struktury; udržujte organizaci nebo rozdíly značky ve variantách.
- Uložit návrh a cvičení zatížení, prázdné, chyba, host a znaménko -ve stavu v náhledu.
Prohlédněte si skutečné cesty, ne jednu šťastnou obrazovku
- Vyberte si podporu hosta, znakovou jízdenku, fakturační péči, organizaci nebo předávání znalostí.
- Přepnout personas, organizace, role a Nápověda Center jazyk.
- Prohlédněte mobilní, velké mobilní, tablety, notebook, stolní počítače, široké a ultraširoké body.
- Zkontrolujte zděděné, převrácené a resetované hodnoty; vyhněte se zbytečnému duplikaci zlomu.
- Spustit klávesnici, RTL, reduced- motion, načítání, prázdné, nedostupný a povolení stavy.
- Před přezkoumáním použijte zkušební laboratoř pro dostupnost, užitečné zatížení, trasu, vazbu a výsledky.
Provozujte centrum nápovědy Zendesk- level bez duplikátu
- Vytvořit kategorie, sekce, články, překlady, přílohy a šablony v Centrum nápovědy.
- Povolit jazyky tam; lokalizované kulky, vyhledávání, kanály, SEO a článek chrom sledovat stejný orgán.
- Ve Studiu, umístit vyhledávání znalostí, kategorie / zdroje mřížky, kanály, téma akordeon, článek, tabulka obsahu, zpětná vazba, související a předchozí / další komponenty.
- Nastavit zobrazené, populární a nejnovější kanály; použít kontextové návrhy v proudech tipu.
- Náhled na žádné výsledky, dlouhé články, přílohy, zpětná vazba, hodinky / předplatné a předání vstupenek.
- Po zveřejnění ověřte čisté locale trasy, kanonický / heflang, strukturované údaje a cache neplatnost.
Nastavit signál bezpečně
- Otevřít Identita & organizace → Identity a udržet alespoň jeden signál v cestě zapnutý.
- Vyberte výchozí metodu, registrační pravidla, dobu trvání sezení, SSO-Dominální prosazování a objevování chování.
- Přidat poskytovatele s vizuálním směrovacím polem: typ, domény, priorita, prezentace, zapnutý a ověřený stav. Tajemství zůstávají v subsystému identity.
- Pro SCIM, zapněte zásobování, kopírujte přesný koncový bod pracovní plochy a otočte token. Uložte jednočasový token v IDP.
- Mapové nároky a členství v organizaci, poté test vytvořit, aktualizovat, skupinové členství a deaktivace s testovacím nájemníkem.
- Náhled host, zákazník, delegovaná organizace a blokované stavy před zveřejněním.
Sestavit kompletní podpůrnou cestu
- Vyberte přímý formulář, průvodce, search- first, hub nebo service- desk vstup.
- Vytvořte si pojmenovaný formulář s žádostí o verzi s oddíly a přístupnými polem.
- Vybudovat vizuální podmínky, směrování, SLA a schvalovací kroky; pokročilé JSON je pouze pro revidované změny vývojáře.
- Nastavit seznam, detail, vlákno, časová osa, připojení, schválení, SLA a odpovědět povrchy.
- Test host vyhledávání, signed- in požadavky, viditelnost organizace, nahrávání selhání, e-mailové oznámení a znalosti deflekci.
- Uložit návrh; zveřejnit pouze po přeletu traťového adaptéru a notifikační cesty.
Přesunout přes regulované uvolnění
- Spustit validaci a zkušební laboratoř. Opravit blokování zjištění; potvrdit povolená varování s kontextem.
- Přidat poznámky k vydání a žádost o přezkoumání. Recenze komentář na stabilní stránky / uzel cesty.
- Příchozí kontrolují rozdíly, ukázkové cesty, změny povolení a důkazy.
- Publikovat nebo rozpis přes pracovník pozadí. Opuštění Studio nezruší trvalou práci.
- Sledujte pokrok, zdravotní a korelační ID. Stop / retry pouze z kontroly práce.
- Ověřte kritické trasy, identitu, jízdenky a znalosti. Přejeďte zpět na neměnné předchozí vydání, pokud je to nutné.
| Schopnost | Účel |
|---|---|
| Zobrazit / Upravit | Prohlédněte nebo změňte návrhy bez povolení k uvolnění. |
| Přezkum / schválení | Oddělená zpětná vazba a schválení od autorů. |
| Harmonogram / publikovat / Rollback | Nezávislé kontroly výroby. |
| Identita / SCIM / Migrate / Components / Diagnostics | Omezte citlivé specializované operace. |
Migrovat s důkazy a cestou zpět
- Vyberte plán poskytovatele a vytvořte suchý běh.
- Recenze objevených nastavení, nemapovaných hodnot, počtu obsahu a vizuálních paritních zachycení.
- Kompletní bezpečné mapování a přesměrování strukturovaného rozdílu.
- Aplikujte na návrh, sladit počty a náhled každé chráněné cesty.
- Zaznamenejte autorizované přijetí; nikdy nepřepište aktuální zveřejněné vydání během dovozu.
- Publikovat prostřednictvím správy a udržet zprávu o migraci, uvolnění ID a převrácení bod dohromady.
Rozšiřují se smlouvy, nikoli šablony
Bezpečné rozšíření registruje stabilní typ a schéma komponent, prohlašuje povolení a potřeby dat, propouští kanonický kompilátor, a dodává deterministické přípravky / testy. Nedotazovat libovolné tabulky, vstřikovat editor JavaScript do veřejného portálu, vytvořit jiný článek úložiště, nebo obejít uvolňovací bránu.
Portálový dokument v2
Stránky obsahují stabilní uzly, sloty, vlastnosti, vazby, responsibilní přejetí, podmínky a metadata přístupnosti.
Registr součástí
Jedna smlouva obsahuje Studio, kompilátor, dokumentace, migrace a kontroly zralosti.
Registr zdrojů dat
Přípustné, pouze pro čtení, povolení-oskenované DTOs nahrazují svévolné SQL nebo dynamické akce.
Jeden posel
Náhled a veřejná tvorba akcií, sanace, rozpočty a runtime států.
Definovat balíček komponentů
Použijte malý jmenný prostor ID a sémantické verze. Dodávejte jak názvy vlastností kompatibility, které jsou uvedeny, protože kontrola balíku a validace bezpečnosti provádějí nezávislé kontroly.
{
"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}
}
Tvar uzlu
{
"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"}
}
- Průkazy jsou stabilní v celém rozsahu úprav a migrace.
- Vlastnosti odmítají nehlášená pole a nebezpečné HTML.
- Každý pohled vázaný na data definuje výstup načítání, prázdno, oprávnění a chyby.
- Kontejnerové komponenty pojmenují své sloty; listy nemohou přijmout svévolné děti.
- Mark Scetence upřímně: plánované bloky, beta varuje, GA vyžaduje plné důkazy.
Používejte povolení-bezpečné DTOs
- Vyberte stávající tečkované ID, jako je
tickets.mine,knowledge.featurednebocustomer.profile. - Vazba pouze pole deklarovaná jeho verzí DTO. Neznámé zdroje selhávají
data_source.unknown. - Projděte autorizovaným Portálem; nikdy nepřijímejte pracovní prostor / zákaznickou identitu z nedůvěryhodné vlastnosti.
- Mezní hodnoty seznamu jsou uchyceny1–100 Normalizace pohanění, lokalizace a vyhledávací hodnoty.
- Pokud je nový zdroj nevyhnutelný, přidejte jeho stabilní definici, bezpečné mapování, oprávnění, prázdné chování a náhled fixture společně.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
Zůstaň uvnitř hranic důvěry.
| Hranice | Požadované chování |
|---|---|
| Pracovní prostor | Vyřešte z důvěryhodného hostitele / trasa / relace, pak proveďte každé čtení a zapište před provedením. |
| HTML | Používejte Portal Sanitizer / Parser allowlist. Nikdy konkatetovat nedůvěryhodné atributy, URLs, CSS nebo scénář. |
| Náhled | Vyžadovat stejné zdrojové okno, podepsanou verzi kanálu a non. ignorujte nevyžádané zprávy. |
| Identita | Udržet tajemství mimo dokumenty. SCIM je nositelem-ověřené, sessionless a pracovní prostor-vázána. |
| Balení | Zamítněte průchod, absolutní cesty, odkazy / speciální soubory, nadrozměrné archivy, kontrolní součet / podpis nesoulad a neznámá oprávnění. |
| Chyby | Vrátit stabilní kód, bezpečné zprávy, retryable, sanace a korelace ID; log soukromé výjimky serverside. |
| Znalosti | Přečtěte si přes HelpCenterBridge. Nikdy autor nebo duplikát Help Center články v prodloužení. |
{
"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"}
}
}
Prohlédněte, nainstalujte a upgradujte atomicky
- Put
component.jsonu kořene ZIP a udržujte každou cestu relativní. - Proveďte inspekci jako první. Instalátor uzamkne archivy na 500 záznamy a 25 MB extrahováno; validace bezpečnosti přidává nezávislé limity.
- Ověřte očekávaný SHA-256 a podpis balíčku v procesu uvolnění.
- Nainstalujte do adresáře s verzí. Nikdy nezmutujte nainstalovanou verzi na místě.
- Poskytněte immigraci majetku pro prolomení změn schématu a zachovat neznámé pole kompatibility.
- Otevřete složku v návrhu, spusťte každý stát / viewport / persona fixture a zveřejněte prostřednictvím správy.
- Převrácení aktivuje předchozí shodné vydání součásti / dokumentu; ponechá si důkazy o reprodukovatelnosti.
Prokázat rozšíření na stejné vydání hash
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
Zdrojové brány jsou nezbytné, nestačí. Připojte databázi / migraci, real-browser vizuální, identifity-provider, autorizace- izolace, dostupnost, výkon, fronta / cron, mail / příloha, zálohování / obnovení a nasazení důkazů ke stejnému neměnnému uvolnitelného hash. Neznámý požadovaný důkaz musí být vyřazen.
- Jednotka: schéma, dezinfekce, tvar DTO, podmínky, migrace a selhání na stroji.
- Smlouva: nakládka / prázdné / chyba / úspěch, splatnost, sloty, vazby a jednosměrná parita.
- Prohlížeč: klávesnice, ostření, sémantika, RTL, zoom / reflow, snížený pohyb a každý bod zlomu.
- Bezpečnost: sondy pro mezipracovní prostory, padělání akcí, útoky balíčků, ukázka podfuku a tajného úniku.
- Operace: trvalý pokrok, dovolená / návrat, stop / retry / return, srdeční tep a zpětný chod.
Potíže podle stavu a korelace ID
| Stát | Co dělat |
|---|---|
| Povolení | Požadujte pojmenované schopnosti. Skryté UI je pohodlí; backend vždy podporuje. |
| Ověření | Otevřete stránku / uzel / pole, opravte to, pak znovu zadejte předlet. |
| Konflikt | Obnovit nejnovější revizi, porovnat změny a použít záměrně. Nikdy vynutit přepsat. |
| Offline / opakovatelné | Udržujte návrh, obnovte konektivitu, znovu se pokuste prostřednictvím akce a ověřte trvalý stav práce. |
| Smrtelné / nedostupné | Kopírovat korelaci ID a časový razítko pro podporu. Nikdy vložte tajemství nebo soukromý text výjimky. |
| Publikovat selhalo | Zkontrolujte výstup před letem / zaměstnání, zkuste pouze retestovatelné fáze, nebo se vraťte zpět do posledního zdravého vydání. |
| SCIM 401/403 | Potvrdit koncový / pracovní prostor, znamení nositele, stav a rotaci; nikdy nepoužívejte prohlížeč session cookie. |
| Znalosti jsou zatuchlé. | Ověřte lokalizaci / publikaci v Pomocném centru, pak zkontrolujte zrušení cache a čistou lokalizovanou trasu. |
Tento návod je print- ready. Použijte Print → Uložit jako PDF pro řízenou offline kopii.