Customer Reviews Management System

Customer Reviews 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
• FastAPI backend REST API
• MySQL 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

Customer Reviews Products, Customer Reviews Customers, Customer Reviews Orders, Customer Reviews Payments, Customer Reviews Return Requests

Tech Stack

• Frontend: HTML + Tailwind
• Backend: FastAPI
• Database: MySQL
• 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 customer-reviews-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 customer reviews 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

• Customer Reviews Products: Customer Reviews Product Code, Customer Reviews Product Name, Customer Reviews Category, Retail & Store Management Owner, Customer Reviews Product Status, Customer Reviews SKU Code, Customer Reviews Price, Customer Reviews Stock
• Customer Reviews Customers: Customer Reviews Customer Code, Customer Reviews Customer Name, Customer Reviews Category, Retail & Store Management Owner, Customer Reviews Customer Status, Customer Reviews Customer Code, Customer Reviews Phone Number, Customer Reviews Loyalty Points
• Customer Reviews Orders: Customer Reviews Order Code, Customer Reviews Order Name, Customer Reviews Category, Retail & Store Management Owner, Customer Reviews Order Status, Customer Reviews Order Number, Customer Reviews Order Date, Customer Reviews Order Value
• Customer Reviews Payments: Customer Reviews Payment Code, Customer Reviews Payment Name, Customer Reviews Category, Retail & Store Management Owner, Customer Reviews Payment Status, Customer Reviews Payment Number, Customer Reviews Payment Method, Customer Reviews Payment Status
• Customer Reviews Return Requests: Customer Reviews ReturnRequest Code, Customer Reviews ReturnRequest Name, Customer Reviews Category, Retail & Store Management Owner, Customer Reviews ReturnRequest Status, Customer Reviews Return Number, Customer Reviews Return Reason, Customer Reviews 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 customer reviews products for Customer Reviews
• Track customer reviews customers and operational ownership
• Run process order workflow
• Generate customer reviews reports and audit history

Problem Statement

Customer Reviews needs a focused system for customer reviews products, customer reviews customers, customer reviews orders, customer reviews payments, workflows, reports, and audit visibility instead of manual spreadsheets.

Learning Outcomes

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