Skip to content

README.md

Latest commit

 

History

History
157 lines (111 loc) · 3.29 KB

README.md

File metadata and controls

157 lines (111 loc) · 3.29 KB
Raw

🛍️ Gumasto – Smart Retail AI Platform

Gumasto is an AI-powered retail intelligence system designed to help store owners reduce losses, improve profit margins, and make data-driven decisions across inventory, pricing, demand forecasting, waste management, shelf placement, and brand replacement.

🚀 Vision

Retail businesses lose revenue daily due to over-stocking, wrong pricing, expiry, and poor shelf planning.

Gumasto transforms raw retail data into real-time intelligence.

🔥 Key Modules

  • 📊 Dashboard – Business health snapshot
  • 📦 Inventory – Expiry & risk detection
  • 💸 Discounts – AI powered dynamic pricing
  • 📈 Trends – Demand forecasting
  • ♻ Waste Management – Smart disposal actions
  • 🛒 Placement – Shelf optimization
  • 🏷 Comparison – Brand performance intelligence

📊 Dashboard Overview

Metric Description
Inventory at Risk Items nearing expiry
Waste Reduced % reduction through AI actions
Revenue Saved Profit preserved via early intervention
Fast Moving Products High-demand SKUs

AI Highlights:

  • Expiry Risk Alerts
  • Demand Surge Prediction
  • Layout Optimization Suggestions

📦 Inventory & Expiry Intelligence

Metric Meaning
Total SKUs All tracked products
High Risk Items Products nearing expiry
Safe Inventory Products with healthy shelf life
Avg Shelf Life Average remaining life

Products are automatically classified into High / Medium / Safe Risk.

💸 Dynamic Discount Engine

AI determines optimal discounts based on:

  • Expiry risk
  • Sales velocity
  • AI sensitivity tuning
Metric Meaning
Products Discounted Items currently discounted
Avg Discount Average price reduction
Waste Reduction Impact % reduction in waste

📈 Demand Forecasting

Metric Meaning
Predicted Growth Expected sales increase
High Demand Category Fastest growing category
Underperforming SKUs Products losing demand

♻ Waste Management

Action Meaning
Dispose Expired items
Donate Surplus inventory
Discount Near-expiry products
Sale Flash sale suggestions

🛒 Placement Intelligence

Shelf optimization zones:

  • Top / Mid / Bottom × Left / Center / Right
  • Checkout Zone

🏷 Brand Comparison & Replacement Intelligence

Brands evaluated on:

  • Sales Velocity
  • Profit Margin
  • Customer Preference
  • Expiry Risk
  • AI Performance Score

🧾 CSV File Format Required

Column Description
Product_name Product name
Brand Brand name
Category Product category
Price Selling price
Stock Quantity
Units_sold Sold Units
Expiry_date YYYY-MM-DD

Max file size: 500MB

🛠 Tech Stack

Frontend: HTML, CSS, JavaScript, Bootstrap Backend: Node.js, Express
AI / ML: Python Database: MongoDB

⚙️ Installation

git clone https://github.com/Freny07/Retail-AI
cd Gumasto
cd backend/node-api
npm install
npm run dev
cd frontend
npm install
npm run dev

Gumasto – Your AI powered retail growth partner. 🚀