[WIP] Synchronize inventory across multiple sales channels

[Copilot]

Thanks for assigning this issue to me. I'm starting to work on it and will keep this PR's description up to date as I form a plan and make progress.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Phase 3] Epic: Multi-Channel Sales</issue_title>
<issue_description>## Priority: P3
Phase: 3
Type: Epic

Overview

Epic Goal: Synchronize inventory and product data across multiple sales channels (Shopify, WooCommerce, Facebook Shop, Instagram Shopping, TikTok Shop) from a single StormCom dashboard, preventing overselling and enabling omnichannel commerce.

This epic targets merchants selling on 3+ platforms simultaneously, addressing the #1 pain point: inventory inconsistency causing overselling, customer disappointment, and manual reconciliation work.

Business Value

• Market Need: 65% of merchants sell on 2+ channels (2024 survey)
• Overselling Prevention: Reduce overselling incidents by 95%
• Time Savings: Eliminate 10+ hours/week of manual inventory updates
• Revenue Increase: +20% sales by listing on all channels without inventory fear
• Competitive Advantage: 80% of competitors lack real-time sync

Child Issues

Phase 3.1 - Core Sync Engine (3 issues, 6 days)

• Issue [WIP] Integrate Facebook Shop for product catalog and order management #56: Centralized Inventory Model (2 days)

  • InventorySnapshot table (product, channel, quantity, lastSyncAt)
  • Real-time sync on StormCom inventory change
  • Conflict resolution (StormCom as source of truth)
  • Low stock alerts (<10 units across all channels)

• Issue [WIP] Synchronize inventory across multiple sales channels #57: Channel Abstraction Layer (2 days)

  • ChannelConnector interface (connect, syncProducts, updateInventory)
  • ShopifyConnector, WooCommerceConnector, FacebookConnector
  • OAuth flows for each channel
  • Connection health monitoring

• Issue [WIP] Implement marketing automation for social media platforms #58: Webhook Router (2 days)

  • Receive webhooks from all channels (order.created, product.updated)
  • Route to appropriate handler (ShopifyHandler, WooCommerceHandler)
  • Duplicate order detection (prevent double fulfillment)
  • Webhook retry queue (exponential backoff)

Phase 3.2 - Channel Integrations (4 issues, 10 days)

• Issue [WIP] Add multi-vendor marketplace functionality to StormCom #59: Shopify Integration (3 days)

  • OAuth 2.0 connection (Shopify App Store listing)
  • Product sync (variants, images, pricing)
  • Inventory updates via GraphQL Admin API
  • Order import with fulfillment status

• Issue [WIP] Add WordPress integration plugin for StormCom storefront #60: WooCommerce Integration (2 days)

  • REST API connection (reuse WordPress epic [Phase 2] Epic: External Website Integration #33 code)
  • Inventory sync via stock_quantity field
  • Order webhook handler
  • Multi-store support (connect 5+ WooCommerce sites)

• Issue [WIP] Add WooCommerce product sync to StormCom #61: Facebook Shop Integration (3 days)

  • Facebook Commerce API (catalog_batch_update)
  • Product feed sync (XML/CSV)
  • Inventory updates every 15 minutes
  • Order notifications via Facebook Messenger API

• Issue [WIP] Build RESTful API for external integration #62: Instagram Shopping Integration (2 days)

  • Instagram Graph API (product tagging)
  • Sync product catalog from Facebook Shop
  • Track sales via Instagram Checkout
  • Shoppable post analytics

Phase 3.3 - Advanced Features (3 issues, 6 days)

• Issue [Phase 1] PaymentAttempt & PaymentTransaction State Machine #63: Channel-Specific Pricing (2 days)

  • Set different prices per channel (Shopify: $99, Amazon: $89)
  • Currency conversion (USD, EUR, GBP, BDT)
  • Bulk price updates (increase all Shopify prices by 10%)
  • Price sync schedule (daily at 12am UTC)

• Issue [Phase 1] Inventory Reservation & Hold System #64: Order Consolidation Dashboard (2 days)

  • View orders from all channels in one place
  • Filter by channel (show only Shopify orders)
  • Unified order status (map Shopify "fulfilled" → StormCom "SHIPPED")
  • Export multi-channel orders (CSV, Excel)

• Issue [WIP] Add inventory reservation and hold system #65: Channel Performance Analytics (2 days)

  • Revenue by channel (pie chart: Shopify 40%, Facebook 30%, etc.)
  • Conversion rate by channel
  • Best-selling products per channel
  • Inventory turnover rate

Acceptance Criteria (Epic Level)

1. Inventory Synchronization

   • ✅ Real-time inventory updates (<30 seconds across all channels)
   • ✅ Support 5+ channels simultaneously
   • ✅ Prevent overselling (central inventory as single source of truth)
   • ✅ Low stock alerts when total quantity <10 units

2. Channel Connections

   • ✅ One-click OAuth connection for Shopify, Facebook, Instagram
   • ✅ REST API connection for WooCommerce
   • ✅ Connection health monitoring (last sync time, error count)
   • ✅ Automatic reconnection on token expiry

3. Order Management

   • ✅ Import orders from all channels hourly
   • ✅ Deduplicate orders (same customer email + order total)
   • ✅ Unified order fulfillment (mark as shipped → update all channels)
   • ✅ Track order source (Order.source = "SHOPIFY", "FACEBOOK", etc.)

4. Conflict Resolution

   • ✅ StormCom inventory as source of truth (always)
   • ✅ Handle simultaneous edits (last-write-wins ...

• Fixes [Phase 3] Epic: Multi-Channel Sales #35

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
stormcomui	Ready	Preview	Comment	Nov 25, 2025 2:20am