Chronobill User Manual

Please enter your credentials to access the user manual

Contact administrator for access credentials

Powered by SCUBE Infotech

Chronobill

Intelligent Time & Resource Management

Professional User Manual

Version 2.5 | December 2025
Developed by SCUBE Infotech Pvt. Ltd.

Getting Started

System Access

URL: https://timesheet.scubeinfotech.com.sg

Browser: Chrome, Firefox, Safari, or Edge (latest versions)

Mobile: Responsive design supports tablets and phones

Default Credentials

Admin admin / admin123

Supervisor supervisor1 / supervisor123

Employee employee1 / employee123

Multi-Tenant Branding

Chronobill: Intelligent Time & Resource Management

Rapas Groups . Singapore: Licensed to Rapas Groups . Singapore

Custom Branding: Configurable per client deployment

First Login: Navigate to the system URL, enter your credentials, and you'll be redirected to the dashboard. Important: Change your password after first login for security.

Enterprise Solution by SCUBE Infotech

Professional timesheet management system designed and developed by

SCUBE Infotech Pvt. Ltd., Singapore

Your trusted partner for enterprise software solutions

User Roles & Permissions

Admin Full System Access

  • Manage all users, employees, projects, and companies
  • View and edit all timesheets
  • Approve/reject timesheets
  • Access all reports and audit logs
  • System configuration and maintenance

Supervisor Management Access

  • Manage employees, projects, and companies
  • View and edit all timesheets
  • Approve/reject timesheets
  • Bulk timesheet entry
  • Access timesheet reports
  • Generate invoices (if permitted)

Manager Department Access

  • View all timesheets
  • Approve/reject timesheets
  • Access reports
  • Limited master data access

Employee Basic Access

  • Submit own timesheets
  • View own timesheet history
  • Edit pending timesheets only
  • View assigned projects and companies

Dashboard Overview

Main Dashboard Features

Quick Stats

Total hours, pending approvals, recent activity, and revenue tracking

Recent Activity

Last 5 submitted entries with employee and project details

Pending Actions

Items requiring your attention based on your role

Quick Actions

Fast access to common tasks like logging time and generating reports

Navigation Structure

πŸ“Š Dashboard
πŸ“… Time Records
  βž• Log Time Entry
  πŸ“‹ View Time Records  
  πŸ‘₯ Bulk Entry (Supervisors only)
  βœ… Approvals
    πŸ’¬ WhatsApp Timesheets (Supervisors/Admin)
🀝 Vendors & External
    🏒 Vendor Companies (Admin/Supervisor)
    πŸ‘₯ External Workers (Admin/Supervisor)
    �️ Vendor Time Records (Admin/Supervisor/User)
    πŸ’° Vendor Payables (Admin/Supervisor/Manager)
οΏ½πŸ“ Master Data (Single page with tabs)
πŸ’° Invoicing (Permission-based)
  βž• Generate Invoice
  πŸ“‹ Manage Invoices
πŸ“Š Reports & Analytics
  πŸ“ˆ Time Analytics
  πŸ“‹ Activity Log (Admin only)
πŸ’Ό HRM - Payroll (Admin/Supervisor)
    🧾 Individual Payslips
    πŸ‘₯ Batch Processing
    βœ… Salary Approvals
    πŸ’³ Payment Management
    βœ‰οΈ Payslip Distribution
    πŸ“Š Payroll Reports
βš™οΈ System Management (Admin only)
  πŸ‘₯ User Management
    οΏ½ Permissions Overview
  οΏ½πŸ”§ System Diagnostics

Quick Entry

Fast Access: Quick Entry provides immediate access to time logging for all user roles
Add Timesheet Entry

The Quick Entry feature allows users to rapidly log their time entries with a streamlined interface. This is the primary entry point for individual time tracking.

Access

  • Location: Available in the main sidebar navigation
  • Roles: All user roles (Admin, Supervisor, Manager, Employee, User)
  • Function: Direct link to add_timesheet.php
Highlighted Feature: This menu item is highlighted in the sidebar for easy identification and quick access.

Time Records Management

Individual Time Entry

Adding New Time Entry

Step 1: Navigate to Log Time Entry

Click "Time Records" β†’ "Log Time Entry"

Step 2: Fill Required Information

Basic Information
  • Date: Select the work date
  • Employee: Choose employee (auto-selected for employee role)
  • Project: Select from available projects
  • Company: Choose the company for this work
