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

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

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

    Documentation

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

    Добро пожаловать в Ring
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Членство и кредиты
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    WalletConductor
    Реферальные коды (Refcodes)
    Шторка страницы
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Организации
    Возможности
    AI Matcher
    Messaging
    Peer Games
    News
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Уведомления
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Ring Mailer и RingdomX Mail
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Быстрый старт — ваш первый клон Ring
    Руководство по кастомизации
    Vertical Presets (SSOT)
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Интеграция платёжного шлюза
    Референсные деплои Ring
    Конфигурация проекта
    Публичные переменные окружения
    Секреты Order Lab
    Project ID WalletConnect (Reown Cloud)
    Поддерживаемые сервисы
    Вики NODUS (знания проекта)
    Плейбук конфигурации
    Web3
    Token launch jurisdictions
    Кошелёк
    Советы по безопасности кошелька
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Развёртывание на собственном сервере
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    Архитектура PaymentConductor
    Wallet Conductor
    Архитектура News Kingdom
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server
    OSS и enterprise

    Быстрый вход (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
    Ring Oracle
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    WalletConductor
    Реферальные коды (Refcodes)
    Шторка страницы
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Организации
    Возможности
    AI Matcher
    Messaging
    Peer Games
    News
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Уведомления
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Ring Mailer и RingdomX Mail
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Быстрый старт — ваш первый клон Ring
    Руководство по кастомизации
    Vertical Presets (SSOT)
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Интеграция платёжного шлюза
    Референсные деплои Ring
    Конфигурация проекта
    Публичные переменные окружения
    Секреты Order Lab
    Project ID WalletConnect (Reown Cloud)
    Поддерживаемые сервисы
    Вики NODUS (знания проекта)
    Плейбук конфигурации
    Web3
    Token launch jurisdictions
    Кошелёк
    Советы по безопасности кошелька
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Развёртывание на собственном сервере
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    Архитектура PaymentConductor
    Wallet Conductor
    Архитектура News Kingdom
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server
    OSS и enterprise

    Быстрый вход (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
    Ring Oracle
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    WalletConductor
    Реферальные коды (Refcodes)
    Шторка страницы
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Организации
    Возможности
    AI Matcher
    Messaging
    Peer Games
    News
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Уведомления
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Ring Mailer и RingdomX Mail
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    Базовая настройка
    White Label
    Custom Branding
    Интеграция Web3
    Реальные Проекты
    Advanced Features
    Кастомизация
    Быстрый старт — ваш первый клон Ring
    Руководство по кастомизации
    Vertical Presets (SSOT)
    Руководство по Ringization
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Интеграция платёжного шлюза
    Референсные деплои Ring
    Конфигурация проекта
    Публичные переменные окружения
    Секреты Order Lab
    Project ID WalletConnect (Reown Cloud)
    Поддерживаемые сервисы
    Вики NODUS (знания проекта)
    Плейбук конфигурации
    Web3
    Token launch jurisdictions
    Кошелёк
    Советы по безопасности кошелька
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Развёртывание на собственном сервере
    Vercel
    Docker
    Конфигурация Окружения
    Мониторинг и аналитика
    Оптимизация производительности
    Резервное копирование и восстановление
    Архитектура
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    Архитектура PaymentConductor
    Wallet Conductor
    Архитектура News Kingdom
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server
    OSS и enterprise

    Быстрый вход (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


    title: Мультивендорный магазин description: Мультивендорный маркетплейс: онбординг продавцов, кэшированный каталог, корзина на клиенте и сервере, аутентифицированное оформление, Agent Knowledge Research, комиссии по уровням и ограничение аудитории для участников last_modified: "2026-10-26" audience: both

    Мультивендорный магазин

    Ring Platform поставляется с мультивендорным маркетплейсом: любая верифицированная организация может стать продавцом, выставлять товары и зарабатывать после расчёта оплаченных заказов. Покупатели просматривают кэшированный каталог, держат корзину, а затем оформляют заказ через аутентифицированный заказ + рейки PaymentConductor. Продавцы обогащают тексты каталога через Agent Knowledge Research (WebConductor → поля, markdown, Admin Wiki NODUS, альтернативные изображения в File Cabinet) и явно добавляют медиа в галерею.

    Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Корзина и оформление ниже соответствуют features/store + app/api/store/* в Layer1; не придумывайте дополнительный REST корзины сверх проверенного сессионного зеркала.

    Карта возможностей

    АспектГде находитсяПримечания
    SSOT каталогаgetCachedProductCatalog() → GET /api/store/products'use cache' + cacheTag('store:products'); инвалидируйте через updateTag после создания
    Гостевая корзинаКлюч localStorage ring_cart{ id, qty }[] в features/store/context.tsx
    Зеркало корзины с аутентификациейGET/POST /api/store/cartПривязано к сессии; игнорирует клиентский userId; мягкое резервирование через POST /api/store/cart/hold
    ОформлениеPOST /api/store/checkoutТребуется аутентификация → StoreOrdersService + резервирование запасов
    ОплатаPOST /api/store/payments/*Назначение PaymentConductor store_order
    Панель продавца/vendor/start, /vendor/productsServer actions, а не /api/store/vendors
    Комиссииsettlement.ts + /admin/store/commissionsПроцент платформы по уровню из TIER_BENEFITS (StoreTier)

    Почему мультивендорный магазин важен для вашего клона

    Каждая организация в вашем развёртывании Ring может стать продавцом, внешний маркетплейс не нужен. Доход платформы поступает из комиссий по уровням с рассчитанных продаж. Продавцы сами ведут каталог; операторы одобряют товары и рассчитывают комиссии из панели администратора.

    Ключевые возможности оператора

    Жизненный цикл продавца

    Онбординг организаций на /vendor/start. Оценка доверия, переход между уровнями и приостановка в vendor-lifecycle.

    Agent Knowledge Research

    В формах создания и редактирования товара: Research → поля + markdown + wiki NODUS + альтернативные изображения в кабинете. Use in gallery работает только явно, ничто тихо не заменяет основное фото.

    Расчёт комиссий

    Комиссия платформы по уровню с каждой продажи. Панель администратора на /admin/store/commissions: пробный запуск и обработка причитающихся выплат.

    Реализация

    Мультивендорная архитектура

    Корзина и оформление (проверено, без выдуманных маршрутов)

    ЧастьПутьРоль
    Клиентский контекстfeatures/store/context.tsxГлобальный StoreProvider; откладывает загрузку каталога, пока путь не содержит /store или в ring_cart есть позиции; одиночный GET /api/store/products
    Гостевые позицииuseLocalStorage('ring_cart'){ id, qty }[]
    Серверная корзина

    Частые вопросы

    Влияние

    Сохранят ли гости корзину без входа?

    Да, позиции хранятся в ring_cart на устройстве. Вход подтягивает данные из GET /api/store/cart (сервер имеет приоритет), а последующие изменения отправляются POST обратно в сессионное зеркало.

    Начисляются ли комиссии, когда кто-то добавляет в корзину?

    Нет. Комиссия платформы и реферальные доли вычисляются при расчёте заказа продавца, когда существует оплачиваемый заказ, а не при изменениях корзины.

    Создаёт ли посещение страницы товара чат?

    Нет. Ветка товара появляется в Messages только после того, как покупатель напишет агенту товара.

    Могут ли товары только для участников появляться на публичной витрине?

    Не для не-участников. getStoreProducts фильтрует productAudience: 'member', если зритель не администратор и не имеет привилегий участника.

    Миграция

    Мы использовали только клиентскую корзину без серверного зеркала, что меняется?

    Оставьте ring_cart для гостей. Для аутентифицированных покупателей считайте /api/store/cart SSOT при загрузке и после изменений; мягкое резервирование может возвращать 409 при нехватке запасов. Оформление по-прежнему требует сессии.

    Действителен ли ещё POST /api/store/orders?

    Оформление и заказы используют общий платёжный конвейер orders через StoreOrdersService. Предпочитайте задокументированный вход оформления, который использует HttpStoreAdapter (/api/store/checkout). Избегайте любого устаревшего пути, писавшего только в store_orders: платёжные вебхуки их не рассчитывают.

    Эксплуатация

    Где операторы рассчитывают выплаты продавцам?

    /admin/store/commissions: пробный запуск причитающихся выплат, обработка причитающихся и удержание. Подробно: Commissions & Settlements.

    Каталог выглядит устаревшим после создания товара, что инвалидировать?

    Вызовите updateTag('store:products') (уже подключено при создании товара в app/api/store/products/route.ts). Потребители должны работать через getCachedProductCatalog().

    Как платежи привязываются к оформлению в магазине?

    После создания заказа UI отправляет POST на /api/store/payments/{wayforpay|stripe|credit|token|paypal|card} → назначение PaymentConductor store_order. См. PaymentConductor и Store API.

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

    Related documentation

    Page Curtain

    См. также: рекламируйте товары в шторке страницы и платите авторам комиссию.

    PaymentConductor

    Зависит от: оформления store_order рассчитываются через PaymentConductor и реестр payment_transactions.

    Payments Overview

    Тот же процесс: платёжные рейки клона и ограничения env, которые учитывают способы оплаты магазина.

    Ring ERP

    Следующий шаг: хаб ERP для инварианта запасов, commitSale и панели расчётов.

    1. Документация
    2. /Функции
    3. /Store

    9 мин прослушивания


    title: Мультивендорный магазин description: Мультивендорный маркетплейс: онбординг продавцов, кэшированный каталог, корзина на клиенте и сервере, аутентифицированное оформление, Agent Knowledge Research, комиссии по уровням и ограничение аудитории для участников last_modified: "2026-10-26" audience: both

    Мультивендорный магазин

    Ring Platform поставляется с мультивендорным маркетплейсом: любая верифицированная организация может стать продавцом, выставлять товары и зарабатывать после расчёта оплаченных заказов. Покупатели просматривают кэшированный каталог, держат корзину, а затем оформляют заказ через аутентифицированный заказ + рейки PaymentConductor. Продавцы обогащают тексты каталога через Agent Knowledge Research (WebConductor → поля, markdown, Admin Wiki NODUS, альтернативные изображения в File Cabinet) и явно добавляют медиа в галерею.

    Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Корзина и оформление ниже соответствуют features/store + app/api/store/* в Layer1; не придумывайте дополнительный REST корзины сверх проверенного сессионного зеркала.

    Карта возможностей

    АспектГде находитсяПримечания
    SSOT каталогаgetCachedProductCatalog() → GET /api/store/products'use cache' + cacheTag('store:products'); инвалидируйте через updateTag после создания
    Гостевая корзинаКлюч localStorage ring_cart{ id, qty }[] в features/store/context.tsx
    Зеркало корзины с аутентификациейGET/POST /api/store/cartПривязано к сессии; игнорирует клиентский userId; мягкое резервирование через POST /api/store/cart/hold
    ОформлениеPOST /api/store/checkoutТребуется аутентификация → StoreOrdersService + резервирование запасов
    ОплатаPOST /api/store/payments/*Назначение PaymentConductor store_order
    Панель продавца/vendor/start, /vendor/productsServer actions, а не /api/store/vendors
    Комиссииsettlement.ts + /admin/store/commissionsПроцент платформы по уровню из TIER_BENEFITS (StoreTier)

    Почему мультивендорный магазин важен для вашего клона

    Каждая организация в вашем развёртывании Ring может стать продавцом, внешний маркетплейс не нужен. Доход платформы поступает из комиссий по уровням с рассчитанных продаж. Продавцы сами ведут каталог; операторы одобряют товары и рассчитывают комиссии из панели администратора.

    Ключевые возможности оператора

    Жизненный цикл продавца

    Онбординг организаций на /vendor/start. Оценка доверия, переход между уровнями и приостановка в vendor-lifecycle.

    Agent Knowledge Research

    В формах создания и редактирования товара: Research → поля + markdown + wiki NODUS + альтернативные изображения в кабинете. Use in gallery работает только явно, ничто тихо не заменяет основное фото.

    Расчёт комиссий

    Комиссия платформы по уровню с каждой продажи. Панель администратора на /admin/store/commissions: пробный запуск и обработка причитающихся выплат.

    Реализация

    Мультивендорная архитектура

    Корзина и оформление (проверено, без выдуманных маршрутов)

    ЧастьПутьРоль
    Клиентский контекстfeatures/store/context.tsxГлобальный StoreProvider; откладывает загрузку каталога, пока путь не содержит /store или в ring_cart есть позиции; одиночный GET /api/store/products
    Гостевые позицииuseLocalStorage('ring_cart'){ id, qty }[]
    Серверная корзина

    Частые вопросы

    Влияние

    Сохранят ли гости корзину без входа?

    Да, позиции хранятся в ring_cart на устройстве. Вход подтягивает данные из GET /api/store/cart (сервер имеет приоритет), а последующие изменения отправляются POST обратно в сессионное зеркало.

    Начисляются ли комиссии, когда кто-то добавляет в корзину?

    Нет. Комиссия платформы и реферальные доли вычисляются при расчёте заказа продавца, когда существует оплачиваемый заказ, а не при изменениях корзины.

    Создаёт ли посещение страницы товара чат?

    Нет. Ветка товара появляется в Messages только после того, как покупатель напишет агенту товара.

    Могут ли товары только для участников появляться на публичной витрине?

    Не для не-участников. getStoreProducts фильтрует productAudience: 'member', если зритель не администратор и не имеет привилегий участника.

    Миграция

    Мы использовали только клиентскую корзину без серверного зеркала, что меняется?

    Оставьте ring_cart для гостей. Для аутентифицированных покупателей считайте /api/store/cart SSOT при загрузке и после изменений; мягкое резервирование может возвращать 409 при нехватке запасов. Оформление по-прежнему требует сессии.

    Действителен ли ещё POST /api/store/orders?

    Оформление и заказы используют общий платёжный конвейер orders через StoreOrdersService. Предпочитайте задокументированный вход оформления, который использует HttpStoreAdapter (/api/store/checkout). Избегайте любого устаревшего пути, писавшего только в store_orders: платёжные вебхуки их не рассчитывают.

    Эксплуатация

    Где операторы рассчитывают выплаты продавцам?

    /admin/store/commissions: пробный запуск причитающихся выплат, обработка причитающихся и удержание. Подробно: Commissions & Settlements.

    Каталог выглядит устаревшим после создания товара, что инвалидировать?

    Вызовите updateTag('store:products') (уже подключено при создании товара в app/api/store/products/route.ts). Потребители должны работать через getCachedProductCatalog().

    Как платежи привязываются к оформлению в магазине?

    После создания заказа UI отправляет POST на /api/store/payments/{wayforpay|stripe|credit|token|paypal|card} → назначение PaymentConductor store_order. См. PaymentConductor и Store API.

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

    Related documentation

    Page Curtain

    См. также: рекламируйте товары в шторке страницы и платите авторам комиссию.

    PaymentConductor

    Зависит от: оформления store_order рассчитываются через PaymentConductor и реестр payment_transactions.

    Payments Overview

    Тот же процесс: платёжные рейки клона и ограничения env, которые учитывают способы оплаты магазина.

    Ring ERP

    Следующий шаг: хаб ERP для инварианта запасов, commitSale и панели расчётов.

    1. Документация
    2. /Функции
    3. /Store

    9 мин прослушивания


    title: Мультивендорный магазин description: Мультивендорный маркетплейс: онбординг продавцов, кэшированный каталог, корзина на клиенте и сервере, аутентифицированное оформление, Agent Knowledge Research, комиссии по уровням и ограничение аудитории для участников last_modified: "2026-10-26" audience: both

    Мультивендорный магазин

    Ring Platform поставляется с мультивендорным маркетплейсом: любая верифицированная организация может стать продавцом, выставлять товары и зарабатывать после расчёта оплаченных заказов. Покупатели просматривают кэшированный каталог, держат корзину, а затем оформляют заказ через аутентифицированный заказ + рейки PaymentConductor. Продавцы обогащают тексты каталога через Agent Knowledge Research (WebConductor → поля, markdown, Admin Wiki NODUS, альтернативные изображения в File Cabinet) и явно добавляют медиа в галерею.

    Используйте вкладки Founder / Developer в боковой панели документации, чтобы отфильтровать эту страницу. Корзина и оформление ниже соответствуют features/store + app/api/store/* в Layer1; не придумывайте дополнительный REST корзины сверх проверенного сессионного зеркала.

    Карта возможностей

    АспектГде находитсяПримечания
    SSOT каталогаgetCachedProductCatalog() → GET /api/store/products'use cache' + cacheTag('store:products'); инвалидируйте через updateTag после создания
    Гостевая корзинаКлюч localStorage ring_cart{ id, qty }[] в features/store/context.tsx
    Зеркало корзины с аутентификациейGET/POST /api/store/cartПривязано к сессии; игнорирует клиентский userId; мягкое резервирование через POST /api/store/cart/hold
    ОформлениеPOST /api/store/checkoutТребуется аутентификация → StoreOrdersService + резервирование запасов
    ОплатаPOST /api/store/payments/*Назначение PaymentConductor store_order
    Панель продавца/vendor/start, /vendor/productsServer actions, а не /api/store/vendors
    Комиссииsettlement.ts + /admin/store/commissionsПроцент платформы по уровню из TIER_BENEFITS (StoreTier)

    Почему мультивендорный магазин важен для вашего клона

    Каждая организация в вашем развёртывании Ring может стать продавцом, внешний маркетплейс не нужен. Доход платформы поступает из комиссий по уровням с рассчитанных продаж. Продавцы сами ведут каталог; операторы одобряют товары и рассчитывают комиссии из панели администратора.

    Ключевые возможности оператора

    Жизненный цикл продавца

    Онбординг организаций на /vendor/start. Оценка доверия, переход между уровнями и приостановка в vendor-lifecycle.

    Agent Knowledge Research

    В формах создания и редактирования товара: Research → поля + markdown + wiki NODUS + альтернативные изображения в кабинете. Use in gallery работает только явно, ничто тихо не заменяет основное фото.

    Расчёт комиссий

    Комиссия платформы по уровню с каждой продажи. Панель администратора на /admin/store/commissions: пробный запуск и обработка причитающихся выплат.

    Реализация

    Мультивендорная архитектура

    Корзина и оформление (проверено, без выдуманных маршрутов)

    ЧастьПутьРоль
    Клиентский контекстfeatures/store/context.tsxГлобальный StoreProvider; откладывает загрузку каталога, пока путь не содержит /store или в ring_cart есть позиции; одиночный GET /api/store/products
    Гостевые позицииuseLocalStorage('ring_cart'){ id, qty }[]
    Серверная корзина

    Частые вопросы

    Влияние

    Сохранят ли гости корзину без входа?

    Да, позиции хранятся в ring_cart на устройстве. Вход подтягивает данные из GET /api/store/cart (сервер имеет приоритет), а последующие изменения отправляются POST обратно в сессионное зеркало.

    Начисляются ли комиссии, когда кто-то добавляет в корзину?

    Нет. Комиссия платформы и реферальные доли вычисляются при расчёте заказа продавца, когда существует оплачиваемый заказ, а не при изменениях корзины.

    Создаёт ли посещение страницы товара чат?

    Нет. Ветка товара появляется в Messages только после того, как покупатель напишет агенту товара.

    Могут ли товары только для участников появляться на публичной витрине?

    Не для не-участников. getStoreProducts фильтрует productAudience: 'member', если зритель не администратор и не имеет привилегий участника.

    Миграция

    Мы использовали только клиентскую корзину без серверного зеркала, что меняется?

    Оставьте ring_cart для гостей. Для аутентифицированных покупателей считайте /api/store/cart SSOT при загрузке и после изменений; мягкое резервирование может возвращать 409 при нехватке запасов. Оформление по-прежнему требует сессии.

    Действителен ли ещё POST /api/store/orders?

    Оформление и заказы используют общий платёжный конвейер orders через StoreOrdersService. Предпочитайте задокументированный вход оформления, который использует HttpStoreAdapter (/api/store/checkout). Избегайте любого устаревшего пути, писавшего только в store_orders: платёжные вебхуки их не рассчитывают.

    Эксплуатация

    Где операторы рассчитывают выплаты продавцам?

    /admin/store/commissions: пробный запуск причитающихся выплат, обработка причитающихся и удержание. Подробно: Commissions & Settlements.

    Каталог выглядит устаревшим после создания товара, что инвалидировать?

    Вызовите updateTag('store:products') (уже подключено при создании товара в app/api/store/products/route.ts). Потребители должны работать через getCachedProductCatalog().

    Как платежи привязываются к оформлению в магазине?

    После создания заказа UI отправляет POST на /api/store/payments/{wayforpay|stripe|credit|token|paypal|card} → назначение PaymentConductor store_order. См. PaymentConductor и Store API.

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

    Related documentation

    Page Curtain

    См. также: рекламируйте товары в шторке страницы и платите авторам комиссию.

    PaymentConductor

    Зависит от: оформления store_order рассчитываются через PaymentConductor и реестр payment_transactions.

    Payments Overview

    Тот же процесс: платёжные рейки клона и ограничения env, которые учитывают способы оплаты магазина.

    Ring ERP

    Следующий шаг: хаб ERP для инварианта запасов, commitSale и панели расчётов.

    1. Документация
    2. /Функции
    3. /Store

    9 мин прослушивания

    Ограничение аудитории товара

    Отмечайте товары только для участников. Не-участники видят только публичные товары (hasMemberPrivileges()).

    Оплата заказов магазина

    После оформления покупатели платят через PaymentConductor (store_order): WayForPay, Stripe, кредит, токен или PayPal, если включено.

    Запасы ERP

    Оформление резервирует запасы; вебхуки оплаты запускают commitSale, поэтому запасы и расчёты остаются согласованными.

    Типичные сценарии

    • Сеть локального бизнеса: каждый магазин выставляет ассортимент; расчёты выполняются из панели комиссий.
    • Каталог DAO / участников: SKU только для участников; публичные товары как лид-магниты (productAudience: 'member').
    • Обогащение каталога: продавец вставляет URL производителя, запускает Research, просматривает предложенные поля, сохраняет Agent Knowledge, а затем нажимает Use in gallery только для фото, которые хочет видеть на витрине.
    • Помощь DAGI: инструмент чата ERP продавца dagi_research_product возвращает те же предложенные поля / медиа исследования / путь в кабинете для привязанного продавца.

    Чаты агента товара на витрине используют Conversation.type: 'product' и остаются видимыми в Messages. Чаты инструмента Generative Gallery устанавливают метаданные kind: 'generative_gallery' (фильтрация ящика в conversation-service). См. Messaging и Generative Gallery.

    Уровни комиссий (для оператора)

    Комиссия платформы при расчёте использует преимущества StoreTier (constants/store.ts → TIER_BENEFITS):

    Уровень магазинаКомиссия платформы, %Типичная частота расчётов
    starter20%Еженедельно
    growth17%Ежедневно
    professional15%Ежедневно
    enterprise12%Мгновенно

    Запасное значение, когда преимущества уровня отсутствуют: DEFAULT_COMMISSION_PCT = 15. Уровни доверия продавца (new → premium) отслеживают репутацию отдельно от уровня магазина. Реферальная комиссия это двойная рейка, см. Commissions и refcodes.

    features/store/services/server-cart.ts
    Коллекция store_user_carts; id документа cart_{userId}
    HTTP корзиныapp/api/store/cart/route.tsТребуется аутентификация; привязывает только session.user.id
    Мягкое резервированиеapp/api/store/cart/hold/route.tsМягкое резервирование запасов, пока в корзине есть позиции
    Оформление через адаптерfeatures/store/adapters/http-adapter.tsfetch('/api/store/checkout', { items, info })
    HTTP оформленияapp/api/store/checkout/route.tsАутентификация → StoreOrdersService + reserveInventoryForOrder; устаревший путь адаптера store_orders не является платёжным конвейером

    Нет публичного неаутентифицированного REST CRUD корзины и нет эндпоинта заявки /api/store/vendors. Онбординг продавца это UI + server actions.

    Доставка Новой Почтой при оформлении

    features/store/components/checkout/prebilling-page.tsx запрашивает GET /api/shipping/novapost/status, настроена ли Новая Почта (NOVAPOST_API_KEY, читается в lib/shipping/nova-post.ts). Поиск отделений использует /api/shipping/novapost/cities и /api/shipping/novapost/warehouses.

    Способ доставкиЧто нужно формеПлатёжный адрес
    nova-postВыбранное отделение. Уличный адрес не нуженПринудительно совпадает с адресом доставки
    pickup (когда Новая Почта включена)Ничего, кроме имени и emailПо выбору
    Доставка по адресу (Новая Почта не настроена)Сохранённый адресПо выбору

    Карточка выбранного отделения показывает населённый пункт и область простым текстом. До 2026-10-22 объект области отображался как [object Object].

    Чат агента товара и ящик

    Открытие страницы товара больше не создаёт ветку в Messages. GET /api/store/products/<id>/agent-chat только ищет существующий разговор (findExistingConversation). Ветка создаётся, когда покупатель отправляет первое сообщение, и помечается metadata.buyerEngaged: true. ConversationService.getConversations скрывает ветки product, которые не вовлечены и не имеют сообщений от покупателя, поэтому старые ветки только с приветствием тоже пропадают из ящика.

    Реклама в шторке и хосты изображений

    • Продавцы могут включить товар в шторке страницы с комиссией автору от 1% до 10% (по умолчанию 5%).
    • domains.imageHosts в ring-config.json перечисляет дополнительные хосты, с которых может загружать next/image, например фид ассортимента партнёра. next.config.mjs читает его при сборке, поэтому запущенный образ не может добавить хосты.

    Agent Knowledge Research (выпущено)

    ЧастьПутьРоль
    Conductorlib/web/conductor/web-conductor.tsTextConductor webSearch: true → структурированные поля + productAgentMarkdown + NODUS JSON + кандидаты изображений с хостов цитирований
    Оркестраторfeatures/store/lib/product-agent-research.tsСтроит запрос + runProductAgentResearch
    Запись в кабинетfeatures/store/lib/product-cabinet-media.tsКаталоги store/[storename]/[product-slug]/alt (укладываются в MAX_FOLDER_DEPTH 3; концептуальный префикс files/), SSRF-безопасная загрузка изображений → RingBase → узлы кабинета
    Действияapp/_actions/product-agent-research.tsresearchProductAgentAction, researchProductDraftAction, saveProductAgentKnowledgeAction
    UIfeatures/store/components/product-agent-knowledge-section.tsxСоздание + редактирование; Use in gallery только явно
    Помощник wikifeatures/store/lib/product-nodus-wiki.tscreateProductNodusWikiFromDraft → Admin Wiki тенанта
    DAGIfeatures/store/services/dagi-erp-tools.tsdagi_research_product → suggestedFields / researchMedia / cabinetPath / skippedImages
    Заметки схемыAI-LEGIOX/legiox-truth-lens/AGENT-PRODUCT-SCHEMA.mdШаги генератора фото / исследования

    Аутентификация: владелец организации-продавца или администратор платформы (resolveResearchVendor + проверка владения). Исследование черновика (ещё без id товара) использует researchProductDraftAction и всё равно записывает артефакты кабинета от имени владельца продавца.

    Правило галереи: медиа исследования никогда автоматически не становятся основными. Операторы должны нажать Use in gallery.

    SSOT каталога товаров

    getCachedProductCatalog() в features/store/config.ts ('use cache' + cacheTag('store:products')). Потребители: app/api/store/products/route.ts, getStoreProducts в app/_actions/store-products.ts, MCP app/api/mcp/v1/store/products/route.ts. Инвалидируйте через updateTag('store:products') после создания.

    Проверенные маршруты приложения

    МаршрутНазначениеАутентификация
    /vendor/startОнбординг продавцаSubscriber и выше
    /vendor/productsCRUD товаров продавца + Agent KnowledgeВладелец организации-продавца
    /admin/store/productsОчередь одобрения товаров (та же форма)Администратор платформы
    /admin/store/commissionsРасчёт комиссийАдминистратор платформы
    /admin/store/ordersСтол заказовАдминистратор платформы
    /admin/store/stockСтол запасовАдминистратор платформы
    /storeПубличная витрина + фильтр аудиторииПублично

    Пользовательские поля товара

    1. 1

      Продавец выбирает категорию в форме товара.

    2. 2

      Добавляет параметры имя+значение («Add product parameter»).

    3. 3

      Сохраняет через createProductCustomField() в app/_actions/vendor-actions.ts (с проверкой владения).

    Фильтрация аудитории товаров

    Товары с productAudience: 'member' (или устаревшим audience) скрыты, если не выполнено isAdmin || hasMemberPrivileges(currentRole) в app/_actions/store-products.ts.

    SSOT комиссии расчёта

    features/store/services/settlement.ts читает TIER_BENEFITS[vendor.storeTier || 'starter'].commissionRate (запасное DEFAULT_COMMISSION_PCT). Взвешенная реферальная комиссия использует features/store/lib/referral-commission.ts. Не документируйте локальную карту WayForPay getCommissionRateForTier(NEW…PREMIUM) как SSOT расчёта: этот помощник специфичен для платёжного пути.

    Сводка модулей

    МодульНазначение
    features/store/config.tsАдаптер + SSOT кэшированного каталога
    features/store/context.tsxОтложенный клиентский каталог + корзина + вызов оформления
    features/store/services/server-cart.tsАутентифицированное зеркало корзины
    features/store/services/vendor-lifecycle.tsПрофиль продавца + уровни доверия
    features/store/services/settlement.tsРасчёт комиссии
    features/store/services/orders-service.tsПлатёжный конвейер orders
    features/store/services/inventory-sync.tsreserve / commitSale / восстановление при отмене
    lib/web/conductor/web-conductor.tsВеб-исследование товара
    features/store/lib/product-cabinet-media.tsИсследование → alt в File Cabinet
    app/_actions/product-agent-research.tsИсследование / черновик / сохранение знаний
    app/_actions/vendor-actions.tsCRUD товаров продавца + поля формы исследования
    app/_actions/admin-store-erp.tsПуть товара администратора + скрытые поля Agent Knowledge
    features/auth/user-role.tshasMemberPrivileges()
    constants/store.tsStoreTier, VendorTrustLevel, TIER_BENEFITS

    Inventory & Stock

    Подробно: резервирование при оформлении → commitSaleForOrder при оплате → восстановление при отмене/возврате.

    Commissions & Settlements

    Следующий шаг: реестр комиссий продавцов, пробные выплаты и двойная реферальная рейка.

    Store API

    Подробно: проверенная HTTP-поверхность /api/store для товаров, зеркала корзины, оформления и платежей.

    Ring File Cabinet

    Тот же процесс: изображения исследования попадают в store/product/alt; чат Image/Video улучшает соседние файлы.

    Generative Gallery

    Следующий шаг: Generative Gallery Upload | Generate в формах товара и область кабинета.

    Admin Wiki

    Зависит от: Research записывает страницы NODUS товаров в хранилище wiki тенанта.

    Ring Oracle

    Зависит от: SSR-гидратация курсов и presentment convertPrice / displayMode для оформления.

    Ограничение аудитории товара

    Отмечайте товары только для участников. Не-участники видят только публичные товары (hasMemberPrivileges()).

    Оплата заказов магазина

    После оформления покупатели платят через PaymentConductor (store_order): WayForPay, Stripe, кредит, токен или PayPal, если включено.

    Запасы ERP

    Оформление резервирует запасы; вебхуки оплаты запускают commitSale, поэтому запасы и расчёты остаются согласованными.

    Типичные сценарии

    • Сеть локального бизнеса: каждый магазин выставляет ассортимент; расчёты выполняются из панели комиссий.
    • Каталог DAO / участников: SKU только для участников; публичные товары как лид-магниты (productAudience: 'member').
    • Обогащение каталога: продавец вставляет URL производителя, запускает Research, просматривает предложенные поля, сохраняет Agent Knowledge, а затем нажимает Use in gallery только для фото, которые хочет видеть на витрине.
    • Помощь DAGI: инструмент чата ERP продавца dagi_research_product возвращает те же предложенные поля / медиа исследования / путь в кабинете для привязанного продавца.

    Чаты агента товара на витрине используют Conversation.type: 'product' и остаются видимыми в Messages. Чаты инструмента Generative Gallery устанавливают метаданные kind: 'generative_gallery' (фильтрация ящика в conversation-service). См. Messaging и Generative Gallery.

    Уровни комиссий (для оператора)

    Комиссия платформы при расчёте использует преимущества StoreTier (constants/store.ts → TIER_BENEFITS):

    Уровень магазинаКомиссия платформы, %Типичная частота расчётов
    starter20%Еженедельно
    growth17%Ежедневно
    professional15%Ежедневно
    enterprise12%Мгновенно

    Запасное значение, когда преимущества уровня отсутствуют: DEFAULT_COMMISSION_PCT = 15. Уровни доверия продавца (new → premium) отслеживают репутацию отдельно от уровня магазина. Реферальная комиссия это двойная рейка, см. Commissions и refcodes.

    features/store/services/server-cart.ts
    Коллекция store_user_carts; id документа cart_{userId}
    HTTP корзиныapp/api/store/cart/route.tsТребуется аутентификация; привязывает только session.user.id
    Мягкое резервированиеapp/api/store/cart/hold/route.tsМягкое резервирование запасов, пока в корзине есть позиции
    Оформление через адаптерfeatures/store/adapters/http-adapter.tsfetch('/api/store/checkout', { items, info })
    HTTP оформленияapp/api/store/checkout/route.tsАутентификация → StoreOrdersService + reserveInventoryForOrder; устаревший путь адаптера store_orders не является платёжным конвейером

    Нет публичного неаутентифицированного REST CRUD корзины и нет эндпоинта заявки /api/store/vendors. Онбординг продавца это UI + server actions.

    Доставка Новой Почтой при оформлении

    features/store/components/checkout/prebilling-page.tsx запрашивает GET /api/shipping/novapost/status, настроена ли Новая Почта (NOVAPOST_API_KEY, читается в lib/shipping/nova-post.ts). Поиск отделений использует /api/shipping/novapost/cities и /api/shipping/novapost/warehouses.

    Способ доставкиЧто нужно формеПлатёжный адрес
    nova-postВыбранное отделение. Уличный адрес не нуженПринудительно совпадает с адресом доставки
    pickup (когда Новая Почта включена)Ничего, кроме имени и emailПо выбору
    Доставка по адресу (Новая Почта не настроена)Сохранённый адресПо выбору

    Карточка выбранного отделения показывает населённый пункт и область простым текстом. До 2026-10-22 объект области отображался как [object Object].

    Чат агента товара и ящик

    Открытие страницы товара больше не создаёт ветку в Messages. GET /api/store/products/<id>/agent-chat только ищет существующий разговор (findExistingConversation). Ветка создаётся, когда покупатель отправляет первое сообщение, и помечается metadata.buyerEngaged: true. ConversationService.getConversations скрывает ветки product, которые не вовлечены и не имеют сообщений от покупателя, поэтому старые ветки только с приветствием тоже пропадают из ящика.

    Реклама в шторке и хосты изображений

    • Продавцы могут включить товар в шторке страницы с комиссией автору от 1% до 10% (по умолчанию 5%).
    • domains.imageHosts в ring-config.json перечисляет дополнительные хосты, с которых может загружать next/image, например фид ассортимента партнёра. next.config.mjs читает его при сборке, поэтому запущенный образ не может добавить хосты.

    Agent Knowledge Research (выпущено)

    ЧастьПутьРоль
    Conductorlib/web/conductor/web-conductor.tsTextConductor webSearch: true → структурированные поля + productAgentMarkdown + NODUS JSON + кандидаты изображений с хостов цитирований
    Оркестраторfeatures/store/lib/product-agent-research.tsСтроит запрос + runProductAgentResearch
    Запись в кабинетfeatures/store/lib/product-cabinet-media.tsКаталоги store/[storename]/[product-slug]/alt (укладываются в MAX_FOLDER_DEPTH 3; концептуальный префикс files/), SSRF-безопасная загрузка изображений → RingBase → узлы кабинета
    Действияapp/_actions/product-agent-research.tsresearchProductAgentAction, researchProductDraftAction, saveProductAgentKnowledgeAction
    UIfeatures/store/components/product-agent-knowledge-section.tsxСоздание + редактирование; Use in gallery только явно
    Помощник wikifeatures/store/lib/product-nodus-wiki.tscreateProductNodusWikiFromDraft → Admin Wiki тенанта
    DAGIfeatures/store/services/dagi-erp-tools.tsdagi_research_product → suggestedFields / researchMedia / cabinetPath / skippedImages
    Заметки схемыAI-LEGIOX/legiox-truth-lens/AGENT-PRODUCT-SCHEMA.mdШаги генератора фото / исследования

    Аутентификация: владелец организации-продавца или администратор платформы (resolveResearchVendor + проверка владения). Исследование черновика (ещё без id товара) использует researchProductDraftAction и всё равно записывает артефакты кабинета от имени владельца продавца.

    Правило галереи: медиа исследования никогда автоматически не становятся основными. Операторы должны нажать Use in gallery.

    SSOT каталога товаров

    getCachedProductCatalog() в features/store/config.ts ('use cache' + cacheTag('store:products')). Потребители: app/api/store/products/route.ts, getStoreProducts в app/_actions/store-products.ts, MCP app/api/mcp/v1/store/products/route.ts. Инвалидируйте через updateTag('store:products') после создания.

    Проверенные маршруты приложения

    МаршрутНазначениеАутентификация
    /vendor/startОнбординг продавцаSubscriber и выше
    /vendor/productsCRUD товаров продавца + Agent KnowledgeВладелец организации-продавца
    /admin/store/productsОчередь одобрения товаров (та же форма)Администратор платформы
    /admin/store/commissionsРасчёт комиссийАдминистратор платформы
    /admin/store/ordersСтол заказовАдминистратор платформы
    /admin/store/stockСтол запасовАдминистратор платформы
    /storeПубличная витрина + фильтр аудиторииПублично

    Пользовательские поля товара

    1. 1

      Продавец выбирает категорию в форме товара.

    2. 2

      Добавляет параметры имя+значение («Add product parameter»).

    3. 3

      Сохраняет через createProductCustomField() в app/_actions/vendor-actions.ts (с проверкой владения).

    Фильтрация аудитории товаров

    Товары с productAudience: 'member' (или устаревшим audience) скрыты, если не выполнено isAdmin || hasMemberPrivileges(currentRole) в app/_actions/store-products.ts.

    SSOT комиссии расчёта

    features/store/services/settlement.ts читает TIER_BENEFITS[vendor.storeTier || 'starter'].commissionRate (запасное DEFAULT_COMMISSION_PCT). Взвешенная реферальная комиссия использует features/store/lib/referral-commission.ts. Не документируйте локальную карту WayForPay getCommissionRateForTier(NEW…PREMIUM) как SSOT расчёта: этот помощник специфичен для платёжного пути.

    Сводка модулей

    МодульНазначение
    features/store/config.tsАдаптер + SSOT кэшированного каталога
    features/store/context.tsxОтложенный клиентский каталог + корзина + вызов оформления
    features/store/services/server-cart.tsАутентифицированное зеркало корзины
    features/store/services/vendor-lifecycle.tsПрофиль продавца + уровни доверия
    features/store/services/settlement.tsРасчёт комиссии
    features/store/services/orders-service.tsПлатёжный конвейер orders
    features/store/services/inventory-sync.tsreserve / commitSale / восстановление при отмене
    lib/web/conductor/web-conductor.tsВеб-исследование товара
    features/store/lib/product-cabinet-media.tsИсследование → alt в File Cabinet
    app/_actions/product-agent-research.tsИсследование / черновик / сохранение знаний
    app/_actions/vendor-actions.tsCRUD товаров продавца + поля формы исследования
    app/_actions/admin-store-erp.tsПуть товара администратора + скрытые поля Agent Knowledge
    features/auth/user-role.tshasMemberPrivileges()
    constants/store.tsStoreTier, VendorTrustLevel, TIER_BENEFITS

    Inventory & Stock

    Подробно: резервирование при оформлении → commitSaleForOrder при оплате → восстановление при отмене/возврате.

    Commissions & Settlements

    Следующий шаг: реестр комиссий продавцов, пробные выплаты и двойная реферальная рейка.

    Store API

    Подробно: проверенная HTTP-поверхность /api/store для товаров, зеркала корзины, оформления и платежей.

    Ring File Cabinet

    Тот же процесс: изображения исследования попадают в store/product/alt; чат Image/Video улучшает соседние файлы.

    Generative Gallery

    Следующий шаг: Generative Gallery Upload | Generate в формах товара и область кабинета.

    Admin Wiki

    Зависит от: Research записывает страницы NODUS товаров в хранилище wiki тенанта.

    Ring Oracle

    Зависит от: SSR-гидратация курсов и presentment convertPrice / displayMode для оформления.

    Ограничение аудитории товара

    Отмечайте товары только для участников. Не-участники видят только публичные товары (hasMemberPrivileges()).

    Оплата заказов магазина

    После оформления покупатели платят через PaymentConductor (store_order): WayForPay, Stripe, кредит, токен или PayPal, если включено.

    Запасы ERP

    Оформление резервирует запасы; вебхуки оплаты запускают commitSale, поэтому запасы и расчёты остаются согласованными.

    Типичные сценарии

    • Сеть локального бизнеса: каждый магазин выставляет ассортимент; расчёты выполняются из панели комиссий.
    • Каталог DAO / участников: SKU только для участников; публичные товары как лид-магниты (productAudience: 'member').
    • Обогащение каталога: продавец вставляет URL производителя, запускает Research, просматривает предложенные поля, сохраняет Agent Knowledge, а затем нажимает Use in gallery только для фото, которые хочет видеть на витрине.
    • Помощь DAGI: инструмент чата ERP продавца dagi_research_product возвращает те же предложенные поля / медиа исследования / путь в кабинете для привязанного продавца.

    Чаты агента товара на витрине используют Conversation.type: 'product' и остаются видимыми в Messages. Чаты инструмента Generative Gallery устанавливают метаданные kind: 'generative_gallery' (фильтрация ящика в conversation-service). См. Messaging и Generative Gallery.

    Уровни комиссий (для оператора)

    Комиссия платформы при расчёте использует преимущества StoreTier (constants/store.ts → TIER_BENEFITS):

    Уровень магазинаКомиссия платформы, %Типичная частота расчётов
    starter20%Еженедельно
    growth17%Ежедневно
    professional15%Ежедневно
    enterprise12%Мгновенно

    Запасное значение, когда преимущества уровня отсутствуют: DEFAULT_COMMISSION_PCT = 15. Уровни доверия продавца (new → premium) отслеживают репутацию отдельно от уровня магазина. Реферальная комиссия это двойная рейка, см. Commissions и refcodes.

    features/store/services/server-cart.ts
    Коллекция store_user_carts; id документа cart_{userId}
    HTTP корзиныapp/api/store/cart/route.tsТребуется аутентификация; привязывает только session.user.id
    Мягкое резервированиеapp/api/store/cart/hold/route.tsМягкое резервирование запасов, пока в корзине есть позиции
    Оформление через адаптерfeatures/store/adapters/http-adapter.tsfetch('/api/store/checkout', { items, info })
    HTTP оформленияapp/api/store/checkout/route.tsАутентификация → StoreOrdersService + reserveInventoryForOrder; устаревший путь адаптера store_orders не является платёжным конвейером

    Нет публичного неаутентифицированного REST CRUD корзины и нет эндпоинта заявки /api/store/vendors. Онбординг продавца это UI + server actions.

    Доставка Новой Почтой при оформлении

    features/store/components/checkout/prebilling-page.tsx запрашивает GET /api/shipping/novapost/status, настроена ли Новая Почта (NOVAPOST_API_KEY, читается в lib/shipping/nova-post.ts). Поиск отделений использует /api/shipping/novapost/cities и /api/shipping/novapost/warehouses.

    Способ доставкиЧто нужно формеПлатёжный адрес
    nova-postВыбранное отделение. Уличный адрес не нуженПринудительно совпадает с адресом доставки
    pickup (когда Новая Почта включена)Ничего, кроме имени и emailПо выбору
    Доставка по адресу (Новая Почта не настроена)Сохранённый адресПо выбору

    Карточка выбранного отделения показывает населённый пункт и область простым текстом. До 2026-10-22 объект области отображался как [object Object].

    Чат агента товара и ящик

    Открытие страницы товара больше не создаёт ветку в Messages. GET /api/store/products/<id>/agent-chat только ищет существующий разговор (findExistingConversation). Ветка создаётся, когда покупатель отправляет первое сообщение, и помечается metadata.buyerEngaged: true. ConversationService.getConversations скрывает ветки product, которые не вовлечены и не имеют сообщений от покупателя, поэтому старые ветки только с приветствием тоже пропадают из ящика.

    Реклама в шторке и хосты изображений

    • Продавцы могут включить товар в шторке страницы с комиссией автору от 1% до 10% (по умолчанию 5%).
    • domains.imageHosts в ring-config.json перечисляет дополнительные хосты, с которых может загружать next/image, например фид ассортимента партнёра. next.config.mjs читает его при сборке, поэтому запущенный образ не может добавить хосты.

    Agent Knowledge Research (выпущено)

    ЧастьПутьРоль
    Conductorlib/web/conductor/web-conductor.tsTextConductor webSearch: true → структурированные поля + productAgentMarkdown + NODUS JSON + кандидаты изображений с хостов цитирований
    Оркестраторfeatures/store/lib/product-agent-research.tsСтроит запрос + runProductAgentResearch
    Запись в кабинетfeatures/store/lib/product-cabinet-media.tsКаталоги store/[storename]/[product-slug]/alt (укладываются в MAX_FOLDER_DEPTH 3; концептуальный префикс files/), SSRF-безопасная загрузка изображений → RingBase → узлы кабинета
    Действияapp/_actions/product-agent-research.tsresearchProductAgentAction, researchProductDraftAction, saveProductAgentKnowledgeAction
    UIfeatures/store/components/product-agent-knowledge-section.tsxСоздание + редактирование; Use in gallery только явно
    Помощник wikifeatures/store/lib/product-nodus-wiki.tscreateProductNodusWikiFromDraft → Admin Wiki тенанта
    DAGIfeatures/store/services/dagi-erp-tools.tsdagi_research_product → suggestedFields / researchMedia / cabinetPath / skippedImages
    Заметки схемыAI-LEGIOX/legiox-truth-lens/AGENT-PRODUCT-SCHEMA.mdШаги генератора фото / исследования

    Аутентификация: владелец организации-продавца или администратор платформы (resolveResearchVendor + проверка владения). Исследование черновика (ещё без id товара) использует researchProductDraftAction и всё равно записывает артефакты кабинета от имени владельца продавца.

    Правило галереи: медиа исследования никогда автоматически не становятся основными. Операторы должны нажать Use in gallery.

    SSOT каталога товаров

    getCachedProductCatalog() в features/store/config.ts ('use cache' + cacheTag('store:products')). Потребители: app/api/store/products/route.ts, getStoreProducts в app/_actions/store-products.ts, MCP app/api/mcp/v1/store/products/route.ts. Инвалидируйте через updateTag('store:products') после создания.

    Проверенные маршруты приложения

    МаршрутНазначениеАутентификация
    /vendor/startОнбординг продавцаSubscriber и выше
    /vendor/productsCRUD товаров продавца + Agent KnowledgeВладелец организации-продавца
    /admin/store/productsОчередь одобрения товаров (та же форма)Администратор платформы
    /admin/store/commissionsРасчёт комиссийАдминистратор платформы
    /admin/store/ordersСтол заказовАдминистратор платформы
    /admin/store/stockСтол запасовАдминистратор платформы
    /storeПубличная витрина + фильтр аудиторииПублично

    Пользовательские поля товара

    1. 1

      Продавец выбирает категорию в форме товара.

    2. 2

      Добавляет параметры имя+значение («Add product parameter»).

    3. 3

      Сохраняет через createProductCustomField() в app/_actions/vendor-actions.ts (с проверкой владения).

    Фильтрация аудитории товаров

    Товары с productAudience: 'member' (или устаревшим audience) скрыты, если не выполнено isAdmin || hasMemberPrivileges(currentRole) в app/_actions/store-products.ts.

    SSOT комиссии расчёта

    features/store/services/settlement.ts читает TIER_BENEFITS[vendor.storeTier || 'starter'].commissionRate (запасное DEFAULT_COMMISSION_PCT). Взвешенная реферальная комиссия использует features/store/lib/referral-commission.ts. Не документируйте локальную карту WayForPay getCommissionRateForTier(NEW…PREMIUM) как SSOT расчёта: этот помощник специфичен для платёжного пути.

    Сводка модулей

    МодульНазначение
    features/store/config.tsАдаптер + SSOT кэшированного каталога
    features/store/context.tsxОтложенный клиентский каталог + корзина + вызов оформления
    features/store/services/server-cart.tsАутентифицированное зеркало корзины
    features/store/services/vendor-lifecycle.tsПрофиль продавца + уровни доверия
    features/store/services/settlement.tsРасчёт комиссии
    features/store/services/orders-service.tsПлатёжный конвейер orders
    features/store/services/inventory-sync.tsreserve / commitSale / восстановление при отмене
    lib/web/conductor/web-conductor.tsВеб-исследование товара
    features/store/lib/product-cabinet-media.tsИсследование → alt в File Cabinet
    app/_actions/product-agent-research.tsИсследование / черновик / сохранение знаний
    app/_actions/vendor-actions.tsCRUD товаров продавца + поля формы исследования
    app/_actions/admin-store-erp.tsПуть товара администратора + скрытые поля Agent Knowledge
    features/auth/user-role.tshasMemberPrivileges()
    constants/store.tsStoreTier, VendorTrustLevel, TIER_BENEFITS

    Inventory & Stock

    Подробно: резервирование при оформлении → commitSaleForOrder при оплате → восстановление при отмене/возврате.

    Commissions & Settlements

    Следующий шаг: реестр комиссий продавцов, пробные выплаты и двойная реферальная рейка.

    Store API

    Подробно: проверенная HTTP-поверхность /api/store для товаров, зеркала корзины, оформления и платежей.

    Ring File Cabinet

    Тот же процесс: изображения исследования попадают в store/product/alt; чат Image/Video улучшает соседние файлы.

    Generative Gallery

    Следующий шаг: Generative Gallery Upload | Generate в формах товара и область кабинета.

    Admin Wiki

    Зависит от: Research записывает страницы NODUS товаров в хранилище wiki тенанта.

    Ring Oracle

    Зависит от: SSR-гидратация курсов и presentment convertPrice / displayMode для оформления.