Preparing Ring content
Preparing Ring content
Preparing Ring content
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/products | Server actions, а не /api/store/vendors |
| Комісії | settlement.ts + /admin/store/commissions | Відсоток платформи за рівнем з TIER_BENEFITS (StoreTier) |
Кожна організація у вашому розгортанні Ring може стати продавцем, зовнішній маркетплейс не потрібен. Дохід платформи надходить із комісій за рівнями з розрахованих продажів. Продавці самі ведуть каталог; оператори схвалюють товари й розраховують комісії з панелі адміністратора.
Онбординг організацій на /vendor/start. Оцінка довіри, перехід між рівнями й призупинення в vendor-lifecycle.
У формах створення й редагування товару: Research → поля + markdown + wiki NODUS + альтернативні зображення в кабінеті. Use in gallery працює лише явно, ніщо тихо не замінює основне фото.
Комісія платформи за рівнем із кожного продажу. Панель адміністратора на /admin/store/commissions: пробний запуск і обробка належних виплат.
Так, позиції зберігаються в 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.
Дивіться також: рекламуйте товари в завісі сторінки й платіть авторам комісію.
Залежить від: оформлення store_order розраховуються через PaymentConductor і реєстр payment_transactions.
Той самий процес: платіжні рейки клону та обмеження env, які враховують способи оплати магазину.
Наступний крок: хаб ERP для інваріанта запасів, commitSale і панелі розрахунків.
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/products | Server actions, а не /api/store/vendors |
| Комісії | settlement.ts + /admin/store/commissions | Відсоток платформи за рівнем з TIER_BENEFITS (StoreTier) |
Кожна організація у вашому розгортанні Ring може стати продавцем, зовнішній маркетплейс не потрібен. Дохід платформи надходить із комісій за рівнями з розрахованих продажів. Продавці самі ведуть каталог; оператори схвалюють товари й розраховують комісії з панелі адміністратора.
Онбординг організацій на /vendor/start. Оцінка довіри, перехід між рівнями й призупинення в vendor-lifecycle.
У формах створення й редагування товару: Research → поля + markdown + wiki NODUS + альтернативні зображення в кабінеті. Use in gallery працює лише явно, ніщо тихо не замінює основне фото.
Комісія платформи за рівнем із кожного продажу. Панель адміністратора на /admin/store/commissions: пробний запуск і обробка належних виплат.
Так, позиції зберігаються в 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.
Дивіться також: рекламуйте товари в завісі сторінки й платіть авторам комісію.
Залежить від: оформлення store_order розраховуються через PaymentConductor і реєстр payment_transactions.
Той самий процес: платіжні рейки клону та обмеження env, які враховують способи оплати магазину.
Наступний крок: хаб ERP для інваріанта запасів, commitSale і панелі розрахунків.
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/products | Server actions, а не /api/store/vendors |
| Комісії | settlement.ts + /admin/store/commissions | Відсоток платформи за рівнем з TIER_BENEFITS (StoreTier) |
Кожна організація у вашому розгортанні Ring може стати продавцем, зовнішній маркетплейс не потрібен. Дохід платформи надходить із комісій за рівнями з розрахованих продажів. Продавці самі ведуть каталог; оператори схвалюють товари й розраховують комісії з панелі адміністратора.
Онбординг організацій на /vendor/start. Оцінка довіри, перехід між рівнями й призупинення в vendor-lifecycle.
У формах створення й редагування товару: Research → поля + markdown + wiki NODUS + альтернативні зображення в кабінеті. Use in gallery працює лише явно, ніщо тихо не замінює основне фото.
Комісія платформи за рівнем із кожного продажу. Панель адміністратора на /admin/store/commissions: пробний запуск і обробка належних виплат.
Так, позиції зберігаються в 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.
Дивіться також: рекламуйте товари в завісі сторінки й платіть авторам комісію.
Залежить від: оформлення store_order розраховуються через PaymentConductor і реєстр payment_transactions.
Той самий процес: платіжні рейки клону та обмеження env, які враховують способи оплати магазину.
Наступний крок: хаб ERP для інваріанта запасів, commitSale і панелі розрахунків.
productAudience: 'member').dagi_research_product повертає ті самі запропоновані поля / медіа дослідження / шлях у кабінеті для прив'язаного продавця.Чати агента товару на вітрині використовують Conversation.type: 'product' і лишаються видимими в Messages. Чати інструмента Generative Gallery встановлюють метадані kind: 'generative_gallery' (фільтрація скриньки в conversation-service). Див. Messaging і Generative Gallery.
Комісія платформи при розрахунку використовує переваги StoreTier (constants/store.ts → TIER_BENEFITS):
| Рівень магазину | Комісія платформи, % | Типова частота розрахунків |
|---|---|---|
starter | 20% | Щотижня |
growth | 17% | Щодня |
professional | 15% | Щодня |
enterprise | 12% | Миттєво |
Запасне значення, коли переваги рівня відсутні: 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.ts | fetch('/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, які не залучені й не мають повідомлень від покупця, тож старі гілки лише з привітанням теж зникають зі скриньки.
domains.imageHosts у ring-config.json перелічує додаткові хости, з яких може завантажувати next/image, наприклад фід асортименту партнера. next.config.mjs читає його під час збирання, тож запущений образ не може додати хости.| Частина | Шлях | Роль |
|---|---|---|
| Conductor | lib/web/conductor/web-conductor.ts | TextConductor 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.ts | researchProductAgentAction, researchProductDraftAction, saveProductAgentKnowledgeAction |
| UI | features/store/components/product-agent-knowledge-section.tsx | Створення + редагування; Use in gallery лише явно |
| Помічник wiki | features/store/lib/product-nodus-wiki.ts | createProductNodusWikiFromDraft → Admin Wiki тенанта |
| DAGI | features/store/services/dagi-erp-tools.ts | dagi_research_product → suggestedFields / researchMedia / cabinetPath / skippedImages |
| Нотатки схеми | AI-LEGIOX/legiox-truth-lens/AGENT-PRODUCT-SCHEMA.md | Кроки генератора фото / дослідження |
Автентифікація: власник організації-продавця або адміністратор платформи (resolveResearchVendor + перевірка власності). Дослідження чернетки (ще без id товару) використовує researchProductDraftAction і все одно записує артефакти кабінету від імені власника продавця.
Правило галереї: медіа дослідження ніколи автоматично не стають основними. Оператори мають натиснути Use in gallery.
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/products | CRUD товарів продавця + Agent Knowledge | Власник організації-продавця |
/admin/store/products | Черга схвалення товарів (та сама форма) | Адміністратор платформи |
/admin/store/commissions | Розрахунок комісій | Адміністратор платформи |
/admin/store/orders | Стіл замовлень | Адміністратор платформи |
/admin/store/stock | Стіл запасів | Адміністратор платформи |
/store | Публічна вітрина + фільтр аудиторії | Публічно |
Продавець обирає категорію у формі товару.
Додає параметри ім'я+значення («Add product parameter»).
Зберігає через createProductCustomField() у app/_actions/vendor-actions.ts (із перевіркою власності).
Товари з productAudience: 'member' (або застарілим audience) приховані, якщо не виконано isAdmin || hasMemberPrivileges(currentRole) в app/_actions/store-products.ts.
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.ts | reserve / 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.ts | CRUD товарів продавця + поля форми дослідження |
app/_actions/admin-store-erp.ts | Шлях товару адміністратора + приховані поля Agent Knowledge |
features/auth/user-role.ts | hasMemberPrivileges() |
constants/store.ts | StoreTier, VendorTrustLevel, TIER_BENEFITS |
Детально: резервування при оформленні → commitSaleForOrder при оплаті → відновлення при скасуванні/поверненні.
productAudience: 'member').dagi_research_product повертає ті самі запропоновані поля / медіа дослідження / шлях у кабінеті для прив'язаного продавця.Чати агента товару на вітрині використовують Conversation.type: 'product' і лишаються видимими в Messages. Чати інструмента Generative Gallery встановлюють метадані kind: 'generative_gallery' (фільтрація скриньки в conversation-service). Див. Messaging і Generative Gallery.
Комісія платформи при розрахунку використовує переваги StoreTier (constants/store.ts → TIER_BENEFITS):
| Рівень магазину | Комісія платформи, % | Типова частота розрахунків |
|---|---|---|
starter | 20% | Щотижня |
growth | 17% | Щодня |
professional | 15% | Щодня |
enterprise | 12% | Миттєво |
Запасне значення, коли переваги рівня відсутні: 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.ts | fetch('/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, які не залучені й не мають повідомлень від покупця, тож старі гілки лише з привітанням теж зникають зі скриньки.
domains.imageHosts у ring-config.json перелічує додаткові хости, з яких може завантажувати next/image, наприклад фід асортименту партнера. next.config.mjs читає його під час збирання, тож запущений образ не може додати хости.| Частина | Шлях | Роль |
|---|---|---|
| Conductor | lib/web/conductor/web-conductor.ts | TextConductor 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.ts | researchProductAgentAction, researchProductDraftAction, saveProductAgentKnowledgeAction |
| UI | features/store/components/product-agent-knowledge-section.tsx | Створення + редагування; Use in gallery лише явно |
| Помічник wiki | features/store/lib/product-nodus-wiki.ts | createProductNodusWikiFromDraft → Admin Wiki тенанта |
| DAGI | features/store/services/dagi-erp-tools.ts | dagi_research_product → suggestedFields / researchMedia / cabinetPath / skippedImages |
| Нотатки схеми | AI-LEGIOX/legiox-truth-lens/AGENT-PRODUCT-SCHEMA.md | Кроки генератора фото / дослідження |
Автентифікація: власник організації-продавця або адміністратор платформи (resolveResearchVendor + перевірка власності). Дослідження чернетки (ще без id товару) використовує researchProductDraftAction і все одно записує артефакти кабінету від імені власника продавця.
Правило галереї: медіа дослідження ніколи автоматично не стають основними. Оператори мають натиснути Use in gallery.
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/products | CRUD товарів продавця + Agent Knowledge | Власник організації-продавця |
/admin/store/products | Черга схвалення товарів (та сама форма) | Адміністратор платформи |
/admin/store/commissions | Розрахунок комісій | Адміністратор платформи |
/admin/store/orders | Стіл замовлень | Адміністратор платформи |
/admin/store/stock | Стіл запасів | Адміністратор платформи |
/store | Публічна вітрина + фільтр аудиторії | Публічно |
Продавець обирає категорію у формі товару.
Додає параметри ім'я+значення («Add product parameter»).
Зберігає через createProductCustomField() у app/_actions/vendor-actions.ts (із перевіркою власності).
Товари з productAudience: 'member' (або застарілим audience) приховані, якщо не виконано isAdmin || hasMemberPrivileges(currentRole) в app/_actions/store-products.ts.
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.ts | reserve / 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.ts | CRUD товарів продавця + поля форми дослідження |
app/_actions/admin-store-erp.ts | Шлях товару адміністратора + приховані поля Agent Knowledge |
features/auth/user-role.ts | hasMemberPrivileges() |
constants/store.ts | StoreTier, VendorTrustLevel, TIER_BENEFITS |
Детально: резервування при оформленні → commitSaleForOrder при оплаті → відновлення при скасуванні/поверненні.
productAudience: 'member').dagi_research_product повертає ті самі запропоновані поля / медіа дослідження / шлях у кабінеті для прив'язаного продавця.Чати агента товару на вітрині використовують Conversation.type: 'product' і лишаються видимими в Messages. Чати інструмента Generative Gallery встановлюють метадані kind: 'generative_gallery' (фільтрація скриньки в conversation-service). Див. Messaging і Generative Gallery.
Комісія платформи при розрахунку використовує переваги StoreTier (constants/store.ts → TIER_BENEFITS):
| Рівень магазину | Комісія платформи, % | Типова частота розрахунків |
|---|---|---|
starter | 20% | Щотижня |
growth | 17% | Щодня |
professional | 15% | Щодня |
enterprise | 12% | Миттєво |
Запасне значення, коли переваги рівня відсутні: 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.ts | fetch('/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, які не залучені й не мають повідомлень від покупця, тож старі гілки лише з привітанням теж зникають зі скриньки.
domains.imageHosts у ring-config.json перелічує додаткові хости, з яких може завантажувати next/image, наприклад фід асортименту партнера. next.config.mjs читає його під час збирання, тож запущений образ не може додати хости.| Частина | Шлях | Роль |
|---|---|---|
| Conductor | lib/web/conductor/web-conductor.ts | TextConductor 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.ts | researchProductAgentAction, researchProductDraftAction, saveProductAgentKnowledgeAction |
| UI | features/store/components/product-agent-knowledge-section.tsx | Створення + редагування; Use in gallery лише явно |
| Помічник wiki | features/store/lib/product-nodus-wiki.ts | createProductNodusWikiFromDraft → Admin Wiki тенанта |
| DAGI | features/store/services/dagi-erp-tools.ts | dagi_research_product → suggestedFields / researchMedia / cabinetPath / skippedImages |
| Нотатки схеми | AI-LEGIOX/legiox-truth-lens/AGENT-PRODUCT-SCHEMA.md | Кроки генератора фото / дослідження |
Автентифікація: власник організації-продавця або адміністратор платформи (resolveResearchVendor + перевірка власності). Дослідження чернетки (ще без id товару) використовує researchProductDraftAction і все одно записує артефакти кабінету від імені власника продавця.
Правило галереї: медіа дослідження ніколи автоматично не стають основними. Оператори мають натиснути Use in gallery.
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/products | CRUD товарів продавця + Agent Knowledge | Власник організації-продавця |
/admin/store/products | Черга схвалення товарів (та сама форма) | Адміністратор платформи |
/admin/store/commissions | Розрахунок комісій | Адміністратор платформи |
/admin/store/orders | Стіл замовлень | Адміністратор платформи |
/admin/store/stock | Стіл запасів | Адміністратор платформи |
/store | Публічна вітрина + фільтр аудиторії | Публічно |
Продавець обирає категорію у формі товару.
Додає параметри ім'я+значення («Add product parameter»).
Зберігає через createProductCustomField() у app/_actions/vendor-actions.ts (із перевіркою власності).
Товари з productAudience: 'member' (або застарілим audience) приховані, якщо не виконано isAdmin || hasMemberPrivileges(currentRole) в app/_actions/store-products.ts.
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.ts | reserve / 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.ts | CRUD товарів продавця + поля форми дослідження |
app/_actions/admin-store-erp.ts | Шлях товару адміністратора + приховані поля Agent Knowledge |
features/auth/user-role.ts | hasMemberPrivileges() |
constants/store.ts | StoreTier, VendorTrustLevel, TIER_BENEFITS |
Детально: резервування при оформленні → commitSaleForOrder при оплаті → відновлення при скасуванні/поверненні.