Знаеш ли какво притежава Студио
Портал студио притежава клиентско-обличителната обвивка: страници, компонентно поставяне, маркови символи, отзивчиво поведение, навигация, подметка за самоличност, представяне на билети и релийзи. Центърът за помощ притежава езици, категории, секции и съдържание на статии. Студиото консумира това съдържание чрез защитен мост; никога не създава втори магазин за статии.
Пълна готовност преди да се изгради дълбоко
- Отваряне Портал студио → Начало → Готовност.
- Потвърдете адреса на каноничния портал и го отворете в отделен раздел.
- Задайте логото, иконата на браузъра, докоснете икона, социален образ и цвят на темата.
- Потвърдете Help Center езици; промяна езиков орган в Центъра за помощ, а не студио.
- Настройване на навигацията и глобалния предприемач.
- Изберете билет пътуване и конфигурирайте поне една заявка форма.
- Съхранявайте поне един безопасен метод за влизане активен и преглед на откриването на самоличността.
- Стартирай Качеството и установи подписаното ръкостискане.
- Създаване на първото регулирано освобождаване след всеки блокиращ елемент е ясно.
Процентът на готовност се изчислява от записани данни за работното пространство и състояние на преглед. Избиране на маршрут директно към своя панел.
Изграждане на страници и повторно използване секции
- Отваряне Изграждане → Страници и изберете защитена системна страница или да създадете обичайна страница.
- Задаване на маршрут, заглавие, режим на достъп и поведение на място. Защитените системни пътища не могат да бъдат изтрити.
- Отваряне Компоненти, филтър по работа или зрялост, и да постави компонент в съвместим слот.
- Използвайте инспектора за съдържание, външен вид, свързване, видимост и достъпност.
- Използвайте повторно използваеми модели за повтарящи се структури; поддържайте организацията или разликата в марката варианти.
- Запис на проекта и упражнение зареждане, празен, грешка, гост и записани в състояния в preview.
Преглед на реални пътувания, нито един щастлив екран
- Изберете подкрепа за гости, подписан билет, грижа за фактуриране, организация или предаване на знания.
- Превключване персонажи, организация, роля и Help Center език.
- Огледайте мобилните, големи мобилни, таблети, лаптоп, десктоп, широки и ултрашироки гранични пунктове.
- Проверка на наследени, пренаселени и нулирани стойности; избягване на ненужните точки дублиране.
- Пусни клавиатурата, RTL, намалена скорост, зареждане, празно, недостъпно и с разрешение.
- Използвайте тестовата лаборатория за достъпност, полезен товар, маршрут, свързване и извършване на констатации преди преглед.
Управление на Център за помощ Zendesk ниво без дублирано съдържание
- Създаване на категории, раздели, статии, преводи, прикачени файлове и шаблони в Център за помощ.
- Включване на езици там; локализирани плужеци, търсене, фуражи, SEO и статия хром следват една и съща власт.
- В Студио, поставете търсене на знания, категория / ресурси мрежи, емисии, тема акордеон, статия, таблица на съдържанието, обратна връзка, свързани и предишни/следващи компоненти.
- Настройване на функции, популярни и скорошни емисии; използвайте контекстуални предложения в потоците билети.
- Преглед на резултатите, дълги статии, прикачени файлове, обратна връзка, часовник/ Абонамент и фиш за предаване.
- Проверете чистите локални маршрути, каноничния/хрефланг, структурирани данни и кеш-ове в невалидност след публикуване.
Настройване на безопасно въвеждане
- Отваряне Идентичност и организации → Идентификация и да поддържа поне един вход включен.
- Изберете метод по подразбиране, политика за регистрация, продължителност на сесията, SSO- Главно управление и поведение на откритието.
- Добавете доставчици с визуални полета за маршрутизиране: тип, домейни, приоритет, представяне, активирано и проверено състояние. Тайните остават в подсистемата за идентичност.
- За SCIM, да се даде възможност за предоставяне, копирайте точната крайна точка на работното пространство и завъртете жетон.
- Карта вземания и организация членство, след това тест създавате, актуализирате, членство в група и изключване с тест наемател.
- Преглед на гостите, клиентите, делегираните организации и блокираните държави преди публикуване.
Композирайте пълното поддържащо пътуване
- Изберете директна форма, магьосник, първо търсене, хъб или сервизно бюро.
- Създаване на именна, версия на формуляр за заявка с раздели и достъпни етикети.
- Build visual conditions, routing, SLA and approval steps; advanced JSON is for reviewed developer changes only.
- Configure list, detail, thread, timeline, attachment, approval, SLA and reply surfaces.
- Тест гост проверка, записани в заявки, организация видимост, качване на неуспех, имейл уведомление и отклонение на знанията.
- Запис на проект; публикувайте само след като адаптера за маршрута и път за уведомяване премине преди полета.
Преминаваме през контролирано освобождаване
- Стартирайте валидирането и тестовата лаборатория. Поправете блокиращите констатации; потвърдете разрешените предупреждения с контекст.
- Добави бележки за освобождаване и искане преглед. Reviewers коментират стабилни страници / анод пътеки.
- Одобрените инспектират диференциала, превю пътуванията, промените в разрешението и доказателствата.
- Издателство или график чрез фоновия работник.
- Гледайте напредъка, здравето и корелационното разпознаване.
- Проверете критични маршрути, идентичност, билети и знания.
| Възможност | Цел |
|---|---|
| Изглед / Редактиране | Преглед или промяна на проекти без освобождаване орган. |
| Преглед / Одобряване | Отделете обратна връзка и одобрение от авторството. |
| График / Издателство / Обратна връзка | Независим контрол на производството. |
| Самоличност / SCIM / Миграция / Компоненти / Диагностика | Ограничи чувствителните специализирани операции. |
Мигирайте с доказателства и път назад
- Изберете план на доставчика и да се създаде сух пробег.
- Преглед на открити настройки, нематографирани стойности, брой съдържание и визуални париоценъчни улови.
- Пълна безопасна карта и повторно да се повтаря структурирана diff.
- Кандидатствайте за проект, съгласувайте броя и прегледайте всяко защитено пътуване.
- Запис на разрешено приемане; никога не презапишете текущото публикувано съобщение по време на внос.
- Публикувайте чрез управление и поддържайте доклада за миграцията, пуснете ID и rollback точка заедно.
Разширяване на договорите, а не шаблони
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
Страниците съдържат стабилни възли, слотове, свойства, подвързвания, реагиращи настройки, условия и метаданни за достъпност.
Регистър на компонентите
Един договор подхранва студио, компилатор, документация, миграция и проверка на падеж.
Регистър на източника на данни
Включени, само за четене, позволени DTO заместват произволно SQL или динамични действия.
Един превод
Преглед и компилация на публични акции, саниране, бюджети и състояния за изпълнение.
Определяне на компонентен пакет
Използвайте имена с малки букви ID и семантична версия. Доставяйте както имената на имотите за съвместимост, показани, защото пакетната проверка и валидирането на сигурността извършват независими проверки.
{
"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 изисква пълно доказателство.
Използване на защитени DTO
- Изберете съществуващ пунктиран ID като
tickets.mine,knowledge.featuredилиcustomer.profile. - Завържете само полетата, декларирани от версията DTO. Неизвестни източници не успяват с
data_source.unknown. - Преминете вече позволения Портал контекст; никога не приемайте работното пространство/клиент за самоличност от непроверен имот.
- List limits are clamped to 1–100. Normalize pagination, locale and search values.
- Ако нов източник е неизбежен, добавете неговата стабилна дефиниция, безопасно картиране, разрешения, празно поведение и превю заедно.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
Стой в границите на доверието.
| Гранична стойност | Изисквано поведение |
|---|---|
| Работно пространство | След това се преоткрива от доверения домакин/път /сесийство, след което огледайте всяко четене и писане преди изпълнение. |
| HTML | Използвайте порталния стерилизатор/позволяващия списък. URLs, CSS или сценарий. |
| Преглед | Изискване на прозорец източник със същия произход, подписана версия канал и nonce. Игнорирайте непоискани съобщения. |
| Идентификация | Keep secrets outside documents. SCIM is bearer-authenticated, sessionless and workspace-bound. |
| Пакети | Отхвърляне на траверсите, абсолютните пътища, връзките/специалните файлове, оразмеряване на архивите, контролния център/подписа и неизвестни разрешения. |
| Грешки | Връщане на стабилен код, безопасно съобщение, възможност за повторно използване, възстановяване и корелационно ID; записвайте лични изключения сървър-страна. |
| Познания | Прочетете чрез HelpCenterBridge. Никога не автор или дублирайте Helpe Center статии в разширение. |
{
"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 и пакетния подпис в процеса на освобождаване.
- Инсталирайте в версия директория. Никога не мутирайте инсталирана версия на място.
- Осигурете имоти миграция за прекъсване на промени схема и да запази неизвестни полета съвместимост.
- Отворете компонента в чернова, стартирайте всяко държавно/изгледно/лицейско устройство и го публикувайте чрез управление.
- Rollback активира предварително непробиваемия компонент/документ за освобождаване; запазва своите възпроизводими доказателства.
Докаже разширението на същото освобождаване хашиш
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
Прикрепете база данни/миграция, визуалния, доставчик на лични данни, достъпа до разрешения, ефективността, опашката/крона, пощата/прилепването, архива/резервацията и внедряването на доказателства за същата непроменлива версия. Неизвестните необходими доказателства трябва да не успеят да бъдат освободени.
- Единица: схема, саниране, DTO форма, условия, миграция и типови неуспехи.
- Договор: товарене/празна/поръчка/успех, матуритет, слотове, подвързвания и еднопоточни пари.
- Броузър: клавиатура, фокус, семантика, RTL, увеличение/рефлуб, намалено движение и всяка точка на прекъсване.
- Охрана: междуработни космически сонди, фалшиви действия, пакетни атаки, превю измами и тайно изтичане.
- Операции: траен напредък, отпуск/завръщане, стоп/ретри/препоемане, графикен пулс и обратно.
Отстраняване по състояние и идентификационен код на съответствието
| Държава | Какво да правя? |
|---|---|
| Разрешение | Скритият UI е удобство, а бекендът винаги го налага. |
| Утвърждаване | Отворете страницата/свързващото поле, коригирайте я и след това преполетете. |
| Конфликт | Презареди последната ревизия, сравни промените и отново приложи умишлено. |
| Офлайн / рестартиран | Поддържане на проекта, възстановяване на свързаността, повторно се опита чрез действието и проверка на трайно състояние на работа. |
| Фатален / недостъпен | Копирайте ID на съответствието и дата за поддръжка. Никога не поставяйте тайни или личен текст изключение. |
| Публикуването е неуспешно | Проверете предварителното/работното изпълнение, опитайте само повторно опитни етапи, или се върнете към последното здравословно освобождаване. |
| SCIM 401/403 | Потвърдете крайната точка/работното пространство, showder signum, активирано състояние и ротация; никога не използвайте бисквитка за сесия на браузъра. |
| Знанието е остаряло | Проверете местоположението/публиката в Центъра за помощ, след това проверете кеш-а за анулиране и чистия локализиран маршрут. |
This guide is print-ready. Use Print → Save as PDF for a controlled offline copy.