💊 PharmaEZ — Pharmacy & Healthcare E-Commerce Platform

A full-featured MERN Stack (MongoDB, Express.js, React.js, Node.js) e-commerce application for a pharmacy and healthcare store.

📋 Table of Contents

Features
Tech Stack
Project Structure
Prerequisites
Installation & Setup
Environment Variables
Seeding Sample Data
Running the Application
API Documentation
Database Schema
Application Modules
Admin Dashboard
Deployment

✅ Features

Customer Features

🔐 User registration, login, and JWT authentication
🛍️ Browse products by categories and subcategories
🔍 Full-text search with filters (category, price, prescription required)
🛒 Shopping cart with quantity management
❤️ Wishlist management
💳 Multi-step checkout with address selection
💊 Prescription upload and verification workflow
📦 Order tracking with real-time status updates
⭐ Product reviews and ratings system
🎁 Loyalty points system (1 point per ₹10 spent)
📍 Multiple delivery addresses management
👤 Personal profile management

Admin Features

📊 Analytics dashboard with revenue charts
📦 Complete order management with status updates
💊 Product catalogue management (CRUD)
👥 User account management
📋 Prescription review and approval workflow
🏭 Inventory monitoring with low-stock alerts
📈 Sales and revenue reporting

Healthcare-Specific Features

Prescription (Rx) required flag on medicines
Salt/generic name tracking
Dosage form and strength information
Side effects and usage instructions
Batch number and expiry date management
Prescription upload and pharmacist review workflow
Medicine categories: OTC, Prescription, Vitamins, Medical Devices, Baby Care, etc.

🛠 Tech Stack

Layer	Technology
Frontend	React.js 18, React Router v6, Context API
Backend	Node.js, Express.js
Database	MongoDB with Mongoose ODM
Authentication	JWT (JSON Web Tokens) + bcryptjs
File Upload	Multer
Styling	Custom CSS with CSS Variables
HTTP Client	Axios
Icons	React Icons (Feather Icons)
Toast Notifications	React Hot Toast
Build Tool	Vite

📁 Project Structure

