1. Introduction
1.1 Overview
Cloud HRMS Suite is a cloud-based Human Resource Management System. Employee login is at app.cloud-hrms.com and the admin panel at admin.cloud-hrms.com. It centralises all HR operations — onboarding, attendance, payroll, leave, shifts, and asset tracking — in one unified platform.
1.2 Purpose
The system eliminates manual HR processes by centralising employee data and automating payroll, leave, and headcount analytics. It provides real-time dashboards for data-driven workforce decisions.
1.3 User Roles
🛡️
Administrator
Full System Access
Manages all employees, payroll, leaves, shifts, assets and reports via admin.cloud-hrms.com
👔
HR Manager
Department Access
Manages employees within assigned departments, approves leaves, processes departmental payroll
👤
Employee (Client)
Personal Data Only
Views own profile, applies for leave, checks attendance and payslips via app.cloud-hrms.com
2. Getting Started
2.1 Login Process
No installation required. Open any modern browser and navigate to app.cloud-hrms.com.
| Field / Element | Required? | Example | Description |
| Company Login Toggle | Optional | ON (blue ✓) | Enables company-based authentication. Must be ON for company accounts. |
| Company Name | Optional | demo | Your organisation's registered account name. Label floats above when filled. |
| Username / Email | Required | demo@gmail.com | Registered email — unique login identifier across the system. |
| Password | Required | (masked •••••••) | Case-sensitive. Click eye-slash icon 👁 to toggle visibility. |
| Remember me | Optional | Unchecked | Stays logged in on this device. Never use on shared computers. |
| Forgot Password? | — | Blue link | Starts the email-based password reset flow. |
| Login button | — | Click to submit | Purple-taupe gradient. Submits credentials and redirects to the dashboard. |
Step-by-Step Login Instructions
1
Open browser → navigate to app.cloud-hrms.com. The Sign In page loads automatically.
2
Confirm Company Login toggle is ON (blue ✓). Click it if it appears grey/off.
3
Type your Company Name (e.g., "demo"). The field label floats above as you type.
4
Enter your Username / Email (e.g., demo@gmail.com).
5
Enter your Password. Border turns blue when focused. Use the 👁 eye icon to verify typing.
6
Optionally check Remember me (personal devices only).
7
Click Login. Admin users are redirected to admin.cloud-hrms.com/#/admin/dashboard.
⚠️Password reset links expire in 30 minutes. If yours has expired, return to Sign In and click Forgot Password? again to generate a new link.
2.2 Admin Navigation
After admin login, the interface has three zones: Left Sidebar (module navigation), Top Bar (global controls), and Main Content Area.
The full admin navigation is organised into the following modules and sub-sections. Each item links directly to its respective screen in the system.
| Module | Sub-Item | URL Path |
| 🏠 Dashboard | — | #/admin/dashboard |
| 👥 Employees | Employees | #/admin/employees/allEmployees |
| Probation / Contractual Employees | #/admin/employees/probation-contractual |
| Loan Approval | #/admin/employees/loan-approval |
| Vehicle Management | #/admin/employees/vehicLe-management |
| ⏰ Attendance | Attendance Sheet | #/admin/attendance/attendance-sheet |
| Generate Timesheets | #/admin/attendance/generate-time-card |
| Timesheets | #/admin/attendance/time-cards |
| Mark Attendance | #/admin/attendance/mark-attendance |
| Attendance Approval | #/admin/employees/attendance-approval |
| 🕑 Shift | Shifts | #/admin/attendance/shifts |
| Shift Groups | #/admin/attendance/shift-groups |
| Shift Schedules | #/admin/attendance/shift-schedules |
| Override Shifts | #/admin/attendance/override-shifts |
| 🌴 Leave Management | Leave Types | #/admin/tenant-setup/payroll-management/leave-types |
| Leave Policy | #/admin/tenant-setup/payroll-management/leave-policies |
| Leave Approval | #/admin/employees/leave-approval |
| Generate Yearly Leaves | #/admin/attendance/generate-financial-leaves |
| 💼 Assets | — | #/admin/assets |
| 📢 Announcements | — | #/admin/announcements |
| 🎉 Holidays | — | #/admin/holidays |
| 💰 Payroll | Generate Salary | #/admin/payroll/generate-salary |
| Salary Stop / Resume | #/admin/payroll/salary-stop-resume |
| One Time Allowances | #/admin/payroll/one-time-allowances |
| One Time Deductions | #/admin/payroll/one-time-deductions |
| Increments | #/admin/payroll/increments |
| 📋 Final Settlement | — | #/admin/final-settlement |
| 📊 Reports — Attendance | Attendance Report | #/admin/reports/attendance-summary |
| CPL Comparison Report | #/admin/reports/cpl-comparison |
| Leave Tracking Report | #/admin/reports/leave-tracking |
| Leave Ledger Report | #/admin/reports/leave-ledger |
| Leave Detail Report | #/admin/reports/leave-detail |
| Manual Attendance Report | #/admin/reports/manual-attendance-report |
| Missing Attendance Report | #/admin/reports/missing-attendance-report |
| OD Attendance Report | #/admin/reports/od-attendance-report |
| Leave Encashment Report | #/admin/reports/leave-encashment-report |
| Overtime Summary Report | #/admin/reports/overtime-summary-report |
| Overtime Detailed Report | #/admin/reports/overtime-detailed-report |
| 💰 Reports — Salary | Gratuity Report | #/admin/reports/gratuity-report |
| Daily Wages Bank & Cash | #/admin/reports/daily-wages-bank-cash |
| Daily Wages Summary | #/admin/reports/daily-wages-summary |
| Employee Allowances | #/admin/reports/employee-allowances |
| Employee Deductions | #/admin/reports/employee-deductions |
| Loan Outstanding | #/admin/reports/loan-outstanding |
| Loan Ledger Report | #/admin/reports/loan-ledger-report |
| Vehicle Ledger Report | #/admin/reports/vehicle-ledger-report |
| Directors Salary | #/admin/reports/directors-salary |
| Salary Comparison | #/admin/reports/salary-comparison |
| Salary Sheet Bank & Cash | #/admin/reports/salary-sheet-bank-cash |
| Salary Slip | #/admin/reports/salary-slip |
| Salary Stop | #/admin/reports/salary-stop |
| Dept. Wise Summary | #/admin/reports/dept-wise-summary |
| Bonus Sheet Report | #/admin/reports/bonus-sheet-report |
| Employee Income Tax | #/admin/reports/employee-income-tax |
| Employee Financial Income Tax | #/admin/reports/employee-financial-income-tax |
| Employee Expenses | #/admin/reports/employee-expenses |
| Salary Ledger Report | #/admin/reports/salary-ledger-report |
| Salary Report | #/admin/reports/salary-summary-report |
| 📊 Reports — Others | Employee EOBI Annual Contribution | #/admin/reports/employee-eobi-annual-contribution |
| Employee Age | #/admin/reports/employee-age |
| Employee Cards | #/admin/reports/employee-cards |
| Employee Department Detail | #/admin/reports/employee-department-detail |
| Employee Strength | #/admin/reports/employee-strength |
| Employment Form | #/admin/reports/employment-form |
| EOBI Details | #/admin/reports/eobi-details |
| 🚘 Expense | Travel Policy | #/admin/expense/travel-policy |
| D.A Allowance Policies | #/admin/expense/da-allowance-policies |
| Conveyance Allowance Policies | #/admin/expense/conveyance-allowance-policies |
| OD Cities | #/admin/expense/od-cities |
| 🚗 Vehicle Management | Vehicle Name | #/admin/vehicle-management/vehicle-names |
| Vehicle Type | #/admin/vehicle-management/vehicle-type |
| Vehicle Model | #/admin/vehicle-management/vehicle-model |
| 👔 Recruitments | Jobs | #/admin/recruitments/jobs |
| Candidates | #/admin/recruitments/candidates |
| Job Sources | #/admin/tenant-setup/recruitment-setup/job-sources |
| Job Status | #/admin/tenant-setup/recruitment-setup/job-status |
| Experiences | #/admin/tenant-setup/recruitment-setup/experiences |
| Default Questions | #/admin/tenant-setup/recruitment-setup/default-questions |
| 🔒 Roles & Permissions | — | #/admin/tenant-setup/roles |
| 📆 Organization Chart | — | #/admin/organization-chart |
| 📁 File Manager | — | #/admin/file-manager |
| ⚙ Administration — General | Locations | #/admin/tenant-setup/general/locations |
| Departments | #/admin/tenant-setup/general/departments |
| Sub Departments | #/admin/tenant-setup/general/sub-departments |
| Department HOD | #/admin/tenant-setup/general/department-hod |
| Sections | #/admin/tenant-setup/general/sections |
| Sub Sections | #/admin/tenant-setup/general/sub-sections |
| Religions | #/admin/tenant-setup/general/religions |
| Genders | #/admin/tenant-setup/general/genders |
| Nationalities | #/admin/tenant-setup/general/nationalities |
| Marital Statuses | #/admin/tenant-setup/general/marital-statuses |
| Blood Groups | #/admin/tenant-setup/general/blood-groups |
| Asset Types | #/admin/tenant-setup/general/asset-types |
| Asset Conditions | #/admin/tenant-setup/general/asset-conditions |
| Media Categories | #/admin/tenant-setup/general/media-categories |
| ⚙ Administration — Configuration | Languages | #/admin/tenant-setup/configuration/languages |
| Countries | #/admin/tenant-setup/configuration/countries |
| States | #/admin/tenant-setup/configuration/states |
| Cities | #/admin/tenant-setup/configuration/cities |
| ⚙ Administration — Employee Setup | Designations | #/admin/tenant-setup/employee-setup/designations |
| Grades | #/admin/tenant-setup/employee-setup/grades |
| Titles | #/admin/tenant-setup/employee-setup/titles |
| Employee Banks | #/admin/tenant-setup/employee-setup/employee-banks |
| Employee Types | #/admin/tenant-setup/employee-setup/employee-types |
| Employee Payment Types | #/admin/tenant-setup/employee-setup/employee-payment-types |
| Degree Types | #/admin/tenant-setup/employee-setup/degree-types |
| Family Relations | #/admin/tenant-setup/employee-setup/family-relations |
| Institutes | #/admin/tenant-setup/employee-setup/institutes |
| Allowed MAC Addresses | #/admin/tenant-setup/employee-setup/allowed-mac-addresses |
| Tags | #/admin/tenant-setup/employee-setup/tags |
| ⚙ Administration — Payroll Management | Allowance Types | #/admin/tenant-setup/payroll-management/allowance-types |
| Allowances | #/admin/tenant-setup/payroll-management/allowances |
| Approval Policies | #/admin/tenant-setup/payroll-management/approval-policy |
| Salary Types | #/admin/tenant-setup/payroll-management/salary-types |
| Deduction Policy Types | #/admin/tenant-setup/payroll-management/deduction-policy-types |
| Deduction Policy | #/admin/tenant-setup/payroll-management/deduction-policy |
| Deductions | #/admin/tenant-setup/payroll-management/deductions |
| Deduction Types | #/admin/tenant-setup/payroll-management/deduction-types |
| Salary Structures | #/admin/tenant-setup/payroll-management/salary-structures |
| Loan Types | #/admin/tenant-setup/payroll-management/loan-types |
| Loan Policy | #/admin/tenant-setup/payroll-management/loan-policies |
| Tax Slabs | #/admin/tenant-setup/payroll-management/tax-slabs |
| Tax CPR Categories | #/admin/tenant-setup/payroll-management/tax-cpr-categories |
| Petrol Prices | #/admin/tenant-setup/payroll-management/petrol-prices |
| ⚙ Administration | User Management | #/admin/users |
| System Settings | #/admin/settings/general-settings |
| EOBI Settings | #/admin/settings/eobi-settings |
| Social Security Settings | #/admin/settings/social-security-settings |
💡Click the ☰ hamburger menu (top bar) to collapse the left sidebar and gain extra screen space when working with large data tables.
2.3 System Setup Flow
Before using Cloud HRMS Suite, follow this mandatory sequence. Steps must be completed in order — for example, salary cannot be generated until attendance is marked and time cards are produced.
✅Correct Setup Order: Tenant Setup → Administration Setup → Roles → Employees → Users → Shift / Leave / Attendance Settings → Attendance Marking → Time Card Generation → Salary Generation.
1
Create Tenant
Set up your organisation's tenant account. This is the root container for all data in the system.
2
Fill Administration Data
Configure system-wide settings: Site Title, logos, mail server, tenant address, payroll options (Provident Fund, Gratuity), and more via Administration → System Settings.
3
Create Roles — Required before creating users
Define permission roles (e.g. HR Manager, Employee) so that newly created users can be assigned appropriate access levels.
4
Add Employees
Create employee records (Basic Info, Salary, Documents, Shifts, Leave, etc.) via Administration → Employee Management.
5
Create Users
Create login accounts for employees via Administration → User Management, linking each user to their employee record and role.
6
Send User Credentials / Invitation Email
From the User Management screen, use the ✉ envelope action icon to email each user their login credentials.
7
Configure Employee Settings
- Employee Shift Settings — assign shift timings and grace time per employee.
- Leave Settings — assign leave policies and configure leave restrictions.
- Attendance Settings — link attendance rules and sync keys to each employee.
8
Mark Employee Attendance
Record daily attendance for employees via the Attendance Module before any time cards can be generated.
9
Generate Time Cards
Process attendance records into time cards for the relevant pay period via Attendance → Generate Timesheets.
10
Generate Salary / Payroll
Run payroll for the period. Salary generation requires attendance to be marked AND time cards to be successfully generated.
⚠️Salary cannot be generated until: (1) Attendance has been marked, (2) Time cards have been generated successfully, and (3) Payroll settings are fully configured.
System Settings Screen (Administration → System Settings)
The System Settings page (Step 2) allows administrators to configure all global parameters for the tenant. Below are the key setting groups visible in this screen.
System Settings — Branding & Identity (Settings 1–5)
SR.1 — Site Title: Display name of the platform (e.g., "Cloud HRMS Suite").
SR.2 — Footer CopyRight Text: Footer message shown across the application (e.g., "Powered By Alphabizly").
SR.3 — Tenant Logo Dark: Logo displayed on dark backgrounds — upload via "Choose file".
SR.4 — Tenant Logo Light: Logo for light backgrounds.
SR.5 — Tenant Favicon: Small browser-tab icon for the system.
System Settings page — Settings 1 to 5: Site Title, Footer Copyright, Tenant Logo (Dark & Light), and Tenant Favicon.
System Settings — Logos & Mail Configuration (Settings 6–13)
SR.6 — Tenant Small Logo: Compact logo used in collapsed sidebar or mobile views.
SR.8 — HR Designation Id: Internal ID for the HR role designation (used in approval workflows).
SR.9 — Mail Mailer: Mail driver to use (e.g., "smtp").
SR.10 — Mail Host: SMTP server hostname.
SR.11 — Mail Port: SMTP port number.
SR.12 — Mail Username: Sender email account for system notifications.
SR.13 — Mail Password: Password for the mail account (stored securely, masked in the UI).
System Settings — Small Logo, HR Designation, and outgoing mail server configuration (SMTP host, port, credentials).
System Settings — Mail Identity & Tenant Details (Settings 14–21)
SR.14 — Mail Encryption: Encryption protocol for outgoing mail (e.g., "ssl").
SR.15 — Mail From Name: Sender name shown in employee emails (e.g., "Cloud HRMS Suite").
SR.16 — Mail From Address: Sender email address in outgoing emails.
SR.17 — Login Credential Email Subject: Subject line of the auto-sent credential email.
SR.18 — Frontend Url: Employee portal URL (e.g., https://hrms.alphabizly.com/).
SR.19 — Tenant Title: Short identifier for the tenant (e.g., "demo").
SR.20 — Tenant Address: Organisation address (used in reports and payslips).
SR.21 — Support Mail: Support contact email shown to employees.
System Settings — Mail From identity, Login credential email subject, Frontend URL, Tenant Title/Address, and Support Mail.
System Settings — Payroll & Integration Options (Settings 22–28)
SR.22 — Year Type: Fiscal or calendar year basis for payroll (e.g., "calendar").
SR.23 — Is Override Approval Policy By Reporting Employee: Allows reporting managers to override approval policies (1 = Yes).
SR.24 — Attendance Sync Consumer Key: API key for syncing attendance from external biometric/hardware devices.
SR.25 — Attendance Sync Consumer Secret: Secret token for the attendance sync integration.
SR.26 — Web Url: Admin panel base URL (e.g., https://app.cloud-hrms.com/).
SR.27 — Provident Fund: Enable or disable Provident Fund deductions globally (YES / NO).
SR.28 — Gratuity: Enable or disable Gratuity calculations (YES / NO).
Click "Update Settings" to save all changes on this page.
System Settings — Year Type, Approval Policy override, Attendance Sync keys, Web URL, Provident Fund, and Gratuity toggles. Click "Update Settings" to save.
Roles & Permissions Screen (Tenant Setup → Roles & Permissions)
Roles must be created before users (Step 3 in the setup flow). Each role bundles a set of permissions and is assigned to users to control their access level within the system.
Roles & Permissions — Role List
The Roles list shows all defined access roles. Key columns:
• Name — role label (e.g., Sub Admin, Employee, Admin).
• Description — short label describing the role's purpose.
• Permissions — number of individual permissions granted to this role (e.g., Admin role has 687 permissions).
• Users — number of users currently assigned to this role (e.g., Employee role has 12 users).
• Status — Active / Inactive badge.
• Actions — ✎ Edit | 🗑 Delete.
Default roles in this system:
• Sub Admin — Admin-level description, 631 permissions, 0 users assigned.
• Employee — Standard employee role, 13 permissions, 12 users assigned.
• Admin — Full admin role, 687 permissions, 0 users assigned.
Roles & Permissions — Three roles defined: Sub Admin (631 permissions), Employee (13 permissions, 12 users), and Admin (687 permissions). URL: admin.cloud-hrms.com/#/admin/tenant-setup/roles
⚠️Roles must exist before users are created. When adding a new user in User Management, you must select a role. If no roles are defined yet, the user cannot be assigned proper permissions.
User Management Screen (Administration → User Management)
After employees are added (Step 4), create their system login accounts here (Step 5). Each row shows Employee Code, Name, Email, Role, and Status. Use the ✉ envelope icon in the Actions column to send login credentials (Step 6).
User Management — User List
The Users list displays all accounts in the system. Key columns:
• Employee Code — unique identifier linking the user to their employee record (click to open).
• Name — full display name.
• Email — login email and address for system notifications.
• Role — assigned permission role (e.g., Employee, HR Manager).
• Status — Active / Inactive badge.
• Actions — ✎ Edit | 🗑 Delete | ✉ Send Credentials.
User Management — Lists all 13 users (12 employees + 1 admin). Use the envelope icon (✉) in Actions to send login credentials to any user.
3. Admin Dashboard — Headcount Analysis
URL: admin.cloud-hrms.com/#/admin/dashboard — the first screen after admin login. Breadcrumb: 🏠 › Home › Headcount Analysis.
Screen 3 — Admin Dashboard: Headcount Analysis (Top Section)
Left Sidebar visible elements: "Cloud HRMS Suite" (purple logo text), Admin profile photo (red outfit woman) + "Admin / Admininstrator" label, MAIN section label, then: Dashboard (highlighted blue/active), Employees ›, Attendance ›, Shift ›, Leave Management ›, Assets, Announcements, Holidays
Top bar: ☰ hamburger | ⬛ expand | 🏷 English flag | 🔔 bell with red "1" badge | "Admin" text | Admin avatar photo (top-right)
Page title: "Headcount Analysis" (large, left) | Breadcrumb top-right: 🏠 › Home › Headcount Analysis
3 Summary Metric Cards:
• BLUE: 👥 icon | 12 | CURRENT EMPLOYEES | white progress bar | "↑ Active Workforce"
• GREEN: 👥 icon | 27 | APPROVED HEADCOUNT | progress bar | "↑ Sanctioned Strength"
• ORANGE: 🏷 icon | 15 | VACANT POSITIONS | progress bar | "↓ Open Positions"
Charts row (3 panels):
• Age Mix: Concentric ring chart (5 rings, multicolour). Legend left: 18-24:2, 25-34:2, 35-44:7, 45-60:1, 61-80:0. Bar chart below: 18-24(➕2), 25-34(➖2), 35-44(➕7)
• Gender Mix: Large donut (gold-yellow segment majority + dark blue segment). Legend: 4 Male 8 Female
• Department Wise Headcount: Vertical blue bar chart, 10 dept bars, Y-axis 0-5, dept names on diagonal X-axis
Admin Dashboard — Headcount Analysis. Admin logged in (name + photo in sidebar and top-right). Notification bell shows 1 unread item. Settings cog visible on far right edge.
3.1 Summary Metric Cards
Current Employees
12
↑ Active Workforce
Approved Headcount
27
↑ Sanctioned Strength
Vacant Positions
15
↓ Open Positions
| Card | Colour | Value | Meaning | Formula |
| Current Employees | Blue | 12 | Number of staff actively employed right now | Count of all Active-status employee records |
| Approved Headcount | Green | 27 | Total authorised / budgeted positions | Sanctioned strength set in workforce planning |
| Vacant Positions | Orange | 15 | Open unfilled positions | 27 − 12 = 15 |
Each card also shows a white progress bar and a directional label (e.g., "↑ Active Workforce") indicating the metric's trend context.
3.2 Analytics Charts
Screen 4 — Admin Dashboard: Scrolled Down (Lower Charts)
Top row (two charts, visible from scrolled position):
• LEFT — Age by Department stacked bar chart: Each bar = one department, stacked by age band. Tooltip popup visible: "Backend Development / 35-44 / 1" (pink highlight on that bar segment). Legend: ■18-24 ■25-34 ■35-44 ■45-60
• RIGHT — Gender by Department grouped bar chart: Blue bars = Male, Yellow bars = Female side by side per department. Legend: ■Male ■Female
Bottom row (two charts):
• LEFT — "Approved vs Actual HC": Horizontal bar chart. GREEN bar labelled "12" (shorter = Actual). ORANGE bar labelled "27" (longer = Approved). Below: "Actual ⊕12" and "Approved ⊕27"
• RIGHT — "Dept — Actual / Approved / Vacant": Combination chart. Green bars=Actual, Red-pink bars=Vacant, Blue curved line=Approved. Departments: DevOps Department, Design Department, Account Department, Backend Development, Director & Management, Quality Assurance. Legend: ⬤Actual ⬤Vacant ⬤Approved
Sidebar note: "Payroll ›" now visible at bottom of sidebar
Dashboard lower section — 4 additional analytical charts. The Dept—Actual/Approved/Vacant combo chart (bottom-right) is the most powerful for recruitment planning.
🍩 Age Mix (Ring Chart)
5 concentric rings, one per age band: 18-24(2), 25-34(2), 35-44(7—largest), 45-60(1), 61-80(0). Bar chart below shows trends per band.
🍩 Gender Mix (Donut)
Gold/yellow = 8 Female (majority), dark blue = 4 Male. Exact counts in legend. Used for diversity tracking.
📊 Dept Wise Headcount
Blue vertical bars per department: Ops(1), Internship(5), Design(2), Account(1), Frontend(5), Backend(4), Mobile(3), Director&Mgmt(2), Admin&HR(2), QA(2).
📊 Age by Department (Stacked)
Each department bar stacked by age band. Hover tooltip shows exact value (e.g., Backend Dev 35-44: 1). Legend: Blue=18-24, Green=25-34, Orange=35-44, Red=45-60.
📊 Gender by Department
Grouped bars per department: Blue=Male, Yellow=Female side by side. Identifies gender imbalances in specific departments at a glance.
📈 Approved vs Actual HC
Horizontal bars: Green(Actual=12) vs Orange(Approved=27). Visual gap = 15 vacancies. Summary counts shown below bars.
Dept — Actual / Approved / Vacant (Combination Chart): The most detailed chart. Green bars = actual staff, Red bars = vacancies, Blue curved line = approved headcount trend, across 6 key departments. Legend: ●Actual ●Vacant ●Approved.
✅Use the Dept—Actual/Approved/Vacant chart in monthly management meetings to immediately identify which departments need the most urgent hiring attention.
4. Employee Management Module
4.1 Employee List
Navigate: Sidebar → Employees → Employees.
Screen 5 — Employee List (Full Directory)
Sidebar sub-menu expanded under Employees: Probation / Contractual | Employees | Loan Approval | Vehicle Management
Search bar (🔍 magnifying glass, placeholder "Search") top-left
4 action icons top-right: ≡ Filter | + Add | ↻ Refresh | ⬇ Export/Download
Table columns: ▢ Checkbox | Code | Image | Information | Details | Employee Type | Status | Actions
9 employee rows (all Active):
• 10012 | Sophia Miller photo | SOPHIA MILLER / CNIC:1761515271621 / sophia.miller@email.com | Chief Technology Officer / Director & Management / Belpark Estates, 764 Finchley Road, London, NW11 7TH | Permanent | Active | ✎🗑👁
• 10011 | Matthew Baker photo | MATTHEW BAKER / CNIC:3235632445464 / matthew.baker@outlook.com | Sr. Software Quality Eneginer / Quality Assurance | Contractual | Active
• 10010 | Inga Beale photo | INGA BEALE / CNIC:6754312214416 / ingalol@outlook.com | Assitant Project Manager / Acccount Department | Permanent | Active
• 1009 | Alison Cooper photo | ALISON COOPER / CNIC:5464416561611 / alisonv@applecloud.co | Assitant Project Manager / Design Department | Permanent | Active
• 1008 | Peter Harrison photo | PETER HARRISON / CNIC:5676554165156 / peterz@outlook.com | Technical Project Manager / Mobile Application Department | Contractual | Active
• 1007 | Emma Walmsley photo | EMMA WALMSLEY / CNIC:4456087651156 / emmawalmsley432@gmail.com | Sr. Software Engineer / Backend Development | Contractual | Active
• 1006 | Emily Jones photo | EMILY JONES / CNIC:3310070221367 / emilyjones@gmail.com | Sr. Software Engineer / Frontend Development | Permanent | Active
• 1005 | Alex Brown photo | ALEX BROWN / CNIC:3330166777119 / alexrown876@gmail.com | DevOps Engineer / DevOps Department | Permanent | Active
• 1004 | Lisa Wang (partial) | HR Officer / Admin & HR / CNIC:3100588250261 | Permanent | Active
Employee directory — 9 of the organisation's employees shown with codes (10012 down to 1004), profile photos, contact/CNIC info, designations, departments, employment type, and Active status badges.
| Column | What Is Shown | Example |
| ▢ Checkbox | Select rows for bulk actions | Header checkbox selects all |
| Code | Unique numeric employee ID | 10012, 10011, 1009… |
| Image | Circular cropped profile photo | Sophia Miller’s photo |
| Information | Name (ALL CAPS bold), CNIC number, email address | SOPHIA MILLER / 1761515271621 / sophia.miller@email.com |
| Details | Designation, Department, full office location | Chief Technology Officer / Director & Management / Belpark Estates, London |
| Employee Type | Employment classification | Permanent or Contractual |
| Status | Coloured pill badge | Active (green) or Inactive (grey) |
| Actions | Three icon buttons per row | ✎ Edit (blue) | 🗑 Delete (red) | 👁 View (blue) |
🚫The Delete (🗑) action permanently removes the employee record and all linked history. Instead, set Employee Status to Inactive to block access while preserving all payroll, attendance and leave records.
4.2 Edit Employee — Basic Tab (Personal Information)
Click ✎ Edit on any row. URL: admin.cloud-hrms.com/#/admin/employees/edit-employee/[ID]
Screen 6 — Edit Employee: Basic Tab — Personal Information Section
Profile header (always visible, all tabs):
Circular photo (Sophia Miller) | "Sophia Miller" (large heading) | "Chief Technology Officer" | Active badge | 👤 ID: 10012 | 🏢 Dept: Director & Management | 📅 Joined:2025-09-01
TOP-RIGHT corner: "Switch Employee" labelled box showing "10012 - Sophia Miller (sophia.miller@email.co" with ✕ button to clear/close
Tab bar (scrollable left/right with < > arrows): Basic | Salary | Family Info | Education | Work Experience | Documents | Shift Settings | Bank Details | Assets | Leave Settings | Attendan› (clipped by screen edge)
"Edit Employee Information" section heading (with person-edit icon)
Personal Information section (collapsible ∧):
Row 1: Title=Miss (dropdown) | First Name*=Sophia | Last Name=Miller | Full Name (auto, greyed label)
Row 2: Father Name=Jhony Miller | Husband Name=(empty) | Gender=Female (dropdown) | Marital Status=Single (dropdown)
Row 3: Email=sophia.miller@email.com (✉ envelope icon) | Phone=443 456 532 (📱 phone icon) | Employee Code*=10 012 | Employee Status*=Active (dropdown)
Row 4: Emergency Contact Number=(empty, full-width left) | Tag*=Active (dropdown)
Edit Employee — Basic Tab. Profile header always shows employee name, title, status, ID, dept, and join date. Switch Employee dropdown (top-right) allows jumping to any other employee profile.
👤
Basic
Personal, General ID, Company details, EOBI
💰
Salary
Structure, allowances, deductions
👪
Family Info
Family members & emergency contacts
🎓
Education
Degrees & qualifications
💼
Work Experience
Previous employment history
📄
Documents
Contracts, certificates, policy docs
⏰
Shift Settings
Shift, rest days, overtime, grace time
🏢
Bank Details
Account, IBAN, payment type
💻
Assets
Company equipment assigned
🌴
Leave Settings
Policy, approval, restrictions
📋
Attendance
Attendance config (11th tab)
| Field | Req? | Value (Sophia Miller) | Description |
| Title | Opt | Miss | Mr./Mrs./Ms./Miss/Dr. (dropdown) |
| First Name | Req | Sophia | Legal first name |
| Last Name | Opt | Miller | Legal surname |
| Full Name | — | Auto-generated | System combines First + Last (read-only display label) |
| Father Name | Opt | Jhony Miller | Father's full name |
| Husband Name | Opt | (empty) | For married female employees |
| Gender | Opt | Female | Male / Female / Other (dropdown) |
| Marital Status | Opt | Single | Single/Married/Divorced/Widowed (dropdown) |
| Email | Req | sophia.miller@email.com | Login credential — must be unique system-wide |
| Phone | Opt | 443 456 532 | Primary contact number |
| Employee Code | Req | 10 012 | Unique employee ID number |
| Employee Status | Req | Active | Active = can log in; Inactive = access blocked |
| Emergency Contact | Opt | (empty) | Emergency phone number |
| Tag | Req | Active | Category label for employee grouping |
4.3 Basic Tab — General Information
Screens 7 & 8 — Basic Tab: General Information Section (Scrolled)
General section (below Personal Information, same Basic tab):
Row 1: Date of Birth=07/06/1989 (📅) | Place of Birth=United Kingdom | Blood Group=B+ (dropdown) | Religion=Christian (dropdown)
Row 2: CNIC*=17615-1527162-1 (with 🖐 fingerprint/scan icon on right) | CNIC Issue Date=11/02/2003 (📅) | CNIC Expiry Date=(empty 📅) | Family Code=(empty)
Row 3: Passport Number=(empty) | Place of Issue=(empty) | Passport Issue Date=(empty 📅) | Passport Expiry Date=(empty 📅)
Row 4: Driving License Number=(empty) | Nationality=USA (dropdown) | Country=America (dropdown) | State=New Jersey (dropdown)
Row 5: Base Town=Dover (dropdown) | Address=666 Network Way, City, State, 12345 (multi-line text area, full-width right)
Company section header visible at very bottom (collapsed, click ∨ to expand)
General Information section of the Basic Tab — identity documents, nationality, and residential address for Sophia Miller. CNIC field has a fingerprint icon indicating biometric record linkage.
| Field | Value | Notes |
| Date of Birth | 07/06/1989 | Feeds into the Age Mix dashboard chart |
| Place of Birth | United Kingdom | Country/city of birth |
| Blood Group | B+ | Dropdown: A+, A-, B+, B-, O+, O-, AB+, AB- |
| Religion | Christian | For HR records and religious holiday planning |
| CNIC * 🖐 | 17615-1527162-1 | Required. Format: 5-7-1 digits. Fingerprint icon = biometric linkage. |
| CNIC Issue Date | 11/02/2003 | When the CNIC was issued |
| CNIC Expiry Date | (empty) | System can alert when approaching expiry |
| Family Code | (empty) | Government family registration code |
| Passport / Licence | (empty) | Travel and driving document numbers |
| Nationality | USA | Country of citizenship (dropdown) |
| Country / State | America / New Jersey | Current residence country and state (cascading dropdowns) |
| Base Town | Dover | Home city/town (dropdown) |
| Address | 666 Network Way, City, State, 12345 | Full residential address (multi-line text area) |
4.4 Basic Tab — Company Information
Screen 9 — Basic Tab: Company Section
Company section (expanded, below General section):
Row 1: Location*=Belpark Estates, 764 Finchley Road, London, NW1… (dropdown, text truncated) | Department*=Director & Management (dropdown) | Sub Department=(empty dropdown)
Row 2: Section=(empty dropdown) | Sub Section=(empty dropdown) | Designation*=Chief Technology Officer (dropdown)
Row 3: Grade*=Management (dropdown) | Grade Type=management (greyed/auto-filled, read-only) | Date of Joining*=01/09/2025 (📅) | Date of Confirmation=01/09/2025 (📅)
Row 4: NTN Number=(empty text) | Employee Type*=Permanent (dropdown) | Report To=(1001) - John Doe (with ✕ clear button on right)
Row 5: Skill=Highly Skilled (dropdown, half-width left)
EMPLOYEE DIGITAL SIGNATURE section (below Company):
Left box: Pen/signature icon ✎ preview area (teal-bordered, selected state)
Right: Dashed-border upload area: "Choose file or click here to select"
Company Information section. Sophia Miller = CTO, Director & Management dept, Management grade, Permanent type, reporting to John Doe (1001). Digital signature upload area at bottom.
| Field | Value | Description |
| Location * | Belpark Estates, 764 Finchley Road, London… | Office branch assignment (dropdown) |
| Department * | Director & Management | Primary department — drives all dashboard charts |
| Sub Department | (empty) | Sub-unit within the main department |
| Section / Sub Section | (empty) | Further org-chart breakdown levels |
| Designation * | Chief Technology Officer | Official job title (dropdown) |
| Grade * | Management | Pay grade tier — determines salary structure options |
| Grade Type | management | Auto-filled read-only — set by selected Grade |
| Date of Joining * | 01/09/2025 | First official working day (calendar picker 📅) |
| Date of Confirmation | 01/09/2025 | When probation ended and employment was confirmed |
| NTN Number | (empty) | National Tax Number for payroll compliance |
| Employee Type * | Permanent | Permanent / Contractual / Probation (dropdown) |
| Report To | (1001) - John Doe | Direct manager — searchable; ✕ clears selection |
| Skill | Highly Skilled | Highly Skilled / Skilled / Entry Level (dropdown) |
| Digital Signature | Upload area | Click "Choose file" or drag-drop to upload signature image |
4.5 Basic Tab — EOBI & Social Security + Save Buttons
Screen 10 — Basic Tab: EOBI, Social Security & Action Buttons
EOBI section (🏛 institution icon):
• "Enable EOBI" toggle = ON (blue with white ✓)
• "Overwrite Contributions" toggle = OFF (grey with white —)
• EOBI Number field (empty text input with calendar/picker icon 📅 on right)
• Employee Contribution (0%) field = 0
• Employer Contribution (0%) field = 0
Social Security section (🌐 globe icon):
• "Enable Social Security" toggle = ON (blue ✓)
• Social Security Number field (empty text input)
Bottom action bar (sticky at screen bottom):
• Cancel (red/coral button) | Save (blue button) | Save & Continue → (green button with right arrow →)
EOBI and Social Security sections at the bottom of the Basic Tab. Both schemes are enabled for Sophia Miller but registration numbers have not yet been entered. Three action buttons visible at bottom.
| Control | State | What It Does |
| Enable EOBI | ON (blue ✓) | Enrols employee in the EOBI government pension scheme. Triggers automatic EOBI deductions in payroll. |
| Overwrite Contributions | OFF (grey —) | When OFF, default government EOBI rates apply. Toggle ON to manually set custom contribution %. |
| EOBI Number | (empty) | Government-assigned EOBI registration ID. Required for scheme participation. |
| Employee Contribution (%) | 0 | % deducted from employee salary for EOBI contributions |
| Employer Contribution (%) | 0 | % the company contributes on behalf of the employee |
| Enable Social Security | ON (blue ✓) | Enrols employee in the government Social Security welfare scheme |
| Social Security Number | (empty) | Government-assigned Social Security ID number |
| Button | Colour | Action |
| Cancel | Red | Discards ALL unsaved changes on current tab and returns to Employee List |
| Save | Blue | Saves data on the CURRENT TAB ONLY — stays on same tab |
| Save & Continue → | Green | Saves current tab AND automatically advances to the next tab in sequence |
✅When setting up a new employee, always use Save & Continue on every tab. This ensures the complete profile is built in order: Basic → Salary → Family → Education → Work Experience → Documents → Shift → Bank → Assets → Leave Settings.
4.6 Salary Tab
Screen 11 — Salary Tab: Structure, Standard Allowances & Deductions
Salary tab active (underlined blue in tab bar).
Salary Structure Settings section:
• Salary Structure* = "General Salary with Deduction" (dropdown ⌄)
• Gross Salary* = 55000 (editable text field)
• Basic Salary = 44000 (greyed/read-only, auto-calculated)
• Net Salary = 65350 (greyed/read-only, auto-calculated)
Employee Allowances table (blue header 🏞):
Columns: ALLOWANCE | ALLOWANCE TYPE | SALARY TYPE | PERCENTAGE | ALLOWANCE VALUE
Row: House Rent Allowance | Percentage (blue pill badge) | Gross | 20% | 11,000
Employee Deductions table (pink/red header):
Columns: DEDUCTION | DEDUCTION TYPE | SALARY TYPE | PERCENTAGE | DEDUCTION VALUE
Row: EOBI | Fixed (red pill badge) | — | — | 150.00 (shown in red)
Salary Tab — "General Salary with Deduction" structure. Gross=55,000 → Basic=44,000 (auto) → Net=65,350 (auto). House Rent Allowance at 20% of Gross = 11,000. EOBI fixed deduction = 150.
Screen 12 — Salary Tab: Employee Other Allowances & Other Deductions
Employee Other Allowances section (blue header, "+ Add" button top-right):
Columns: ALLOWANCE | ALLOWANCE TYPE | SALARY TYPE | PERCENTAGE | ALLOWANCE VALUE | ACTIONS
Row 1: Medical (dropdown) | Fixed (dropdown) | — | — | 10000 | 🗑 (red)
Row 2: House Rent Allowance (dropdown) | Percentage (dropdown) | Gross (dropdown) | 10 % | 5500 | 🗑 (red)
Employee Other Deductions section (pink/red header, "+ Add" button):
Columns: DEDUCTION | DEDUCTION TYPE | SALARY TYPE | PERCENTAGE | DEDUCTION VALUE | ACTIONS
Row 1: Income Tax (dropdown) | Fixed (dropdown) | — | — | 5000 | 🗑
Bottom bar: Cancel (red) | Save (blue) | Save & Continue (green)
Salary Tab — Other Allowances: Medical (Fixed 10,000) + House Rent (10% of Gross = 5,500). Other Deductions: Income Tax (Fixed 5,000). All rows have dropdown selectors and a red delete icon.
| Section | Row Example | Type | Value |
| Standard Allowance | House Rent Allowance | Percentage of Gross | 20% = 11,000 |
| Standard Deduction | EOBI | Fixed | 150.00 (red) |
| Other Allowance 1 | Medical | Fixed | 10,000 |
| Other Allowance 2 | House Rent Allowance | Percentage of Gross | 10% = 5,500 |
| Other Deduction 1 | Income Tax | Fixed | 5,000 |
⚠️After entering all allowances and deductions, verify the Net Salary in Salary Structure Settings. It recalculates in real time. Sophia Miller: 55,000 + 11,000 + 10,000 + 5,500 − 150 − 5,000 = 65,350.
4.7 Family Info Tab
Screen 13 — Family Info Tab
Family Info tab active (underlined).
"Lists of Family Members" section (👭 people icon) with "+ Add" button top-right
Table columns: # | FIRST NAME | LAST NAME | RELATION | CNIC NO. | PHONE NO. | (delete)
Row 1: 🔸1 | Jhony | Miller | Father ⌄ | 87869-6708047-8 | 175858585 | 🗑
Row 2: 🔸2 | Maya | Miller | Mother ⌄ | 12855-8974715-2 | 282982585 | 🗑
Cancel (red) | Save (blue) | > Save & Continue (green)
Family Info Tab — Two family members: Father (Jhony Miller, CNIC: 87869-6708047-8) and Mother (Maya Miller, CNIC: 12855-8974715-2). Row numbers shown as blue-outlined circles (1, 2).
| Column | Type | Example Row 1 | Example Row 2 |
| # (Auto) | Circle number | 🔸1 | 🔸2 |
| First Name | Text input | Jhony | Maya |
| Last Name | Text input | Miller | Miller |
| Relation | Dropdown ⌄ | Father | Mother |
| CNIC No. | Text input | 87869-6708047-8 | 12855-8974715-2 |
| Phone No. | Text input | 175858585 | 282982585 |
| 🗑 | Delete button | Removes this row | Removes this row |
4.8 Education Tab
Screen 14 — Education Tab
Education tab active (underlined).
"Lists of Education Information" (🎓 graduation cap icon) with "+ Add" button
Table columns: INSTITUTE NAME | DEGREE | DEGREE NAME | START DATE | COMPLETION DATE | OBTAINED MARKS (CGPA)
Row: University of Cambridge… (truncated dropdown ⌄) | Masters (dropdown ⌄) | Business (text) | 03/05/2016 (📅) | 31/08/2019 (📅) | 3.8
Horizontal scrollbar at bottom of table | Cancel | Save | > Save & Continue
Education Tab — Sophia Miller: Masters in Business from University of Cambridge (Mar 2016 – Aug 2019), CGPA 3.8. Scroll right to see any additional columns.
| Field | Type | Value |
| Institute Name | Dropdown/text | University of Cambridge… |
| Degree | Dropdown | Masters (also: Matric, Intermediate, Bachelors, PhD) |
| Degree Name | Text | Business |
| Start Date | Date picker 📅 | 03/05/2016 |
| Completion Date | Date picker 📅 | 31/08/2019 |
| Obtained Marks (CGPA) | Text/Number | 3.8 |
4.9 Work Experience Tab
Screen 15 — Work Experience Tab
Breadcrumb: 🏠 › Employees › Edit
Work Experience tab active. "Lists of Work Experience" (💼 briefcase icon) with "+ Add" button
Table columns: COMPANY NAME | DESIGNATION | START DATE | END DATE | DESCRIPTION | DOCUMENT
Row: Abc (text) | Developer (text) | 19/05/2021 (📅) | 29/10/2023 (📅) | "Roles & responsibilities…" (placeholder) | 📎 Attach (blue outlined button) | 🗑
Horizontal scrollbar visible at bottom
Work Experience Tab — Previous employment at "Abc" as a Developer (May 2021 – Oct 2023). The blue Attach button uploads an experience letter or reference document for that role.
4.10 Documents Tab
Screen 16 — Documents Tab
Documents tab active. "Employee Documents" (📄 document icon) with "+ Add" button
Table columns: MEDIA CATEGORY | DESCRIPTION | DOCUMENT | (delete)
Row: Policy Documents (dropdown ⌄, full-width left) | "Brief document details" (placeholder text input) | 📎 Attach (blue outlined button with paperclip) | 🗑
Cancel (red) | Save (blue) | > Save & Continue (green)
Documents Tab — "Policy Documents" selected as media category. One empty row ready to fill. The Attach button opens a file picker. Delete icon (trash) removes the row.
1
Click + Add to insert a new row.
2
Select Media Category: Policy Documents / Contracts / Certificates / ID Copies (dropdown).
3
Enter a specific Description (e.g., "Signed Employment Contract — Sept 2025").
4
Click the blue 📎 Attach button and select the file from your device.
5
Click Save or Save & Continue.
4.11 Shift Settings Tab
Screen 17 — Shift Settings Tab: “Update Shift Setting”
Shift Settings tab active. Page heading: "Update Shift Setting"
Row 1: Name*=General Shift (text input) | Type*=Shift (dropdown ⌄) | Shift*=General Shift (dropdown with ⏰ clock icon)
Row 2: Rest Days*=Saturday, Sunday (dropdown with 🛋 sofa icon on left)
Row 3 (three toggles in a row):
• Custom Rest Days = ON (blue ✓)
• Overtime = OFF (grey —)
• Grace Time = OFF (grey —)
Row 4: Description* = "General Shift" (multi-line text area, full width)
Cancel (red) | Save (blue) | Save & Continue (green)
Shift Settings Tab — "Update Shift Setting" form for Sophia Miller. Assigned "General Shift" type with Saturday+Sunday rest days. Custom Rest Days ON; Overtime and Grace Time OFF.
| Field / Toggle | Value | Description |
| Name * | General Shift | Label for this shift configuration |
| Type * | Shift | Shift / Roster / Flexible (dropdown) |
| Shift * ⏰ | General Shift | The specific shift to assign — pre-configured in Shift module |
| Rest Days * 🛋 | Saturday, Sunday | Weekly days off (multi-select dropdown) |
| Custom Rest Days | ON (blue ✓) | Enables different rest day patterns per individual week |
| Overtime | OFF (grey —) | Toggle ON to enable overtime tracking and pay for this employee |
| Grace Time | OFF (grey —) | Toggle ON to allow buffer period before marking late arrivals |
| Description * | General Shift | Notes about this shift assignment (free text) |
4.12 Bank Details Tab
Screen 18 — Bank Details Tab: Employee Bank Details
Bank Details tab active. Section: "Employee Bank Details" (🏛 bank icon)
Row 1: Account Title*=Sophia Miller (with 🏴 ID card icon on right) | Account Number*=12989287217418 (with # icon on right)
Row 2: Employee Bank*=Goldman Sachs (dropdown ⌄ with 🏛 bank icon on right) | Employee Payment Type=Bank (dropdown ⌄ with 💳 card icon on right)
Row 3: Branch Code*=48585 (with 📍 location pin icon on right) | IBAN Code*=GS48582141578214 (with 🌐 globe icon on right)
Cancel (red) | Save (blue) | > Save & Continue (green)
Bank Details Tab — Sophia Miller: Goldman Sachs bank, Bank transfer payment, branch code 48585, IBAN GS48582141578214. Each field has a contextual icon on the right edge.
| Field | Req? | Value | Notes |
| Account Title 🏴 | Req | Sophia Miller | Must exactly match the name on the bank account |
| Account Number # | Req | 12989287217418 | Full bank account number |
| Employee Bank 🏛 | Req | Goldman Sachs | Select from registered banks dropdown |
| Employee Payment Type 💳 | Opt | Bank | Bank Transfer / Cash / Cheque |
| Branch Code 📍 | Req | 48585 | Bank branch identification code |
| IBAN Code 🌐 | Req | GS48582141578214 | International Bank Account Number for transfers |
🚫Verify Account Title and IBAN directly with the employee before the first payroll run. Incorrect details cause failed or misdirected salary transfers.
4.13 Assets Tab
Screen 19 — Assets Tab: Assigned Assets
Assets tab active. Section: "Assigned Assets" (🖼 laptop/monitor icon) with "+ Add" button
Table columns: SELECT ASSET | SERIAL NUMBER | ASSIGNED DATE | RECEIVED FROM | RECEIVED DATE | BUY BACK DATE
One blank input row (ready to fill):
Please Select (dropdown ⌄) | e.g. SN-123456 (placeholder text) | mm/dd/yyyy (📅) | HR / Dept (placeholder) | mm/dd/yyyy (📅) | mm/dd/yyyy
Horizontal scrollbar visible at bottom of table
Cancel (red) | Save (blue) | > Save & Continue (green)
Assets Tab — One blank row ready to fill. No assets currently assigned to Sophia Miller. Scroll right to see the Buy Back Date column (6th column, partially off-screen).
1
Click + Add to insert a new asset row.
2
Select the Asset type from the "Please Select" dropdown (e.g., Laptop, Mobile Phone, Vehicle, Tablet).
3
Enter the Serial Number of the physical unit (replaces placeholder "e.g. SN-123456").
4
Set Assigned Date — when the asset was handed over (📅 date picker).
5
Enter Received From — the department or person that issued the asset.
6
Set Received Date — when the employee physically took possession.
7
Optionally enter Buy Back Date — scheduled return date.
8
Click Save or Save & Continue. Click + Add again to assign additional assets.
4.14 Leave Settings Tab
Screen 20 — Leave Settings Tab
Leave Settings tab active (underlined).
Leave Policy* field (full-width dropdown): = Management
"Is Leave Allowed" label with toggle switch = ON (blue with white ✓)
Bordered inner panel containing 4 toggle switches in a row:
• Is Leave Approval Needed = ON (blue ✓)
• Is Mobile Leave Allowed = OFF (grey —)
• Is Web Leave Allowed = OFF (grey —)
• Is CPL Allowed = OFF (grey —)
Leave Restrictions* field (full-width dropdown, 🚫 no-entry icon on left): = None
(Save buttons appear when scrolling down past this section)
Leave Settings Tab — "Management" leave policy assigned. Is Leave Allowed = ON (master switch). Is Leave Approval Needed = ON. Mobile Leave, Web Leave, and CPL are all OFF. No restrictions (None).
| Setting | Value | Description |
| Leave Policy * | Management | Assigns the leave entitlement group, determining leave types and annual quotas |
| Is Leave Allowed | ON ✓ (blue) | Master switch. If OFF, employee cannot apply for any leave regardless of all other settings. |
| Is Leave Approval Needed | ON ✓ (blue) | All leave requires manager approval before being granted. If OFF, leave is auto-approved. |
| Is Mobile Leave Allowed | OFF — (grey) | When ON, employee can submit leave via the mobile app |
| Is Web Leave Allowed | OFF — (grey) | When ON, employee can submit leave via the web Client Dashboard |
| Is CPL Allowed | OFF — (grey) | Compensatory Paid Leave — when ON, overtime hours convert to leave days |
| Leave Restrictions * 🚫 | None | Rules blocking leave in certain periods. None = no restrictions applied. |
✅Always assign a Leave Policy first before enabling any leave toggles. Without a policy, there are no leave quotas — the employee will have zero leave balance even if "Is Leave Allowed" is ON.
4.19 Probation / Contractual Module
Navigate: Sidebar → Employees → Probation / Contractual. This module provides a dedicated filtered view of employees currently on probationary or contractual terms, separate from the full employee directory. Breadcrumb: 🏠 › Admin › HR › Probation Employees / Contractual Employees.
Screen 26 — Probation / Contractual — Probation Tab (currently empty)
Page title: "Employees" | Breadcrumb: 🏠 › Admin › HR › Probation Employees
Two tab buttons at top:
• Probation tab = active (white background, blue checkmark ✓ + bold text)
• Contractual tab = inactive (grey, calendar/document icon)
Search bar (🔍 icon, placeholder "Search") top-left of table area
Three action icons top-right: ≡ Filter | ↻ Refresh | ⬇ Export
Table columns: Code | Image | Information | Details | Date of Joining | Expected Confirmation | Employee Type | Status | Actions
Table body: Empty (no data rows)
Pagination: Items per page: 50 | 0 of 0 | ‹ › navigation
Probation tab — currently 0 employees on probation. The 'Expected Confirmation' column (unique to this view) shows when the probationary period is scheduled to end for each employee.
Screen 27 — Probation / Contractual — Contractual Tab (currently empty)
Same page, Contractual tab now active:
Breadcrumb: 🏠 › Admin › HR › Contractual Employees
Two tab buttons:
• Probation tab = inactive (document/calendar icon)
• Contractual tab = active (blue checkmark ✓ + bold text)
Table columns (different from Probation view): Code | Image | Information | Details | Date of Joining | Contract Expiry Date | Employee Type | Status | Actions
Table body: Empty (0 of 0)
Same search, filter, refresh, export icons available
Contractual tab — currently 0 contractual employees. The key column difference from Probation view: 'Contract Expiry Date' replaces 'Expected Confirmation' — showing when the contract is due to expire.
| Feature | Probation Tab | Contractual Tab |
| Breadcrumb | Admin › HR › Probation Employees | Admin › HR › Contractual Employees |
| Unique Column | Expected Confirmation (end of probation date) | Contract Expiry Date (when contract ends) |
| Employee Type Filter | Shows employees with type = Probation | Shows employees with type = Contractual |
| Use Case | Track who needs to be confirmed or extended | Track who needs contract renewal or separation |
| Actions | Edit ✎, Delete 🗑, View 👁 | Edit ✎, Delete 🗑, View 👁 |
✅Use this module at the end of each month to proactively identify employees whose probation confirmation or contract expiry dates are approaching. This prevents inadvertent extensions and ensures timely HR action on confirmations, renewals, or separations.
5. Attendance Module
Navigate: Sidebar → Attendance (expand sub-menu). The Attendance module contains two key screens: Attendance Sheet (visual calendar view of daily attendance) and Generate Timesheets (export detailed timesheet reports).
5.1 Attendance Sheet
The Attendance Sheet provides a visual day-by-day calendar grid of an employee's attendance for any selected date range. Breadcrumb: 🏠 › Attendance › Sheet.
Screen 28 — Attendance Sheet — John Doe (1001), Apr 1 – Jun 30, 2026
Page title: "Attendance Sheet" | Breadcrumb: 🏠 › Attendance › Sheet
Filter bar (top):
• Select Employee field = "1001 - John Doe" (with ✕ clear button)
• From Date* = 01/04/2026 (calendar picker 📅)
• To Date* = 30/06/2026 (calendar picker 📅)
• Search button (blue outlined)
Filter label below: "Filtered by: Apr 1, 2026 – Jun 30, 2026"
Legend (top-right):
• ⊗ Weekend (grey circle with minus)
• ✅ Present (green circle with checkmark)
• ❎ Leave / Absent (red circle with X)
• ⭐ Holiday (gold/yellow star)
Table:
Header row: Employee Name | numbered date columns (1–30 for each month, scrollable horizontally)
John Doe row (ID: 1001, with photo): a continuous scrolling row of ✅❎⭐ symbols per day
Horizontal scrollbar at bottom to navigate across months
Attendance Sheet — John Doe's attendance from April 1 to June 30, 2026. Green checkmarks = Present, Red X = Leave/Absent, Gold stars = Holidays, Grey circles = Weekends. The row scrolls horizontally to show all 90 days.
How to View an Attendance Sheet
1
Navigate to Sidebar → Attendance → Sheet.
2
Click the Select Employee field and type the employee name or ID (e.g., "1001 - John Doe"). Select from the dropdown.
3
Set the From Date (start of period, e.g., 01/04/2026).
4
Set the To Date (end of period, e.g., 30/06/2026).
5
Click the Search button. The calendar grid loads with coloured symbols for each day.
6
Scroll horizontally using the scrollbar at the bottom to view all days in the selected range.
| Symbol | Colour | Meaning |
| ✅ Checkmark circle | Green | Present — employee attended work on this day |
| ❎ X circle | Red | Leave / Absent — employee was absent or on approved leave |
| ⭐ Star | Gold / Yellow | Holiday — official public or company holiday |
| ⊗ Minus circle | Grey | Weekend — non-working day based on the employee's shift rest days |
5.2 Generate Timesheets
The Generate Timesheets screen allows administrators to produce detailed timesheet reports for one or all employees over a selected period. Breadcrumb: 🏠 › Admin › Attendance › Generate Timesheets.
Screen 29 — Generate Timesheets — Employee Wise, Jane Smith (1002), April 2026
Page title: "Generate Timesheets" | Breadcrumb: 🏠 › Admin › Attendance › Generate Timesheets
5 filter fields in a row:
• Type* = "Employee Wise" (dropdown ⌄) — generate for a specific employee
• Employee = "1002 - Jane Smith" (with ✕ clear button)
• Year* = "2026" (dropdown ⌄)
• Month* = "April" (dropdown ⌄)
• Day = "All" (dropdown ⌄)
• Generate button (blue outlined)
Content area below: Empty (results appear here after clicking Generate)
Generate Timesheets — configured to generate a timesheet for Jane Smith (1002), Employee Wise, for the entire month of April 2026. Click Generate to produce the report.
| Filter Field | Options | Description |
| Type * | Employee Wise / Department Wise / All | Scope of the timesheet — for one employee, a whole department, or entire organisation |
| Employee | Searchable dropdown (employee name/ID) | Required when Type = Employee Wise. Type name or ID to search. |
| Year * | Dropdown (e.g., 2025, 2026) | The calendar year for the timesheet |
| Month * | Dropdown (January – December) | The specific month to generate the timesheet for |
| Day | All / 1–31 (specific day) | Generate for all days or a single specific day in the month |
| Generate button | — | Executes the report generation and displays results below |
How to Generate a Timesheet
1
Navigate to Sidebar → Attendance → Generate Timesheets.
2
Select Type: "Employee Wise" for a single employee, or "Department Wise" for a team.
3
Select the Employee (if Employee Wise) by typing their name or ID.
4
Select the Year and Month you want the report for.
5
Set Day to "All" for the full month, or select a specific date for a single-day report.
6
Click Generate. The timesheet report loads in the content area below.
✅Generate timesheets at the end of each month before running payroll. The timesheet confirms actual working days, absent days, and overtime hours — all of which feed into payroll calculations. Keep generated timesheets on record for audit purposes.
5.5 Mark Attendance
Navigate: Sidebar → Attendance → Mark Attendance. This screen shows a centralised log of all attendance records across all employees — filtered by type (Normal, Missing, OD, Manual) or viewed as All. It also provides the Mark Manual Attendance action button. Breadcrumb: 🏠 › Admin › Attendance › Attendance.
Screen 31 — Mark Attendance — Attendance Log (Sophia Miller, All Type, April 2026)
Page title: "Attendance" | Breadcrumb: 🏠 › Admin › Attendance › Attendance
Four filter tabs (top-left): Normal | Missing | OD | All (active, blue ✓)
"Mark Manual Attendance" button (blue outlined, top-right)
Search bar | Filter ≡ | Refresh ↻ | Export ⬇ icons
Table columns: sr# | Employee Code | Employee Name | Date | In Time | Out Time | Type | Reason | Status
15 rows visible (all Sophia Miller, Employee Code 10012, Type: auto):
All rows show In Time: 09:00:00 and Out Time: 19:00:00, Reason: "System Generated Auto…" (truncated), Status: —
Dates (unordered): 29/04, 30/04, 16/04, 13/04, 14/04, 21/04, 17/04, 23/04, 22/04, 15/04, 28/04, 27/04, 24/04, 03/04, 08/04/2026
Mark Attendance screen — showing all attendance records for Sophia Miller (10012) in April 2026. All records are Type=auto (system-generated Auto Log) with 09:00–19:00 standard times. Status column is blank (no special flag). Records appear unordered by date.
Attendance Type Filter Tabs
| Tab | Description | When to Use |
| Normal | Regular attendance records where the employee checked in/out within the expected shift window | For reviewing standard attendance history |
| Missing | Days where attendance was expected but no record was found (neither check-in nor check-out) | For identifying and correcting gaps in attendance records |
| OD (Outdoor Duty) | Records where the employee marked themselves as working off-site | For reviewing field staff attendance and approving OD claims |
| Manual | Records that were manually entered by an admin (not system-generated or biometric) | For auditing manually created attendance records |
| All | Displays all record types combined in one list | For a complete attendance overview (default view) |
Attendance Record Types
| Type Value | Meaning |
| auto | System Generated Auto Log — automatically created by the system based on shift schedule and auto-mark settings |
| normal | Standard biometric or app-based check-in/out record |
| manual | Manually entered by an administrator via the Apply Attendance dialog |
| missing | Record created to flag a missing attendance entry (late submission or admin correction) |
💡The Mark Manual Attendance button (top-right) opens a form to record attendance for an employee directly without going through the timesheet row actions. This is useful for bulk or ad-hoc attendance entry from a central screen.
5.6 Attendance Approval
Navigate: Sidebar → Attendance → Attendance Approval. This screen lists all attendance records that require or have undergone manager approval. Records are filtered into three workflow states. Breadcrumb: 🏠 › Admin › Attendance › Attendance Approval.
Screen 32 — Attendance Approval — Approved Records List (Sophia Miller, April 2026)
Page title: "Attendance Approval" | Breadcrumb: 🏠 › Admin › Attendance › Attendance Approval
Three workflow status tabs:
• Submitted for Approval (pending review)
• Approved (active, blue ✓) — currently viewing approved records
• Rejected (denied records)
Search bar | Filter ≡ | Refresh ↻ | Export ⬇ icons top-right
Table columns: ▢ Checkbox | Employee Code | Employee Name | Date | In Time | Out Time | Type | Reason | Status | Actions
Multiple rows for Sophia Miller (10012), all April 2026 dates:
All records: In Time 09:00:00 → Out Time 19:00:00 | Type: auto | Reason: System Generated Auto Log | Status: —
Dates: 29/04, 30/04, 14/04, 13/04, 15/04, 27/04, 28/04, 24/04, 16/04, 17/04, 21/04, 22/04, 23/04, 06/04, 08/04 and more
Actions per row: 👁 View (eye) | 🗑 Delete (red trash)
Attendance Approval — Approved tab showing all approved auto-generated attendance records for Sophia Miller (10012) in April 2026. Standard 09:00–19:00 auto records, all auto-type. Each row has a View and Delete action.
Screen 33 — Employee Attendance History Popup — Jane Smith (1002)
Modal title: "Employee Attendance History" (blue/purple header with ✕ close button)
Section 1: "Report To Employee"
Table: Image | Employee Code | Employee Name
Row: Jane Smith photo | 1002 | Jane Smith
Section 2: "Check-in / Check-out Details"
Columns: In Method | Out Method | In MAC | Out MAC | In Latitude | Out Latitude | In Longitude | Out Longitude | In Image | Out Image | Machine Location
Row: admin | admin | — | — | — | — | — | — | [grey photo placeholder] | [grey photo placeholder] | —
Section 3: "Approval History"
Columns: Employee Name | Employee Code | Status | Designation | Reason | Type | Date & Time
Row: — | — | Approved | — | Auto Approved | manual | 26-May-19 1:34:05
Close button (blue, bottom-right)
Behind modal: Attendance Approval list with multiple employees (John Doe 1001, Mike Johnson 1003) showing Approved status badges
Employee Attendance History popup — opened by clicking the View (eye) icon on any Attendance Approval row. Shows three sections: who the record reports to (Jane Smith, 1002), the technical check-in/check-out method details (admin entry, no GPS/MAC data), and the approval history (Auto Approved, manual type, May 26 2019 1:34:05).
Attendance Approval Workflow States
| Tab | Description | Admin Action Required |
| Submitted for Approval | Records submitted by employees or system that are awaiting manager review | Review each record and click Approve or Reject |
| Approved | Records that have been approved and are counted in attendance totals | View or delete if incorrect. Approved records feed into payroll. |
| Rejected | Records that were reviewed and denied by the manager | Review reason for rejection; employee may resubmit with corrections |
Employee Attendance History Popup — Field Reference
| Section | Field | Description |
| Report To Employee | Image, Code, Name | The employee this attendance record belongs to (the person who was present) |
| Check-in/out Details | In/Out Method | How attendance was recorded: admin (manual), biometric, mobile, web, etc. |
| Check-in/out Details | In/Out MAC | Network MAC address of the device used for check-in/out (for geo-network verification) |
| Check-in/out Details | In/Out Latitude & Longitude | GPS coordinates at the time of check-in/out (for geofencing validation) |
| Check-in/out Details | In/Out Image | Selfie photo taken at check-in/out (when Selfie Verification is enabled) |
| Check-in/out Details | Machine Location | Physical location name of the device used |
| Approval History | Status | Current approval status: Approved / Pending / Rejected |
| Approval History | Reason | Why the approval decision was made (e.g., Auto Approved, Late, Testing) |
| Approval History | Type | The attendance entry type: manual, auto, normal, missing |
| Approval History | Date & Time | When the approval action was taken |
✅Process the Submitted for Approval tab daily or weekly to avoid a backlog. Unapproved attendance records may not be counted in payroll calculations until approved. Set up Attendance Approval toggles in each employee's Attendance Setting tab to control which records require manual approval.
5. Frequently Asked Questions
Q1: I forgot my password. How do I reset it? ▼
On the Sign In page, click Forgot Password? (right side, below the Remember Me checkbox). Enter your registered email. A reset link is sent to your inbox — click it and create a new password. Links expire in 30 minutes; request a new one if needed.
Q2: How do I switch between employee profiles without returning to the list? ▼
Use the Switch Employee dropdown in the top-right of any employee profile header. Start typing the employee’s name or ID code, select the correct person, and the system loads their profile immediately without navigating to the Employee List.
Q3: What is the difference between Save and Save & Continue? ▼
Save (blue) stores the current tab’s data and keeps you on the same tab. Save & Continue (green with arrow) saves the current tab AND automatically advances to the next tab. Use Save & Continue when building a new employee profile from start to finish.
Q4: Why does Vacant Positions show 15 when Approved is 27 and Current Employees is 12? ▼
Vacant Positions = Approved Headcount − Current Employees = 27 − 12 = 15. These are authorised, budgeted positions that do not yet have an active employee filling them. They represent your open hiring requirements.
Q5: Can I assign multiple assets to one employee? ▼
Yes. On the Assets tab, click + Add for each asset. Each row tracks independently: asset type, serial number, assigned date, received from, received date, and buy back date. There is no limit on the number of assets per employee.
Q6: How is Net Salary calculated? ▼
Net Salary = Gross Salary + All Allowances − All Deductions. For Sophia Miller: 55,000 + 11,000 (House Rent 20%) + 10,000 (Medical) + 5,500 (House Rent 10%) − 150 (EOBI) − 5,000 (Income Tax) = 65,350. The Net Salary field is read-only and recalculates instantly as you change values.
Q7: What happens if I turn off "Is Leave Allowed"? ▼
The employee is completely blocked from applying for any leave, regardless of their leave policy, balance, or any other toggle. Used for employees in their notice period, on suspension, or on administrative hold. All other settings remain saved but inactive.
Q8: What is the difference between "Employees" and "Probation/Contractual" in the sidebar? ▼
Employees shows all staff regardless of type. Probation/Contractual is a pre-filtered view showing only employees currently on probation or contractual terms — making it easier for HR to manage those on temporary or trial arrangements.
Q9: What is EOBI and does it affect payroll automatically? ▼
EOBI (Employees’ Old-Age Benefits Institution) is a government-mandated retirement contribution scheme. When "Enable EOBI" is ON and an EOBI Number is entered, the system automatically includes Employee and Employer contribution deductions in every payroll run. As seen in Sophia Miller’s salary, EOBI appears as a Fixed deduction of 150.
Q10: How do I export the employee list? ▼
On the Employee List screen, click the ⬇ Download icon (fourth icon in the top-right action bar — after Filter ≡, Add +, and Refresh ↻). The system exports the currently displayed and filtered list to a downloadable CSV or Excel file.