PAMS is a powerful web-based solution designed to streamline HR operations, automate payroll processing, and simplify attendance tracking for businesses of all sizes. Featuring **AI-powered attendance anomaly detection** using Google Gemini, an intuitive interface, and robust features, PAMS helps organizations manage their workforce efficiently while ensuring compliance with labor regulations.

## 🌟 Key Features

### 👥 Employee Management

- **Complete Employee Profiles** - Manage personal, contact, and employment information
- **Department & Designation** - Organize employees by departments and job roles
- **Document Management** - Upload and store employee documents securely
- **Shift Management** - Create and assign multiple shifts
- **Employee Status Tracking** - Track active, inactive, and resigned employees

### ⏰ Attendance Management

- **Manual Attendance Entry** - Record daily attendance with clock in/out
- **Attendance Reports** - Daily, monthly, and custom period reports
- **Overtime Tracking** - Automatic overtime calculation
- **Late/Early Tracking** - Monitor late arrivals and early departures
- **Absenteeism Reports** - Track and analyze employee absences
- **Biometric Ready** - Framework ready for biometric device integration

### 🤖 AI-Powered Attendance Anomaly Detection

- **Smart Anomaly Detection** - Automatically identifies irregular attendance patterns using Google Gemini AI
- **Pattern Analysis** - Detects unusual working hours, suspicious clock-in/out trends, and attendance irregularities
- **Rule-Based Fallback** - Built-in rule-based detection when AI API is unavailable
- **Cached Results** - Efficient caching for optimal performance
- **Admin & HR Dashboard** - Anomaly insights visible to Admin and HR roles
- **Free AI API** - Uses Google Gemini free tier — no paid AI subscription required

### 🏖️ Leave Management

- **Multiple Leave Types** - Configure casual, sick, earned, maternity, and custom leave types
- **Leave Application Workflow** - Employee application with approval/rejection
- **Leave Balance Tracking** - Automatic balance calculation and carry forward
- **Leave Encashment** - Track leave encashment for employees
- **Comprehensive Reports** - Leave balance, history, and summary reports

### 💰 Payroll Management

- **Flexible Salary Structure** - Configure earnings and deductions
- **Salary Templates** - Create reusable salary templates
- **Automated Payroll** - Generate monthly payroll based on attendance
- **Professional Payslips** - Generate and email PDF payslips
- **Loan Management** - Track employee loans with automatic EMI deduction
- **Bonus & Increment** - Manage bonuses and salary increments
- **Tax Calculation** - Progressive tax calculation with configurable slabs
- **Bank Payment Reports** - Generate bank transfer reports

### 📊 Reports & Analytics

**24+ Comprehensive Reports Including:**

- Employee master list, new joiners, status reports
- Attendance summary, daily/monthly sheets
- Leave balance and history
- Monthly/yearly payroll reports
- Department and designation-wise salary reports
- Loan, bonus, and increment reports
- Overtime and late arrival reports
- And many more...

### 🔐 Security & Access Control

- **Role-Based Access Control (RBAC)** - Powered by Spatie Permission
- **Predefined Roles** - Admin, HR Manager, Accountant, Employee
- **Granular Permissions** - Control access at module and feature level
- **Activity Logging** - Complete audit trail of all system activities
- **Secure Authentication** - Laravel Breeze with password hashing
- **CSRF Protection** - Protection against cross-site request forgery
- **Input Validation** - Comprehensive validation on all forms

### 🌍 Multi-language Support

- Language switcher for easy localization
- RTL (Right-to-Left) support ready
- Easy to add new languages

### 🚀 Easy Installation

- **Installation Wizard** - Step-by-step guided installation
- **Requirements Check** - Automatic server requirements validation
- **One-Click Setup** - Database and admin account creation
- **License Verification** - Codester purchase code integration

1️⃣ Functional Requirements

🔹 A. Organization & Setup Module

• Company profile setup
• Multi-branch support
• Department management
• Designation management
• Shift management (day/night/rotational)
• Holiday calendar
• Leave policy setup
• Salary structure configuration
• Tax configuration (country-based if needed)

🔹 B. Employee Management Module

• Employee profile (Personal + Official)
• Employment type (Permanent / Contract / Intern)
• Department & Designation assign
• Salary structure assign
• Bank account details
• Document upload (NID, CV, Contract)
• Employee status (Active / Resigned / Terminated)
• Employee ID auto generation

🔹 C. Attendance Management Module

Attendance Capture Methods:

• Manual entry (HR)
• Biometric machine integration
• RFID
• QR code check-in
• Mobile GPS attendance (optional SaaS feature)

Features:

• Daily attendance record
• In/Out time tracking
• Late detection
• Early leave detection
• Overtime calculation
• Auto shift detection
• Attendance correction request
• Attendance approval workflow

🔹 D. Leave Management Module

• Leave types (Casual, Sick, Earned, etc.)
• Leave allocation
• Leave balance tracking
• Leave request & approval workflow
• Half-day leave
• Sandwich rule support
• Leave carry forward rule

🔹 E. Payroll Management Module

Salary Components:

