Tudd, mi a stúdió tulajdona.
A Portal Studio a vásárlói arculathéjat birtokolja: oldalak, komponensek elhelyezése, márka zsetonok, reagáló viselkedés, navigáció, lábszár, identitás prezentáció, jegyutak és kiadások. A Súgó Központ nyelveket, kategóriákat, szekciókat és cikktartalmat birtokol. A stúdió ezt a tartalmat egy védett hídon keresztül fogyasztja; soha nem hoz létre egy második cikk áruházat.
Teljes készültség, mielőtt mélyebbre süllyednénk
- Megnyitás Portal Studio → Kezdés → Readiness.
- Erősítse meg a kanonikai portálcímet, és nyissa meg külön lapon.
- A logó, a böngésző ikon, az érintőikont, a társadalmi képet és a téma színét kell beállítani.
- Erősítse meg a Súgó Központ nyelveit; a Súgóközpont nyelvi felhatalmazását, nem a Studio-t.
- A navigáció és a globális vállalati lábléc beállítása.
- Válasszon egy menetjegyet, és állítsa be legalább egy kérési űrlapot.
- Legalább egy biztonságos jelszót tartson fenn a módszerben, és vizsgálja felül az azonosság felfedezését.
- Futtasd le a Minőség és az aláírt előzetes kézfogás.
- Az első szabályozott kiadás létrehozása után minden blokkoló elem tiszta.
A készenléti százalék a megtakarított munkaterületadatok és az előzetes állapot alapján számítható ki. A termék közvetlen útvonalai közvetlenül a tulajdonosi panelhez kerülnek.
Oldalak és újrahasználható szakaszok építése
- Megnyitás → Oldalak építése és válasszon ki egy védett rendszeroldalt, vagy hozzon létre egy egyedi oldalt.
- Állítsa be az útvonalat, a címet, a hozzáférési módot és a helyi viselkedést. A védett rendszerútvonalakat nem lehet törölni.
- Megnyitás Összetevők, szűrés munka vagy érettség szerint, és helyezzen egy komponenst egy kompatibilis résidő.
- Az ellenőr segítségével a tartalom, megjelenés, kötelező, láthatóság és hozzáférhetőség.
- Használjon újra használható mintákat ismételt struktúrák; tartsa a szervezet vagy márka különbségek változatok.
- A vázlat- és gyakorlási betöltés mentése, üres, hiba, vendég és aláírás az előre látható államokban.
Valódi utazások előre nézése, nem egy boldog képernyőn
- Válassza ki a vendég támogatást, jelezze a jegyen, számlázási ellátás, szervezet vagy tudás átadás.
- Személyek, szervezési, szerepcsere- és help Center nyelv.
- Megvizsgálható mobil, nagy mobil, tabletta, laptop, asztali, széles és ultramodern töréspontok.
- Ellenőrizze az örökölt, felülbírált és reset értékeket; elkerülje a felesleges töréspont átfedéseket.
- A billentyűzet, az RTL, a csökkentett mozgás, a betöltés, az üres, a nem elérhető és az engedély állapota.
- A vizsgálat eredményei a hozzáférhetőség, hasznos teher, útvonal, kötődés és renderer-leletek előtt.
Egy Zendesk- szintű Súgó Központ üzemeltetése a tartalom másolása nélkül
- A kategóriák, szakaszok, cikkek, fordítások, mellékletek és sablonok létrehozása Súgó központ.
- Engedélyezze a nyelvek ott; helyi csigák, keresés, feed, SEO és cikk króm követi ugyanazt a hatóságot.
- A Studio, a hely tudás keresés, kategória / erőforrás hálózatok, feed, téma harmonika, cikk, tartalomjegyzék, visszajelzés, kapcsolódó és korábbi / következő komponensek.
- Beállítások: a megadott, népszerű és friss adatok; kontextuális javaslatok használata jegyáramlások esetén.
- Előnézet no-eredmények, hosszú cikkek, csatolmányok, visszajelzések, óra / előfizetés és a jegy átadás.
- A tiszta helymeghatározási útvonalak, a kanonikai / hreflang, a strukturált adatok és a gyorsítótár érvénytelenítése közzététele után.
A jel- be történő biztonságos beállítás
- Megnyitás Azonosítás és szervezetek → Személyazonosság és legalább egy jelet az úton kell tartani.
- Válassza ki az alapértelmezett módszert, regisztrációs politika, munkamenet időtartama, SSO-domain végrehajtási és felfedezési viselkedés.
- A szolgáltatók hozzáadása vizuális útválasztási mezők: típus, domainek, prioritás, prezentáció, engedélyezett és ellenőrzött állapot. Titkok maradnak az identitás alrendszerben.
- A SCIM-hoz engedélyezheti a feltöltést, másolja le a pontos munkaterület végpontot, és forgassa a token. Az egyszer használatos jelszót tárolja az IdP-ben.
- Térképek és a szervezet tagság, majd teszt létrehozása, frissítése, csoport tagság és deaktiválás egy tesztbérlő.
- Előnézet vendég, ügyfél, delegált szervezet és blokkolt államok közzététele előtt.
A teljes támogató út beállítása
- Válassza ki a közvetlen forma, varázsló, keresés-első, hub vagy szerviz-asztal bejegyzést.
- Hozzon létre egy névhez kötött, változatos kérőlapot szekciókkal és hozzáférhető mezőcímkékkel.
- Építs vizuális feltételeket, útvonal, SLA és jóváhagyási lépések; fejlett JSON csak a felülvizsgált fejlesztői változások.
- A lista, a részlet, a szál, az idővonal, a csatolás, a jóváhagyás, az SLA és a válaszfelületek beállítása.
- Test vendég keresés, aláírás-a kérések, szervezet láthatósága, feltöltési hiba, e-mail értesítés és tudáseltérítés.
- Mentse a vázlatot; csak az útvonal adapter és értesítési út repülés előtt.
Átlépés a szabályozott kioldáson
- Futtasd le a validálást és a tesztlabort. Oldd meg a blokkolási eredményeket; ismerd el a megengedett figyelmeztetéseket kontextussal.
- Hozzáadja a kiadás feljegyzések és kérje felülvizsgálat. Vélemények komment stabil oldal / csomópont utak.
- A jóváhagyók ellenőrzik a diffot, előre néznek útvonalakat, engedélyváltoztatásokat és bizonyítékokat.
- A háttérmunkáson keresztül publikálhat vagy ütemezhet. A stúdióból való kilépéskor nem marad le a tartós munka.
- Figyelje a fejlődést, az egészségügyi és korrelációs azonosítót. Állítsa / próbálja csak a munka ellenőrzése.
- Ellenőrizzék a kritikus útvonalakat, identitást, jegyeket és tudást. Roll vissza egy változhatatlan előzetes kiadás, ha szükséges.
| Képesség | Cél |
|---|---|
| Nézet / Szerkesztés | Vizsgáld meg vagy cseréld ki a tervezeteket engedély nélkül. |
| Felülvizsgálat / jóváhagyás | Külön visszajelzés és jóváhagyás az szerzőtől. |
| Ütemezés / közzététel / visszavonás | Független gyártásellenőrzés. |
| Azonosító / SCIM / Migrát / Összetevők / Diagnosztika | Szigorúan érzékeny speciális műveletek. |
A bizonyíték és a visszaút összekeveredik.
- Válassza ki a szolgáltató tervrajzát, és hozzon létre egy száraz futást.
- Felülvizsgálat felfedezett beállítások, feltérképezetlen értékek, tartalom szám és vizuális paritás rögzítések.
- Teljes biztonságos feltérképezések és újrafuttatni a strukturált diff.
- Alkalmazzon a vázlatra, egyeztesse a számokat, és előre minden védett utat.
- A felvétel engedélyezett elfogadása; soha ne írja felül a jelenlegi közzétett kiadás importálás alatt.
- A Bizottság a következő információkat terjeszti:
A szerződések kiterjesztése, nem sablonok
A biztonságos kiterjesztés regisztrál egy stabil komponens típusa és séma, nyilatkozik engedélyek és adatok igények, rendel keresztül a kanonikai fordító, és szállít determinista rögzítések / tesztek. Ne kérje önkényes táblázatok, fecskendezze szerkesztő JavaScript a nyilvános portálba, hozzon létre egy másik cikk adattár, vagy megkerüli a kiadás kapu.
A v2 portáldokumentum
Az oldalak stabil csomópontokat, résidőket, tulajdonságokat, kötéseket, reagáló felülírásokat, feltételeket és akadálymentesítési metaadatokat tartalmaznak.
Összetevő-nyilvántartás
Egy szerződés táplálja Studio, fordító, dokumentáció, migráció és érettségi ellenőrzések.
Adatforrás-nyilvántartás
A felsorolt, csak olvasható, engedélyezett DTO-k helyettesítik az önkényes SQL vagy dinamikus akciókat.
Egy rendítõ
Előnézet és nyilvános kibocsátás részarány összeállítása, tisztítás, költségvetés és futási idő államok.
Az alkatrészcsomag meghatározása
A csomag ellenőrzése és a biztonsági ellenőrzés független ellenőrzései miatt mind az kompatibilitási tulajdonnevek megjeleníthetők.
{
"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}
}
A csomópont alakja
{
"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"}
}
- A személyazonosság stabil marad a szélsőségesek és a vándorlások között.
- A tulajdonjogok elutasítják a be nem jelentett mezőket és a nem biztonságos HTML-t.
- Minden adatkötõ nézet a betöltést, ürességet, engedélyt és relatitable-error kimenetet határozza meg.
- A konténerek alkotóelemei nevezzék meg résidőiket; a levelek nem fogadhatnak el önkényes gyerekeket.
- Jelölje meg az érettséget őszintén: tervezett blokkok, béta figyelmeztetések, GA teljes bizonyítékot igényel.
Használjon biztonságos DTO-t
- Válasszon ki egy meglévő pontozott azonosítót, mint például:
tickets.mine,knowledge.featuredvagycustomer.profile. - Csak a visszavont DTO által bejelentett mezők tartoznak ide.
data_source.unknown. - A már engedélyezett portálon keresztül soha ne fogadj el munkaterületet / ügyfélazonosságot egy nem megbízható ingatlantól.
- A listahatárok a következők:1–100. Normalizálja a pagináció, lokál és keresési értékek.
- Ha egy új forrás elkerülhetetlen, adja hozzá a stabil definíciót, biztonságos feltérképezést, engedélyeket, üres viselkedés és előnézeti rögzítés együtt.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
Maradj a bizalom határain belül.
| Határidő | Szükséges viselkedés |
|---|---|
| Munkahely | A megbízható host / route / session-től való eltérés, majd a végrehajtás előtt minden olvasást és írást le kell írni. |
| HTML | A Portal Sanitizer / parser allowlist-ot használja. Soha ne egyeztessen megbízhatatlan attribútumokkal, URLs, CSS vagy forgatókönyv. |
| Előnézet | Kérjen azonos eredetű forrás ablak, aláírt csatorna verzió és nace. Ne vegye figyelembe a kéretlen üzenetek. |
| Azonosító | A SCIM -nak nincs semmi köze a dokumentumokhoz. |
| Csomagok | A keresztirányú, abszolút menetvonalak, linkek / speciális fájlok, nagyméretű archívumok, csekk-összeg / aláírás eltérések és ismeretlen engedélyek elutasítása. |
| Hibák | A biztonságos kód, a biztonságos üzenet, a visszahívhatóság, a kármentesítés és a korreláció azonosítója; a privát kivételek naplója szerveroldalas. |
| Ismeret | Olvassa el a HelpCenterBridge. Soha szerző vagy másolat Súgó Center cikkek egy kiterjesztés. |
{
"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"}
}
}
Vizsgálat, telepítés és korszerűsítés atomikusan
- Tedd
component.jsona ZIP gyökérnél, és minden ösvényt relatív szinten tartani. - Az installáló lezárja az archívumot a 500 bejegyzések és 25 MB kivont; a biztonsági ellenőrzés független korlátokat ad.
- Ellenőrizze a várható SHA-256 és csomag aláírás a kiadás folyamat.
- Telepítsd egy verziós könyvtárba. Soha ne mutálj telepített változatot a helyedre.
- Adja meg a tulajdoni vándorlást a tervváltoztatások megtöréséhez, és őrizze meg az ismeretlen kompatibilitási mezőket.
- Az elem megnyitása a tervezetben, futtatás minden állam / nézet / személyiség beállítás és közzététele irányítás.
- A visszaforgatás aktiválja a korábbi, változatlan komponens / dokumentum kiadást; megőrzi reprodukálhatósági bizonyítékait.
Bizonyítsa be a kiterjesztés ugyanazon kiadás 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
A forráskapuk szükségesek, nem elegendőek. Csatolja az adatbázis- / migráció-, real- böngésző vizuális, identit- szolgáltató, engedélyezés- elszigeteltség, hozzáférhetőség, teljesítmény, sor / cron, mail / csatolás, biztonsági mentés / helyreállítás és telepítés bizonyítékot ugyanahhoz a változatlan kiadáshoz. Ismeretlen szükséges bizonyíték kell, hogy sikerüljön a kiadás.
- Egység: séma, fertőtlenítés, DTO forma, körülmények, vándorlás és gépelt hibák.
- Szerződés: betöltés / üres / hiba / siker, érettség, rések, kötések és egyrendűségi paritás.
- Böngésző: billentyűzet, fókuszálás, szemantika, RTL, zoom / reflow, mozgáscsökkenés és minden töréspont.
- Biztonság: kereszteződés, hamis akciók, csomagtámadások, előzetes kémkedés és titkos szivárgás.
- Műveletek: tartós fejlődés, szabadság / visszatérés, stop / retry / revolver, ütemező szívverés és visszaállítás.
Problémamegoldás az állam és a korrelációs azonosító szerint
| Állam | Mit tegyünk? |
|---|---|
| Engedély | Kérje a megnevezett képesség. Rejtett UI kényelem; a backend mindig rögzíti azt. |
| Jóváhagyás | Nyissa meg a jelentett oldalt / csomópont / mező, javítsa ki, majd futtassa újra az előrepülést. |
| Összeütközés | Újratöltjük a legújabb felülvizsgálatot, összehasonlítjuk a változásokat és szándékosan újra alkalmazzuk. |
| Offline / retriable | Megtartja a tervezetet, helyreállítja az összeköttetést, újra megpróbálja a cselekvést, és ellenőrzi a tartós munkahelyet. |
| Végzetes / nem elérhető | Másolja a korrelációs azonosító és időbélyegző támogatást. Soha ne dugja be titkokat vagy privát kivételek szöveget. |
| A kiadvány nem sikerült | Vizsgáljuk meg a repülés előtti / munkahelyi kimenetet, próbáljuk meg újra csak a relaxálható szakaszokat, vagy guruljunk vissza az utolsó egészséges kiadáshoz. |
| SCIM 401/403 | A végpont / munkaterület megerősítése, bemutatótoken, engedélyezett állapot és forgás; soha ne használjon böngésző munkamenet cookie-t. |
| A tudás megrekedt. | Ellenőrizze a helyazonosságot / publikációt a Súgó Központban, majd ellenőrizze a gyorsítótár érvénytelenítését és a tiszta helyi útvonalat. |
Ez az útmutató nyomtatási kész. Használja a Print → Mentés mint PDF egy ellenőrzött offline másolat.