Appraisal Management System

Appraisal 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
• NestJS 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

Appraisal Employees, Appraisal Attendance Logs, Appraisal Leave Requests, Appraisal Payroll Runs, Appraisal Performance Reviews

Tech Stack

• Frontend: HTML + Tailwind
• Backend: NestJS
• 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 appraisal-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 appraisal 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

• HR Admin
• Employee
• Team Lead
• Payroll Officer

Domain Modules

• Appraisal Employees: Appraisal Employee Code, Appraisal Employee Name, Appraisal Category, HR & Employee Management Owner, Appraisal Employee Status, Appraisal Employee Number, Appraisal Department, Appraisal Designation
• Appraisal Attendance Logs: Appraisal AttendanceLog Code, Appraisal AttendanceLog Name, Appraisal Category, HR & Employee Management Owner, Appraisal AttendanceLog Status, Appraisal Attendance Date, Appraisal Shift Name, Appraisal Hours Worked
• Appraisal Leave Requests: Appraisal LeaveRequest Code, Appraisal LeaveRequest Name, Appraisal Category, HR & Employee Management Owner, Appraisal LeaveRequest Status, Appraisal Request Number, Appraisal Leave Type, Appraisal From Date
• Appraisal Payroll Runs: Appraisal PayrollRun Code, Appraisal PayrollRun Name, Appraisal Category, HR & Employee Management Owner, Appraisal PayrollRun Status, Appraisal Payroll Number, Appraisal Salary Amount, Appraisal Payment Status
• Appraisal Performance Reviews: Appraisal PerformanceReview Code, Appraisal PerformanceReview Name, Appraisal Category, HR & Employee Management Owner, Appraisal PerformanceReview Status, Appraisal Review Number, Appraisal Rating, Appraisal Review Period

Workflows

• Approve Leave: Review Request -> Check Balance -> Manager Approval -> Notify Employee
• Process Payroll: Verify Attendance -> Calculate Salary -> Approve Payroll -> Release Payment
• Complete Review: Set Goals -> Collect Feedback -> Assign Rating -> Publish Review

Demo Use Cases

• Manage appraisal employees for Appraisal Management
• Track appraisal attendance logs and operational ownership
• Run approve leave workflow
• Generate appraisal reports and audit history

Problem Statement

Appraisal Management needs a focused system for appraisal employees, appraisal attendance logs, appraisal leave requests, appraisal payroll runs, workflows, reports, and audit visibility instead of manual spreadsheets.

Learning Outcomes

• Appraisal Management domain modelling
• HR & Employee Management CRUD and dashboard design
• Appraisal workflow automation
• Student-ready documentation, screenshots, and Docker deployment