The foundational product and category management system in Adobe Commerce and Magento Open Source. Core data structures, business logic, and APIs for managing products, categories, product attributes, and pricing.
Module purpose, key features, six product types, category tree management, EAV attribute system, and service contract APIs.
overviewClass hierarchy, database schema (EAV tables, flat tables), service contracts, dependency injection configuration, and design patterns.
architectureProduct save flow, category tree operations, add-to-cart pipeline, product listing page load, and flat index rebuild sequences.
execution-flowsBefore/after/around plugins on product save, price calculation, and category operations. Observer events for catalog_product_save_after, catalog_category_prepare_save, and more.
plugins-observersCross-module dependencies with Quote, Sales, CatalogInventory, CatalogSearch. REST/GraphQL API contracts. Third-party integration patterns for PIM and ERP systems.
integrationsCommon mistakes: direct SQL queries on EAV tables, bypassing service contracts, loading full product collections, and incorrect flat index assumptions.
anti-patternsDocumented bugs, flat index race conditions, URL rewrite conflicts, category anchor behavior quirks, and version-specific workarounds.
known-issuesBreaking changes across 2.4.x versions, deprecated APIs, Elasticsearch to OpenSearch migration, and declarative schema evolution.
version-compatFlat index optimization, product collection tuning, category tree caching, EAV query reduction, and full page cache strategies for catalog pages.
performance