WorkInsight - Laravel HR, Payroll, Requisition & Intelligence System

Documentation Pack v1.0.0

Introduction

WorkInsight is a complete Human Resource Management (HRM) and operations platform built with Laravel 12 and Tailwind CSS. It covers workforce administration, attendance, leave, payroll, projects, requisitions, internal recruitment, promotions, CEO intelligence dashboard, smart alerts, and executive analytics in one production-ready application.

Key Benefits

  • ✅ All-in-one HRM solution
  • ✅ Role-based access control
  • ✅ Employee self-service portal
  • ✅ CEO intelligence dashboard
  • ✅ Smart alerts system
  • ✅ Modern Tailwind CSS UI
  • ✅ No Node.js/npm required

Tech Stack

  • Backend: Laravel 12 (PHP 8.4+)
  • Frontend: Local Tailwind runtime + local assets
  • Interactivity: Alpine.js 3
  • Charts: ApexCharts
  • Icons: Bootstrap Icons
  • Database: MySQL

Features Overview

Core HRM Modules

Employee Management

Full employee lifecycle — add, edit, view, search, filter

Department & Designation

Organizational structure management

Attendance

Daily tracking, bulk entry, monthly reports

Leave Management

Leave types, balances, request workflow

Payroll

Salary processing, payslip generation

Notice Board

Company-wide announcements

Advanced Modules

Project Management

Tasks, Kanban boards, team collaboration

Requisition System

Multi-level approval workflows

Internal Job Postings

Job openings with application tracking

Promotion & Transfer

Employee career progression

CEO Dashboard

Executive intelligence & analytics

Smart Alerts

AI-powered workforce risk detection

Complete Feature List (Point to Point)

Core Modules Included

  • Employee Management
  • Department and Designation Management
  • Attendance (daily + bulk + monthly report)
  • Leave Types and Leave Requests
  • Payroll (single + bulk generation + payslip view)
  • Notice Board
  • Projects and Tasks (Kanban, comments, attachments)
  • Requisitions and Approval Workflow
  • Promotions and Employee Timeline
  • Reports and CSV Exports
  • Settings, Languages, Roles, Users
  • Smart Alerts and Workforce Intelligence
  • CEO Dashboard
  • Installer Wizard

Advanced Intelligence Features

  • Productivity score per employee
  • Attendance discipline rating
  • Risk score based on late, absent, overdue tasks, contract timelines
  • Workload score based on active tasks
  • Department performance index
  • Salary cost vs productivity analytics
  • Workforce risk summary snapshots

Smart Alert Triggers

  • Consecutive late arrivals
  • Contract expiry window
  • Probation ending soon
  • Employee overload detection
  • Repeated leave pattern (example: frequent Monday/Friday leave)
  • Pending requisition approvals
  • Pending leave approvals
  • Project deadline risk
  • Low leave balance alerts

Requisition and Procurement Power

  • Itemized requisition creation
  • Category and urgency support
  • Multi-level approval flow
  • Auto-approval threshold support
  • Expense insights by category/department/month
  • Frequent requester analysis

Promotion and Internal Hiring Workflow

  • Internal job posting
  • Employee applications to internal openings
  • Promotion/transfer/demotion execution
  • Salary and designation updates
  • Auto timeline history record for employee profile

Employee Self-Service Portal

  • My dashboard
  • My attendance
  • My payslips
  • My leaves
  • My tasks
  • My requisitions
  • Job openings and my applications

Security and Access Control

  • Role and permission based access with middleware guards
  • Module-level permission controls
  • CSRF protection and validated input flow
  • Hashed passwords and secure auth practices
  • Google login support with matching existing account email

Customization and Localization

  • Company branding and system configuration panel
  • Currency, date format, timezone, schedule settings
  • SMTP configuration and testing
  • Multi-language management
  • Translation phrase management

Easy Installation

  • Web-based installer
  • Environment and permission checks
  • Database setup wizard
  • Admin account creation
  • Ready-to-use seeded setup

Best For

  • SMEs
  • Corporate HR departments
  • Agencies delivering HR software
  • Product owners who want both operational HR and intelligence-driven decision support

Requirements

Requirement Minimum Version Notes
PHP8.4+With required extensions
MySQL5.7+Or MariaDB 10.3+
Composer2.0+PHP dependency manager
Web ServerApache / Nginxmod_rewrite enabled for Apache
No build tools required! This application does NOT require Node.js, npm, Webpack, or Vite. Frontend assets are bundled locally under the public folder.

Required PHP Extensions

BCMath Ctype cURL DOM Fileinfo JSON Mbstring OpenSSL PDO PDO_MySQL Tokenizer XML

