Админ-панель и эксплуатация

Разделы панели для операторов.

5. Админ-панель: что где находится

После входа в админ-панель настройка выполняется через боковое меню. Набор доступных разделов зависит от вашей роли.

Раздел меню	Что можно сделать
Главная	Сводка состояния платформы
Сервисы	Список подключённых сервисов, запуск и остановка
Маршрутизация	Правила направления запросов к сервисам
Балансировка	Распределение нагрузки между репликами
Контейнеры	Обзор Docker-контейнеров
Пользователи	Учётные записи, роли и права
Модули / Плагины	Установленные расширения и их настройка
Обновления / Маркет	Обновление платформы и каталог расширений
Журналы / Мониторинг	Логи, метрики и оповещения
Файлы	Загрузка и управление файлами
Базы данных / Студия БД	Структура таблиц, просмотр и правка данных
Настройки → Почта	Исходящая почта, шаблоны писем, тестовая отправка
Настройки → Безопасность → Public Auth	Регистрация, подтверждение email, защита от перебора
Настройки → Уведомления	Email-каналы для алертов
Настройки	Общие параметры и API-ключи для интеграций

6. Базы данных

Работа с данными выполняется в трёх связанных разделах админ-панели.

6.1. База данных платформы

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

6.2. Базы данных сервисов

Привязка отдельных баз данных к подключённым сервисам:

выбор источника данных (datasource) и создание новой БД для сервиса;
выполнение install SQL при первичной настройке сервиса;
переход в Студию БД по кнопке «Открыть в студии».

6.3. Студия БД

Единый интерфейс для любой привязанной базы (ядро или сервис):

просмотр основной БД ядра и сервисных баз — служебные каталоги СУБД скрыты;
список таблиц и представлений, структура (колонки, индексы, FK);
просмотр данных с пагинацией, сортировкой и фильтрами — при переключении контекста данные на экране обновляются без «чужих» строк;
добавление, редактирование и удаление строк через формы;
SQL-консоль (read-only или с правом на изменение — по роли);
журнал изменяющих операций (аудит);
проверка схемы — полный актуальный набор таблиц ядра.

В верхней части студии выберите источник данных и базу — контекст сохраняется в URL, ссылку можно передать коллеге.

Доступ к студии и операциям с данными регулируется правами роли: db_view, db_edit, db_schema, db_sql_execute, db_audit. Назначение прав — в разделе «Пользователи».

6.4. Public Swagger UI

Интерактивная read-only документация Public API: /api/docs/public. Спецификация — GET /api/openapi.json. Подробнее — OpenAPI и метрики.

6.5. Веб-контур расширений (опционально, 1.0.6)

Если плагин предоставляет собственный HTTP-интерфейс, включите plugin_ports.enabled: true в config.yml — параметры и диапазоны портов описаны в разделе 3.1. Регистрация и запуск listener'ов — в админ-панели (раздел плагинов) с учётом RBAC.

7. Сервисы и маршрутизация

7.1. Сервисы

На странице сервисов отображаются подключённые бэкенды: статус, health-check, метрики. Доступны действия запуска, остановки, перезапуска и масштабирования — через кнопки в интерфейсе.

7.2. Маршрутизация

Настройка правил, по которым запросы /api/module/<модуль>/… проксируются к целевым сервисам:

создание и редактирование правил (шаблон пути, целевой сервис, метод);
предпросмотр маршрута перед сохранением;
горячая перезагрузка правил без рестарта ядра.

7.3. Балансировка

Выбор алгоритма распределения запросов между репликами сервиса (round-robin, least connections и др.).

7.4. Контейнеры

Обзор и управление Docker-контейнерами, если Service Discovery работает через Docker.

8. Обновления и маркет

8.1. Центр обновлений

Управление версиями ядра, модулей и плагинов:

проверка доступных обновлений по каналу (stable, beta);
запуск задачи обновления или отката из интерфейса;
readiness-проверка перед обновлением в production.

Канал и URL реестра задаются в config.yml (секция updates), остальное — в панели.

8.2. Маркет

Витрина модулей и плагинов поверх центра обновлений:

каталог с поиском и фильтрами по типу артефакта;
карточка продукта с описанием и совместимостью;
установка, обновление и откат версии через интерфейс;
история операций и журнал security-событий.

Установка и обновление из маркета требуют активной подписки или лицензии. На dev/staging просмотр каталога может быть доступен без подписки (параметр market.subscription_gate_mode: browse в config.yml).

8.3. API-ключи для внешних интеграций

Если нужно подключить внешнее приложение к данным, файлам или отправке почты через платформу, создайте API-ключ в разделе Настройки и назначьте нужные разрешения (например, mail:send для Service API почты). Подробности — в документации API почты.

9. Дальнейшие шаги

Быстрый старт — health, первый Public Auth, Swagger.
Общие соглашения Public API — ключи, JWT, форматы ответов.
Решение проблем — типовые ошибки установки и интеграции.