Time Details
  • Time In: Start time (e.g., 09:00)
  • Time Out: End time (e.g., 17:30)
  • Time Slot: Auto-assigned slot number
  • Number of Pax: People involved (optional)
Submit: Click "Submit Timesheet" and entry will be saved with "Pending" status

WhatsApp Timesheets

Automated WhatsApp Timesheets (Supervisors/Admins)
  • Fortnightly Periods: Automatically aligns to 1–15 and 16–end-of-month
  • Monospace Format: Clean, per-day lines for easy reading and pasting
  • Leave Integration: Leave entries included alongside work days
  • Brand Greeting: Message prefixed with tenant brand greeting
  • Location: Time Records β†’ WhatsApp Timesheets
  • Access: Supervisors and Admins with submit_timesheets permission

Viewing Time Records

Filter Options

All: Show all timesheet records
Pending: Show pending approval entries (default)
Approved: Show approved entries
Rejected: Show rejected entries

Timesheet Status Workflow

πŸ“ Draft β†’ 🟑 Pending β†’ βœ… Approved β†’ πŸ’° Paid
                ↓
              ❌ Rejected β†’ πŸ”„ Resubmit

WhatsApp Timesheets

Automated WhatsApp Timesheets (Supervisors/Admins)

Data Management

Restricted Access: Data management features are primarily available to Admin and Manager roles

Master Data

  • Manage employees, projects, and companies
  • Centralized data management interface
  • Tabbed interface for easy navigation
  • Admin and Manager access

Shift Rotas

  • Create and manage shift schedules
  • Assign supervisors and team members
  • Track rota approval status
  • Permission-based access

Supervisor Timesheet

  • Mobile-optimized timesheet entry
  • Load approved rotas automatically
  • Bulk timesheet creation
  • Supervisor and Admin access

Projects

  • Manage project information
  • Assign projects to employees
  • Track project status and details
  • Admin and Manager access

Leave Management (Admin)

Administrative Leave Controls

Leave Types

Configure different types of leave (annual, sick, maternity, etc.)

Public Holidays

Manage statutory and company holidays

Leave Balances

Set and adjust employee leave entitlements

Employee Leaves

View and manage all employee leave records

Vendors & External Workers

Policy: Registry-first workflow. External workers must be registered; ad-hoc entries are not allowed.

Vendor Companies

  • Create and manage third-party vendor companies
  • Assign contact details and notes
  • Restricted to Admin/Supervisor

External Workers

  • Register individual workers linked to vendor companies
  • Store rate and identification details
  • Restricted to Admin/Supervisor

Vendor Time Records

  • Log timesheets for external workers
  • Accessible by Admin, Supervisor, and User roles
  • Separate from internal employee timesheets

Vendor Payables

  • Compute payments due to vendors by period, worker, or project
  • Access restricted to Admin/Supervisor/Manager
  • Export summaries for accounting
Data Separation: Vendor records are maintained in dedicated tables and reports; they do not mix with internal employee payroll.

Bulk Time Entry

Supervisors Only: This feature is available to Supervisors and Admins only
Purpose & Benefits
  • Enter multiple employee timesheets efficiently
  • Handle large teams (80+ employees)
  • Department-based filtering for better organization
  • Bulk operations with individual customization

Department Filtering

Filter by Department

Choose from dropdown to filter employees by their department

View Filtered List

See only employees from selected department for focused entry

Select Visible

Use "Select Visible" to choose all filtered employees at once

Bulk Entry Process

1. Set Common Details

  • Date: Work date for all entries
  • Project: Common project (can be overridden per employee)
  • Company: Common company (can be overridden per employee)
  • Time In/Out: Default times for all employees

2. Employee Selection

  • Use department filter to narrow down list
  • Select employees using checkboxes
  • "Select Visible" for all filtered employees
  • "Select All" for entire list

3. Individual Customization

  • Override project/company for specific employees
  • Adjust time in/out for individual entries
  • Add specific notes or descriptions

4. Submit Bulk Entries

  • Review all selected entries
  • Click "Submit All Timesheets"
  • Entries created with "Pending" status

Master Data Management

Single Page Interface: All master data is managed from one page with tabs for Employees, Projects, and Companies

Employee Management

  • Personal information (name, designation, department)
  • Contact details (phone, email, address)
  • Professional data (experience, hourly rate)
  • User account linking