• Basic salary
• Allowances
• Overtime
• Bonus
• Deductions (Late fine, Loan, Advance, Tax)
• PF / Gratuity (Optional)

Payroll Features:

• Monthly payroll generation
• Auto salary calculation from attendance
• Overtime auto calculation
• Leave deduction logic
• Loan/advance adjustment
• Payslip generation (PDF)
• Bulk salary processing
• Salary hold feature

🔹 F. Loan & Advance Module

• Employee loan entry
• Installment setup
• Auto deduction from payroll
• Loan balance tracking

🔹 G. Reporting Module

Attendance Reports:

• Daily attendance
• Monthly summary
• Late report
• Overtime report
• Absent report

Payroll Reports:

• Salary sheet
• Department-wise payroll
• Tax report
• Bank transfer report
• Payslip history

HR Reports:

• Employee list
• Leave summary
• Employee turnover report

🔹 H. Role & Permission Module

• Admin
• HR
• Manager
• Employee self-service
• Role-based access control (Spatie if Laravel)

🔹 I. Employee Self Service (ESS Portal)

• View attendance
• Apply leave
• Download payslip
• Update profile (limited fields)
• View leave balance

2️⃣ Non-Functional Requirements

🔒 Security

• Role-based access
• Encrypted salary data
• Audit logs
• Secure authentication (2FA optional)
• HTTPS required

⚡ Performance

• Must support 1000+ employees
• Payroll generation optimized
• Indexing for large attendance table

🏗 Scalability

• SaaS-ready architecture
• Multi-tenant database structure (if SaaS)
• Cloud deployment ready

🔄 Reliability

• Automated backup
• Payroll locking after finalization
• Error logging system

3️⃣ SaaS-Specific Requirements

• Tenant registration
• Subscription plans
• Branch-wise access
• Usage limitation per plan
• Payment gateway integration
• Tenant database isolation

4️⃣ Advanced / Smart Features (Future Scope 🚀)

Since you like AI integration, you can add:

• AI-based absenteeism prediction

STEP 1: Initial System Setup (Admin Panel)

1.1 Create Company Profile

• Go to Settings → Company Setup
• Add:
  • Company Name
  • Address
  • Tax Information
  • Payroll Currency
  • Working Days
  • Office Time (In/Out Time)

1.2 Create Departments

• Go to HR → Departments
• Add:
  • IT
  • Accounts
  • HR
  • Operations
  • etc.

1.3 Create Designations

• Go to HR → Designation
• Example:
  • Software Engineer
  • HR Manager
  • Accountant
  • Officer

STEP 2: Employee Setup

2.1 Add Employee

·       Go to Employees → Add Employee

·       Fill:

o   Personal Info

o   Department

o   Designation

o   Joining Date

o   Salary Structure

o   Bank Details

o   Tax Info

2.2 Assign Salary Structure

·       Basic Salary

·       House Rent

·       Medical

·       Conveyance

·       Other Allowances

·       PF / Tax / Loan Deduction

STEP 3: Attendance Management

There are 3 ways attendance can be recorded:

Option 1: Manual Entry

·       Go to Attendance → Manual Entry

·       Select date

·       Mark:

o   Present

o   Absent

o   Late

o   Leave

Option 2: Biometric Device Sync

·       Go to Attendance → Device Sync

·       Import logs

·       System auto-matches:

o   Check-in

o   Check-out

o   Working Hours

o   Late

Option 3: Employee Self Check-in

·       Employee logs in

·       Click Check In

·       Click Check Out

System calculates:

·       Working Hours

·       Overtime

·       Late Penalty

STEP 4: Leave Management

4.1 Create Leave Types

·       Go to Leave → Leave Setup

·       Add:

o   Casual Leave

o   Sick Leave

o   Annual Leave

o   Maternity Leave

4.2 Leave Application (Employee)

·       Employee logs in

·       Apply leave

·       Select date range

·       Submit

4.3 Leave Approval (Manager/HR)

·       Go to Leave → Pending Requests

·       Approve / Reject

·       System auto-adjusts leave balance

STEP 5: Payroll Processing

This is the most important step.

5.1 Generate Salary

·       Go to Payroll → Generate Salary

·       Select:

o   Month

o   Department (optional)

·       Click Generate

System auto-calculates:

·       Basic

·       Allowances

·       Overtime

·       Late deduction

·       Leave deduction

·       Tax

·       Loan deduction

·       Net Payable

5.2 Review Salary Sheet

·       Check:

o   Attendance summary

o   Overtime

o   Leave deduction

o   Final Net Salary

5.3 Approve Payroll

·       Click Approve

·       Lock payroll for that month

5.4 Salary Payment

·       Mark as:

o   Paid (Bank Transfer)

o   Paid (Cash)

o   Pending

STEP 6: Reports

Attendance Reports

·       Daily Report

·       Monthly Summary

·       Late Report

·       Overtime Report

Payroll Reports

·       Salary Sheet

·       Payslip

·       Bank Statement

·       Tax Report

Employee Reports

·       Leave Balance

·       Loan Balance

·       Performance Summary

STEP 7: Employee Self Service Portal

Employees can:

·       View attendance

·       Download payslip

·       Apply leave

·       Update personal info

·       View leave balance