# Порталы и виджеты — Решение проблем

Типовые проблемы порталов и виджетов и их решение. Разделы организованы по типам проблем: виджеты, порталы, новости, пространства, JS-вставки, дашборды, смарт-действия и инфраструктура. Для каждой проблемы указаны симптом, что проверить и решение.

**Как пользоваться этим документом**

Секции организованы по типам проблем. Для каждой:

1. **Симптом** — что описывает пользователь
2. **Что проверить** — шаги диагностики
3. **Решение** — что сделать
4. **Когда обращаться в поддержку 1Ф** — если проблему не удаётся решить на месте

---

## 1. Виджеты — Таблица

**1.1 HTML-теги не обрабатываются / отображаются как текст**

**Симптом:** «в виджете Таблица перестали обрабатываться html-теги», «символы < и > не отображаются, текст пропадает».

**Что проверить:**

- Версия системы — после обновления могло измениться поведение экранирования HTML
- Настройки виджета — включена ли опция отображения HTML в ячейках
- Содержимое ячеек — не используются ли спецсимволы `<`, `>` без экранирования

**Когда обращаться в поддержку 1Ф:** если после обновления HTML перестал рендериться — баг.

**1.2 Фильтры в виджете не работают**

**Симптом:** «в фильтре виджета не отображается выбранный параметр», «не удаляются параметры фильтрации», «настройка фильтра на виджете».

**Что проверить:**

- Тип фильтра — стандартный или пользовательский (хранимая процедура)
- Параметры фильтра — совпадают ли типы данных
- Версия системы

**1.3 Не переносится текст / не применяются настройки отображения**

**Симптом:** «чекбокс "Переносить текст на другую строку" не применяется».

**Что проверить:**

- Версия системы
- Ширина колонки — не фиксирована ли
- Кеш — обновить страницу

**1.4 Закрепление колонок**

**Симптом:** «можно ли закрепить первые N колонок в виджете Таблица?»

**Решение:** стандартной настройки закрепления колонок нет. Возможна доработка.

**1.5 Не выгружается Excel из портала**

**Симптом:** «не работает выгрузка в Excel из виджета / из портала».

**Что проверить:**

- Хранимая процедура виджета — не возвращает ли ошибку
- Объём данных: выгрузка ограничена настройкой `MaxExcelExportRows` (по умолчанию 50000 строк). При превышении вместо файла возвращается ошибка «Max rows to export: N» — это штатное поведение, а не сбой; уменьшите выборку фильтрами или поднимите значение ключа
- Права пользователя на экспорт

**1.6 Виджет-таблица или кастомная иерархия не грузит данные на PostgreSQL (ошибка `0A000`)**

**Симптом:** при открытии виджета-таблицы или кастомной иерархии — ошибка вида `0A000: cross-database references are not implemented: dbo.custom.<имя_функции>` (в интерфейсе и в Администрирование → Лог ошибок как `Npgsql.PostgresException ... 0A000`).

**Что проверить:**

- Схема функции-источника данных: если объект в схеме, отличной от `dbo` (обычно `custom`), имя должно быть указано со схемой явно — `custom.имя_функции`.
- Версия платформы: корректная обработка квалифицированных имён для этого пути (виджеты и иерархии) — начиная со сборки 2.268; на более ранних версиях воспроизводится.
- Временный обходной путь до обновления: перенести или продублировать функцию в схему `dbo` и переключить виджет/иерархию на неё (устраняет симптом, не первопричину).

---

**1.7 В таблице пустые ячейки — значение появляется только после двойного клика**

**Симптом:** строки в виджете «Таблица» отрисовались, но значения в ячейках не видны; значение проявляется после двойного клика по ячейке и перехода в соседнюю.

**Что проверить:**

- Настройку «Брать ссылку из» у проблемной колонки: ссылкой становится только строка-адрес (`http`/`https` или путь от `/`); идентификатор задачи, число или пустое значение адресом не являются.
- Версию платформы: с 2.268 значение ячейки выводится текстом даже при невалидном адресе; на более ранних сборках такая настройка даёт пустые ячейки.

