Pyle

Catalog & Merchandising ​

Catalog & Merchandising is the domain that defines what Pyle sells, how the catalog is classified, and how products are grouped for browsing and selection.

It is the right first deep documentation pass because the framework, admin, storefront, Excel tooling, and ERP bridge all converge here.

Status ​

  • [x] Domain overview written
  • [x] Subdomains reviewed
  • [x] Technical node pages linked
  • [x] End-user concept pages linked
  • [x] Task guides linked

Responsibility ​

This domain is responsible for:

  • defining sellable product records
  • classifying products by type, category, brand, and collection
  • defining reusable product attributes and terms
  • shaping grouped product-selection experiences through product groups
  • exposing catalog structure to search, navigation, Excel workflows, and ERP synchronization

Subdomains ​

  • Product Core
    • Product
  • Taxonomy
    • ProductType
    • ProductCategory
    • ProductManufacturer (Brand in admin and storefront wording)
    • ProductCollection
  • Attributes And Grouped Configurability
    • ProductAttribute
    • ProductGroup
  • Folded Supporting Records
    • ProductTerm
    • ProductAttributeGroup
    • ProductGroupAttribute
    • ProductGroupAttributeOption
    • ProductGroupAttributeOptionProduct
    • ProductImage
    • ProductDocument
    • ProductVideo
    • ProductPolicy
    • ProductCrossSell
    • ProductUpsell

Classification Decisions ​

Standalone technical pages ​

Standalone end-user pages ​

Standalone task guides ​

Folded into parent pages for now ​

  • ProductTerm
    • folded into Product Attribute and Product
  • ProductImage, ProductDocument, ProductVideo, ProductPolicy, ProductCrossSell, ProductUpsell
    • folded into Product
  • ProductAttributeGroup, ProductGroupAttribute, ProductGroupAttributeOption, ProductGroupAttributeOptionProduct
    • folded into Product Group

Evidence Highlights ​

Framework ownership ​

  • packages/framework/src/Models/Product.php
  • packages/framework/src/Models/ProductCategory.php
  • packages/framework/src/Models/ProductCollection.php
  • packages/framework/src/Models/ProductManufacturer.php
  • packages/framework/src/Models/ProductAttribute.php
  • packages/framework/src/Models/ProductGroup.php

Admin surfaces ​

  • packages/admin/routes/web.php
  • packages/admin/src/Livewire/Admin/Products
  • packages/admin/src/Livewire/Admin/Product
  • packages/admin/src/Livewire/Admin/Settings/Brands
  • packages/admin/src/Livewire/Admin/Settings/Categories
  • packages/admin/src/Livewire/Admin/Settings/Collections
  • packages/admin/src/Livewire/Admin/Settings/Types
  • packages/admin/src/Livewire/Admin/Settings/Attributes
  • packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups
  • packages/admin/src/Livewire/Admin/Tools/Excel

Storefront surfaces ​

  • packages/storefront/routes/web.php
  • packages/storefront/src/Livewire/Storefront/Product
  • packages/storefront/src/Livewire/Storefront/Category
  • packages/storefront/src/Livewire/Storefront/Brand
  • packages/storefront/src/Livewire/Storefront/Brands
  • packages/storefront/src/Livewire/Storefront/FastSearch
  • packages/storefront/src/View/Components/Product/CollectionProducts.php
  • packages/storefront/src/View/Components/Navigation/Bar.php

Integration and bulk-data surfaces ​

  • packages/framework/src/Actions/Import/Product/Sheets
  • packages/framework/src/Actions/Exports/Product/Sheets
  • packages/framework/src/Imports/ProductGroup
  • packages/framework/src/Exports/ProductGroup
  • packages/erp-bridge/src/Requests/Products
  • packages/erp-bridge/src/Requests/ProductCategories
  • packages/erp-bridge/src/Requests/ProductAttributes
  • packages/erp-bridge/src/Requests/ProductManufacturers
  • packages/erp-bridge/src/Requests/ProductTypes
  • Admin uses Brand as the business label for the ProductManufacturer model.
  • Product Collection is shopper-visible and used by product groups, but the packaged admin UI behaves more like review and activation tooling than full CRUD.
  • Product Group is a real merchandising capability, not just storefront decoration. It has a dedicated admin workflow, an Excel import/export path, and shopper-facing product-option behavior.

Priority Technical Pages ​

Priority End-User Pages ​

Priority Task Guides ​

Quick Checklists ​