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 при оплате → восстановление при отмене/возврате.