Skip to content

immanas/Grow-Easy

Repository files navigation

πŸ›οΈ GrowEasy: AI‑Driven Retail Optimization for Shopify Stores

🌟 GrowEasy – AI‑Powered Inventory & Pricing Optimization for Shopify Unlock smart retail management with real-time demand forecasting, automated insights, and a full serverless architectureβ€”built entirely on AWS with SageMaker, Lambda, DynamoDB, and React.

Shopify πŸ›οΈ is a popular e-commerce platform, Shopify is selected as the primary integration platform for this project.

GrowEasy

🌐 Supported Platforms

  • Shopify (primary via webhooks & Admin API), WooCommerce (REST API), BigCommerce (official APIs), Magento / Adobe Commerce (enterprise-scale forecasting).

πŸ€” Real-Life Problem This Project Solves (Problem β†’ Solution β†’ Benefit) :

πŸ’’ Problem Without GrowEasy βœ… How GrowEasy Solves It πŸ† Advantage for Store Owners
❌ Manual inventory planning 🧠 Uses LSTM-based forecasting to predict product demand πŸ“¦ Avoids overstock/understock losses
❌ No real-time data-driven insights πŸ“Š Dashboard shows live trends, demand forecasts, and low-stock alerts ⚑ Fast, informed decision-making
❌ Missed opportunities during peak demand πŸ”” SNS alerts store owners about high-demand products in advance πŸ’° Maximizes sales by staying stocked
❌ Static pricing that ignores demand πŸ”„ Integrates demand forecasting into pricing logic (future upgrade) πŸ“ˆ Enables smart, dynamic pricing
❌ Shopify analytics not optimized for future planning πŸ“‚ Stores product + order history in DynamoDB, makes it ML-ready πŸ” Better long-term strategy with historical + forecasted data
❌ High infrastructure cost for ML pipelines ☁️ Fully serverless using AWS Lambda + SageMaker + EventBridge πŸ’Έ Zero server maintenance, pay-as-you-go
❌ No automation for restocking strategy ⏰ Hourly ML pipeline auto-updates forecasts and recommendations πŸ”„ Hands-free inventory management
❌ Difficult for non-tech founders to understand backend logic 🧱 Modular dashboard + visual insights + alerting system πŸ‘©β€πŸ’Ό Accessible to non-technical business users

πŸš€ Full System Architecture (overview) :

POST Request

πŸ“ Project Structure (Current State) :

This repository contains backend webhook ingestion, ML forecasting pipeline, and a React dashboard β€” built during rapid development, so structure reflects functional grouping rather than strict layering.

GrowEasy/ β”‚ β”œβ”€β”€ Backend/ # Core backend logic (Shopify β†’ AWS pipeline) β”‚ β”‚ β”‚ β”œβ”€β”€ Register_Webhook/ β”‚ β”‚ β”œβ”€β”€ register_webhook.py # Registers Shopify webhooks via Admin API β”‚ β”‚ └── GrowEasy.txt # Notes / webhook payload reference β”‚ β”‚ β”‚ β”œβ”€β”€ Webhook_Handler/ β”‚ β”‚ β”œβ”€β”€ webhookhandler.py # Processes incoming webhook POST requests β”‚ β”‚ └── what it does.txt # Explanation of handler logic β”‚ β”‚ β”‚ β”œβ”€β”€ forecast_result_writter/ β”‚ β”‚ β”œβ”€β”€ forecastResult.py # Writes ML forecast output β”‚ β”‚ └── what it does.txt # Description of forecasting output logic β”‚ β”‚ β”‚ β”œβ”€β”€ forecast_trigger/ β”‚ β”‚ β”œβ”€β”€ index.js # Triggers forecasting pipeline (EventBridge/Lambda) β”‚ β”‚ └── what it does.txt # Notes on trigger behavior β”‚ β”œβ”€β”€ data/ # Dataset used for ML pipeline β”‚ β”œβ”€β”€ befor-forcast.csv # Raw historical product/order data β”‚ └── after forecast.txt # Forecast output results β”‚ β”œβ”€β”€ Sagemaker/ # ML experimentation & training β”‚ └── forecasting-notebook.ipynb # LSTM model training notebook β”‚ β”œβ”€β”€ codex 2.0/groweasy/ # Frontend (hackathon dashboard build) β”‚ β”‚ β”‚ β”œβ”€β”€ public/ # Static assets β”‚ β”œβ”€β”€ src/ # React components & UI logic β”‚ β”œβ”€β”€ package.json β”‚ └── tailwind.config.js β”‚ β”œβ”€β”€ assets/ # Supporting files (images, references) β”‚ β”œβ”€β”€ README.md # Project documentation β”œβ”€β”€ LICENSE # License file β”œβ”€β”€ Dashboard.png # UI preview β”œβ”€β”€ api_gateway_event.png # API flow proof β”œβ”€β”€ cloudwatch_logs.png # Monitoring proof └── dynamodb_tables.png # Data storage proof 