Project Management

  • Project number (unique identifier)
  • Vessel name (ship or equipment)
  • Location (geographic location)
  • Status (active/inactive)

Company Management

  • Official company name
  • Business description and notes
  • Contact information
  • Associated projects

Approval Workflow

For Supervisors/Managers/Admins

Accessing Approvals

Navigate to "Time Records" β†’ "Approvals"

Approval Process

1. Review: Check all details for accuracy
2. Verify: Confirm employee worked on specified date
3. Approve: Click green checkmark button
4. Reject: Click red X button (provide reason)

Approval History

Track Approval Activities

Access comprehensive approval history to track all approval activities and decisions.

Features

  • Historical Records: View all past approval decisions
  • Audit Trail: Complete record of who approved what and when
  • Search & Filter: Find specific approvals by date, employee, or status
  • Export Options: Generate reports for compliance

Approval Guidelines

Team Management

Supervisor/Manager Access: Team management features are available to Admin, Supervisor, and Manager roles

Employee Management

  • Manage employee records and information
  • Update employee details and assignments
  • Access employee performance data
  • Restricted to Admin and Supervisor roles

Team Overview

  • View team composition and structure
  • Monitor team performance metrics
  • Access team reports and analytics
  • Available to Admin, Supervisor, and Manager roles

Access Permissions

FeatureAdminSupervisorManager
Employee Managementβœ…βœ…βŒ
Team Overviewβœ…βœ…βœ…

Leave Management

Comprehensive Leave System: Full leave management workflow for employees, supervisors, and administrators

Leave Requests

  • Submit new leave applications
  • View pending leave requests
  • Approve/reject leave requests (Supervisors/Admins)
  • Track leave request status

My Leave Requests

  • View personal leave history
  • Submit new leave requests
  • Check leave balances
  • Available to Employee role

Leave Balances

  • Monitor leave entitlements
  • Track used and remaining leave
  • View leave balance reports
  • Admin/Supervisor access for team management

Leave Types

Supported Leave Categories

  • Annual Leave: Standard vacation entitlement
  • Sick Leave: Medical absence coverage
  • Maternity Leave: Parental leave benefits
  • Emergency Leave: Unplanned absences
  • Public Holidays: Statutory holiday management

Invoicing System

Permission-Based Access: Available to Supervisors and Admins with "can_generate_invoices" permission enabled

Generate Invoice

  • Select date range and parameters
  • Choose employees and projects
  • Auto-populated client information
  • Professional PDF generation

Manage Invoices

  • View all generated invoices
  • Status tracking (Draft, Sent, Paid, Overdue)
  • Edit and resend capabilities
  • Payment status management

Invoice Features

Reports & Analytics

Time Analytics

  • Employee summary reports
  • Project summary reports
  • Daily and period breakdowns
  • Overtime analysis
  • Permission: view_reports

Payroll Reports

  • Monthly payroll summaries
  • Department-wise breakdowns
  • Salary processing reports
  • Admin and Supervisor access

Activity Logs

  • Track all system activities
  • Monitor user actions
  • Compliance and security
  • Export for reporting
  • Admin-only access

Export Options

PDF: Formatted report for printing
Excel: Spreadsheet for analysis
CSV: Data export for other systems
Access Control: Reports are available to Admin, Supervisor, and Manager roles. The dashboard quick action and the reports page itself are permission-gated.

HRM - Payroll

Access: Available to Admin and Supervisor roles from the Dashboard HRM card or via hrm_dashboard.php.

Individual Payslips

  • Calculate net salary per employee
  • Review earnings, deductions, and net pay

Batch Processing

  • Generate payslips for multiple employees at once
  • Status tracking: Draft β†’ Generated β†’ Approved β†’ Paid

Salary Approvals

  • Two-step review and approval workflow
  • Audit trail maintained for compliance

Payment Management

  • Record payment dates and modes
  • Track outstanding payroll liabilities

Payslip Distribution

  • Distribute payslips securely
  • Maintain logs for delivery status

Payroll Reports

  • Monthly totals, department summaries
  • Exportable for accounting

Shift Rota Management

Advanced Workforce Scheduling: Comprehensive shift scheduling and rota management system

Create Rota

  • Build shift schedules with supervisors and teams
  • Assign projects and work locations
  • Set shift timings and durations
  • Permission-based access control

Supervisor Timesheet Entry

  • Mobile-friendly timesheet interface
  • Auto-load approved rotas
  • Pre-populated employee assignments
  • Supervisor and Admin access