pharmaez/
├── server/                     # Backend (Node.js + Express)
│   ├── config/
│   │   └── db.js               # MongoDB connection
│   ├── controllers/
│   │   ├── authController.js   # Auth, profile, addresses, prescriptions
│   │   ├── productController.js# Products, reviews
│   │   ├── cartController.js   # Shopping cart
│   │   ├── orderController.js  # Orders, admin stats
│   │   └── adminController.js  # Admin: users, prescriptions, config
│   ├── middleware/
│   │   ├── auth.js             # JWT protect + adminOnly + generateToken
│   │   └── errorHandler.js     # Global error handler + 404
│   ├── models/
│   │   ├── User.js             # User schema (addresses, prescriptions, wishlist)
│   │   ├── Product.js          # Product schema (medical fields, reviews)
│   │   ├── Cart.js             # Cart schema
│   │   ├── Order.js            # Order schema (status history, prescription)
│   │   └── AdminConfig.js      # Banners, settings
│   ├── routes/
│   │   ├── authRoutes.js
│   │   ├── productRoutes.js
│   │   ├── cartRoutes.js
│   │   ├── orderRoutes.js
│   │   └── adminRoutes.js
│   ├── utils/
│   │   └── seeder.js           # Database seeder
│   ├── uploads/                # Uploaded prescription files
│   ├── .env.example
│   ├── index.js                # Express server entry point
│   └── package.json
│
└── client/                     # Frontend (React.js + Vite)
    ├── src/
    │   ├── assets/styles/
    │   │   ├── global.css      # Global styles, utilities, CSS variables
    │   │   └── components.css  # Shared component styles
    │   ├── components/
    │   │   ├── admin/
    │   │   │   ├── AdminLayout.jsx  # Admin sidebar layout
    │   │   │   └── AdminLayout.css
    │   │   ├── common/
    │   │   │   ├── ProductCard.jsx  # Reusable product card
    │   │   │   └── ProductCard.css
    │   │   └── layout/
    │   │       ├── Navbar.jsx   # Responsive navigation + search
    │   │       ├── Navbar.css
    │   │       ├── Footer.jsx
    │   │       └── Footer.css
    │   ├── context/
    │   │   ├── AuthContext.jsx  # Global auth state
    │   │   └── CartContext.jsx  # Global cart state
    │   ├── pages/
    │   │   ├── admin/
    │   │   │   ├── AdminDashboard.jsx
    │   │   │   ├── AdminProducts.jsx
    │   │   │   ├── AdminProductForm.jsx
    │   │   │   ├── AdminOrders.jsx
    │   │   │   ├── AdminUsers.jsx
    │   │   │   ├── AdminInventory.jsx
    │   │   │   ├── AdminPrescriptions.jsx
    │   │   │   └── AdminPages.css
    │   │   ├── auth/
    │   │   │   ├── AuthPages.jsx  (LoginPage + RegisterPage)
    │   │   │   ├── LoginPage.jsx
    │   │   │   ├── RegisterPage.jsx
    │   │   │   └── AuthPages.css
    │   │   ├── user/
    │   │   │   ├── UserDashboard.jsx
    │   │   │   ├── OrdersPage.jsx
    │   │   │   ├── OrderDetailPage.jsx
    │   │   │   ├── WishlistPage.jsx
    │   │   │   ├── PrescriptionsPage.jsx
    │   │   │   ├── ProfilePage.jsx
    │   │   │   └── UserPages.css
    │   │   ├── HomePage.jsx         # Hero, categories, featured
    │   │   ├── HomePage.css
    │   │   ├── ProductsPage.jsx     # Listing with filters/pagination
    │   │   ├── ProductsPage.css
    │   │   ├── ProductDetailPage.jsx # Detail, tabs, reviews
    │   │   ├── ProductDetailPage.css
    │   │   ├── CartPage.jsx
    │   │   ├── CartPage.css
    │   │   ├── CheckoutPage.jsx     # 3-step checkout
    │   │   ├── CheckoutPage.css
    │   │   └── OrderConfirmationPage.jsx
    │   ├── utils/
    │   │   └── api.js          # Axios instance with interceptors
    │   ├── App.jsx             # Routes + providers
    │   └── main.jsx
    ├── index.html
    ├── vite.config.js
    └── package.json

⚙️ Prerequisites

Node.js v18 or higher
MongoDB v6 or higher (local or MongoDB Atlas)
npm or yarn

🚀 Installation & Setup

1. Clone / Download the Project

cd pharmaez

2. Backend Setup

cd server
npm install

Create your environment file:

cp .env.example .env

Edit .env with your values (see Environment Variables).

3. Frontend Setup

cd ../client
npm install

🔧 Environment Variables

Create server/.env with these values:

PORT=8000
MONGO_URI=mongodb://localhost:27017/pharmaez
JWT_SECRET=pharmaez_super_secret_jwt_key_change_in_production
JWT_EXPIRES_IN=7d
NODE_ENV=development

For MongoDB Atlas (Cloud):

MONGO_URI=mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/pharmaez?retryWrites=true&w=majority

🌱 Seeding Sample Data

After setting up your .env, run the seeder to populate the database with:

1 Admin user
1 Sample customer
12 Healthcare products across all categories

cd server
npm run seed

Default login credentials after seeding:

Role	Email	Password
Admin	admin@pharmaez.com	admin123
User	raj@example.com	user123

▶️ Running the Application

Development Mode (recommended — runs both frontend and backend)

Terminal 1 — Backend:

cd server
npm run dev       # Uses nodemon for hot-reload
# Server starts at http://localhost:8000

Terminal 2 — Frontend:

cd client
npm run dev       # Vite dev server with HMR
# App starts at http://localhost:5173

Open your browser at http://localhost:5173

