Coupon Management System

Coupon Management System is a ready-to-run student project generated from the management template. It includes frontend, backend, database, Docker setup, Swagger API docs, demo login, seed data, screenshots, viva questions, project report content, and presentation material.

Project Category: Web Application.

This project can be used as a minor project or upgraded into a final-year major/enterprise project with custom modules, new UI, advanced reports, role permissions, payment/export modules, and complete college submission documentation.

Features

• HTML + Tailwind frontend with protected dashboard
• Node.js + Express backend REST API
• PostgreSQL database
• Docker Compose run system
• Swagger API documentation
• Demo admin login
• CRUD modules
• Dashboard statistics
• Reports and CSV export
• Audit log
• Seed data
• Student documentation pack
• Browser-tested demo screenshots
• Upgrade-ready custom UI design

Project Modules

Coupon Products, Coupon Customers, Coupon Orders, Coupon Payments, Coupon Return Requests

Tech Stack

• Frontend: HTML + Tailwind
• Backend: Node.js + Express
• Database: PostgreSQL
• API Docs: Swagger
• Runtime: Docker Compose

Demo Login

Email: admin@example.com
Password: Admin@123

Run Locally

Prerequisites

Install these tools first:

• Git
• Docker Desktop
• Node.js 20 or newer

Steps

git clone <your-repo-url>
cd coupon-management-system
cd backend
cp .env.example .env
docker compose up --build

Open:

Frontend: http://localhost:13000
Backend API: http://localhost:18080/api
Swagger Docs: http://localhost:18080/api/docs
Health Check: http://localhost:18080/api/health

Stop the project:

cd backend
docker compose down

Reset database and seed again:

cd backend
docker compose down -v
docker compose up --build

Change Master Login Email And Password

Before the first run, edit:

backend/config/seed.json

Change this section:

{
  "admin": {
    "email": "admin@example.com",
    "password": "Admin@123",
    "displayName": "System Admin",
    "role": "admin"
  }
}

Then run:

cd backend
docker compose up --build

If you already ran the project once, reset the database so the new admin user is seeded:

cd backend
docker compose down -v
docker compose up --build

Student Submission Docs

Generated documentation is available in:

docs/

Important files:

• SYNOPSIS.md
• ABSTRACT.md
• PROJECT-REPORT.md
• MAJOR-PROJECT.md
• PRESENTATION-CONTENT.md
• PRESENTATION.pptx
• VIVA-QUESTIONS.md
• TEST-CASES.md
• ER-DIAGRAM.md
• UML-DIAGRAMS.md
• SCREENSHOTS-CHECKLIST.md
• screenshots/
• diagrams/

Screenshots

Demo screenshots are stored in:

docs/screenshots/

Typical screenshots include login page, dashboard, list pages, forms, reports, audit log, and Swagger docs.

Promotional Upgrade Options

Want this project upgraded so it does not look like a common downloaded project?

Available upgrades:

• Convert minor project to major project
• Convert major project to enterprise-level project
• Change complete UI theme and layout
• Add unique vector images based on your project topic
• Make the project look fresh and different from common downloaded projects
• Add project-specific modules
• Add advanced dashboard analytics
• Add role-based permissions
• Add PDF/Excel export
• Add payment, email, SMS, or notification modules
• Add custom report, synopsis, PPT, viva, and screenshots
• Prepare a complete college submission package

Contact And Community

For upgrades and customization, contact CSEProjects360:

WhatsApp: +91 78914 45668
Website: CSEProjects360

Send WhatsApp Message

Visit CSEProjects360

Scan to message on WhatsApp:

Community links:

• WhatsApp Group: request the latest group invite on WhatsApp.
• WhatsApp Channel: request the latest channel link on WhatsApp.
• Telegram Group: request the latest group invite on WhatsApp.
• Telegram Channel: request the latest channel link on WhatsApp.

Why Customize?

Many student projects look the same because they use the same template, same colors, same dashboard, and same module names. This project factory supports domain-specific modules, configurable design templates, vector illustrations, documentation, and screenshots so your project can look original and presentation-ready.

Notes

• Change demo credentials before submission.
• Do not commit real API keys or production passwords.
• Use Docker Compose for the easiest local setup.
• If ports are busy, update backend/.env and run again.

Domain-Specific Project Details

A student-ready coupon management generated from the management template with domain modules, seed data, reports, Swagger docs, Docker support, screenshots, viva questions, PPT content, and submission documentation.

Target Users

• Store Admin
• Cashier
• Sales Manager
• Inventory Clerk

Domain Modules

• Coupon Products: Coupon Product Code, Coupon Product Name, Coupon Category, Retail & Store Management Owner, Coupon Product Status, Coupon SKU Code, Coupon Price, Coupon Stock
• Coupon Customers: Coupon Customer Code, Coupon Customer Name, Coupon Category, Retail & Store Management Owner, Coupon Customer Status, Coupon Customer Code, Coupon Phone Number, Coupon Loyalty Points
• Coupon Orders: Coupon Order Code, Coupon Order Name, Coupon Category, Retail & Store Management Owner, Coupon Order Status, Coupon Order Number, Coupon Order Date, Coupon Order Value
• Coupon Payments: Coupon Payment Code, Coupon Payment Name, Coupon Category, Retail & Store Management Owner, Coupon Payment Status, Coupon Payment Number, Coupon Payment Method, Coupon Payment Status
• Coupon Return Requests: Coupon ReturnRequest Code, Coupon ReturnRequest Name, Coupon Category, Retail & Store Management Owner, Coupon ReturnRequest Status, Coupon Return Number, Coupon Return Reason, Coupon Refund Amount

Workflows

• Process Order: Select Customer -> Add Products -> Apply Discount -> Complete Payment
• Handle Return: Find Order -> Capture Reason -> Approve Refund -> Restock Product
• Update Store Offer: Select Products -> Set Discount -> Approve Campaign -> Publish Offer

Demo Use Cases

• Manage coupon products for Coupon Management
• Track coupon customers and operational ownership
• Run process order workflow
• Generate coupon reports and audit history

Problem Statement

Coupon Management needs a focused system for coupon products, coupon customers, coupon orders, coupon payments, workflows, reports, and audit visibility instead of manual spreadsheets.

Learning Outcomes

• Coupon Management domain modelling
• Retail & Store Management CRUD and dashboard design
• Coupon workflow automation
• Student-ready documentation, screenshots, and Docker deployment