Approve Supervisor Timesheet Entries

  • Review and approve supervisor timesheets
  • Validate rota compliance
  • Track approval progress
  • Permission-gated access

Workflow Integration

End-to-End Rota Process

1. Create: Build rota with team assignments
2. Approve: Get management approval
3. Execute: Supervisor enters timesheets
4. Finalize: Admin approval and payroll processing
Mobile Optimized: Supervisor timesheet entry is designed for mobile devices with touch-friendly interfaces.

CPF System

Compliance: CPF (Central Provident Fund) calculations for Singapore Citizens and Permanent Residents (CAT_A employees)

Wage Ceiling Enforcement

  • Ordinary Wage ceiling: $6,800/month
  • CPF calculated only on capped wages
  • Automatic ceiling application

Age-Based CPF Rates

Age BandEmployee %Employer %
≀ 5520.0%17.0%
56-6015.0%14.0%
61-659.5%10.0%
66-707.0%8.0%
> 706.0%7.5%

PR Graduated Rates

  • Year 1: Employee 5%, Employer 4-17%
  • Year 2: Employee 15%, Employer 9-17%
  • Year 3+: Full citizen rates

Self-Help Groups

  • SINDA (Indian): Wage-based contributions
  • CDAC (Chinese): Wage-based contributions
  • MBMF (Malay): Wage-based contributions
  • ECF (Eurasian): Wage-based contributions

CPF Configuration

Configuration File: cpf_config.json

The CPF system is configured through config/cpf_config.json which contains:

  • Wage ceilings (OW: $6,800, AW: $102,000)
  • Age-based CPF rate bands
  • PR graduated rate schedules
  • Self-help group contribution tables
  • Skills Development Levy (SDL) rates

Shift Rota System

Workforce Management: Advanced shift scheduling and rota management for supervisors and teams

Rota Creation

  • Create shift rotas with supervisors and team members
  • Assign projects and work locations
  • Set shift timings (Normal, Overtime, etc.)
  • Restricted to Admin/Supervisor roles

Rota Management

  • View all active shift rotas
  • Monitor approval status
  • Edit and update rota details
  • Delete cancelled rotas

Approval Workflow

  • Approve pending rotas
  • Track approval progress
  • Automatic status updates
  • Supervisor timesheet integration

Timesheet Integration

  • Load approved rotas for timesheet entry
  • Automatic employee assignment
  • Project and company pre-selection
  • Bulk timesheet creation

WhatsApp Timesheets

Automated WhatsApp Timesheets (Supervisors/Admins)
  • Fortnightly Periods: Automatically aligns to 1–15 and 16–end-of-month
  • Monospace Format: Clean, per-day lines for easy reading and pasting
  • Leave Integration: Leave entries included alongside work days
  • Brand Greeting: Message prefixed with tenant brand greeting
  • Access: Time Records β†’ WhatsApp Timesheets

Enhanced Status Tracking

Workflow Management: Advanced timesheet approval status tracking with real-time progress monitoring

Status Progression

  • timesheets_under_approval - Approval process started
  • timesheets_partially_approved - Some approved, some pending
  • timesheets_fully_approved - All timesheets approved
  • timesheets_rejected - Some/all timesheets rejected

Progress Tracking

  • Real-time approval counters
  • Total, approved, rejected, pending counts
  • Approval start and completion timestamps
  • Progress indicators in dashboard

Automatic Updates

  • Status changes trigger rota status updates
  • Real-time synchronization
  • No manual intervention required
  • Consistent workflow state

Dashboard Integration

  • Status badges display current state
  • Progress bars show completion percentage
  • Quick action buttons for approvals
  • Filtered views by status

Approval Workflow

Status Transition Flow

Rota Created β†’ Timesheets Submitted β†’ Under Approval β†’ Partially Approved β†’ Fully Approved
                                                                ↓
                                                          Rejected

Salary Templates

Flexible Payslips: JSON-based salary slip templates for customizable payroll processing

Template Configuration

  • JSON-based template system
  • Configurable earnings components
  • Customizable deduction items
  • Formula-based calculations

Automatic Calculations

  • Hourly rate auto-calculation
  • Overtime multipliers (1.5Γ— weekdays, 2.0Γ— Sunday/PH)
  • Formula-based totals
  • Net pay computation

Professional Output

  • HTML formatted payslips
  • Company branding
  • Detailed breakdown
  • Print-ready format