πŸ“ˆ Core Features :

βœ… What This Project IS ❌ What This Project is NOT
Real-Time Data Ingestion System β€” Captures Shopify product and order events via webhooks and processes them through a serverless pipeline Not a manual data entry or batch-processing system
AI-Driven Demand Forecasting β€” Uses historical product data with LSTM/ML models to predict future demand Not a rule-based or static analytics dashboard
Serverless Processing Architecture β€” Built using AWS Lambda, EventBridge, and DynamoDB for scalable, event-driven execution Not a server-based backend requiring infrastructure management
Inventory Optimization Engine β€” Provides actionable insights on stock levels, demand trends, and restocking needs Not a passive reporting tool with no decision support
Automated Workflow Pipeline β€” Scheduled ML jobs update forecasts and insights without manual intervention Not a one-time analysis or offline ML experiment
Cost-Efficient Cloud Design β€” Fully serverless architecture minimizing idle infrastructure cost Not a heavy ML pipeline with high operational overhead

πŸ”„ Request Lifecycle (End-to-End) :

GrowEasy integrates directly with Shopify using webhooks and a serverless backend pipeline to enable real-time data processing.

App Setup & Installation
The GrowEasy app is created via the Shopify Partner Dashboard and installed on a merchant’s store using OAuth, granting secure access to product and inventory data. Webhook Registration Once installed, the system registers webhook events (e.g., product create/update) using the Shopify Admin API to receive real-time store activity. Event Ingestion (API Layer)
Shopify sends webhook POST requests to an API Gateway endpoint, which acts as a secure entry point for all incoming data. Processing (Lambda Backend) AWS Lambda processes the incoming payload, extracts relevant fields (product, inventory, pricing), and prepares it for downstream usage. Data Storage
Processed data is stored in DynamoDB for further analysis, forecasting, and historical tracking.

πŸ“· Diagram: Webhook Flow

API Gateway Flow
DynamoDB Tables

⏱️ ML Pipeline (Forecasting Flow)

GrowEasy runs an automated, serverless ML pipeline to generate demand forecasts:

  • ⏰ Event Trigger (EventBridge) β†’ Schedules forecasting job at regular intervals
  • πŸ“ Data Extraction (Lambda) β†’ Reads historical product data from DynamoDB and exports to S3 (products.csv)
  • 🧠 Model Execution (SageMaker / Python) β†’ Trains and runs LSTM-based forecasting on product demand
  • πŸ“Š Result Storage (DynamoDB) β†’ Stores forecast outputs per product for fast retrieval
  • πŸ“€ Alerting (SNS) β†’ Sends notifications on low stock or demand spikes

⚑ Outcome: Automated, repeatable forecasting pipeline with no manual intervention

πŸ“ˆ Observability & Monitoring

The system is monitored end-to-end for reliability, visibility, and debugging:

  • πŸ”— API Layer (API Gateway + Lambda) β†’ Serves latest forecast data to the dashboard
  • πŸ“Š Visualization (React + Recharts) β†’ Displays trends, forecasts, and usage insights
  • πŸ” Tracing (X-Ray) β†’ Provides request-level visibility across services
  • πŸ” Access Control (IAM) β†’ Enforces secure, least-privilege access

⚑ Outcome: Full visibility into data flow, system health, and model execution

Why this design?

  • Serverless β†’ no infra overhead
  • API abstraction β†’ secure frontend
  • Event + request hybrid β†’ supports both real-time + scheduled insights

πŸ“· Diagram: Monitoring & Logging via CloudWatch
CloudWatch Logs

πŸ“· Screenshot: GrowEasy Dashboard UI This dashboard is built specifically for retail business owners and inventory managers to monitor forecasted demand, stock levels, and price recommendations in real-time. But, Now here , Dashboard fully developed and owned by me as part of the GrowEasy AI-powered retail platform. Responsible for architecture, design, data integration, and deployment. πŸ”— Live Dashboard Demo β€” You can explore the working example here.

Dashbord view

βš™οΈYou can add multiple store here in the seeting :

Dashboard Settings

🧰 Tech Stack :

☁️ Cloud & Backend

  • AWS Lambda β€” serverless processing for webhooks, data pipelines, and forecasting
  • API Gateway β€” secure endpoint for Shopify webhook ingestion
  • DynamoDB β€” scalable storage for product, order, and forecast data
  • Amazon S3 β€” stores exported datasets for ML processing

