Skip to main content

Offline Tracking

This module is used to track employee device status and activity data when they are in the field. It provides bulk API endpoints for the mobile app to sync device status and activity updates, and includes a route analysis report for administrators.

Features

  • Bulk Device Status Sync - Mobile app syncs device status updates in bulk to the server
  • Bulk Activity Status Sync - Mobile app syncs activity status updates (travelling, still, etc.) in bulk
  • Route Analysis Report - Web-based report analyzing employee travel patterns, distances, speeds, and efficiency

Requirements

  • Open Core Business Suite (Base System)
  • Mobile app with location and activity tracking capabilities

Installation

Enable via Admin Panel

  1. Log in as administrator
  2. Navigate to Settings > Addons
  3. Find Offline Tracking and click Enable
  4. Run migrations if prompted

Enable via Command Line

php artisan module:enable OfflineTracking
php artisan migrate

Usage

Route Analysis Report

The route analysis report is available in the admin panel and provides insights into employee field activity:

  1. Navigate to Offline Tracking > Reports > Route Analysis
  2. Filter by date range and employee
  3. View statistics including:
    • Total estimated distance traveled
    • Travel time vs. still time
    • Average and maximum speeds
    • Activity type distribution (travelling, still, etc.)
    • Speed range breakdown
    • Distance by employee
    • Fuel cost estimation
    • Efficiency score (travel time as percentage of total time)

Mobile App Integration

The mobile app uses API endpoints to sync data collected while employees are in the field:

  • Bulk Device Status Update - Sends batched device status updates to the server
  • Bulk Activity Status Update - Sends batched activity recognition data (travelling, still, etc.) to the server

Data is collected on the mobile device and synced to the server when connectivity is available.


Changelog: View version history