Employees
Manage your workforce with a centralized employee directory, detailed profiles, and integrated HR data.
The Employees module is your central hub for managing every person in your organization. It provides a searchable directory of all employees, with rich detail pages that consolidate HR information -- from personal details and attendance records to payroll history and leave balances -- all in one place.
Navigation: Employees
Who Uses This Module
| Role | Typical Actions |
|---|---|
| HR Manager | Add new employees, update personal information, manage department assignments, review attendance |
| Finance Manager | Review payroll history, check loan balances, verify allowance and benefit assignments |
| Operations Manager | View working schedules, check attendance patterns, review group permissions |
| Administrator | Full access to all employee data, configure permissions, manage organizational structure |
Purpose
Every fleet and transport operation depends on its people. The Employees module gives your team a single source of truth for workforce data:
- Maintain a complete directory of all employees with contact details, department assignments, and role information
- Track attendance, leave balances, and working schedules without switching between modules
- View financial data such as payroll history, loans, and allowances directly from the employee profile
- Manage permissions and group assignments to control what each employee can access
- Onboard new hires quickly with a structured creation form
Module Structure
The Employees section is organized around four key routes:
| Page | Route | Description |
|---|---|---|
| Employee List | /employees | Browse, search, and filter all employees |
| Create Employee | /employees/create | Add a new employee to the system |
| Edit Employee | /employees/edit/:id | Update an existing employee's information |
| Employee Detail | /employees/detail/:id | View the full employee profile with tabbed sections |
What You Will See
The main Employee List page displays a table of all employees with key information at a glance.
Table Columns
| Column | Description |
|---|---|
| Name | The employee's full name, displayed with an avatar or initials |
| The employee's email address | |
| Department | The department the employee belongs to |
| Role | The employee's assigned role in the system |
| Status | Whether the employee is currently Active or Inactive |
| Join Date | The date the employee joined the organization |
Searching and Filtering
Use the search bar at the top of the table to find employees by name or email. The search updates results as you type, making it fast to locate a specific person even in large organizations.
You can also filter the list by:
- Department -- Show only employees belonging to a specific department
- Status -- Filter by Active or Inactive employees
The employee list uses pagination to keep the page responsive. Use the page controls at the bottom of the table to navigate through results. You can also change the number of rows displayed per page.
Actions
From the Employee List, you can:
- Click on any row to open that employee's detail page
- Click "Create Employee" to add a new employee
- Use the action menu on each row to quickly edit or view employee details
Key Concepts
Employee vs. User
In TransportechAI, an employee represents the HR record -- personal information, department assignment, and employment details. A user represents the login account and system access. Every employee has an associated user account that determines what they can access in the platform.
Departments
Employees are organized into departments. Departments are configured in the Settings module and help with reporting, filtering, and organizational structure. Each employee belongs to exactly one department.
Status
Employees can be in one of two statuses:
- Active -- The employee is currently employed and their account is operational
- Inactive -- The employee has been deactivated (e.g., left the company). Inactive employees are retained in the system for historical records but cannot log in
Deactivating an employee does not delete their data. All historical records -- attendance, payroll, loans, and leave -- are preserved for audit and reporting purposes.
Next Steps
- Creating an Employee -- Step-by-step guide to adding a new employee
- Employee Detail Page -- Understand the employee profile layout and navigation
- Employee Tabs Guide -- Detailed guide for each tab on the employee detail page