Ganesh Beda Jewellery CRM

A comprehensive, production-ready CRM and Inventory Management System for jewelry stores built with React, Node.js, Express, MongoDB, and Tailwind CSS.

Features

✨ Core Modules

• Authentication with role-based access control (Owner, Manager, Staff)
• Dashboard with KPIs and analytics
• Customer Management with purchase history
• Inventory Management with low stock alerts
• Sales & Billing with invoice generation
• Custom Jewelry Orders tracking
• CRM Follow-ups (birthdays, anniversaries, VIP tracking)
• Reports & Analytics with export options
• Settings & Shop Configuration

🎨 UI/UX

• Premium gold & black luxury theme
• Responsive design (Mobile, Tablet, Desktop)
• Dark mode support
• Modern animations
• Toast notifications
• Loading skeletons

Tech Stack

Frontend

• React 18 with TypeScript
• Tailwind CSS
• Shadcn/UI Components
• Chart.js for analytics
• Axios for API calls
• React Router for navigation

Backend

• Node.js + Express.js
• MongoDB with Mongoose
• JWT Authentication
• Multer for file uploads
• jsPDF for invoice generation

Quick Start

Prerequisites

• Node.js 16+ and npm
• MongoDB (local or Atlas)

Backend Setup

cd backend
npm install
cp .env.example .env
# Update .env with your MongoDB URI
npm run dev

Frontend Setup

cd frontend
npm install
npm start

Visit http://localhost:3000 in your browser.

API Documentation

Base URL: http://localhost:5000/api

Auth Routes

• POST /auth/register - Create new user
• POST /auth/login - User login
• POST /auth/refresh - Refresh token
• POST /auth/logout - Logout

Customer Routes

• GET /customers - List customers
• POST /customers - Create customer
• GET /customers/:id - Get customer details
• PUT /customers/:id - Update customer
• DELETE /customers/:id - Delete customer

Product Routes

• GET /products - List products
• POST /products - Create product
• PUT /products/:id - Update product
• DELETE /products/:id - Delete product

Sales Routes

• GET /sales - List invoices
• POST /sales - Create invoice
• GET /sales/:id - Get invoice details

Orders Routes

• GET /orders - List custom orders
• POST /orders - Create order
• PUT /orders/:id - Update order

Project Structure

ganesh-crm/
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── context/
│   │   ├── services/
│   │   ├── types/
│   │   └── App.tsx
│   └── package.json
├── backend/
│   ├── src/
│   │   ├── models/
│   │   ├── controllers/
│   │   ├── routes/
│   │   ├── middleware/
│   │   ├── config/
│   │   └── server.ts
│   ├── seeds/
│   └── package.json
└── README.md

Development

Running Tests

npm run test

Building for Production

# Frontend
cd frontend
npm run build

# Backend
cd backend
npm run build

Future Enhancements

• AI Sales Assistant (Phase 2)
• WhatsApp Integration for customer notifications
• Multi-branch support
• Advanced reporting with BI tools
• Mobile app for staff

License

MIT

Contact

For support, contact: support@ganeshbeda.com