Eye Care Management System Final Year Project

• Secure admin login in this final year project
• Separate admin session using JWT
• Admin dashboard
• View KPIs for orders, users, products, and appointments
• View pending contact message alerts
• View low-stock product alerts
• View out-of-stock product alerts
• View catalog summary counts
• Reports and analytics
• View sales total
• View order count
• Filter reports by optional date range
• View appointment status breakdown
• View user totals
• View low-stock product table
• View out-of-stock product table
• Manage brands
• Add, edit, and delete brands
• Upload brand logo
• Set brand active/inactive status
• Manage categories
• Add, edit, and delete categories
• Upload category image
• Set category active/inactive status
• Manage products
• Create, edit, and delete products
• Upload multiple product images
• Link product with brand and category
• Manage product price
• Manage discount
• Manage stock quantity
• Mark product as featured
• Set product active/inactive status
• Manage registered users
• View user list
• View user details
• Set user active/inactive status
• Delete users
• Manage orders
• List all orders
• Open order detail modal
• Update order status such as pending, processing, shipped, delivered, or cancelled
• Delete order
• Manage appointments
• View eye checkup bookings
• Update appointment status
• Add admin notes
• Delete appointment
• Manage blog and eye care tips
• Create, edit, and delete blog posts
• Upload blog image
• Manage title, content, and publish status
• Manage homepage banners
• Create, edit, and delete banners
• Upload banner image
• Manage banner title, link, order, and active flag
• Moderate product reviews
• Edit or delete reviews
• Manage contact inbox
• View contact form submissions
• Update contact message status such as pending/read
• Delete contact message
• Manage notifications
• Send in-app notification to a user by MongoDB user ID
• View sent notifications

The admin panel modules include dashboard, reports, brands, categories, products, users, orders, appointments, blogs, banners, reviews, contact inbox, and notifications.

• Customer registration in this final year project
• Customer login
• JWT-based user session
• Inactive user login blocking
• Forgot password using reset email
• Reset password using token
• Product browsing
• Product search
• Category and brand filters
• Price sorting
• Shareable filtered product views using URL query parameters
• Product detail page
• View product images
• View product price
• View product stock
• View product brand and category
• View product description
• Add product to cart
• Add product to wishlist
• View and submit product reviews after login
• Shopping cart
• View cart line items
• Update cart quantities
• Remove cart items
• Proceed to checkout
• Checkout with shipping address
• Select payment method
• Place order from cart
• Product stock reduction after checkout
• View order history
• View order detail
• Cancel order when status allows
• Wishlist management
• Save products
• Remove wishlist items
• Book eye checkup appointment
• Select appointment date and time
• Add appointment notes
• View booked appointments
• Cancel appointments
• Profile management
• Edit profile fields
• Upload profile photo
• Change password
• Blog and eye care tips
• View published eye care articles
• Read full blog article
• Contact form submission
• Header search
• Notifications dropdown
• Mark notifications as read
• Cart count sync
• User menu with profile, orders, appointments, wishlist, and logout

The customer storefront includes product catalog, product detail, cart, checkout, orders, wishlist, appointment booking, profile, blog, contact, login, registration, forgot password, and reset password routes.

• Full-stack MERN architecture in this final year project
• React 18 storefront and admin UI
• Node.js backend server
• Express 4 REST API
• MongoDB database
• Mongoose 8 models and validation
• JWT authentication
• Separate user and admin sessions
• bcryptjs password hashing
• Multer file uploads
• Product image uploads
• Banner image uploads
• Blog image uploads
• Profile photo uploads
• Static uploads served from /uploads
• Nodemailer Gmail support for forgot-password reset links
• Axios API calls with token attachment
• React Router protected routes
• Admin and user access control
• Inactive user blocking
• Product reviews and ratings
• In-app notifications
• Homepage banners
• Featured products
• Eye care blog/articles module
• Contact form stored for admin inbox
• Dashboard KPIs
• Reports and analytics
• Low-stock and out-of-stock tracking
• Seed data with admin, users, brands, categories, products, orders, appointments, reviews, blogs, banners, contact messages, notifications, cart, and wishlist records
• Production build support

Technology Used

Step 1: Open project folder

cd eye-care-management-v2

Step 2: Install dependencies

npm install
cd client && npm install && cd ..

Step 3: Create environment file

Copy .env.example to .env in the project root:

cp .env.example .env

Step 4: Configure environment variables

Add or update the required values:

MONGODB_URI=mongodb://localhost:27017/eye-care-management
JWT_SECRET=your_strong_random_secret
JWT_EXPIRE=7d
[email protected]
ADMIN_PASSWORD=Admin@123
[email protected]
EMAIL_PASS=your_16_char_gmail_app_password
PORT=5000
CLIENT_URL=http://localhost:3000

Gmail App Password is required for forgot-password reset emails.

Step 5: Seed the database

npm run seed

The seed command creates sample admin, users, brands, categories, products, orders, appointments, reviews, blog posts, banners, contact messages, notifications, cart, and wishlist data.

Step 6: Run API and React together

npm run dev

After running, use these URLs:

Run backend or frontend only

npm run server
npm run client

Credentials are created after running npm run seed.

Admin Login

Customer Login