Project Description
# Freelance Requirement – Grocery Store Ordering Website with WhatsApp Integration
We are looking for an experienced Full Stack Developer / Team to build an **Online Grocery Store Ordering System integrated with WhatsApp** for local kirana/grocery stores.
## Project Overview
The platform will allow customers to scan a QR code, open WhatsApp, access an online store, place orders, and receive automated order updates via WhatsApp.
The system should include:
* Customer-facing grocery ordering website
* WhatsApp integration
* Shopkeeper dashboard
* Super admin dashboard
* Referral & coupon system
* Delivery/order management
* Razorpay payment integration
---
# Customer Flow
QR Scan (Store Counter)
→ WhatsApp Opens
→ Welcome Message
→ “Shop Online” Button
→ Website Opens
→ Browse Products
→ Add to Cart
→ Checkout
### Business Rules
* Minimum order value: ₹200
* Delivery charge: ₹20
* First order discount:
* If first order AND order ≥ ₹500
* Apply ₹50 OFF automatically
After checkout:
* Customer receives WhatsApp confirmation
* Shopkeeper receives order on WhatsApp
* Delivery initiated
---
# Shopkeeper Flow
Shopkeeper Registration
→ QR Code Generation
→ Customer Orders
→ Order Sent to Shopkeeper WhatsApp
Shopkeeper replies:
* 1 = Accept
* 2 = Reject
* 3 = Call Customer
System automatically updates customer status.
---
# Required Features
## 1. Customer Website
* Mobile-first responsive UI
* Product categories
* Product search
* Cart & checkout
* Coupon system
* Razorpay payment gateway
* COD option
* Order tracking
* WhatsApp notifications
---
## 2. WhatsApp Integration
Need WhatsApp Business API integration for:
* Welcome messages
* Order confirmation
* Order status updates
* Referral rewards
* Weekly reports to shopkeepers
---
## 3. Shopkeeper Dashboard
Dashboard should show:
* Today’s Orders
* Today’s Revenue
* Pending Orders
* Delivered Orders
* Product Management
* Order Management
* Offers & Discounts
* Delivery Staff Management
* COD vs Online Payments
Weekly analytics report should be automatically sent to shopkeeper WhatsApp number.
---
## 4. Super Admin Dashboard
### Store Management
* All stores list
* Activate/deactivate stores
* Subscription management
### Subscription Plans
* Monthly – ₹599
* Quarterly – ₹1500
* Annual – ₹5000
### Analytics Required
* Orders Today
* Revenue Analytics
* Repeat Customers
* Product Analytics
* Peak Ordering Times
* WhatsApp Analytics
* Delivery Analytics
* Category Performance
* Low Stock Alerts
---
# Referral System
User A refers User B
→ User B places first successful order
→ System generates coupon
→ WhatsApp reward message sent
Example:
Referral Reward Unlocked!
You earned ₹25 OFF on your next order.
Coupon Code: AMAN25
Valid on orders above ₹300.”
Backend validation should include:
* Coupon belongs to user?
* Already used?
* Expired?
* Minimum order reached?
Discount should apply before Razorpay payment.
---
# Preferred Tech Stack
Frontend:
* React / Next.js
Backend:
* Node.js / Laravel / Django
Database:
* MySQL / PostgreSQL
Integrations:
* WhatsApp Business API
* Razorpay
* QR Code Generator
Hosting:
* AWS / DigitalOcean / VPS
---
# Deliverables
* Full source code
* Admin panels
* API integration
* Deployment support
* Documentation
* Bug fixing support
---
# Developer Requirements
Please apply with:
1. Relevant portfolio/projects
2. Experience with WhatsApp API
3. Estimated timeline
4. Estimated budget
5. Suggested tech stack
We are looking for a long-term development partner.