**Решение:** привести колонку-источник ссылки к строке-адресу либо очистить настройку «Брать ссылку из» у колонки — значения ячеек начнут отображаться сразу. Детализация (drill-down) настраивается отдельным полем и от этого не страдает.

## 2. Виджеты — Гант, Кнопка-тикер, прочие

**2.1 Виджет Гант — нет колонок / не хватает доработок**

**Симптом:** «после обновления в виджете Гант нельзя выбрать колонки», «не хватает доработок в Ганте».

**Что проверить:**

- Версия системы — Гант активно дорабатывается
- Настройки виджета — какие колонки ожидаются

**2.2 Значение колонки «Выполнено» в Ганте**

**Симптом:** «за что отвечает колонка "Выполнено"?»

**Решение:** колонка «Выполнено» отображает процент выполнения задачи. Значение берётся из ДП, привязанного к этой колонке в настройках виджета.

**2.3 Кнопка-тикер — некорректная ссылка / локализация**

**Симптом:** «ссылка в кнопке-тикере ведёт не туда», «локализация не применяется для кнопки-тикера».

**Что проверить:**

- URL в настройках тикера — корректен ли
- Локализация — заполнены ли переводы для нужного языка

**2.4 Виджет «Контакты» — нет данных по звонкам**

**Симптом:** «в виджете Контакты не отображаются данные по звонкам».

**Что проверить:**

- Настройки интеграции с ВКС / телефонией
- Наличие данных в истории звонков

**2.5 Виджет «Группа виджетов» — некорректное отображение списка**

**Симптом:** «виджет Группа виджетов некорректно отображает список на новых порталах».

**Что проверить:**

- Тип портальной страницы — dashboard, board, CSS Grid
- Настройки вложенных виджетов — корректны ли привязки
- Версия системы — поведение могло измениться после обновления

**2.6 Виджет не отображается в ДП «Большой текст с форматированием»**

**Симптом:** «виджет не показывается при открытии ДП через модальное окно».

**Что проверить:**

- Тип виджета
- Контекст открытия — полная страница vs модальное окно

---

## 3. Порталы — создание и настройка

**3.1 Ошибка при создании / добавлении портала**

**Симптом:** «при добавлении нового портала — ошибка», «не отображается портал после обновления».

**Что проверить:**

- Текст ошибки
- Версия системы
- Права администратора

**3.2 Хранимая процедура портала — нет редактирования в AdminSPA**

**Симптом:** «в AdminSPA нет возможности отредактировать хранимую процедуру для портала, как в старой админке».

**Решение:** в текущей версии AdminSPA редактирование хранимых процедур порталов ещё не реализовано. Использовать SSMS/pgAdmin для редактирования SP напрямую.

**3.3 Пакетная обработка из-под портала**

**Симптом:** «как сделать пакетную обработку из портала?»

**Решение:** пакетная обработка из портала работает через виджет Таблица с включённой опцией множественного выбора. Настройки действий — в конфигурации виджета.

**3.4 Сертификат портала**

**Симптом:** «как обновить SSL-сертификат на портале?»

**Решение:** сертификат настраивается на уровне веб-сервера (nginx/IIS), не в 1Ф. Передать администратору инфраструктуры.

**3.5 Права доступа к публикациям не сохраняются**

**Симптом:** «не сохраняются настройки прав доступа в публикации», «сохранение настроек права доступа к публикации не работает».

**Что проверить:**

- Тип публикации — портал, пространство
- Роль пользователя — администратор публикации или нет
- Версия системы — поведение прав менялось в последних релизах

**Когда обращаться в поддержку 1Ф:** если права не сохраняются при корректной роли — баг.

**3.6 CSSGrid — потеря привязки виджетов при переносе**

**Симптом:** «при переносе CSSGrid портала с настроенным виджетом не переносится сам виджет, отсутствует связь».

**Что проверить:**

- Способ переноса — копирование категории, экспорт/импорт, ручной перенос
- Версия системы
- Наличие виджета в целевой категории после переноса

**Когда обращаться в поддержку 1Ф:** если виджет теряется при копировании CSSGrid — баг.

**3.7 Создание учётных записей на портале**

**Симптом:** «как создать учётную запись на портале?», «настройка регистрации на портале».

**Решение:** регистрация на портале настраивается через механизм внешних пользователей. Проверить: включена ли регистрация в настройках портала, настроены ли шаблоны уведомлений.

**3.8 Расширение рабочей области портала на весь экран**

**Симптом:** «как расширить рабочую область для порталов на весь экран?»

**Решение:** ширина рабочей области портала определяется настройками шаблона страницы (CSS Grid / dashboard). Для расширения — изменить параметры сетки в настройках страницы или использовать CSS-вставку.

### 3.9 Зависимый dropdown-фильтр показывает «Нет данных: …»

**Симптом:** «в выпадающем списке зависимого фильтра вместо значений вижу `Нет данных: <название>`».

**Решение:** это штатное поведение с **2.268.349**. Раньше пустой каскад показывал просто `Нет данных`, теперь к плейсхолдеру дописывается название самого параметра — чтобы было понятно, **какой именно** зависимый фильтр оказался пустым. Сам пустой результат — следствие выбранного значения родительского параметра: по нему смарт-выражение/статический набор каскада не вернули ни одной строки. Проверить:

- выбранное значение родительского фильтра — действительно ли по нему должны быть данные;
- настройку `Колонка родителя` (для смарт-набора) или `Ключ родителя` (для статического набора) у дочернего параметра — корректно ли указано поле привязки;
- результат смарт-выражения дочернего параметра с переданным `@eventParam2`, равным значению родителя.

### 3.10 Зависимый фильтр падает с 500 или не блокирует недоступные значения

**Симптом:** «при выборе значения в родительском dropdown-фильтре виджет возвращает ошибку 500», либо «значения в зависимом фильтре не блокируются/не скрываются, хотя должны — признак доступности не работает».

**Решение:** оба симптома — следствие одного бага в бэкенде (перепутаны переменные при проверке на null), исправлено в сборке 2.268.378. Обновите систему. Если ошибка воспроизводится на актуальной версии — проверьте настройки «Колонка родителя»/«Колонка доступности» дочернего параметра (см. § «Каскадные выпадающие списки» выше) и обратитесь в поддержку 1Ф с логами.

---

### 3.11 После переноса портала пропали виджеты во вкладках Board или на узком экране

**Симптом:** портал выгрузили утилитой переноса конфигурации и загрузили на другую площадку. Корневая сетка на месте, а вкладка-секция Board пустая или на узком экране нет части виджетов.

**Что проверить:** режим вёрстки портала — Board или Dashboard с отдельными раскладками xs…xl; что в архив попал сам портал вместе с шаблонами секций, а не только виджеты; на какой сборке снят архив — выгрузка блоков секций и адаптивных раскладок появилась в 2.268.

**Решение:** снять архив заново на сборке с этой выгрузкой и загрузить его. Архив, снятый раньше, блоков секций и раскладок не содержит, поэтому повторная загрузка того же файла не поможет.

**Когда обращаться в поддержку 1Ф:** если после повторной выгрузки блоки секции или адаптивной раскладки всё равно отсутствуют.

---

### 3.12 Виджет выводит «Виджет не поддерживается» на портале

**Симптом:** вместо содержимого блока — на портальной странице или в превью конструктора портала — показан текст «Виджет не поддерживается»; при этом тот же виджет на другой странице работает.

**Что проверить:** тип вёрстки страницы — Dashboard, CSS Grid, Flex или Board. Набор поддерживаемых типов зависит от него: «Навигация» и «Мини-опрос» отображаются только в CSS Grid, а в Dashboard и в секциях Board на их месте заглушка. Блоки устаревших типов, оставшиеся от порталов прежних версий, не отображаются ни в одной раскладке.

