- Shipped
- April 3, 2026 at 10:26 AM UTC
- Author
- Kamo
- Commit
- 99b5947
Full retail POS data model designed for standalone KamoRetail operation and bidirectional sync with Shopify, BigCommerce, Wix, Squarespace, Shift4Shop, Ecwid, WooCommerce, Magento, PrestaShop, and OpenCart. Product Catalog (29 files): - ProductCategory (hierarchical), ProductBrand, ProductAttribute, ProductAttributeValue - ProductVariant (SKU-level with pricing/weight/inventory policy) - ProductImage (multi-image), ProductTag, ProductReview - ProductRelation (cross-sell/up-sell), ProductVariantAttribute - Product-Category and Product-Tag junction tables - 5 enums: ProductType, ProductAttributeType, ProductAttributeInputType, InventoryPolicy, ProductRelationType - Offering entity expanded: brand, productType, slug, SEO fields, weight, compareAtPrice, costPrice, taxClassId, requiresShipping Customer Domain (13 files): - RetailCustomer, RetailCustomerAddress, RetailCustomerGroup - RetailCustomerGroupMembership, Wishlist, WishlistItem - AddressType enum, all repositories Pricing/Tax/Discounts (19 files): - TaxClass, TaxZone, TaxRate (compound/inclusive/priority support) - Discount (codes + automatic), DiscountRule (granular targeting) - PriceList, PriceListEntry (tiered per-group pricing) - GiftCard with balance tracking - 3 enums, all repositories Enhanced Inventory (6 files): - InventoryLocation (multi-warehouse with fulfillment/pickup flags) - StockLevel (per-variant per-location with thresholds) - StockAdjustment (full audit trail) - StockAdjustmentType enum Shipping & Fulfillment (14 files): - ShippingZone, ShippingMethod (flat/weight/carrier/free calculation types) - ShippingClass, Carrier (with tracking URL templates) - Shipment, ShipmentItem (with full tracking lifecycle) - ShipmentStatus, ShippingCalculationType enums Cart & Checkout (12 files): - Cart **************** CartItem - DraftOrder, DraftOrderLineItem (merchant-created pre-payment orders) - OrderNote (internal/customer-visible) - CartStatus, DraftOrderStatus enums Provider Abstraction Layer (15 files): - RetailProviderType enum (KAMO_NATIVE + 10 providers) - RetailProviderConfig entity (per-market provider settings) - RetailSyncLog entity (sync audit trail) - 6 sync adapter interfaces: ProductSyncAdapter, OrderSyncAdapter, InventorySyncAdapter, CustomerSyncAdapter, PricingSyncAdapter, FulfillmentSyncAdapter - RetailProviderCapability interface (feature flags per provider) - RetailProviderRegistry (runtime adapter registry) - SyncDirection, SyncStatus enums