Консоль адміністратора

Консоль адміністратора Ring (/admin/*) — це робоче середовище оператора з трьома панелями: ліві меню для центрів розділів, центральна область для роботи, права панель для підменю модуля та пов’язаних центрів. Навігація фільтрується за роллю з одного SSOT — адміністратори платформи (admin | superadmin) бачать центри спільноти, довіри, комерції та CRM; superadmin також бачить Platform ops (налаштування, процеси, продуктивність, підписки, Web3).

|| Поверхня | Що показує | Джерело | ||---------|---------------|--------| || Панель піктограм | Один пункт Admin → /admin | sidebar-rail.tsx + isPlatformAdmin | || Бічна панель для ПК | Згруповані центри (Overview → … → Platform) | useAdminNavMenu ← admin-nav-config.ts | || Мобільний нижній аркуш | Ті самі відфільтровані центри | bottom-navigation.tsx | || Права панель | Підменю → пов’язані центри → необов’язкова статистика новин → довідка | AdminWrapper → admin-rail.tsx | || Плитки дашборда | Ті самі центри (без самого Dashboard) | admin-dashboard-tiles.ts | || Оболонка CRM | Центральна область на всю ширину + горизонтальні вкладки (без правої панелі) | CrmAdminShell |

Пов’язана документація

Консоль адміністратора

Консоль адміністратора Ring (/admin/*) — це робоче середовище оператора з трьома панелями: ліві меню для центрів розділів, центральна область для роботи, права панель для підменю модуля та пов’язаних центрів. Навігація фільтрується за роллю з одного SSOT — адміністратори платформи (admin | superadmin) бачать центри спільноти, довіри, комерції та CRM; superadmin також бачить Platform ops (налаштування, процеси, продуктивність, підписки, Web3).

|| Поверхня | Що показує | Джерело | ||---------|---------------|--------| || Панель піктограм | Один пункт Admin → /admin | sidebar-rail.tsx + isPlatformAdmin | || Бічна панель для ПК | Згруповані центри (Overview → … → Platform) | useAdminNavMenu ← admin-nav-config.ts | || Мобільний нижній аркуш | Ті самі відфільтровані центри | bottom-navigation.tsx | || Права панель | Підменю → пов’язані центри → необов’язкова статистика новин → довідка | AdminWrapper → admin-rail.tsx | || Плитки дашборда | Ті самі центри (без самого Dashboard) | admin-dashboard-tiles.ts | || Оболонка CRM | Центральна область на всю ширину + горизонтальні вкладки (без правої панелі) | CrmAdminShell |

Пов’язана документація

Консоль адміністратора

Консоль адміністратора Ring (/admin/*) — це робоче середовище оператора з трьома панелями: ліві меню для центрів розділів, центральна область для роботи, права панель для підменю модуля та пов’язаних центрів. Навігація фільтрується за роллю з одного SSOT — адміністратори платформи (admin | superadmin) бачать центри спільноти, довіри, комерції та CRM; superadmin також бачить Platform ops (налаштування, процеси, продуктивність, підписки, Web3).

|| Поверхня | Що показує | Джерело | ||---------|---------------|--------| || Панель піктограм | Один пункт Admin → /admin | sidebar-rail.tsx + isPlatformAdmin | || Бічна панель для ПК | Згруповані центри (Overview → … → Platform) | useAdminNavMenu ← admin-nav-config.ts | || Мобільний нижній аркуш | Ті самі відфільтровані центри | bottom-navigation.tsx | || Права панель | Підменю → пов’язані центри → необов’язкова статистика новин → довідка | AdminWrapper → admin-rail.tsx | || Плитки дашборда | Ті самі центри (без самого Dashboard) | admin-dashboard-tiles.ts | || Оболонка CRM | Центральна область на всю ширину + горизонтальні вкладки (без правої панелі) | CrmAdminShell |

Пов’язана документація

Контракт правої панелі

Порядок в AdminSidebarContent:

1. Підменю модуля, коли resolveRailSection(pageContext) не дорівнює null і getRailSubmenu повертає посилання
2. Пов’язані центри через getRelatedHubs
3. Повна швидка навігація лише коли pageContext === 'dashboard'
4. Статистика новин, коли pageContext === 'news' і передано newsStats
5. Довідка — посилання на документацію

Підсвічування активних вкладок у query використовує pathWithQuery (pathname + useSearchParams), тому посилання з ?tab= у Security / Matcher / Moderation підсвічуються правильно.

|| pageContext | Розділ панелі | Помітне підменю | ||---------------|--------------|-----------------| || security / застарілі fraud-desk / verification | security | ?tab=overview\|fraud\|verification\|events | || matcher | matcher | Analytics або ?tab=moderation | || store | store | Products, orders, stock, commissions, add | || crm-* | CRM (вкладки, без панелі) | Orders, inbox, drafts, contacts, analytics, tasks через CrmAdminShell | || news | news | Articles, categories, analytics, bulk | || web3 | web3 | Dashboard + Settings (посилання на settings — якщо superadmin) | || users | users | ?tab= overview / users / verification / analytics | || moderation | moderation | queue / rules / reports / analytics (синхронізується з URL на клієнті) |

Центр Security + перенаправлення

SSOT вкладок: features/admin/security/types/security-overview.ts (SECURITY_TABS). Клієнт: admin-security-center-client.tsx (контрольовані Tabs + router.push).

Синхронізація вкладок Matcher

Moderation у панелі → /admin/matcher?tab=moderation. Клієнт admin-matcher-client.tsx читає tab; підвкладки аналітики (performance, quality, …) залишаються локальними для клієнта, коли tab відсутня.

Сторінки CRM

Усі маршрути CRM обгортаються в CrmAdminShell + pageContext (crm-orders, crm-inbox, crm-drafts, crm-contacts, crm-tasks, crm-analytics). Оболонка встановлює showRightRail={false} і відображає горизонтальні вкладки: Orders | Inbox | Drafts | Contacts | Tasks | Analytics. HTTP API Email залишаються в /api/admin/email/*. Топологія чату замовлення проєкту: Owner Project Lab.

Налаштування Web3

/admin/web3/settings має передавати pageContext="web3" (сторінка лише для superadmin), щоб відображалося підменю Web3 замість пов’язаних центрів дашборда.

1. 1

   Розширення головного меню

   Додайте елемент у відповідну групу ADMIN_NAV_GROUPS з href, pageContext, minRole і labelKey. Додайте мітку до admin-labels.ts і locales/{en,uk,ru}/modules/admin.json.

2. 2

   Підключення оболонки сторінки

   Огорніть сторінку (або клієнт) у AdminWrapper із відповідним pageContext. Для маршрутів Email використовуйте EmailAdminShell.

3. 3

   Додавання дочірніх пунктів панелі, якщо розділ має кілька кінцевих сторінок

   Розширте getRailSubmenu / resolveRailSection. Надавайте перевагу реальним маршрутам або ?tab=, синхронізованим у клієнті сторінки (див. Security / Moderation). Передавайте pathWithQuery у предикати isActive, які перевіряють query-рядки.

Whitelabel Navigation

Див. також: налаштування навігації на рівні клону під час розгалуження меню адміністратора.

Контракт правої панелі

Порядок в AdminSidebarContent:

1. Підменю модуля, коли resolveRailSection(pageContext) не дорівнює null і getRailSubmenu повертає посилання
2. Пов’язані центри через getRelatedHubs
3. Повна швидка навігація лише коли pageContext === 'dashboard'
4. Статистика новин, коли pageContext === 'news' і передано newsStats
5. Довідка — посилання на документацію

Підсвічування активних вкладок у query використовує pathWithQuery (pathname + useSearchParams), тому посилання з ?tab= у Security / Matcher / Moderation підсвічуються правильно.

|| pageContext | Розділ панелі | Помітне підменю | ||---------------|--------------|-----------------| || security / застарілі fraud-desk / verification | security | ?tab=overview\|fraud\|verification\|events | || matcher | matcher | Analytics або ?tab=moderation | || store | store | Products, orders, stock, commissions, add | || crm-* | CRM (вкладки, без панелі) | Orders, inbox, drafts, contacts, analytics, tasks через CrmAdminShell | || news | news | Articles, categories, analytics, bulk | || web3 | web3 | Dashboard + Settings (посилання на settings — якщо superadmin) | || users | users | ?tab= overview / users / verification / analytics | || moderation | moderation | queue / rules / reports / analytics (синхронізується з URL на клієнті) |

Центр Security + перенаправлення

SSOT вкладок: features/admin/security/types/security-overview.ts (SECURITY_TABS). Клієнт: admin-security-center-client.tsx (контрольовані Tabs + router.push).

Синхронізація вкладок Matcher

Moderation у панелі → /admin/matcher?tab=moderation. Клієнт admin-matcher-client.tsx читає tab; підвкладки аналітики (performance, quality, …) залишаються локальними для клієнта, коли tab відсутня.

Сторінки CRM

Усі маршрути CRM обгортаються в CrmAdminShell + pageContext (crm-orders, crm-inbox, crm-drafts, crm-contacts, crm-tasks, crm-analytics). Оболонка встановлює showRightRail={false} і відображає горизонтальні вкладки: Orders | Inbox | Drafts | Contacts | Tasks | Analytics. HTTP API Email залишаються в /api/admin/email/*. Топологія чату замовлення проєкту: Owner Project Lab.

Налаштування Web3

/admin/web3/settings має передавати pageContext="web3" (сторінка лише для superadmin), щоб відображалося підменю Web3 замість пов’язаних центрів дашборда.

1. 1

   Розширення головного меню

   Додайте елемент у відповідну групу ADMIN_NAV_GROUPS з href, pageContext, minRole і labelKey. Додайте мітку до admin-labels.ts і locales/{en,uk,ru}/modules/admin.json.

2. 2

   Підключення оболонки сторінки

   Огорніть сторінку (або клієнт) у AdminWrapper із відповідним pageContext. Для маршрутів Email використовуйте EmailAdminShell.

3. 3

   Додавання дочірніх пунктів панелі, якщо розділ має кілька кінцевих сторінок

   Розширте getRailSubmenu / resolveRailSection. Надавайте перевагу реальним маршрутам або ?tab=, синхронізованим у клієнті сторінки (див. Security / Moderation). Передавайте pathWithQuery у предикати isActive, які перевіряють query-рядки.

Whitelabel Navigation

Див. також: налаштування навігації на рівні клону під час розгалуження меню адміністратора.

Контракт правої панелі

Порядок в AdminSidebarContent:

1. Підменю модуля, коли resolveRailSection(pageContext) не дорівнює null і getRailSubmenu повертає посилання
2. Пов’язані центри через getRelatedHubs
3. Повна швидка навігація лише коли pageContext === 'dashboard'
4. Статистика новин, коли pageContext === 'news' і передано newsStats
5. Довідка — посилання на документацію

Підсвічування активних вкладок у query використовує pathWithQuery (pathname + useSearchParams), тому посилання з ?tab= у Security / Matcher / Moderation підсвічуються правильно.

|| pageContext | Розділ панелі | Помітне підменю | ||---------------|--------------|-----------------| || security / застарілі fraud-desk / verification | security | ?tab=overview\|fraud\|verification\|events | || matcher | matcher | Analytics або ?tab=moderation | || store | store | Products, orders, stock, commissions, add | || crm-* | CRM (вкладки, без панелі) | Orders, inbox, drafts, contacts, analytics, tasks через CrmAdminShell | || news | news | Articles, categories, analytics, bulk | || web3 | web3 | Dashboard + Settings (посилання на settings — якщо superadmin) | || users | users | ?tab= overview / users / verification / analytics | || moderation | moderation | queue / rules / reports / analytics (синхронізується з URL на клієнті) |

Центр Security + перенаправлення

SSOT вкладок: features/admin/security/types/security-overview.ts (SECURITY_TABS). Клієнт: admin-security-center-client.tsx (контрольовані Tabs + router.push).

Синхронізація вкладок Matcher

Moderation у панелі → /admin/matcher?tab=moderation. Клієнт admin-matcher-client.tsx читає tab; підвкладки аналітики (performance, quality, …) залишаються локальними для клієнта, коли tab відсутня.

Сторінки CRM

Усі маршрути CRM обгортаються в CrmAdminShell + pageContext (crm-orders, crm-inbox, crm-drafts, crm-contacts, crm-tasks, crm-analytics). Оболонка встановлює showRightRail={false} і відображає горизонтальні вкладки: Orders | Inbox | Drafts | Contacts | Tasks | Analytics. HTTP API Email залишаються в /api/admin/email/*. Топологія чату замовлення проєкту: Owner Project Lab.

Налаштування Web3

/admin/web3/settings має передавати pageContext="web3" (сторінка лише для superadmin), щоб відображалося підменю Web3 замість пов’язаних центрів дашборда.

1. 1

   Розширення головного меню

   Додайте елемент у відповідну групу ADMIN_NAV_GROUPS з href, pageContext, minRole і labelKey. Додайте мітку до admin-labels.ts і locales/{en,uk,ru}/modules/admin.json.

2. 2

   Підключення оболонки сторінки

   Огорніть сторінку (або клієнт) у AdminWrapper із відповідним pageContext. Для маршрутів Email використовуйте EmailAdminShell.

3. 3

   Додавання дочірніх пунктів панелі, якщо розділ має кілька кінцевих сторінок

   Розширте getRailSubmenu / resolveRailSection. Надавайте перевагу реальним маршрутам або ?tab=, синхронізованим у клієнті сторінки (див. Security / Moderation). Передавайте pathWithQuery у предикати isActive, які перевіряють query-рядки.

Whitelabel Navigation

Див. також: налаштування навігації на рівні клону під час розгалуження меню адміністратора.