МожливостіСутності
Документація
    Ring Platform

    Децентралізоване самобудівне майбутнє

    Увійти
    Сутності
    Можливості
    Магазин
    Документація
    Концепції
    RING ЕкономікаSonoratek LLCГлобальний впливAI зустрічає Web3
    Розпочати
    Швидкий стартКалькуляторДорожня карта
    Конфіденційність|Контакти
    v1.106.29|Sonoratek LLC

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Store
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Членство та кредити
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    Завіса сторінки
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Організації
    Можливості
    AI Matcher
    Messaging
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    News
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Сповіщення
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура 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
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    Завіса сторінки
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Організації
    Можливості
    AI Matcher
    Messaging
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    News
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Сповіщення
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура 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
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    Завіса сторінки
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Організації
    Можливості
    AI Matcher
    Messaging
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    News
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Сповіщення
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура 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 для оформлення.