Payroll Management System (PMS)

A robust, secure, and modern Payroll Management System built with Java Javalin, JDBC, SQLite, and Vanilla JS/CSS.

---

🌟 About The Project

The Payroll Management System (PMS) is a comprehensive solution designed to automate and streamline the payroll processes of small to medium-sized organizations. It provides administrators with a beautiful, cyber-themed dashboard to manage employees, process batch payroll calculations, generate custom payslips, and keep track of tax deductions efficiently.

🔑 Key Features

• 👩‍💼 Employee Management: Add, update, delete, and search employees effortlessly.
• 💸 Automated Payroll Batching: Calculate gross salary, HRA, DA, allowances, and tax deductions with one click.
• 🧾 Custom Payslip Generation: Edit and preview payslips before generating them.
• 📥 One-Click Exporting: Instantly view HTML payslips in the browser or export them as raw text to Notepad.
• 🔒 Secure Admin Authentication: Login protected administrator panel with audit logs and user management.
• 🎨 Modern UI/UX: A responsive, glassmorphism-inspired design with a dark cyber aesthetic.

---

🚀 Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Java Development Kit (JDK) 11 or higher
• Maven 3.6+ installed and added to PATH
• A modern web browser

Installation & Run

1. Clone the repository

   git clone https://github.com/your_username/payroll-management-system.git

2. Navigate into the project directory

   cd "payroll-management-system"

3. Build and run the server using Maven

   mvn clean compile exec:java

4. Open your browser and navigate to the application:

   http://localhost:8080
   

Default Credentials

• Username: admin
• Password: password123

---

🛠️ Tech Stack

Backend

• Java 17: Core application logic.
• Javalin: Lightweight web framework for REST APIs.
• SQLite JDBC: Serverless relational database for persistent data storage.
• Maven: Dependency management and build tool.

Frontend

• HTML5 / Vanilla CSS3: Beautiful, custom glassmorphism design variables.
• Vanilla JavaScript (ES6+): Fetch API for asynchronous backend communication.
• Google Material Symbols: High-quality, modern icon integration.

---

📁 Project Structure

JAVA PROJECT/
├── database/
│   └── payroll.db            # Auto-generated SQLite Database
├── src/
│   ├── main/
│   │   ├── java/com/payroll/ # Java Source Code (DAOs, Models, Services)
│   │   │   ├── App.java      # Main entry point & API endpoints
│   │   └── resources/
│   │       └── public/       # Static Frontend Files
│   │           ├── index.html
│   │           └── assets/   # CSS and JS logic
├── pom.xml                   # Maven configuration
└── README.md

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📝 License

Distributed under the MIT License. See LICENSE for more information.

Built with ❤️ by the open-source community.