Production Build

# Build frontend
cd client
npm run build
# dist/ folder is created

# Start backend in production
cd ../server
NODE_ENV=production npm start

📡 API Documentation

Base URL: http://localhost:8000/api

Authentication Endpoints

Method	Endpoint	Access	Description
POST	`/auth/register`	Public	Register new user
POST	`/auth/login`	Public	Login and get JWT token
GET	`/auth/profile`	Private	Get user profile + wishlist
PUT	`/auth/profile`	Private	Update profile
PUT	`/auth/change-password`	Private	Change password
POST	`/auth/address`	Private	Add delivery address
DELETE	`/auth/address/:id`	Private	Delete delivery address
POST	`/auth/wishlist/:productId`	Private	Toggle product in wishlist
POST	`/auth/prescription`	Private	Upload prescription (multipart)

Product Endpoints

Method	Endpoint	Access	Description
GET	`/products`	Public	List with filters: `keyword`, `category`, `subcategory`, `minPrice`, `maxPrice`, `prescriptionRequired`, `sort`, `page`, `limit`
GET	`/products/featured`	Public	Featured products
GET	`/products/category/:category`	Public	Products by category
GET	`/products/:id`	Public	Single product
POST	`/products/:id/reviews`	Private	Add review
POST	`/products`	Admin	Create product
PUT	`/products/:id`	Admin	Update product
DELETE	`/products/:id`	Admin	Delete product

Cart Endpoints

Method	Endpoint	Access	Description
GET	`/cart`	Private	Get user's cart
POST	`/cart`	Private	Add item `{ productId, quantity }`
PUT	`/cart/:itemId`	Private	Update item quantity
DELETE	`/cart/:itemId`	Private	Remove item
DELETE	`/cart`	Private	Clear entire cart

Order Endpoints

Method	Endpoint	Access	Description
POST	`/orders`	Private	Place order
GET	`/orders/my`	Private	Get user's orders
GET	`/orders/:id`	Private	Get order by ID
PUT	`/orders/:id/cancel`	Private	Cancel order
GET	`/orders/admin/stats`	Admin	Dashboard statistics
GET	`/orders/admin/all`	Admin	All orders with filters
PUT	`/orders/admin/:id/status`	Admin	Update order status

Admin Endpoints

Method	Endpoint	Access	Description
GET	`/admin/users`	Admin	All users with pagination
PUT	`/admin/users/:id/toggle`	Admin	Toggle user active status
GET	`/admin/prescriptions`	Admin	All uploaded prescriptions
PUT	`/admin/prescriptions/:userId/:prescriptionId`	Admin	Approve/reject prescription
GET	`/admin/config`	Public	Get store configuration
PUT	`/admin/config`	Admin	Update store configuration
GET	`/admin/inventory`	Admin	Inventory report

Health Check

GET /api/health

🗄️ Database Schema

User

name, email (unique), password (hashed), phone, dateOfBirth, gender
addresses: [{ fullName, phone, street, city, state, pincode, isDefault }]
prescriptions: [{ fileName, fileUrl, uploadedAt, status, doctorName, notes }]
wishlist: [ObjectId → Product]
isActive, role (user|admin), loyaltyPoints

Product

name, genericName, description, manufacturer
category (enum: 10 categories), subcategory
images: [String], price, discountPrice, discountPercent
stock, unit, packSize, prescriptionRequired
saltComposition, dosageForm, strength
sideEffects: [String], usageInstructions, storageInstructions
expiryDate, batchNumber, isAvailable, isFeatured
reviews: [{ user, name, rating, comment }]
rating, numReviews, tags: [String]

Cart

user: ObjectId → User
items: [{ product, name, image, price, discountPrice, quantity, prescriptionRequired, packSize }]
couponCode, discount
virtuals: totalItems, subtotal

Order

