Клиентский кабинет¶
Кабинет открывается по <ваш-адрес>/setup. Вход проходит через локальный Keycloak. Первый системный администратор создаётся во время установки.
Обзор и каталог данных¶
Обзор показывает число доступных схем, наборов и полей, а также первые разрешённые наборы без привязки к конкретному источнику. Каталог данных строится из разрешённых пользователю схем, таблиц и представлений PostgreSQL. Здесь можно увидеть колонки и типы, просмотреть строки и выполнить ограниченный поиск. Список зависит от ролей пользователя.
Названия наборов и колонок в каталоге, конструкторе поиска, таблице результатов и разделе Индексы берутся из подписей клиентской схемы. Подпись показывается первой, техническое имя — рядом или в подсказке. Если подпись не задана, кабинет разделяет техническое имя на слова: source_date → Source date. Для точного названия на русском разработчик клиентского пакета задаёт PostgreSQL COMMENT в миграции. Технические имена остаются именами полей в API, MCP и SQL.
В конструкторе поиска можно отметить колонки результата галочками и выбрать поле и направление сортировки. После нажатия Выполнить запрос возвращает только отмеченные колонки; сортировать можно и по колонке, не включённой в результат. Настройка действует для текущего запроса и сбрасывается при выборе другого набора данных.
Системный администратор может изменить подпись колонки кнопкой рядом с её названием в каталоге. Кабинет сохраняет PostgreSQL COMMENT; пользователи сразу видят новую подпись в каталоге, конструкторе и результатах после обновления данных. Имя колонки в API и права не меняются. Для новой установки перенесите изменение в миграцию клиентского пакета.
Пайплайны¶
Пайплайны разделены на по расписанию и ручные. Системный администратор открывает запуск и историю во вкладках окна выбранного DAG и управляет паузой из списка. Параметры формы берутся из Airflow Params конкретного DAG; историческая загрузка может принимать период, а справочник — запускаться без него. Подробнее →
API и доступ¶
Раздел API показывает утверждённые маршруты, их права и примеры. Администратор может включать или скрывать только маршруты из проверенного клиентского пакета. В разделе Доступ он создаёт пользователей и назначает роли. Право на каталог и право на конкретный набор данных задаются отдельно.
Настройки и секреты¶
Base URL — публичный адрес кабинета. Он нужен для ссылок приложения и не меняет DNS. Секреты источников появляются из деклараций клиентского пакета: для каждого поля указаны имя, описание, сервис-потребитель и обязательность. Введите значения после установки, затем убедитесь, что у обязательных полей статус «Задан».
Системный администратор в блоке Соединения PostgreSQL задаёт предел открытых и свободных соединений Go API, срок жизни и срок простоя. Изменения действуют сразу и сохраняются после перезапуска клиента. Блок показывает текущую занятость и число ожиданий. Другие роли не могут читать или менять эти настройки.
В блоке Go ELT worker системный администратор включает или останавливает обработку сырых порций, задаёт число рабочих горутин (1–32) и интервал между попытками (1–300 секунд). Настройки применяются работающим worker в течение нескольких секунд и сохраняются после перезапуска. Кабинет показывает последнее подключение, число работающих горутин, обработанных порций и признак ошибки. Worker есть только в пакетах ELT; ETL управляется DAG-ами Airflow. Каждая порция должна сохраняться идемпотентно в клиентском коде.
Значения хранятся в клиентском контуре и после сохранения не возвращаются в форму. Пустое значение при редактировании сохраняет прежний секрет; отдельное действие удаляет его. Секреты источников не передаются в шину управления, MCP и параметры запуска DAG.