09 · Platform barcode / UPC catalog

A platform product line that also “trickles down” into every GPE tenant’s POS and inventory.

Dual go-to-market

flowchart TB
  PPC[(Master DB
platform_product_catalog)]
  PPC --> T1[GPE tenants — included]
  PPC --> T2[Public guests — rate limited]
  PPC --> T3[Future paid API keys]
  T1 --> POS[POS scan prefill]
  T1 --> INV[Inventory item wizard]
  T2 --> WEB[public-site /barcode]
  MA[Master Admin CRUD + images] --> PPC

Endpoints

Surface	Endpoint	Auth
Tenant enrichment	`GET /api/platform-catalog/lookup?barcode=`	Session
Public lookup	`GET /api/public/barcode-lookup?q=`	None · ~10/hr/IP
Admin CRUD	`/api/master-admin/platform-catalog`	master_admin
Images	`/media/platform-catalog/*`	Public read via Nginx/static

Service: platformProductCatalog.service.js · UI: PlatformCatalogAdmin.jsx, ItemsPage, ModernPOS, public BarcodeLookup.jsx.

Rule for development

Tenants never own the global GTIN row Lookup enriches; pricing/stock stay in tenant main DB. Imports and partner feeds should write master catalog, not N tenant copies.