Docs
EN

Модули Shop

uticms.shop.overview · verified 2026-07-14

Обзор

Scope
Shop commerce core, ShopB2C storefront и интеграция OneCBridge

Ключевые понятия

Shop
Installable commerce-core module с catalog, pricing, stock, orders, payments, receipts и API integration.
Shop B2c
Опциональный Shop-dependent B2C storefront/template module.
One C Bridge
Shop-dependent CommerceML/1C exchange module.

Структура

  • Shop
    • Modulemodules/Shop
    • Api Routesmodules/Shop/Routes/api.php
    • Models
      • Catalog
      • Product
      • Offer
      • Price
      • PriceType
      • Stock
      • StockReservation
      • Warehouse
      • Order
      • PaymentTransaction
      • Receipt
      • Brand
    • AdminFilament resources, settings, widgets и console commands под modules/Shop
  • Storefront
    • Modulemodules/ShopB2C
    • Web Routesmodules/ShopB2C/Routes/web.php
    • Layout Drivershop_b2c
  • One C
    • Modulemodules/OneCBridge
    • Api Routesmodules/OneCBridge/Routes/api.php

Факты

  • Shop installable, экспонирует API routes, объявляет schema tables, migrations и install seeder, priority 200. authoritative
  • Shop sources определяют catalog, product, offer, prices, warehouses, stock reservations, search index, facets, orders, payment transactions и receipts. authoritative
  • Shop включает acquiring abstractions с cash и YooKassa systems и receipt listener для paid orders. authoritative
  • ShopB2C требует Shop ^1.0, installable, предоставляет web routes и views, добавляет site layout driver shop_b2c и содержит catalog/cart/checkout/account controllers. authoritative
  • OneCBridge требует Shop ^1.0, имеет API routes и migrations, и не помечен как installable в manifest. authoritative

Инструкции

Add Storefront Feature

  1. проверить совместимые active Shop и ShopB2C modules
  2. определить, относится ли изменение к Shop API/domain или ShopB2C web/layout layer
  3. сохранить declared route, view и layout-driver boundaries
  4. проверить catalog, cart, checkout или account flow, затронутый изменением

Правила

Architectural rule

Держите Shop business-domain behavior в Shop; ShopB2C — storefront/template integration.

Примеры

Module Layers

Shop (modules/Shop) — domain, admin, API, order placement
ShopB2C (modules/ShopB2C) — web routes, layout driver shop_b2c, cart/checkout UI
OneCBridge — CommerceML API; manifest install=false

modules/Shop/README.md

Shop Dependency

"dependencies": { "required": { "shop": "^1.0" } }

modules/ShopB2C/module.json