Documentation

Everything the platform does, explained

A complete reference for every module, role and AI feature in HR Payroll Suite — for admins configuring the system and developers extending it.

01 · Getting Started

Overview

HR Payroll Suite is a multi-company HR and payroll platform. A single installation can host any number of companies, each with its own employees, payroll runs, settings and AI configuration — fully isolated from one another.

Two Panels

A full Admin panel for running the business, and a self-service Employee panel for day-to-day tasks like attendance, leave and payslips.

Multi-Company

One Super Admin account manages all companies on the platform; each Company Admin only ever sees their own company's data.

Getting Started

User Roles

Every user is assigned exactly one role, which determines what they can see and do.

RoleScopeCan do
Super AdminAll companiesCreate and manage companies, create Company Admins, view any company's data.
Company AdminOwn companyFull control of their company: employees, payroll, leave, recruitment, and creating HR/Payroll/Department managers.
HR ManagerOwn companyEmployees, attendance, leave approvals, recruitment.
Payroll ManagerOwn companyPayroll generation, payslips, salary reports.
Department ManagerOwn departmentAttendance and leave approvals for their team.
EmployeeSelfClock in/out, apply for leave, view payslips, submit expenses, edit their own profile.
Getting Started

Companies & Tenancy

Companies are created by a Super Admin from Admin → Companies. Each new company needs a name, contact email, subscription plan and an employee limit.

After creating a company, go to Admin → Users to create its first Company Admin — that account is the one your customer will actually log in with day to day.
02 · Core Modules

Employees

Central directory of every person in the company: personal details, department, designation, joining date, documents and photo.

  • Search and filter by department, designation or status
  • Upload identity, education and contract documents per employee
  • Deactivate an employee without deleting their historical records
Core Modules

Attendance

Daily, monthly and report views of who was present, absent, late, on leave or working from home.

Daily View

Mark or edit any employee's attendance for a specific date, with a running present/absent summary.

Monthly View

A calendar grid of the whole month per employee, filterable by department.

Core Modules

Leave Management

Configure leave types (casual, sick, earned, etc.) with an annual quota under Admin → Leave → Leave Types. Employees apply from their panel; approvers act from Admin → Leave.

Core Modules

Payroll & Payslips

Generate a full month's payroll for a company in one action. The system calculates gross pay, PF, ESI, professional tax and net pay per employee based on attendance for that period.

  • Review and approve a payroll run before it's marked as paid
  • Every employee gets an instant, branded PDF payslip
  • Employees can view and download their own payslips — never anyone else's
Core Modules

Recruitment

Post a job opening against a department and designation, track applicants as candidates, and move them through your hiring pipeline.

Core Modules

Reports

Six built-in reports under Admin → Reports: Headcount, Salary, PF, ESI, Attrition and Overtime — each scoped to the active company.

03 · AI Features

Admin AI Tools

FeatureWhat it does
HR AssistantChat-based answers to HR policy and process questions.
Resume ScreeningScores a candidate's resume against a specific job opening.
Payroll Anomaly DetectionFlags unusual pay or deduction patterns before a payroll run is approved.
Attendance Anomaly DetectionSurfaces irregular clock-in patterns and chronic lateness.
Interview Question GeneratorDrafts role-specific interview questions from a job description.
Salary BenchmarkingCompares a salary or offer against role and market context.
AI Features

Employee AI Tools

FeatureWhat it does
Leave Policy Q&AEmployees ask leave-balance and policy questions in plain language.
Performance Summary HelperTurns raw review notes into a clear written summary.
AI Features

Configuring AI

Go to Admin → Settings → AI Features, paste an Anthropic API key, and toggle AI on for that company. The key is stored per-company and never shared across tenants.

Treat your API key like a password — anyone who can view a company's Settings page can see it. Only give Settings access to trusted admins.
04 · Reference

Settings

Company-level configuration lives under Admin → Settings: company profile, payroll defaults, leave policy defaults, and the AI Features toggle described above.

Reference

Troubleshooting

"Target class [dompdf.wrapper] does not exist"

Your package cache is stale. Run:

composer install
php artisan config:clear
php artisan package:discover

A super admin sees no data on a company-scoped page

Select a company first — the Super Admin isn't tied to one company by default, so most pages need you to choose which company's data to view.