# sunzzx/shopify-dropshipping-automation architecture

> Architecture diagram of the GitHub repository sunzzx/shopify-dropshipping-automation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sunzzx/shopify-dropshipping-automation
- Repository: https://github.com/sunzzx/shopify-dropshipping-automation

## Overview

This repository combines a Shopify storefront theme, CJ-to-Shopify automation, and an AI store-management dashboard. The main product workflow is an operator initiating an upload through the manager or CLI; the sync service obtains CJ product data, optimizes listings, and creates products and collections in Shopify. The theme presents storefront pages, while monitoring, order/inventory automation, and multi-market support are documented companion capabilities. Several listed modules were not excerpted, so their links are shown only where documented; the theme’s internal rendering relationships are likewise kept broad.

Main entry points: [`ai-store-manager/ai-manager.js`](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai-manager.js) (Manager API), [`automation/src/services/ProductSyncService.js`](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/ProductSyncService.js) (Product Sync), [`layout/theme.liquid`](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/layout/theme.liquid) (Storefront Theme), [`ai-store-manager/dashboard/index.html`](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/dashboard/index.html) (Manager Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_manager["AI Store Manager"]
  node_dashboard["Manager Dashboard<br/>[index.html]"]
  node_manager_api["Manager API<br/>[ai-manager.js]"]
  node_chat["Chat Interface<br/>[chat-interface.js]"]
  node_optimizer["AI Optimizer<br/>[auto-optimizer.js]"]
  node_manager_modules["AI Modules<br/>[ai-modules.js]"]
  node_manager_health["Manager Health<br/>[health-monitor.js]"]
  node_notifications["Notifications"]
end

subgraph group_automation["Product Automation"]
  node_cli_upload["Live Upload CLI<br/>[uploadHoodies.js]"]
  node_demo_upload["Demo Upload"]
  node_automation_api["Automation API<br/>[index.js]"]
  node_product_sync["Product Sync"]
  node_seo["SEO Optimizer<br/>[SEOOptimizer.js]"]
  node_logger["Automation Logger<br/>[Logger.js]"]
end

subgraph group_integrations["External Integrations"]
  node_cj_service["CJ Product Service<br/>[CJService.js]"]
  node_shopify_service["Shopify API Service<br/>[ShopifyService.js]"]
end

subgraph group_storefront["Shopify Storefront"]
  node_theme["Storefront Theme<br/>[theme.liquid]"]
  node_theme_pages["Store Pages<br/>[product.liquid]"]
  node_theme_seo["Theme SEO"]
end

subgraph group_operations["Store Operations"]
  node_inventory_sync["Inventory Sync"]
  node_orders["Order Processing"]
  node_webhooks["Webhook Handler<br/>[WebhookHandler.js]"]
  node_health["Health Monitor<br/>[health-monitor.js]"]
end

node_operator(("Store Operator"))
node_cj["CJ Dropshipping"]
node_shopify["Shopify Platform"]

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"served by"| node_manager_api
node_manager_api -->|"runs demo"| node_demo_upload
node_manager_api -->|"runs live upload"| node_cli_upload
node_manager_api -.->|"offers chat"| node_chat
node_manager_api -.->|"reports status"| node_manager_health
node_manager_api -.->|"may notify"| node_notifications
node_manager_api -.->|"uses AI modules"| node_manager_modules
node_manager_api -.->|"uses optimizer"| node_optimizer
node_cli_upload -->|"invokes upload"| node_product_sync
node_automation_api -->|"invokes upload"| node_product_sync
node_operator -->|"requests upload"| node_automation_api
node_product_sync -->|"searches products"| node_cj_service
node_product_sync -->|"gets details"| node_cj
node_product_sync -->|"optimizes listing"| node_seo
node_product_sync -->|"creates listings"| node_shopify_service
node_cj_service -->|"calls API"| node_cj
node_shopify_service -->|"calls API"| node_shopify
node_product_sync -->|"logs progress"| node_logger
node_theme -.->|"renders pages"| node_theme_pages
node_theme -.->|"includes SEO tags"| node_theme_seo
node_shopify -->|"serves storefront"| node_theme
node_shopify -.->|"syncs inventory"| node_inventory_sync
node_shopify -.->|"processes orders"| node_orders
node_shopify -.->|"sends webhooks"| node_webhooks
node_operator -.->|"checks health"| node_health

click node_dashboard "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/dashboard/index.html"
click node_manager_api "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai-manager.js"
click node_chat "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai/chat-interface.js"
click node_optimizer "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai/auto-optimizer.js"
click node_manager_modules "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/modules/ai-modules.js"
click node_manager_health "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/monitoring/health-monitor.js"
click node_notifications "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/core/notification-center.js"
click node_cli_upload "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/commands/uploadHoodies.js"
click node_demo_upload "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/commands/uploadHoodiesDemo.js"
click node_automation_api "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/index.js"
click node_product_sync "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/ProductSyncService.js"
click node_seo "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/utils/SEOOptimizer.js"
click node_logger "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/utils/Logger.js"
click node_cj_service "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/CJService.js"
click node_shopify_service "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/ShopifyService.js"
click node_theme "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/layout/theme.liquid"
click node_theme_pages "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/sections/product.liquid"
click node_theme_seo "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/snippets/seo-meta-tags-pro.liquid"
click node_inventory_sync "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/InventorySyncService.js"
click node_orders "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/OrderProcessingService.js"
click node_webhooks "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/handlers/WebhookHandler.js"
click node_health "https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/monitoring/health-monitor.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_manager_api,node_chat,node_optimizer,node_manager_modules,node_manager_health,node_notifications toneBlue
class node_cli_upload,node_demo_upload,node_automation_api,node_product_sync,node_seo,node_logger toneAmber
class node_cj_service,node_shopify_service toneMint
class node_theme,node_theme_pages,node_theme_seo toneRose
class node_inventory_sync,node_orders,node_webhooks,node_health,node_operator,node_cj,node_shopify toneIndigo
```

## Components

### AI Store Manager

- [Manager Dashboard](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/dashboard/index.html): `ai-store-manager/dashboard/index.html`
- [Manager API](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai-manager.js): `ai-store-manager/ai-manager.js`
- [Chat Interface](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai/chat-interface.js): `ai-store-manager/ai/chat-interface.js`
- [AI Optimizer](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/ai/auto-optimizer.js): `ai-store-manager/ai/auto-optimizer.js`
- [AI Modules](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/modules/ai-modules.js): `ai-store-manager/modules/ai-modules.js`
- [Manager Health](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/monitoring/health-monitor.js): `ai-store-manager/monitoring/health-monitor.js`
- [Notifications](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/core/notification-center.js): `ai-store-manager/core/notification-center.js`

### Product Automation

- [Live Upload CLI](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/commands/uploadHoodies.js): `automation/src/commands/uploadHoodies.js`
- [Demo Upload](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/commands/uploadHoodiesDemo.js): `automation/src/commands/uploadHoodiesDemo.js`
- [Automation API](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/index.js): `automation/src/index.js`
- [Product Sync](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/ProductSyncService.js): `automation/src/services/ProductSyncService.js`
- [SEO Optimizer](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/utils/SEOOptimizer.js): `automation/src/utils/SEOOptimizer.js`
- [Automation Logger](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/utils/Logger.js): `automation/src/utils/Logger.js`

### External Integrations

- [CJ Product Service](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/CJService.js): `automation/src/services/CJService.js`
- [Shopify API Service](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/ShopifyService.js): `automation/src/services/ShopifyService.js`

### Shopify Storefront

- [Storefront Theme](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/layout/theme.liquid): `layout/theme.liquid`
- [Store Pages](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/sections/product.liquid): `sections/product.liquid`
- [Theme SEO](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/snippets/seo-meta-tags-pro.liquid): `snippets/seo-meta-tags-pro.liquid`

### Store Operations

- [Inventory Sync](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/InventorySyncService.js): `automation/src/services/InventorySyncService.js`
- [Order Processing](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/services/OrderProcessingService.js): `automation/src/services/OrderProcessingService.js`
- [Webhook Handler](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/automation/src/handlers/WebhookHandler.js): `automation/src/handlers/WebhookHandler.js`
- [Health Monitor](https://github.com/sunzzx/shopify-dropshipping-automation/blob/clean-main/ai-store-manager/monitoring/health-monitor.js): `ai-store-manager/monitoring/health-monitor.js`

### Other components

- **Store Operator**
- **CJ Dropshipping**
- **Shopify Platform**

## Connections

- Store Operator → Manager Dashboard: uses (evidence: `README.md`)
- Manager Dashboard → Manager API: served by (evidence: `ai-store-manager/ai-manager.js`)
- Manager API → Demo Upload: runs demo (evidence: `ai-store-manager/ai-manager.js`)
- Manager API → Live Upload CLI: runs live upload (evidence: `ai-store-manager/ai-manager.js`)
- Manager API → Chat Interface: offers chat
- Manager API → Manager Health: reports status
- Manager API → Notifications: may notify
- Manager API → AI Modules: uses AI modules
- Manager API → AI Optimizer: uses optimizer
- Live Upload CLI → Product Sync: invokes upload (evidence: `automation/src/commands/uploadHoodies.js`)
- Automation API → Product Sync: invokes upload (evidence: `automation/src/index.js`)
- Store Operator → Automation API: requests upload (evidence: `automation/src/index.js`)
- Product Sync → CJ Product Service: searches products (evidence: `automation/src/services/ProductSyncService.js`)
- Product Sync → CJ Dropshipping: gets details
- Product Sync → SEO Optimizer: optimizes listing (evidence: `automation/src/services/ProductSyncService.js`)
- Product Sync → Shopify API Service: creates listings (evidence: `automation/src/services/ProductSyncService.js`)
- CJ Product Service → CJ Dropshipping: calls API (evidence: `automation/src/services/CJService.js`)
- Shopify API Service → Shopify Platform: calls API (evidence: `automation/src/services/ShopifyService.js`)
- Product Sync → Automation Logger: logs progress (evidence: `automation/src/services/ProductSyncService.js`)
- Storefront Theme → Store Pages: renders pages
- Storefront Theme → Theme SEO: includes SEO tags
- Shopify Platform → Storefront Theme: serves storefront (evidence: `README.md`)
- Shopify Platform → Inventory Sync: syncs inventory
- Shopify Platform → Order Processing: processes orders
- Shopify Platform → Webhook Handler: sends webhooks
- Store Operator → Health Monitor: checks health