**Решение:** перенести блок на страницу с подходящей раскладкой либо заменить его виджетом поддерживаемого типа. Смена раскладки сами блоки не удаляет — при возврате прежнего режима они показываются снова. Устаревший блок удаляют с портала. Полный список типов по раскладкам — в разделе [Поддержка типов по режимам вёрстки](https://help.1forma.ru/domains/portal/admin-widgets.md#поддержка-типов-по-режимам-вёрстки).

**Когда обращаться в поддержку 1Ф:** если заглушка выводится для типа, который эта раскладка должна поддерживать, — например, «Навигация» перестала отображаться в CSS Grid после обновления.

---

### 3.13 Виджет не удаляется: в уведомлении перечислены порталы

**Симптом:** «не могу удалить виджет», «при удалении виджета выводится сообщение с названиями порталов».

**Что проверить:** сообщение «Виджет используется на следующих порталах» перечисляет порталы, на которых виджет размещён сейчас; тот же список заранее показывает действие «Где используется» в реестре виджетов.

**Решение:** это штатное поведение, а не ошибка: полностью удалить виджет, пока он размещён хотя бы на одном портале, нельзя. Снимите виджет с перечисленных порталов в редакторе портала и повторите удаление — в реестре виджетов или в окне настроек виджета. Виджет, который нигде не размещён, удаляется после подтверждения и не восстанавливается. Не путайте с действием «Удалить с портала»: оно убирает блок только с текущего портала, сам виджет остаётся в реестре, и его можно добавить снова. Правила удаления — в разделе [Различие «удалить с портала» и «полное удаление»](https://help.1forma.ru/domains/portal/admin.md#различие-удалить-с-портала-и-полное-удаление).

**Когда обращаться в поддержку 1Ф:** если уведомление не содержит перечня порталов, хотя виджет размещён, либо удаление не проходит после снятия виджета со всех перечисленных порталов.

---

### 3.14 Выпадающий список фильтра сразу раскрыт или не закрывается

**Симптом:** при открытии портала список значений параметра фильтра уже раскрыт, либо после нажатия его не удаётся закрыть; в списке — плоский набор значений, без иерархии.

**Что проверить:** какой параметр раскрыт и на какой странице портала; источник значений параметра и заполнена ли у него «Колонка родителя»; возвращает ли смарт-набор в колонке родителя фактические значения связи с родителем — заполненная настройка без таких данных иерархию не образует; точный номер сборки (вид 2.268.693, а не только название «Скульптор»: по названию семейства сборку с исправлением от более ранней не отличить).

**Решение:** обновить систему до актуальной сборки 2.268 «Скульптор» — при плоском наборе значений, даже если «Колонка родителя» заполнена, список открывается свёрнутым и раскрывается по нажатию, а деревом значения показываются только при наличии элементов со связью с родителем. На более ранних сборках плоский набор мог отрисовываться раскрытым и не закрываться. Настройки источника и «Колонку родителя» при обновлении менять не нужно.

**Когда обращаться в поддержку 1Ф:** если сборка актуальная, а список по-прежнему раскрыт при открытии портала или не закрывается — приложить ссылку на страницу портала, имя параметра фильтра, настройки его источника и снимок экрана.

---

### 3.15 Значение фильтра на портале не очищается — возвращается само

**Симптом:** «очищаю значение фильтра кнопкой „Очистить“ или крестиком у выпадающего списка, а значение возвращается»; у параметра «Значение по умолчанию» не заполнено, сохранение значений фильтров выключено.

**Что проверить:** заполнено ли у параметра поле «Значение по умолчанию» — при открытии портала подставляется именно оно; чем чистили значение — кнопкой «Очистить» над фильтром или крестиком у списка; какое значение возвращается (например, элемент `0` или первый элемент списка); точный номер сборки (вид 2.268.693, а не только название «Скульптор»: по названию семейства сборку с исправлением от более ранней не отличить).

**Решение:** обновить систему до актуальной сборки 2.268 «Скульптор» — после обновления и крестик у списка, и кнопка «Очистить» сбрасывают значение в пустое, и оно не возвращается при перерисовке страницы. Если «Значение по умолчанию» у параметра заполнено, его значение подставляется при открытии портала — это штатное поведение, а не возврат очищенного; чтобы при открытии портала фильтр был пустым, очистите «Значение по умолчанию» у параметра.

**Когда обращаться в поддержку 1Ф:** если сборка актуальная, «Значение по умолчанию» не заполнено, а после очистки значение всё равно возвращается — приложить ссылку на страницу портала, имя параметра фильтра, настройки его источника и снимок экрана.

### 3.16 Виджет «Профиль пользователя»: вместо сотрудника заглушка или «неоднозначно»

**Симптом:** «на портале карточка сотрудника не показывается — пустое место», «виджет профиля пишет, что сотрудников несколько», «настройки блока профиля не сохраняются».

**Что проверить:**

- Источник блока: фиксированный пользователь, узел оргструктуры или смарт-выражение. Узел оргструктуры должен быть задан именно как узел, а не как запись о назначении на должность.
- Подразделение, скрытое настройкой «Не показывать в оргструктуре», и функциональные единицы как источник не работают — блок покажет заглушку, это штатно.
- Смарт-выражение-источник должно возвращать идентификатор пользователя. Пока смарт не отработал, блок пуст — это штатно, а не ошибка настройки.
- Неоднозначность возникает, когда источник указывает на нескольких действующих сотрудников: сузьте источник до одного. Уволенные сотрудники в подсчёте кандидатов не участвуют.
- Если карточка пропала после удаления смарт-выражения — проверьте, не был ли этот смарт источником или подстрочником блока.

**Решение:** заглушка вместо карточки штатна, когда сотрудник уволен, недоступен для просмотра профиля или не найден — блок не различает эти случаи. При «неоднозначно» уточните источник.

**Когда обращаться в поддержку 1Ф:** если заглушка или «неоднозначно» появляются при заведомо корректном источнике с одним сотрудником либо блок молча перестал работать после удаления смарт-выражения — приложите имя портала, имя блока, источник и снимок экрана.

### 3.17 Виджет «Баннер» пуст или показывает «Ошибка загрузки»

### 3.18 Список групп портала не приходит: нет доступа к порталу

**Симптом:** запрос списка групп портала возвращает отказ или пусто; администратор не видит, каким группам открыт портал.

**Что проверить:** доступ пользователя к самому порталу — состав групп отдаётся только тому, кому портал виден; записи о группах доступа портала и членство пользователя в этих группах; что проверяется именно доступ к порталу, а не право менять его настройки — видимость портала и право менять конфигурацию это разные механизмы.

**Решение:** это штатное поведение: без права на портал перечень групп не раскрывается. Если пользователю нужен состав групп портала — выдать ему доступ к порталу группами; менять состав групп по-прежнему может администратор.

**Когда обращаться в поддержку 1Ф:** если список не приходит пользователю, которому портал по группам виден.

**Симптом:** на портальной странице виджет «Баннер» не выводит слайды.

**Что проверить:**

- выбрана ли категория-источник в настройках виджета — без неё настройки не сохраняются;
- есть ли в категории активные задачи, доступные смотрящему, и заполнены ли у них выведенные в слайд дополнительные параметры;
- заполнена ли дата публикации — она задаёт порядок, но слайд без неё всё равно показывается в конце карусели;
- тип вёрстки страницы: «Баннер» отображается во всех раскладках — Dashboard, Board, CSS Grid и Flex.

**Решение:** заполнить категорию и привязки полей в настройках виджета. Пустой виджет при отсутствии подходящих задач — штатное поведение, а не ошибка.

**Когда обращаться в поддержку 1Ф:** если настройки заполнены, активные задачи с заполненными полями есть, а виджет показывает «Ошибка загрузки».

## 4. Новости

**4.1 Новости не отображаются в мобильном приложении**

**Симптом:** «не отображаются новости в МП на Android и iOS», «несогласованные новости видны в МП».

**Что проверить:**

- Версия мобильного приложения
- Статус новости — опубликована ли / согласована ли
- Настройки видимости новости — для каких групп

**4.2 HTML-теги в заголовке / карточке новости**

**Симптом:** «в заголовке новости отображаются HTML-теги», «на карточке новости — null».

**Что проверить:**

- Контекст отображения — через категории или через ленту
- Формат заголовка — нет ли «сырого» HTML

Форматированный текст новости очищается при показе: безопасные теги отображаются, а скрипты и опасные атрибуты вырезаются и не исполняются в браузере.

**4.3 Пропала возможность ставить лайки**

**Симптом:** «не могу ставить лайки новостям, как раньше».

**Что проверить:**

- Версия системы — настройка лайков могла переехать
- Настройки категории новостей

**4.4 Поиск по содержимому новостей / статей FAQ**

**Симптом:** «не работает поиск по содержимому новостей», «поиск по статьям FAQ не находит».

**Что проверить:**

- Индексация — запущена ли полнотекстовая индексация
- Версия системы

**4.5 Тэги в заголовке новости**

**Симптом:** «как использовать тэги в заголовках новостей?»

**Решение:** тэги для новостей настраиваются в категории новостей. Отображение тэгов зависит от версии.

---

## 5. Пространства и статьи

**5.1 Нет системных категорий пространств**

**Симптом:** «не вижу системных категорий пространств (раздела)».

**Что проверить:**

- Версия системы
- Права пользователя
- Настройки модуля «Пространства»

**5.2 Подписи изображений в статьях сместились**

**Симптом:** «подписи изображений в статьях пространств стали располагаться не под изображениями».

**Что проверить:**

- Версия системы — после обновления мог измениться стиль
- CSS — нет ли пользовательских стилей, конфликтующих с обновлением

**5.3 Поле «Контакты» в пространствах**

**Симптом:** «в чём смысл поля Контакты в пространствах?»

**Решение:** поле «Контакты» привязывает к пространству ответственных лиц. Отображается как ссылка на профили пользователей в шапке пространства.

**5.4 Настройки категории не открываются из списка пространств**

**Симптом:** «не могу перейти в настройки категории из списка пространств, хотя из бокового меню — работает».

**Что проверить:**

- URL — отличаются ли ссылки
- Версия системы

---

## 6–9. JS-вставки, дашборды, смарт-действия и инфраструктура порталов

**6.1 Ошибка при добавлении JS-вставки**

**Симптом:** «не могу поставить JS в портал», «ошибка при добавлении JS-вставки».

**Что проверить:**

- Синтаксис JS — нет ли ошибок
- CSP (Content Security Policy) — не блокирует ли
- Версия системы

**6.2 Дублирование JS-вставок при копировании категории**

**Симптом:** «при копировании категории JS-вставки тоже копируются (дублируются)».

**Решение:** ожидаемое поведение — при копировании категории копируются все связанные настройки, включая JS-вставки. Лишние вставки нужно удалить вручную.

**6.3 Один виджет не отобразился: вместо содержимого — «Ошибка загрузки»**

**Симптом:** на странице портала, дашборда или борда один блок показывает «Ошибка загрузки», остальные блоки отрисованы штатно; в консоли браузера — сообщение `Widget component creation failed: <тип виджета>`.

**Что это значит:** отказ изолирован на уровне одного виджета — вся страница не белеет. Исключение при создании виджета перехватывается, на его месте ставится заглушка, факт пишется в лог с типом виджета.

**Что проверить:**

- Тип виджета из сообщения в логе — он сужает круг настроек, которые стоит перепроверить
- Права доступа и группы пользователя: блок без прав не показывается вовсе, а упавший блок показывает заглушку
- Работает ли этот же виджет на другой странице — если не работает нигде, причина в источнике данных блока
- Не менялись ли настройки блока незадолго до появления симптома

**Когда обращаться в поддержку 1Ф:** если заглушка появляется у блока, который раньше работал и настройки которого не менялись, — это дефект конкретного виджета; нужны снимок страницы и текст сообщения из консоли.

**Другой симптом — пустая рамка без надписи.** Если вместо содержимого осталась пустая рамка без «Ошибка загрузки», барьер не сработал: так проявляется дефект на сборках до 2.268, когда обращение к адресу родительского окна при создании виджета прерывало рендер без контролируемого результата. Отличать от заглушки стоит по отсутствию текста.

---

**7. Дашборды в мобильном приложении**

**7.1 Цвет текста на плитке дашборда не применяется**

**Симптом:** «в МП не применяются настройки цвета текста на плитке дашборда».

**Что проверить:**

- Версия мобильного приложения
- Настройки плитки — какие цвета заданы

**7.2 Не добавляется виджет на портал**

**Симптом:** «не могу добавить виджет на портал».

**Что проверить:**

- Тип виджета
- Тип страницы (dashboard, board, CSS Grid) — не все виджеты совместимы со всеми типами
- Права администратора портала

---

**8. Смарт-действия и публикации**

**8.1 Смарт-действие через публикацию — ошибка**

**Симптом:** «смарт-действие "Резолюция подписи", вызванное через публикацию, возвращает ошибку».

**Что проверить:**

- Тип смарт-действия — какое именно действие вызывается
- Контекст вызова — из карточки задачи работает, а из публикации — нет
- Версия системы — совместимость смарт-действий с публикациями ограничена

**Когда обращаться в поддержку 1Ф:** если действие работает из карточки, но не из публикации — баг или ограничение платформы.

**8.2 Быстрый опрос на портале**

**Симптом:** «как настроить быстрый опрос на портале?», «не работает быстрый опрос».

**Что проверить:**

- Настройки виджета опроса — привязан ли к категории
- Права пользователей на участие в опросе
- Версия системы — функционал может быть недоступен в старых версиях

---

**9. Инфраструктура порталов**

**9.1 Настройки балансировщика для продуктивного портала**

**Симптом:** «как настроить балансировщик для продуктивного портала?», «портал работает нестабильно под нагрузкой».

**Решение:** балансировка настраивается на уровне инфраструктуры (nginx/HAProxy), не в 1Ф. Передать администратору инфраструктуры. Ключевые моменты: sticky sessions, проброс заголовков, health checks.

---

## Чеклист для первичной диагностики

Что зафиксировать при первичном разборе:

1. **Тип проблемы** — виджет (Таблица/Гант/тикер/Группа виджетов), портал (создание/настройка/публикации), новости, пространства, JS-вставки, смарт-действия
2. **Версия системы**
3. **Контекст** — веб / мобильное приложение
4. **Тип портальной страницы** — dashboard, board, CSS Grid, Flex; для заглушки «Виджет не поддерживается» — тип блока
5. **Скриншот / текст ошибки**
6. **Работало ли до обновления** — если да, какая версия была до

**Когда обращаться в поддержку 1Ф**

- HTML перестал рендериться в виджете после обновления (баг)
- Портал не отображается после обновления системы
- Массовые проблемы с виджетами после обновления
- Ошибка при создании портала при корректных настройках
- JS-вставки блокируются CSP
- Права доступа к публикациям не сохраняются при корректной роли
- CSSGrid теряет привязку виджетов при переносе
- После переноса портала пустые секции Board или пропавшие виджеты на одном размере экрана
- «Виджет не поддерживается» на типе, который раскладка должна поддерживать
- Смарт-действие работает из карточки, но не из публикации