πŸ”— Integration

  • Shopify Admin API β€” access product, inventory, and order data
  • Shopify Webhooks β€” real-time event ingestion (products, updates, orders)

🧠 Machine Learning

  • Amazon SageMaker β€” LSTM-based demand forecasting

βš™οΈ Orchestration & Automation

  • Amazon EventBridge β€” schedules periodic ML jobs and pipeline execution

πŸ“Š Monitoring & Alerts

  • Amazon CloudWatch β€” logs, metrics, and system monitoring
  • Amazon SNS β€” notifications for low stock and demand spikes

πŸ’» Frontend

  • React + Tailwind CSS β€” responsive dashboard UI
  • Recharts β€” data visualization (trends, forecasts, insights)

πŸ” Security

  • AWS IAM β€” role-based access control with least privilege

⚑ Quickstart (Run in ~30 seconds) :

1️⃣ Clone the repository

git clone https://github.com/your-username/groweasy.git

2️⃣ Setup Backend

  • cd GrowEasy/Backend
  • Update webhook endpoint (API Gateway URL)
  • Deploy Lambda functions (AWS Console / ZIP)

3️⃣ Configure Shopify Webhooks

  • Add API Gateway endpoint in Shopify
  • Subscribe to:
products/create products/update orders/create 

4️⃣ Run Forecasting Pipeline

  • Upload historical data to /data
  • Run: Sagemaker/forecasting-notebook.ipynb

5️⃣ Run Frontend Dashboard

cd "codex 2.0/groweasy" npm install npm start 

πŸ† Hackathon Experience: Codex 2.0

I built GrowEasy during the Codex 2.0 Hackathon in just 36 hours, working under extreme pressure with my team.

  • βœ… Real-life problem solving β†’ tackled challenges faced by small Shopify merchants like stockouts and wrong pricing.
  • βœ… Hands-on project building β†’ designed and implemented the end-to-end AI + cloud pipeline (Shopify β†’ AWS β†’ AI β†’ Dashboard).

πŸ“Έ Hackathon Moments:

Here are some snapshots from my Codex 2.0 journey while building GrowEasy:

CloudWatch Logs

Also, you can check from here: LinkedIn

✨ This experience made GrowEasy not just a project, but a real proof of my skills in cloud, AI, and problem-solving under pressure.

πŸ›‘οΈ Resilience & Security :

Failure Handling

  • Retry-safe execution (idempotent Lambda design)
  • Partial failures don’t break full pipeline
  • Errors logged in CloudWatch for traceability

Security

  • IAM roles with least privilege (no over-permissioned access)
  • No secrets exposed to frontend
  • API Gateway enforces controlled access + CORS

Scalability & Performance

  • Lambda auto-scales with request load
  • DynamoDB handles high-throughput reads/writes
  • Stateless design avoids bottlenecks

🧠 Engineering Philosophy :

Key Decisions

  • Serverless over containers β†’ faster setup, lower ops cost
  • API abstraction over direct AWS calls β†’ security + simplicity
  • Real data over mock dashboards β†’ credibility
  • Modular design β†’ Lambda, API, frontend decoupled

Trade-offs

  • Limited control over long-running workloads
  • Forecasting kept lightweight (not full ML pipeline infra)
  • Depends on AWS API availability

Explicit Limitations

  • No enterprise-grade RBAC/auth system
  • Forecasting accuracy depends on historical data quality
  • Not a full FinOps platform (focused scope)

πŸ™Œ Contributions Welcome!

GrowEasy is an open-source initiative, and we welcome contributions from developers, data scientists, cloud engineers, and e-commerce enthusiasts!

πŸ’‘ Ideas You Can Work On

Feature Idea Description
πŸ’° Dynamic Pricing Adjust product prices based on forecasted demand and stock levels
πŸ“‰ Sales Anomaly Detection Detect sudden drops/spikes in sales and alert store owners
🏬 Multi-Store Support Enable GrowEasy to manage multiple Shopify stores under one dashboard
πŸ” Role-Based Dashboard Add user authentication and access control for different team members
πŸ“ˆ Trend Analysis Charts Show seasonality and long-term performance trends for each product
πŸ“¬ Email Reporting (SNS) Send daily/weekly summaries to store owners using Amazon SNS

πŸ› οΈ How to Contribute

  1. 🍴 Fork the repo
  2. πŸ“¦ Create a new feature branch: git checkout -b feature-name
  3. βœ… Make your changes and test them
  4. πŸ“¬ Submit a pull request describing your enhancement

🀝 Let's Build This Together! Made with πŸ’š by Manas Gantait

About

GrowEasy-- AI-powered retail optimization system that uses real-time Shopify data to generate demand forecasts, automate inventory decisions, and provide actionable insights through a scalable serverless architecture.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors