Админка

Зачем нужно

Документ фиксирует, что admin является UI-слоем над доменами, а не отдельным источником бизнес-логики.

1. Принцип

Admin-консоль — это набор страниц для управления платформой. Нет собственной бизнес-логики. Каждая admin-страница вызывает API соответствующего домена напрямую.

Доступ к admin-консоли: пользователь видит раздел "Администрирование" в меню, если у него есть хотя бы один permission из группы admin-страниц (любой *.view, *.edit, *.manage из маппинга ниже). Каждая конкретная страница защищена своим permission. super_admin видит всё (wildcard *).

2. Маппинг страниц на домены

Admin-страница	Домен API	Что делает
Дашборд	агрегация из нескольких доменов	Метрики: пользователи, сессии, активность
Управление пользователями	users	Список, фильтры, редактирование, бан
Кастомные поля	users	CRUD определений полей
Управление ролями	rbac	CRUD ролей и permissions
Управление организациями	organizations	Список, карточка, статусы, owner, members, students, teams, duplicates, merge, audit
Управление плагинами	plugins	Список, вкл/выкл, настройки
Конструктор воронки	auth	Настройка auth flow
OAuth-клиенты	oauth-server	CRUD OAuth-клиентов
Шаблоны уведомлений	notifications	Редактор шаблонов
Журнал аудита	notifications	Просмотр audit_logs с фильтрами
Сервис-реестр	platform	Зарегистрированные внешние сервисы экосистемы
Заявки на владение	organizations	Рассмотрение ownership claims
Приглашения (системные)	organizations	Все pending organization invitations по системе
Системные настройки	platform	Маска телефона, переключатели, default role
Брендинг	platform	Логотипы, favicon, название проекта
Настройки меню	platform	Структура сайдбара, видимость
Настройки страниц/блоков	platform	Видимость страниц и блоков ЛК

3. Дашборд

Единственная страница с агрегацией. Метрики собираются из нескольких доменов:

Метрика	Домен	Описание
Пользователи (total + новые за сегодня)	users	COUNT + COUNT WHERE created_at > today
Активные сессии	auth	COUNT WHERE is_revoked=false AND expires_at > now
Неудачные попытки входа за 24ч	audit	COUNT audit_logs WHERE action='identity.login.failed' AND created_at > 24h
Pending приглашения	organizations	COUNT organization_invitations WHERE status IN ('created','sent')
Pending ownership claims	organizations	COUNT organization_ownership_claims WHERE status IN ('submitted','needs_more_info')
Возможные дубли организаций	organizations	COUNT organizations WHERE duplicate_status='possible_duplicate'
Активные плагины	plugins	COUNT WHERE is_enabled=true
Организации (total)	organizations	COUNT
Audit-события за сегодня	audit	COUNT audit_logs WHERE created_at > today

Агрегация выполняется через единый endpoint GET /platform/stats, который собирает метрики из нескольких сервисов на стороне бэкенда.

4. Что перенесено в platform

Подсистема	Почему platform
Системные настройки (system_settings)	Конфигурация платформы, не привязана к конкретному домену
Брендинг (логотипы, favicon, projectName)	Конфигурация платформы
UI-права (видимость меню, страниц, блоков)	Инфраструктура UI
Навигационное меню (navigation_menus)	Инфраструктура UI
Конфигурация страниц/блоков ЛК	Инфраструктура UI

Таблицы ui_elements / ui_groups удаляются. Навигация управляется через navigation_menus (см. platform.md).

5. UX/UI

5.1. AdminLayout

Все admin-страницы рендерятся внутри AdminLayout:

• Левая панель: AdminSidebar (persistent, lazy-loaded, permission-filtered)
• Mobile: MobileBottomNav с гамбургером → overlay sidebar

Группы навигации AdminSidebar:

Группа	Пункты
Dashboard	Обзор (chart-bar)
Пользователи	Управление, Роли, Кастомные поля (super_admin)
Авторизация	Алгоритм auth flow, OAuth-клиенты
Организации	Управление, Конструктор формы заявки
Настройки	Общие, Личный кабинет, Брендинг, Уведомления
Расширения	Управление, Загрузка

5.2. AdminDashboardPage

Страница /:lang/admin — обзорная панель.

Метрики (4 карточки в ряд):

• Всего пользователей
• Активных пользователей
• Новых сегодня
• Активных сессий

Двухколоночная сетка:

• Левая: "Последние регистрации" — таблица (аватар, имя, email, дата), 5 последних
• Правая: "Последние события" — таблица (событие, плагин, статус Badge зелёный/красный, дата), пагинация по 6

5.3. UsersManagementPage

Страница /:lang/admin/users — управление пользователями.

• UserSegmentsBar — табы-сегменты: Все, Активные, Заблокированные и др.
• UserFiltersPanel — боковая панель фильтров: поиск, роли, статус
• UsersTable — таблица данных с ColumnSettings (выбор видимых колонок)
• UsersPagination — пагинация

UserDetailPanel (slide-in справа):

Таб	Содержимое
Информация	Поля профиля пользователя
Роли	Назначение ролей
Активность	Лог действий

5.4. RolesManagementPage

Страница /:lang/admin/roles — роли и права.

• RoleTreeSimple — иерархический список ролей (дерево)
• RoleModal — создание/редактирование роли
• PermissionBuilder — визуальный конструктор наборов прав
• RolesControl / RolesSelector — выбор ролей для назначения

5.5. AuthFlowBuilderPage

Страница /:lang/admin/auth-flow — визуальный конструктор auth flow.

• Список шагов с drag-and-drop для изменения порядка
• Каждый шаг: название + тип + обязательность (Switch)
• StepSettingsModal — настройки конкретного шага
• AddAuthMethodModal — добавление нового метода аутентификации
• Превью: как будет выглядеть flow для пользователя

5.6. AccountSettingsPage

Страница /:lang/admin/account-settings — настройка личного кабинета пользователя.

4 таба:

Таб	Компонент	Что настраивает
Страницы	PagesConfigManager	Какие страницы существуют (dashboard, data, security, family)
Меню	MenuItemsManager	Пункты sidebar (название, иконка, путь, тип: default/iframe/embedded/plugin/external)
Виджеты	ProfileBlocksManager	Видимость и порядок блоков на дашборде
Блоки	PageBlocksManager	Под-блоки внутри страниц

5.7. Остальные admin-страницы

Страница	Путь	Описание
GeneralSettingsPage	/admin/general-settings	Общие настройки: язык, регистрация вкл/выкл
LogoManagementPage	/admin/logo	BrandingUpdater: загрузка логотипа, название проекта
UserCustomFieldsPage	/admin/user-custom-fields	Определение кастомных полей профиля (super_admin)
OAuthClientsManagementPage	/admin/oauth-clients	Регистрация и управление OAuth 2.0 клиентами
NotificationTemplatesPage	/admin/notification-templates	Два таба: шаблоны уведомлений (TemplateEditorModal) + email-лейауты (LayoutEditorModal) + VariableChip для подстановки переменных
ExtensionsManagerPage	/admin/extensions	Список плагинов, включение/выключение
ExtensionUploadPage	/admin/extensions/upload	Загрузка нового пакета расширения

5.8. Редиректы маршрутов

Старый путь	Новый путь
/admin/menu-settings	/admin/account-settings
/admin/profile-blocks	/admin/account-settings
/admin/backup	/admin/general-settings
/admin/organization-applications	/admin/companies