Installation

1

Extract Files & Create Database

Extract the ZIP archive to your web server document root and create a MySQL database:

CREATE DATABASE smart_workforce_hub CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
2

Run Installer Wizard

After extracting the files, run the installer wizard by accessing the application(your domain) in your browser.

The installer will guide you through environment checks, database configuration, and admin account setup.

installer step 1
3

Application Requirements

The installer will check for required PHP extensions, file permissions, and environment compatibility. Ensure all checks pass before proceeding.

installer step 2
4

File Permissions

Ensure the following directories have write permissions (chmod 755 or 775):

installer step 3
5

Database Configuration

Enter your database connection details. The installer will attempt to connect and run migrations/seeding automatically.

installer step 4
6

Admin User Setup

Create your admin user account and configure initial settings.

installer step 5
7

Complete Installation

Installation is complete. You can now access the application.

installer step 6

Login

Access the application and login with your given credentials:

RoleEmailPassword
Adminyour-email@example.comyour-password

Configuration

Company Settings

After login, navigate to System -> Settings in the sidebar to configure your organization:

Company Name
Your organization name displayed across the app
Currency Symbol
Used in payroll and financial displays ($, €, £, ৳)
Date Format
Preferred date display format across the system
Working Hours / Late Threshold
Default work hours and late marking threshold
SMTP Settings
Email server configuration for sending notifications
Google Credentials
API credentials for Google login integration
Company Settings Email Configuration

Roles & Permissions

The system uses a granular role-based access control system. Each role can have specific permissions for each module.

Default Permissions

ModuleViewCreateEditDelete
Employees
Departments
Designations
Attendance
Leave Types
Leave Requests
Payroll
Notices
Projects
Requisitions
Roles
Reports
Settings
CEO Dashboard
Smart Alerts

Dashboard

The main dashboard provides a quick overview of your organization:

  • Quick Stats — Total employees, departments, pending leave requests, today's attendance
  • Attendance Chart — Visual attendance trends (line chart)
  • Department Distribution — Employees per department (pie chart)
  • Recent Activity — Latest attendance records
  • Upcoming Events — Birthdays, work anniversaries
Dashboard Overview

Employee Management

Adding an Employee

  1. Navigate to Employees → Add Employee
  2. Fill in: First Name, Last Name, Email, Employee ID, Department, Designation
  3. Set Joining Date, Employment Type, and Basic Salary
  4. Optionally add: Phone, Gender, DOB, Address, Photo
  5. Click Create Employee

Search & Filter

Use the filter bar to search by name/email/ID, or filter by department, status (Active/Inactive/Resigned/Terminated), and employment type.

Employee Profile

Click any employee to view their complete profile including personal info, employment details, attendance history, leave history, payroll records, and documents.

Employee Profile

Attendance Management

Daily Attendance

Navigate to Attendance → Add Attendance, select employee, date, status (Present/Absent/Late/Half Day/On Leave), and enter clock-in/out times.

Bulk Entry

Use Attendance → Bulk Entry to mark attendance for all employees in a department at once. Select date and department, then set status for each employee.

Monthly Report

View comprehensive monthly attendance breakdown per employee with present/absent/late/leave days count.

Attendance Management

Leave Management

Leave Types

Configure leave types (Casual, Sick, Earned, Maternity, etc.) with annual allocation days per type.

Processing Requests

  1. Navigate to Leave Requests
  2. Review pending requests with employee info, dates, and reason
  3. Click View, Approve or Reject
  4. Leave balances are automatically updated
Leave Management

Payroll Management

Generating Payroll

  1. Navigate to Payroll → Create
  2. Select employee, month, and year
  3. System auto-calculates basic salary, allowances, deductions
  4. Add custom earnings/deductions as needed
  5. Click Generate

Payslip

View print-ready payslips with company branding, employee info, earnings breakdown, deductions, and net salary. Employees can also view their payslips through the Employee Portal.

Payroll Management

Project Management

Creating Projects

Create projects with name, description, dates, priority, budget, and assign a project manager. Add team members and create tasks with priority levels and assignments.

Kanban Board

Visual task management with drag-and-drop columns: To Do → In Progress → Review → Completed. Tasks automatically update status on column change.

Project Management Project Details Project Kanban Board

Requisition System

Submit procurement and resource requests with multi-level approval workflow:

  1. Create requisition with title, description, urgency level
  2. Add line items (item name, quantity, estimated cost)
  3. Submit for approval — follows configured approval chain
  4. Approvers can approve or reject with comments
  5. Track status in real-time with analytics dashboard
Requisition System

