Знайте, що у нас є власні студія
Портал студії володіє оболонкою клієнтів: сторінки, розміщення компонентів, брендові токени, адаптивна поведінка, навігація, нижній колонтитул, презентація ідентичності, подорожі квитків та релізи. Центр Допомоги володіє мовами, категоріями, розділами та змістом статті. Студія споживає цей вміст через захищений міст; він ніколи не створює другого магазину статті.
Повна готовність до будівництва глибоко
- Відкрито Портал студії → Початок → Готовність.
- Підтвердіть адресний портал і відкрийте його в окремій вкладці.
- Настроювання логотипу, іконки браузера, сенсорний значок, соціальний образ і колір теми.
- Підтвердіть довідкові мови Центру; змінити повноваження мови в Центрі допомоги, не Студія.
- Навігація налаштувати та керувати світовим підприємством.
- Виберіть подорож і налаштувати принаймні одну заявку.
- У разі виникнення принаймні одного безпечного входу в метод, який активно та рецензує особистість.
- Якість і встановлення підписаного передогляду рукосми.
- Створіть перший регульований реліз після кожного блокуючого елемента.
Відсоток готовності обчислюється з збережених даних робочого простору та стану попереднього перегляду. Вибір маршрутів пункту безпосередньо до панелі керування власними силами.
Створення сторінок і багаторазових розділів
- Відкрито Побудова → Сторінки і виберіть сторінку захищеної системи або створити на замовлення.
- Встановити маршрут, назву, режим доступу та локальну поведінку. Захищені шляхи системи не можна видаляти.
- Відкрито Комплекти, фільтрувати за допомогою роботи або зрілості і розмістити компонент в сумісному слоті.
- Використовуйте інспектор для контенту, зовнішнього вигляду, зв'язування, видимості та доступності.
- Використовуйте багаторазові візерунки для повторних структур; зберігати організацію або відмінності брендів в варіантах.
- Збережіть проект та навантаження на вправи, порожньою, помилкою, гістьом і підписаними державами в попередньому перегляді.
Переглядайте реальні подорожі, не один щасливий екран
- Підбір гостя, підписаний квиток, супровід векселя, організація або знання ручної роботи.
- Переключити людей, організацію, роль та допомогу
- Перевірте мобільний, великий мобільний, планшет, ноутбук, робочий стіл, широкі та ультраширокі точки прориву.
- Перевірте успадковані, перевантажені та скидання значень; не потрібно розбиття точок дублювання.
- Запуск клавіатури, RTL, знижена емоція, завантаження, порожній, недоступний і дозвільний стан.
- Використовуйте випробувальну лабораторію для доступності, завантаження, маршруту, обов'язкові та рендерні висновки до огляду.
Оперте центр допомоги Zendesk-level без дублікатів
- Створення категорій, розділів, статей, перекладів, вкладення та шаблони у Центр допомоги.
- Увімкнути мови там; локалізовані стропи, пошук, подача, SEO та стаття хромувати слідують за тим же органом.
- In Studio, place knowledge search, category/resource grids, feeds, topic accordion, article, table of contents, feedback, related and previous/next components.
- Налаштуйте показані, популярні та останні корми; використовуйте контекстні пропозиції в потоках квитків.
- Перегляд невідповідностей, довгих статей, вкладення, зворотний зв'язок, годинник/платно та квиток.
- Перевірити чисті маршрути, канонічний/хрефланг, структуровані дані та недійсність кешу після публікації.
Налаштувати знак безпечно
- Відкрито Ідентифікатор та організація → Ідентифікація і тримати принаймні один ввімкнений шлях.
- Виберіть метод за замовчуванням, реєстраційна політика, тривалість сеансу SSO_-domainforce and відкриття поведінки.
- Додайте провайдера з візуальними маршрутами: тип, домени, пріоритет, презентацію, ввімкнено та перевірений стан. Секрети залишаються у підсистемі ідентичності.
- Для SCIM, увімкнути надання, скопіювати точну кінцеву точку робочого простору та обертати токен. Зберігайте одноразовий токени в IdP.
- Заяви на картографію та членство в організації, потім створюйте тести, оновлення, членство групи та деактивація з тестовим завіренням.
- Перегляд гостя, клієнт, делеговані організації та заблоковані стани перед публікаціюм.
Налаштуйте повну подорож підтримки
- Виберіть прямий вигляд, майстер, пошук-перший, hub або сервіс-desk запис.
- Створіть назву, виправданий бланк з розділами та доступні етикетки поля.
- Створіть візуальні умови, маршрутизація, SLA та затвердження кроків; розширений JSON призначений для перегляду змін розробника тільки.
- Налаштуйте список, деталь, нитка, часовий ряд, вкладення, затвердження, SLA та відповідь поверхонь.
- Тестування гостьового пошуку, підписаних запитів, видимість організації, відмова завантаження, повідомлення електронної пошти та дефлекція знань.
- Заощаджуйте проект, опишіть тільки після маршрутного адаптера і пропустіть повідомлення.
Перемістити через обмежений реліз
- Виконувати затвердження та тестування лабораторії. Виправлення результатів блокування; визнання дозволених повідомлень з контекстом.
- Додати випуск ноти та огляд запиту. Коментар рецензентів на стабільну сторінку / шляхах безводних.
- Затвердження перевіряють дифу, попередню подорож, зміни дозволу та докази.
- Ви можете замовити послугу з підбору персоналу або графіку.
- Стоп/ретрита тільки від контрольних завдань.
- Перевірити критичні маршрути, ідентичність, квитки та знання. Повернути до незмінного попереднього релізу при необхідності.
| Можливість | Мета |
|---|---|
| Перегляд / редагування | Перевірка або зміна проектів без повноважень вивільнення. |
| Огляд / Затвердження | Відокремити відгуки та затвердження від автора. |
| Розклад / Публікація / Роллбек | Незалежні виробничі елементи. |
| Ідентифікатор / SCIM / Міграція / Компоненти / Діагностика | Обмеження чутливих спеціалістів. |
Зігніть з доказами і назад
- Виберіть постачальника синтека і створити сухий пробіг.
- Переглядайте відкриті налаштування, незрівняні значення, кількість вмісту та захоплення візуальної пари.
- Повна безпечна картографування і перевипуск структурованого дифуду.
- Застосувати до проекту, розвідувальних та прев’ю кожного захищеного подорожі.
- Запис авторизованого прийняття; не перезаписати поточний опублікований випуск при імпорті.
- Попри те, що уряд і зберегти звіт про міграцію, випустити ID та розкачати точку разом.
Розширені контракти, не шаблони
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
Сюжети містять стабільні вузли, слоти, властивості, обов'язки, чуйні перенади, умови та метадані доступності.
Реєстр компонентів
Один контракт живить студію, компілятором, документацією, контрольним та строковим навантаженням.
Реєстр даних
Допускається розміщення з дозволом на DTOS заміну довільного SQL або динамічних дій.
Один рендер
Перегляд та збір публічних даних, дезінфекція, бюджети та штати runtime.
Визначення компонентного пакету
Використовуйте нижню назву, що знаходиться в полі, ідентифікацію та визначення безпеки.
{
"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.
- Кожен вид даних визначає завантаження, порожній, дозвіл та ретривалий вихід.
- Складові контейнерів ім'я своїх слотів; листя не можуть приймати довільні діти.
- Відзнаки зрілості чесно: планові блоки, бета попереджає, ГА вимагає повного доказу.
Використовуйте дозвіл-безпечні ДТО
- Виберіть існуючий пунктовий ідентифікатор, такий як
tickets.mine,knowledge.featuredабоcustomer.profile. - Визначені джерела не здаються
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 або скрипт. |
| Рецензія | Вимагати одноголовне вікно, підписане версія каналу і неспроможність. Ігнорувати повідомлення нескольчено. |
| Зручність | Keep secrets outside documents. SCIM is bearer-authenticated, sessionless and workspace-bound. |
| Пакети | Відхилити траверсал, абсолютні доріжки, посилання/спеціальні файли, перезавантажити архіви, контрольно-транспортні засоби та нездатні дозволи. |
| Помилка | Повернути стабільний код, безпечне повідомлення, ретривалість, переспрямування та кореляційний ідентифікатор; лог приватні винятки сервера-за межами. |
| Знання | Читать через 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.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
Джерела залом необхідно, не достатні. Прикріпити базу даних/міграцію, візуальний реальний брови, ідентичність-провідувач, авторизація-ізоляція, доступність, продуктивність, чергування/крон, поштову пошту/розгортання, резервне копіювання/відновлення та розгортання доказів до того ж імітованого релізу hh. Невідомо необхідні докази повинні бути невдалими.
- Блок: schema, санітарія, DTO форма, умови, міграції та типовані збої.
- Договір: завантаження/порожнення/корпора/настройка, зрілість, слоти, зв'язки та одностороння парність.
- Браузера: клавіатура, фокус, семантика, RTL, збільшення / переповнення, зменшення руху і кожен пункт прориву.
- Безпека: крос-платформні зонди, ковані дії, пакунки, попадання попереднього перегляду та секретний виток.
- Операції: міцний прогрес, залишок/повернення, зупинки/відведення/розум, графік роботи серця і розгортання.
Виправлення несправностей державним та кореляційним ідентифікатором
| АД | Що робити |
|---|---|
| Проживання | Запит на ім'я можливості. Прихована UI зручність; задня завжди її виконує. |
| Введення | Відкрийте сторінку, яку ви можете переглянути. |
| Конфлікт | Перевантажити останні версії, порівняти зміни та повторювати навмисно. Ніколи не змусимо перезаписувати. |
| Оффлайн / їстівний | Зберігати проект, відновити підключення, перейматися через дію і перевірити міцний стан роботи. |
| Жири / 1.00 | Скопіюйте ідентифікатор кореляції та часовий збір для підтримки. Ніколи не вставте секрети або текст приватного винятку. |
| Не вдалося | Огляньте попередній набір / продуктивність, тільки переробні стадії або закочуйте назад до останнього здорового релізу. |
| SCIM 401/403 | Підтвердіть кінцеву точку / робоче місце, ведмедя токена, ввімкнений стан і обертання; ніколи не використовуйте cookie-файл для сеансу браузера. |
| Знання – стебл | Визначте місцеве / публічне право в Центрі допомоги, потім перевірте недійсність кешу та чистий локалізований маршрут. |
Цей посібник є друком. Використовуйте Друк → Зберегти як PDF для контрольованої офлайн-копії.