BTWorkforce Documentation

Complete documentation for the BTWorkforce HR & Payroll Management System.

1. System Introduction

BTWorkforce is an awesome, modern HR & Payroll management system built with cutting-edge technology. It provides a complete solution for organizations to manage their workforce efficiently with multiple salary structures.

2. User Roles & Access Structure

BTWorkforce has a hierarchical role structure with 4 levels:

3. Modules Overview

4. Employee Management Module

4.1 Overview

The Employee Management module handles all employee-related operations including adding, viewing, editing, and managing employee records with different salary types.

4.2 Features

• Employee CRUD - Create, view, edit, delete employees
• 3 Salary Types - Monthly, Hourly, Production Worker
• Department & Designation - Organizational structure
• Employee Profile - Complete details with documents
• Status Tracking - Active/Inactive employees

4.3 Salary Types

4.4 User Roles Access

5. Attendance Tracking Module

5.1 Overview

The Attendance Tracking module monitors employee attendance, working hours, overtime, and provides multiple views for different needs.

5.2 Attendance Views

5.3 Status Types

• Present - Full day present
• Late - Arrived late but marked present
• Absent - Did not mark attendance
• Half Day - Worked half day
• Early Exit - Left before end of shift

5.4 Overtime Calculation

Hours beyond shift duration = Overtime

5.5 Features

• Manual attendance entry
• Auto-processing from device logs
• Weekend & Holiday handling
• Color-coded status display
• Export to PDF/CSV

6. Payroll Management Module

6.1 Overview

The Payroll Management module handles salary calculation, processing, approval, and payment tracking for all employees.

6.2 Payroll Workflow

6.3 Payroll Actions

• Process - Draft → Processed (Validates calculations, locks payroll)
• Approve - Processed → Approved (Manager reviews, cannot edit after)
• Mark as Paid - Approved → Paid (Records payment method & transaction ID)

6.4 Payment Methods

6.5 Payroll Adjustments

Bonus Types

• Festival Bonus
• Performance Bonus
• Attendance Bonus
• Other

Allowance Types

• Transport Allowance
• Food Allowance
• House Rent Allowance
• Medical Allowance
• Other

Deduction Types

• Late Arrival Deduction
• Absent Deduction
• Tax Deduction
• Other Deductions

6.6 Payslip Generation

PDF payslip includes:

• Employee details
• Salary breakdown
• Overtime details
• Production earnings (for production workers)
• Bonuses & Allowances itemized
• Deductions itemized
• Net salary
• Payment Mode & Transaction ID (if paid)

7. Production Worker Module

7.1 Overview

The Production Worker module manages production items, tracks daily production logs, and calculates earnings for workers paid based on output.

7.2 Production Items

Define items that can be produced with rates:

• Item Name - e.g., "Shirt", "Pant", "Piece"
• Unit - e.g., piece, kg, meter
• Rate per Unit - ₹
• Status - Active/Inactive

7.3 Production Logs

Record daily production by workers:

• Employee (Production Worker type)
• Production Item
• Work Date
• Quantity Produced
• Rate (auto-filled from item)
• Total Amount (auto-calculated)
• Notes

7.4 Salary Calculation

7.5 Example

• Base Salary (Monthly): ₹10,000
• Shirts: 100 pieces × ₹50 = ₹5,000
• Pants: 50 pieces × ₹80 = ₹4,000
• Total Production: ₹9,000
• Bonus: ₹500
• Allowances: ₹1,000
• Total = ₹10,000 + ₹9,000 + ₹500 + ₹1,000 = ₹20,500

8. Reports Module

8.1 Available Reports

8.2 Export Options

• PDF - For printing/sharing
• CSV - For Excel/data analysis

8.3 Filters

• Date Range (Start/End)
• Company (Super Admin only)
• Employee (optional)
• Department (where applicable)
• Status (Active/Inactive)
• Salary Type

9. User Management Module

9.1 User Roles

9.2 Authentication

• Login - Email + Password
• Registration - By invitation only
• Password Reset - Email with reset link

9.3 Dashboard Views

Each role sees different dashboards:

• Super Admin - All companies overview, total stats
• Company Admin - Company statistics, monthly summary
• HR Manager - Team attendance, pending approvals
• Employee - My attendance, My payslips

10. Biometric Integration

10.1 Overview

BTWorkforce supports integration with ZKTeco biometric attendance devices for automatic attendance tracking. This feature is available in the Professional plan.

10.2 Supported Devices

10.3 Features

• Real-time Sync - Automatic attendance data sync
• Auto Check-in/Check-out - Records in/out automatically
• IP Configuration - Static IP setup for devices
• Port Configuration - Default port 4370
• Device Management - Add/Edit/Remove devices
• Connection Status - Monitor device online/offline

10.4 Configuration Steps

1. Go to Settings → Device Configuration
2. Click Add New Device
3. Enter device details:
   • Device Name
   • IP Address
   • Port (default: 4370)
   • Company
4. Click Save
5. Test connection

10.5 Device Letter Generation

Generate official configuration letters for IT teams to set up devices:

• Network configuration requirements
• Server details
• IP and port specifications
• Authorization for technicians

10.6 Troubleshooting