Employee Self-Service Portal

Employees linked to a user account can access their personal portal with:

Personal Dashboard
Clock In/Out Attendance
Leave Request Submission
Payslip Viewing
Task Management
Requisition Submission
Internal Job Applications
Application Tracking
Employee Portal

Notice Board

Creating Notices

  1. Go to Notices and click Create Notice.
  2. Enter title, message, publish date, and expiry date.
  3. Set target visibility by role/department if needed.
  4. Publish to make it visible on dashboard and notice list.
Notice Board

Promotion and Internal Hiring

Internal Job Posting

  1. Navigate to Internal Job Posts and create a new opening.
  2. Set title, department, eligibility, and deadline.
  3. Review employee applications from Job Applications.

Promotion / Transfer / Demotion

  1. Open Promotions and select an employee.
  2. Choose action type (Promotion, Transfer, Demotion).
  3. Update department/designation/salary and effective date.
  4. Save record to automatically update employee timeline history.
Internal Job Posting Promotion Management

Reports and CSV Export

Generating Reports

  1. Go to Reports and choose Attendance, Leave, Payroll, or Employee report.
  2. Apply filters: date range, department, employee, and status.
  3. Review summary and detailed rows before export.

CSV Export

  1. Click Export CSV in any report view.
  2. Use the exported file for audit, compliance, and external analysis.
Reports

Smart Alerts and Workforce Intelligence

Using Smart Alerts

  1. Open Smart Alerts to view alert list with severity and status.
  2. Track triggers like late streaks, contract expiry, probation end, overload, repeated leave pattern, pending approvals, project deadline risk, and low leave balance.
  3. Mark alerts as read/resolved after operational action.

Workforce Intelligence Metrics

  1. Review employee productivity score and attendance discipline rating.
  2. Analyze workload and risk scores to prioritize interventions.
  3. Use department performance index and salary cost vs productivity trends for management planning.
Smart Alerts Workforce Intelligence CEO Dashboard

Color Customization

Changing Theme Colors

Edit the Tailwind config in resources/views/layouts/admin.blade.php:

tailwind.config = {
    theme: {
        extend: {
            colors: {
                sidebar: {
                    DEFAULT: '#0f172a',  // Sidebar bg
                    hover: '#1e293b',
                    active: '#3b82f6'    // Active item
                }
            }
        }
    }
}

Adding Custom Modules

  1. Create Model & Migration: php artisan make:model ModuleName -m
  2. Create Controller: php artisan make:controller ModuleNameController --resource
  3. Add routes in routes/web.php
  4. Create views in resources/views/module-name/
  5. Add sidebar navigation in the admin layout

Troubleshooting

"Class not found" error

composer dump-autoload
php artisan optimize:clear

Storage/uploads not working

php artisan storage:link

Ensure storage/app/public directory exists and is writable.

"419 Page Expired" error

CSRF token mismatch. Verify APP_KEY is set, session config is correct, and browser cookies are enabled.

Email not sending

Verify SMTP credentials in .env. For Gmail, use App Password (not regular password). Check storage/logs/laravel.log for details.

Blank page / 500 error

php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan route:clear

Check storage/logs/laravel.log for the actual error.

Production Optimization

php artisan config:cache
php artisan route:cache
php artisan view:cache
composer install --optimize-autoloader --no-dev

Changelog

v1.0.0 January 2025

Initial Release

  • ✅ Core HRM modules (Employees, Departments, Designations)
  • ✅ Attendance management with bulk entry & monthly reports
  • ✅ Leave management system with balances
  • ✅ Payroll processing & payslip generation
  • ✅ Notice board system
  • ✅ Granular role-based access control
  • ✅ Project management with Kanban boards
  • ✅ Requisition system with multi-level approvals
  • ✅ Internal job postings & application tracking
  • ✅ Promotion & transfer management
  • ✅ Report center (Attendance, Leave, Payroll, Employee)
  • ✅ CEO Intelligence Dashboard
  • ✅ AI-powered Smart Alerts
  • ✅ Employee Self-Service Portal
  • ✅ Modern Tailwind CSS responsive UI
  • ✅ SMTP email support

Support

Included in Support

  • ✅ Bug fixes and patches
  • ✅ Installation assistance
  • ✅ Configuration help
  • ✅ General usage questions

Not Included

  • ❌ Custom feature development
  • ❌ Third-party plugin integration
  • ❌ Server setup and management
  • ❌ Design customization

If you face any issue contact our Support

Email: rokbyte@gmail.com

Thank you for purchasing WorkInsight!

If you find this product useful, please consider leaving a rating on CodeCanyon. Your feedback helps us improve!