ВозможностиОрганизации
Документация
    Ring Platform

    Децентрализованное самостроящееся будущее

    Войти
    Организации
    Возможности
    Магазин
    Документация
    Концепции платформы
    RING ЭкономикаSonoratek LLCГлобальное влияниеAI встречает Web3
    Начать
    Быстрый стартКалькуляторДорожная карта
    Конфиденциальность|Контакты
    v1.104.17|Sonoratek LLC

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Real-Time Messaging
    Peer Games
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Real-Time Messaging
    Peer Games
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Real-Time Messaging
    Peer Games
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    API администрирования

    Фильтруйте по Founder / Developer в боковом меню. В старых версиях упоминались 12 конечных точек, придуманные маршруты GET /api/admin/users (список/поиск), GET /api/admin/analytics, IP whitelisting и отдельное ограничение по частоте для админов — ничего из этого не подтверждено в репозитории. Ниже перечислено то, что реально доступно в app/api/admin/**/route.ts начиная с v1.6.4.

    Админ-маршруты обслуживают консоль администратора (/admin/*): роли пользователей, модерация сущностей, верификационное управление, статусы заказов, бренд/AI настройки платформы, пайплайны ProcessConductor, инструменты Web3-деска и Email AI-CRM. Все браузерные запросы используют Auth.js session cookies на том же домене — см. API reference.

    Уровни доступа

    ПроверкаРолиОбычные маршруты
    isPlatformAdmin()admin, superadminПользователи, заказы, модерация, верификация
    isSuperadmin() / requireSuperadminApi()только superadminНастройки платформы, процессы, Web3-деск, сохранение бренда
    Проверки в сервисеАдмин в доменном сервисеОчередь модерации, действия по верификации
    requireEmailAdmin()Админ платформы + email CRM/api/admin/email/*

    SSOT: features/auth/user-role.ts — роли в нижнем регистре (visitor … superadmin).

    Что операторы контролируют через API администрирования

    Эти HTTP-обработчики поддерживают кнопки в UI администратора — вручную вы редко их вызываете, только для автоматизации.

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

    Трёхпанельная навигация с учётом ролей, вкладки Security hub, оболочка Email CRM — основной UI для всех этих API.

    Стол пользователя

    Просмотр и редактирование одного пользователя, смена роли, ручная выдача бейджа верификации, удаление аккаунта (не своего), вкладка Платежи (членство + пополнение счёта).

    Trust & Safety

    Панель безопасности (антифрод / верификация / события), очередь модерации, процедуры KYC.

    ERP магазина

    Схема авторизации

    Обработка админ-маршрута

    Глобального ограничения частоты для admin-маршрутов в app/api/admin/* нет. Добавляйте защиту на уровне edge/reverse proxy по ситуации.

    Реестр маршрутов (только подтверждённые)

    Пользователи и роли

    МетодПутьАвторизацияПримечания
    GET/api/admin/users/[id]Админ платформыJSONB-док пользователя, пароли скрыты
    GET/api/admin/users/[id]/paymentsАдмин платформыСтроки платежей (membership_upgrade, wallet_topup); query: ?limit= (до 100), ?purposes=a,b
    DELETE

    Связанная документация

    API-индекс

    Модель сессий и доменное деление.

    Email AI-CRM API

    Все маршруты /api/admin/email/*.

    Модель безопасности

    RBAC и уровни доступа.

    Мониторинг

    Аналитика админа и логирование ошибок.

    Wallet API — оракул

    API администрирования

    Фильтруйте по Founder / Developer в боковом меню. В старых версиях упоминались 12 конечных точек, придуманные маршруты GET /api/admin/users (список/поиск), GET /api/admin/analytics, IP whitelisting и отдельное ограничение по частоте для админов — ничего из этого не подтверждено в репозитории. Ниже перечислено то, что реально доступно в app/api/admin/**/route.ts начиная с v1.6.4.

    Админ-маршруты обслуживают консоль администратора (/admin/*): роли пользователей, модерация сущностей, верификационное управление, статусы заказов, бренд/AI настройки платформы, пайплайны ProcessConductor, инструменты Web3-деска и Email AI-CRM. Все браузерные запросы используют Auth.js session cookies на том же домене — см. API reference.

    Уровни доступа

    ПроверкаРолиОбычные маршруты
    isPlatformAdmin()admin, superadminПользователи, заказы, модерация, верификация
    isSuperadmin() / requireSuperadminApi()только superadminНастройки платформы, процессы, Web3-деск, сохранение бренда
    Проверки в сервисеАдмин в доменном сервисеОчередь модерации, действия по верификации
    requireEmailAdmin()Админ платформы + email CRM/api/admin/email/*

    SSOT: features/auth/user-role.ts — роли в нижнем регистре (visitor … superadmin).

    Что операторы контролируют через API администрирования

    Эти HTTP-обработчики поддерживают кнопки в UI администратора — вручную вы редко их вызываете, только для автоматизации.

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

    Трёхпанельная навигация с учётом ролей, вкладки Security hub, оболочка Email CRM — основной UI для всех этих API.

    Стол пользователя

    Просмотр и редактирование одного пользователя, смена роли, ручная выдача бейджа верификации, удаление аккаунта (не своего), вкладка Платежи (членство + пополнение счёта).

    Trust & Safety

    Панель безопасности (антифрод / верификация / события), очередь модерации, процедуры KYC.

    ERP магазина

    Схема авторизации

    Обработка админ-маршрута

    Глобального ограничения частоты для admin-маршрутов в app/api/admin/* нет. Добавляйте защиту на уровне edge/reverse proxy по ситуации.

    Реестр маршрутов (только подтверждённые)

    Пользователи и роли

    МетодПутьАвторизацияПримечания
    GET/api/admin/users/[id]Админ платформыJSONB-док пользователя, пароли скрыты
    GET/api/admin/users/[id]/paymentsАдмин платформыСтроки платежей (membership_upgrade, wallet_topup); query: ?limit= (до 100), ?purposes=a,b
    DELETE

    Связанная документация

    API-индекс

    Модель сессий и доменное деление.

    Email AI-CRM API

    Все маршруты /api/admin/email/*.

    Модель безопасности

    RBAC и уровни доступа.

    Мониторинг

    Аналитика админа и логирование ошибок.

    Wallet API — оракул

    API администрирования

    Фильтруйте по Founder / Developer в боковом меню. В старых версиях упоминались 12 конечных точек, придуманные маршруты GET /api/admin/users (список/поиск), GET /api/admin/analytics, IP whitelisting и отдельное ограничение по частоте для админов — ничего из этого не подтверждено в репозитории. Ниже перечислено то, что реально доступно в app/api/admin/**/route.ts начиная с v1.6.4.

    Админ-маршруты обслуживают консоль администратора (/admin/*): роли пользователей, модерация сущностей, верификационное управление, статусы заказов, бренд/AI настройки платформы, пайплайны ProcessConductor, инструменты Web3-деска и Email AI-CRM. Все браузерные запросы используют Auth.js session cookies на том же домене — см. API reference.

    Уровни доступа

    ПроверкаРолиОбычные маршруты
    isPlatformAdmin()admin, superadminПользователи, заказы, модерация, верификация
    isSuperadmin() / requireSuperadminApi()только superadminНастройки платформы, процессы, Web3-деск, сохранение бренда
    Проверки в сервисеАдмин в доменном сервисеОчередь модерации, действия по верификации
    requireEmailAdmin()Админ платформы + email CRM/api/admin/email/*

    SSOT: features/auth/user-role.ts — роли в нижнем регистре (visitor … superadmin).

    Что операторы контролируют через API администрирования

    Эти HTTP-обработчики поддерживают кнопки в UI администратора — вручную вы редко их вызываете, только для автоматизации.

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

    Трёхпанельная навигация с учётом ролей, вкладки Security hub, оболочка Email CRM — основной UI для всех этих API.

    Стол пользователя

    Просмотр и редактирование одного пользователя, смена роли, ручная выдача бейджа верификации, удаление аккаунта (не своего), вкладка Платежи (членство + пополнение счёта).

    Trust & Safety

    Панель безопасности (антифрод / верификация / события), очередь модерации, процедуры KYC.

    ERP магазина

    Схема авторизации

    Обработка админ-маршрута

    Глобального ограничения частоты для admin-маршрутов в app/api/admin/* нет. Добавляйте защиту на уровне edge/reverse proxy по ситуации.

    Реестр маршрутов (только подтверждённые)

    Пользователи и роли

    МетодПутьАвторизацияПримечания
    GET/api/admin/users/[id]Админ платформыJSONB-док пользователя, пароли скрыты
    GET/api/admin/users/[id]/paymentsАдмин платформыСтроки платежей (membership_upgrade, wallet_topup); query: ?limit= (до 100), ?purposes=a,b
    DELETE

    Связанная документация

    API-индекс

    Модель сессий и доменное деление.

    Email AI-CRM API

    Все маршруты /api/admin/email/*.

    Модель безопасности

    RBAC и уровни доступа.

    Мониторинг

    Аналитика админа и логирование ошибок.

    Wallet API — оракул

    Изменение статуса заказа: new → paid → processing → shipped → completed / canceled.

    Email AI-CRM

    Потоки, черновики, задачи, аналитика — отдельное email пространство для админов.

    Аналитика платформы

    Дашборд находится по /admin/analytics — это не монолитный /api/admin/analytics.

    Типовые сценарии работы оператора

    • Проверить платежи — Админ → Пользователи → Глаз → вкладка Платежи загружает GET /api/admin/users/{id}/payments (назначения: membership_upgrade, wallet_topup из payment_transactions).
    • Повысить роль участника — через UI администратора PUT /api/admin/users/{id}/role или наследованный POST /api/admin/set-user-role.
    • Обработать очередь верификации — /admin/security?tab=verification (старый /admin/verification перенаправляет сюда) → POST /api/admin/verification/procedures/{n}/{action} (approve, reject, request-info, under-review).
    • Заблокировать злонамеренную сущность — очередь модерации → POST /api/admin/entity-moderation/block с entityId и reason.
    • Сохранить новый бренд (цвета) — настройки superadmin → POST /api/admin/whitelabel/save (редирект на настройки).
    • Установить курс RING/USD — Web3-деск → POST /api/admin/web3/settings с { "nativePerMainCurrency": "..." }; хранится в коллекции platform_settings в namespace web3.

    Изменения только для superadmin (AI-ключи, JSON бренда, запуск пайплайнов вручную, курс RING) влияют на всех пользователей — ограничьте количество ролей superadmin в боевых клонах.

    /api/admin/users/[id]
    Админ платформы
    Самостоятельное удаление невозможно
    PUT/api/admin/users/[id]/roleАдмин платформыBody: { "role": "member" }
    PUT/api/admin/users/[id]/verificationРучная верификацияBody: { "isVerified": true, ... }
    POST/api/admin/set-user-roleАдмин платформыУстарело: { "uid", "role" }; запрещает самопонижение

    НЕ реализовано: GET /api/admin/users (список/поиск) — используйте UI администратора или DatabaseService для своих инструментов.

    UI для вкладки Платежи: компонент features/auth/components/admin-user-detail-sheet.tsx (открывается из admin-user-manager.tsx по кнопке-глаз), делает запрос /api/admin/users/${user.id}/payments?limit=50.

    Модерация и верификация

    МетодПутьПримечания
    GET/api/admin/entity-moderation{ items: EntityModerationQueueItem[] }
    POST/api/admin/entity-moderation/block{ entityId, reason }
    GET/api/admin/verification/queue{ success, queue }
    POST/api/admin/verification/procedures/[procedureNumber]/[action]approve | reject | request-info | under-review

    Магазин

    МетодПутьТело запроса
    POST/api/admin/orders/[id]/status{ "status": "processing" } (enum: new, paid, processing, shipped, completed, canceled)

    Настройки платформы (superadmin)

    МетодПутьПримечания
    GET/api/admin/platform-settings?namespace=ai|brandingЧтение namespace
    PUT/api/admin/platform-settingsJSON body: { namespace, data, secrets? }
    POST/api/admin/whitelabel/savePOST формы → цвета бренда → редирект
    POST/api/admin/saveУстарело: сохранение бренда (JSON, редирект)

    Персистентность: сервис features/admin/platform-settings/platform-settings-service.ts читает/записывает коллекцию platform_settings через db() из @/lib/database. Namespace ai и branding используют методы readDoc / updateDoc / createDoc и кэшируются модулем platform-settings-cache.ts.

    EnvЭффект
    PLATFORM_SETTINGS_DISABLE_DB=trueЧтение — дефолты/пусто, запись — ошибка. Для тестов/clone без БД.

    importPlatformSettingsFromEnv() подхватывает настройки из env и ring-config.json при отсутствии строк в БД.

    Процессы ProcessConductor (superadmin)

    МетодПутьНазначение
    GET/api/admin/processesСписок пайплайнов
    POST/api/admin/processes/[id]/runРучной запуск пайплайна
    GET/api/admin/processes/[id]/historyИстория запусков

    Кроны используют /api/cron/* + CRON_SECRET — подробнее см. ProcessConductor в Monitoring.

    Web3-деск (superadmin)

    МетодПутьПримечания
    GET/api/admin/web3/settingsКурс оракула, настройка, аудит-лог, газ-резерв
    POST/api/admin/web3/settings{ "nativePerMainCurrency": "..." }
    GET/api/admin/web3/gas-reserveБаланс fee-payer Solana

    Хранение курса оракула: сервис features/wallet/services/native-token-oracle.ts хранит nativePerMainCurrency и аудит в документе platform_settings id web3 (через db()). Если PLATFORM_SETTINGS_DISABLE_DB=true — чтение из RING_ORACLE_DEFAULT_RATE (100), запись блокируется.

    Email AI-CRM (админ платформы)

    Полная таблица маршрутов: Email AI-CRM API — потоки, черновики, задачи, контакты, GET /api/admin/email/analytics?range=7d.

    Обслуживание (superadmin, будьте осторожны)

    МетодПутьНазначение
    POST/api/admin/migrate-usersРазовая миграция пользователей — не используйте как рутину

    Аналитика (НЕ через /api/admin)

    МетодПутьАвторизация
    GET/api/analytics/platform-statsАдмин платформы
    GET/api/analytics/web-vitals?scope=platformАдмин платформы
    GET/api/analytics/errorsАдмин платформы

    В UI: /admin/analytics → getPlatformAnalytics() (features/analytics/services/get-platform-analytics.ts).

    Пример — смена роли

    1. 1

      Войти как админ через браузер

      Войдите под аккаунтом с ролью admin или superadmin.

    2. 2

      PUT — смена роли

    3. 3

      Проверить

      Обновите пользователя или откройте Admin → Users; роль будет в нижнем регистре в users.data.role.

    Котировки для пользователей; админский rate см. в Web3-деске выше.

    Изменение статуса заказа: new → paid → processing → shipped → completed / canceled.

    Email AI-CRM

    Потоки, черновики, задачи, аналитика — отдельное email пространство для админов.

    Аналитика платформы

    Дашборд находится по /admin/analytics — это не монолитный /api/admin/analytics.

    Типовые сценарии работы оператора

    • Проверить платежи — Админ → Пользователи → Глаз → вкладка Платежи загружает GET /api/admin/users/{id}/payments (назначения: membership_upgrade, wallet_topup из payment_transactions).
    • Повысить роль участника — через UI администратора PUT /api/admin/users/{id}/role или наследованный POST /api/admin/set-user-role.
    • Обработать очередь верификации — /admin/security?tab=verification (старый /admin/verification перенаправляет сюда) → POST /api/admin/verification/procedures/{n}/{action} (approve, reject, request-info, under-review).
    • Заблокировать злонамеренную сущность — очередь модерации → POST /api/admin/entity-moderation/block с entityId и reason.
    • Сохранить новый бренд (цвета) — настройки superadmin → POST /api/admin/whitelabel/save (редирект на настройки).
    • Установить курс RING/USD — Web3-деск → POST /api/admin/web3/settings с { "nativePerMainCurrency": "..." }; хранится в коллекции platform_settings в namespace web3.

    Изменения только для superadmin (AI-ключи, JSON бренда, запуск пайплайнов вручную, курс RING) влияют на всех пользователей — ограничьте количество ролей superadmin в боевых клонах.

    /api/admin/users/[id]
    Админ платформы
    Самостоятельное удаление невозможно
    PUT/api/admin/users/[id]/roleАдмин платформыBody: { "role": "member" }
    PUT/api/admin/users/[id]/verificationРучная верификацияBody: { "isVerified": true, ... }
    POST/api/admin/set-user-roleАдмин платформыУстарело: { "uid", "role" }; запрещает самопонижение

    НЕ реализовано: GET /api/admin/users (список/поиск) — используйте UI администратора или DatabaseService для своих инструментов.

    UI для вкладки Платежи: компонент features/auth/components/admin-user-detail-sheet.tsx (открывается из admin-user-manager.tsx по кнопке-глаз), делает запрос /api/admin/users/${user.id}/payments?limit=50.

    Модерация и верификация

    МетодПутьПримечания
    GET/api/admin/entity-moderation{ items: EntityModerationQueueItem[] }
    POST/api/admin/entity-moderation/block{ entityId, reason }
    GET/api/admin/verification/queue{ success, queue }
    POST/api/admin/verification/procedures/[procedureNumber]/[action]approve | reject | request-info | under-review

    Магазин

    МетодПутьТело запроса
    POST/api/admin/orders/[id]/status{ "status": "processing" } (enum: new, paid, processing, shipped, completed, canceled)

    Настройки платформы (superadmin)

    МетодПутьПримечания
    GET/api/admin/platform-settings?namespace=ai|brandingЧтение namespace
    PUT/api/admin/platform-settingsJSON body: { namespace, data, secrets? }
    POST/api/admin/whitelabel/savePOST формы → цвета бренда → редирект
    POST/api/admin/saveУстарело: сохранение бренда (JSON, редирект)

    Персистентность: сервис features/admin/platform-settings/platform-settings-service.ts читает/записывает коллекцию platform_settings через db() из @/lib/database. Namespace ai и branding используют методы readDoc / updateDoc / createDoc и кэшируются модулем platform-settings-cache.ts.

    EnvЭффект
    PLATFORM_SETTINGS_DISABLE_DB=trueЧтение — дефолты/пусто, запись — ошибка. Для тестов/clone без БД.

    importPlatformSettingsFromEnv() подхватывает настройки из env и ring-config.json при отсутствии строк в БД.

    Процессы ProcessConductor (superadmin)

    МетодПутьНазначение
    GET/api/admin/processesСписок пайплайнов
    POST/api/admin/processes/[id]/runРучной запуск пайплайна
    GET/api/admin/processes/[id]/historyИстория запусков

    Кроны используют /api/cron/* + CRON_SECRET — подробнее см. ProcessConductor в Monitoring.

    Web3-деск (superadmin)

    МетодПутьПримечания
    GET/api/admin/web3/settingsКурс оракула, настройка, аудит-лог, газ-резерв
    POST/api/admin/web3/settings{ "nativePerMainCurrency": "..." }
    GET/api/admin/web3/gas-reserveБаланс fee-payer Solana

    Хранение курса оракула: сервис features/wallet/services/native-token-oracle.ts хранит nativePerMainCurrency и аудит в документе platform_settings id web3 (через db()). Если PLATFORM_SETTINGS_DISABLE_DB=true — чтение из RING_ORACLE_DEFAULT_RATE (100), запись блокируется.

    Email AI-CRM (админ платформы)

    Полная таблица маршрутов: Email AI-CRM API — потоки, черновики, задачи, контакты, GET /api/admin/email/analytics?range=7d.

    Обслуживание (superadmin, будьте осторожны)

    МетодПутьНазначение
    POST/api/admin/migrate-usersРазовая миграция пользователей — не используйте как рутину

    Аналитика (НЕ через /api/admin)

    МетодПутьАвторизация
    GET/api/analytics/platform-statsАдмин платформы
    GET/api/analytics/web-vitals?scope=platformАдмин платформы
    GET/api/analytics/errorsАдмин платформы

    В UI: /admin/analytics → getPlatformAnalytics() (features/analytics/services/get-platform-analytics.ts).

    Пример — смена роли

    1. 1

      Войти как админ через браузер

      Войдите под аккаунтом с ролью admin или superadmin.

    2. 2

      PUT — смена роли

    3. 3

      Проверить

      Обновите пользователя или откройте Admin → Users; роль будет в нижнем регистре в users.data.role.

    Котировки для пользователей; админский rate см. в Web3-деске выше.

    Изменение статуса заказа: new → paid → processing → shipped → completed / canceled.

    Email AI-CRM

    Потоки, черновики, задачи, аналитика — отдельное email пространство для админов.

    Аналитика платформы

    Дашборд находится по /admin/analytics — это не монолитный /api/admin/analytics.

    Типовые сценарии работы оператора

    • Проверить платежи — Админ → Пользователи → Глаз → вкладка Платежи загружает GET /api/admin/users/{id}/payments (назначения: membership_upgrade, wallet_topup из payment_transactions).
    • Повысить роль участника — через UI администратора PUT /api/admin/users/{id}/role или наследованный POST /api/admin/set-user-role.
    • Обработать очередь верификации — /admin/security?tab=verification (старый /admin/verification перенаправляет сюда) → POST /api/admin/verification/procedures/{n}/{action} (approve, reject, request-info, under-review).
    • Заблокировать злонамеренную сущность — очередь модерации → POST /api/admin/entity-moderation/block с entityId и reason.
    • Сохранить новый бренд (цвета) — настройки superadmin → POST /api/admin/whitelabel/save (редирект на настройки).
    • Установить курс RING/USD — Web3-деск → POST /api/admin/web3/settings с { "nativePerMainCurrency": "..." }; хранится в коллекции platform_settings в namespace web3.

    Изменения только для superadmin (AI-ключи, JSON бренда, запуск пайплайнов вручную, курс RING) влияют на всех пользователей — ограничьте количество ролей superadmin в боевых клонах.

    /api/admin/users/[id]
    Админ платформы
    Самостоятельное удаление невозможно
    PUT/api/admin/users/[id]/roleАдмин платформыBody: { "role": "member" }
    PUT/api/admin/users/[id]/verificationРучная верификацияBody: { "isVerified": true, ... }
    POST/api/admin/set-user-roleАдмин платформыУстарело: { "uid", "role" }; запрещает самопонижение

    НЕ реализовано: GET /api/admin/users (список/поиск) — используйте UI администратора или DatabaseService для своих инструментов.

    UI для вкладки Платежи: компонент features/auth/components/admin-user-detail-sheet.tsx (открывается из admin-user-manager.tsx по кнопке-глаз), делает запрос /api/admin/users/${user.id}/payments?limit=50.

    Модерация и верификация

    МетодПутьПримечания
    GET/api/admin/entity-moderation{ items: EntityModerationQueueItem[] }
    POST/api/admin/entity-moderation/block{ entityId, reason }
    GET/api/admin/verification/queue{ success, queue }
    POST/api/admin/verification/procedures/[procedureNumber]/[action]approve | reject | request-info | under-review

    Магазин

    МетодПутьТело запроса
    POST/api/admin/orders/[id]/status{ "status": "processing" } (enum: new, paid, processing, shipped, completed, canceled)

    Настройки платформы (superadmin)

    МетодПутьПримечания
    GET/api/admin/platform-settings?namespace=ai|brandingЧтение namespace
    PUT/api/admin/platform-settingsJSON body: { namespace, data, secrets? }
    POST/api/admin/whitelabel/savePOST формы → цвета бренда → редирект
    POST/api/admin/saveУстарело: сохранение бренда (JSON, редирект)

    Персистентность: сервис features/admin/platform-settings/platform-settings-service.ts читает/записывает коллекцию platform_settings через db() из @/lib/database. Namespace ai и branding используют методы readDoc / updateDoc / createDoc и кэшируются модулем platform-settings-cache.ts.

    EnvЭффект
    PLATFORM_SETTINGS_DISABLE_DB=trueЧтение — дефолты/пусто, запись — ошибка. Для тестов/clone без БД.

    importPlatformSettingsFromEnv() подхватывает настройки из env и ring-config.json при отсутствии строк в БД.

    Процессы ProcessConductor (superadmin)

    МетодПутьНазначение
    GET/api/admin/processesСписок пайплайнов
    POST/api/admin/processes/[id]/runРучной запуск пайплайна
    GET/api/admin/processes/[id]/historyИстория запусков

    Кроны используют /api/cron/* + CRON_SECRET — подробнее см. ProcessConductor в Monitoring.

    Web3-деск (superadmin)

    МетодПутьПримечания
    GET/api/admin/web3/settingsКурс оракула, настройка, аудит-лог, газ-резерв
    POST/api/admin/web3/settings{ "nativePerMainCurrency": "..." }
    GET/api/admin/web3/gas-reserveБаланс fee-payer Solana

    Хранение курса оракула: сервис features/wallet/services/native-token-oracle.ts хранит nativePerMainCurrency и аудит в документе platform_settings id web3 (через db()). Если PLATFORM_SETTINGS_DISABLE_DB=true — чтение из RING_ORACLE_DEFAULT_RATE (100), запись блокируется.

    Email AI-CRM (админ платформы)

    Полная таблица маршрутов: Email AI-CRM API — потоки, черновики, задачи, контакты, GET /api/admin/email/analytics?range=7d.

    Обслуживание (superadmin, будьте осторожны)

    МетодПутьНазначение
    POST/api/admin/migrate-usersРазовая миграция пользователей — не используйте как рутину

    Аналитика (НЕ через /api/admin)

    МетодПутьАвторизация
    GET/api/analytics/platform-statsАдмин платформы
    GET/api/analytics/web-vitals?scope=platformАдмин платформы
    GET/api/analytics/errorsАдмин платформы

    В UI: /admin/analytics → getPlatformAnalytics() (features/analytics/services/get-platform-analytics.ts).

    Пример — смена роли

    1. 1

      Войти как админ через браузер

      Войдите под аккаунтом с ролью admin или superadmin.

    2. 2

      PUT — смена роли

    3. 3

      Проверить

      Обновите пользователя или откройте Admin → Users; роль будет в нижнем регистре в users.data.role.

    Котировки для пользователей; админский rate см. в Web3-деске выше.

    1. Документация
    2. /API-интерфейс
    3. /API администрирования
    Обновлено 10 июл. 2026 г.6 мин прослушивания
    1. Документация
    2. /API-интерфейс
    3. /API администрирования
    Обновлено 10 июл. 2026 г.6 мин прослушивания
    1. Документация
    2. /API-интерфейс
    3. /API администрирования
    Обновлено 10 июл. 2026 г.6 мин прослушивания