TripTrack is a real-time GPS device monitoring and tracking platform, designed to visualize routes, manage devices, and analyze trajectories through a modern web interface.

The system is based on the open-source Traccar software, which has been extended and modified to adapt to new use cases such as:

• Tourism agencies
• Mobile workforce monitoring
• Logistics tracking
• IoT device monitoring

TripTrack allows users to visualize real-time locations, analyze traveled routes, and manage devices from a centralized web dashboard.

🎥 System Demo

📡 Main Features

• 📍 Real-time GPS device tracking
• 🗺️ Historical route visualization
• 👥 Management of multiple devices
• ⚠️ Custom alerts and events
• 📊 Trajectory analysis
• 🧭 Interactive dashboard with maps
• 🔗 Integration with external databases
• ⚙️ Extensible architecture

📱 How the System Works

The system uses a mobile application that sends GPS location data to the server.

System Workflow

    Mobile Device
    │
    │ GPS
    ▼
    Traccar Client
    │
    │ Location Data
    ▼
    Traccar Server
    │
    ▼
    TripTrack Backend
    │
    ▼
    Web Dashboard (React)

1️⃣ The tourist or worker installs Traccar Client
2️⃣ The phone sends its GPS location to the server
3️⃣ TripTrack receives the information
4️⃣ The administrator visualizes the locations in the web dashboard

🧭 Use Cases

TripTrack can be used in different scenarios:

Tourism

• Tracking tourist groups
• Prevention of lost tourists

Logistics

• Monitoring of delivery vehicles
• Management of small fleets

Mobile Workforce

• Tracking street vendors
• Monitoring field workers

IoT

• GPS devices
• Mobile sensors

🏗️ Project Architecture

    TripTrack/
    ├── backend/
    │ ├── api/
    │ ├── services/
    │ └── controllers/
    │
    ├── frontend/
    │ ├── components/
    │ ├── pages/
    │ └── styles/
    │
    ├── database/
    │ ├── migrations/
    │ └── schema.sql
    │
    ├── config/
    │
    └── README.md

⚙️ Technologies Used

🚀 Installation

1️⃣ Clone the repository

git clone https://github.com/tuusuario/triptrack.git
cd triptrack

2️⃣ Install frontend dependencies

npm install

3️⃣ Run the frontend

npm start

4️⃣ Run the backend

./gradlew run

🧰 System Requirements

Before running TripTrack make sure you have installed:

• Java 8
• Node.js
• npm
• Gradle / gradlew
• MySQL or PostgreSQL
• Git

Optional:

• Docker
• Docker Compose

📲 Required Mobile Application

To send GPS location data it is necessary to install the application:

Traccar Client

Available on:

Android
https://play.google.com/store/apps/details?id=org.traccar.client

This application works as a background service that sends location data to the server in real time.

🗺️ Tracking Features

TripTrack allows users to visualize:

• 📍 Current device location

• 🧭 Historical trajectory

• ⏱️ Idle time

• ⚠️ Generated events

• 📊 Movement statistics

⚖️ License

This project is based on Traccar, distributed under the Apache License 2.0.
Additional modifications and extensions have been implemented on top of the original project.

Original project:
https://github.com/traccar/traccar

📧 Contact

• Email: slrv.ramosv@gmail.com
• LinkedIn: sergioramosvillena
• Phone: +51 3932416666

Made with ❤️ by Sergio Ramos and Cledy Becerra | 2024