Extensible Design

  • Easy to add new components
  • Multiple template support
  • Custom calculation rules
  • Validation and error handling

Template Structure

Configuration File: workpass_cat_c_template.json

Located in config/salary_templates/, contains:

  • Company Details: Branding and contact information
  • Earnings: Basic pay, overtime, allowances, incentives
  • Deductions: Utility, advances, leave deductions
  • Calculation Rules: Multipliers, standard hours, formulas
  • Display Options: Formatting and layout preferences

System Administration

Admin Only: System administration features are restricted to administrators only

User Management

  • Create and manage user accounts
  • Assign roles and permissions
  • Reset passwords and credentials
  • Activate/deactivate accounts

Role Permissions

  • Configure role-based access control
  • Manage permission assignments
  • Set up custom permission rules
  • Audit permission changes

System Diagnostics

  • Check system health and performance
  • Database connection verification
  • PHP and server diagnostics
  • Export diagnostic reports

Backup Management

  • Create system backups
  • Manage backup schedules
  • Restore from backups
  • Monitor backup status

Developer Panel

Advanced Development Tools

Access: Super Admin role only

  • Advanced system configuration
  • Database schema management
  • System performance monitoring
  • Development and debugging tools
Critical Functions: System administration features control the core functionality and security of the application. Changes should be made with caution and proper testing.

Permissions Overview

Roles Γ— Modules Matrix

For a complete, always-up-to-date view of role permissions and navigation visibility, use the built-in page:

  • System Management β†’ Permissions Overview (permissions_overview.php)
  • Static reference: ROLES_MODULES_MATRIX.md in the repository
Note: Some actions (e.g., invoicing) require both role permission and an explicit user flag (e.g., can_generate_invoices).

User Management

Admin Only: User management functions are restricted to administrators
Adding New Users
  1. Go to "System Management" β†’ "User Management"
  2. Click "Add User" button
  3. Fill user information:
    • Username: Unique login name
    • Password: Secure password
    • Role: Admin/Supervisor/Manager/Employee
    • Employee Link: Connect to employee record
    • Status: Active/inactive
  4. Click "Create User"

Security Settings

System Diagnostics

Professional Diagnostic Interface

Access comprehensive system health checks through "System Management" β†’ "System Diagnostics"

Database Tests

  • Connection verification
  • Query execution tests
  • Critical tables check
  • MySQL version info

System Health

  • PHP version compatibility
  • Memory usage monitoring
  • Required extensions check
  • Disk space analysis

Session Management

  • Session status verification
  • Configuration check
  • Security settings audit
  • Current session info

File System

  • Write permissions test
  • Critical files verification
  • Configuration files check
  • Environment validation

Support Features

Troubleshooting

Login Problems
Issue: Cannot login to system
  • Verify username and password
  • Check caps lock status
  • Clear browser cache and cookies
  • Try different browser
  • Contact system administrator
Timesheet Errors
Issue: Error when submitting timesheet
  • Check all required fields are filled
  • Verify date format is correct
  • Ensure time out is after time in
  • Refresh page and try again
  • Check internet connection
Filter Issues
Issue: Filters not showing correct data
  • Refresh the page
  • Clear browser cache
  • Check if JavaScript is enabled
  • Try different filter options
  • Contact support if persistent
Button Issues
Issue: Edit buttons not responding
  • Refresh the page
  • Check browser JavaScript console
  • Disable browser extensions temporarily
  • Try different browser
  • Clear browser cache

Getting Help

24/7 Professional Support

Email Support

[email protected]

Website

https://scubeinfotech.com.sg

Company

SCUBE Infotech Pvt. Ltd.

Singapore

Professional IT Solutions & Enterprise Software Development

Information to Provide When Contacting Support

Best Practices

For Employees

  • Submit timesheets daily for accuracy
  • Record exact start and end times
  • Provide clear work descriptions
  • Check timesheet status regularly
  • Fix rejected entries quickly

For Supervisors

  • Review and approve within 24 hours
  • Verify all timesheet details
  • Provide specific rejection reasons
  • Apply approval criteria uniformly
  • Maintain approval notes for audit

For Administrators

  • Ensure regular data backups
  • Provide adequate system training
  • Keep system updated
  • Monitor system performance
  • Review user permissions regularly

Data Security

  • Use strong, complex passwords
  • Change passwords periodically
  • Don't share login credentials
  • Always logout when finished
  • Report security concerns immediately