GROWTHmerchant

(formerly Merchant Growth AI)

📖 Project Overview

GROWTHmerchant is an intelligent, bilingual (English & Hindi) business dashboard and AI copilot designed for modern retail merchants. It transforms raw, day-to-day transaction data into proactive, actionable insights. Instead of just showing historical charts, the platform actively predicts revenue, identifies slow periods, automatically drafts promotional offers, and executes them directly to customers—acting as a fully autonomous marketing and finance assistant.

🚀 Core Features

• AI Merchant Growth Copilot: A proactive daily action plan that generates a 30-day "Growth Score" and a 7-day expected revenue forecast. It monitors customer footfall and alerts the merchant to anomalies (e.g., "A quieter afternoon") with concrete evidence.
• Action Lab (Smart Offers): An experimentation lab where the AI drafts targeted promotional campaigns (e.g., offering a combo deal to loyal customers during slow hours). The merchant can review the budget, expected ROI, and approve the campaign with a single click.
• Ask AI (Conversational Intelligence): A built-in chat interface where merchants can ask questions about their business in plain language, and the LLM interprets the data to provide exact answers and charts.
• Bilingual Accessibility: The entire interface toggles seamlessly between English and Hindi to accommodate a wider merchant base in India.

🔌 Production Integrations

• Paytm Payment Gateway Intelligence:
  • Secure Webhooks: Includes a production-ready Server-to-Server (S2S) webhook that ingests Paytm transactions.
  • Fraud Prevention: Uses official checksum validation and directly queries the Meta Status API to authoritatively verify payments before recording them.
  • Real-Time Analytics: Calculates live gateway success rates, daily collections, and average order values directly from verified database records.
• WhatsApp Business Cloud Messaging:
  • Seamless Broadcasts: Integrates directly with the official Meta Graph API. Approved "Smart Offers" from the Action Lab are immediately broadcasted to opted-in customer segments via WhatsApp.
  • Campaign Analytics: Features a webhook receiver to track message delivery, read receipts, and ultimately attribute store revenue back to specific WhatsApp campaigns.
  • Sandbox Safety: Automatically falls back to a simulated demo mode if live Meta credentials aren't provided in the environment file, preventing crashes during local development.

🛠️ Technical Stack

• Framework: Hybrid React architecture using vinext (Vite + Next-style routing) optimized for edge computing.
• Database: Cloudflare D1 (Serverless Edge SQLite) managed safely via Drizzle ORM.
• Styling: Tailwind CSS with accessible, Radix-style UI components and Lucide icons.
• Deployment Environment: Designed to run blazingly fast on Cloudflare Workers / Edge infrastructure with strict environment variable handling to protect API secrets.