user: ObjectId → User
orderNumber (auto-generated, e.g. PEZ7829430001)
items: [{ product, name, image, price, quantity, packSize, prescriptionRequired }]
shippingAddress: { fullName, phone, street, city, state, pincode }
paymentMethod (cod|upi|card|netbanking|wallet)
paymentStatus (pending|paid|failed|refunded)
itemsPrice, shippingPrice, taxPrice, discountAmount, totalPrice
orderStatus (placed|confirmed|processing|shipped|delivered|cancelled|returned)
prescriptionStatus (not_required|pending|approved|rejected)
statusHistory: [{ status, timestamp, note }]
estimatedDelivery, deliveredAt, notes, couponCode

🏥 Application Modules

1. Authentication & Authorization

JWT-based stateless authentication
Role-based access control (user / admin)
Protected and admin-only routes
Password hashing with bcryptjs (salt rounds: 10)

2. Product Management

10 healthcare categories
Full-text search across name, genericName, and tags
Advanced filtering (price range, category, prescription required)
Sort by price, rating, newest, relevance
Pagination (12 per page by default)
Product reviews with rating aggregation

3. Prescription Workflow

Customer uploads prescription (image/PDF)
System flags order as "prescription pending"
Admin reviews prescription in dashboard
Admin approves or rejects with notes
Order proceeds or is cancelled

4. Cart & Checkout

Real-time stock validation
Prevents overselling
Free shipping threshold (₹499)
GST calculation (5%)
3-step checkout: Address → Payment → Review
Multiple saved addresses

5. Order Management

Auto-generated order numbers (PEZ + timestamp + sequence)
Status progression: placed → confirmed → processing → shipped → delivered
Status history audit trail
Stock auto-deduction on order placement
Stock restoration on cancellation
Loyalty points awarded automatically (1 point per ₹10)

🎛️ Admin Dashboard

Access at /admin after logging in with admin credentials.

Page	URL	Description
Dashboard	`/admin`	KPIs, revenue chart, recent orders, low stock
Products	`/admin/products`	List, search, edit, delete products
Add/Edit Product	`/admin/products/new`	Full product creation form
Orders	`/admin/orders`	All orders, status updates, detail panel
Users	`/admin/users`	User list, activate/deactivate
Inventory	`/admin/inventory`	Stock overview, low-stock alerts
Prescriptions	`/admin/prescriptions`	Review, approve, reject prescriptions

🚢 Deployment

Backend (e.g., Railway, Render, Heroku)

Set environment variables on your platform
Set MONGO_URI to your MongoDB Atlas connection string
Set NODE_ENV=production
Start command: node index.js

Frontend (e.g., Vercel, Netlify)

Build: npm run build
Publish directory: dist
Set the VITE_API_URL if you move away from the proxy approach

Full Stack on Single Server

Build the React app and serve it from Express:

// Add to server/index.js for production
if (process.env.NODE_ENV === 'production') {
  const path = require('path');
  app.use(express.static(path.join(__dirname, '../client/dist')));
  app.get('*', (req, res) => {
    res.sendFile(path.resolve(__dirname, '../client/dist/index.html'));
  });
}

🔒 Security Notes

Change JWT_SECRET to a strong random string in production
Enable HTTPS in production
Configure CORS to only allow your frontend domain
Add rate limiting (express-rate-limit) for production
Validate and sanitize all inputs
Never commit .env to version control

📝 License

This project is for educational purposes. Built with the MERN stack.

👨‍💻 Tech Credits

React.js, Node.js, Express.js, MongoDB, Mongoose
React Router v6, React Hot Toast, React Icons
Axios, Multer, bcryptjs, jsonwebtoken
Vite (build tool)

Name		Name	Last commit message	Last commit date
Flowcharts		Flowcharts
MERN Phase Wise		MERN Phase Wise
Project Screenshot		Project Screenshot
Word Document		Word Document
code		code
Demo Video - PharmaEZ_Project Explanation.mp4		Demo Video - PharmaEZ_Project Explanation.mp4
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation