ShaloTrack API v0.4.0

ShaloTrack API v0.4.0 – Telemetry Foundation Release

Release Date: 2026-07-06

🚀 Overview

This release marks the transition from a business management API to a real-time GPS tracking platform. It introduces the first telemetry-focused APIs, allowing clients to retrieve live GPS information from devices connected through the ShaloTrack Gateway, alongside significant architectural improvements to support high-performance read queries.

---

✨ New Features

📍 Current Location API

New query-oriented architecture built around projections rather than full entity retrieval.

Implemented:

• Projection-based queries
• Read-only repository pattern
• Live vehicle locations
• Vehicle lookup
• Device lookup

Endpoints:

• GET /api/currentlocations
• GET /api/currentlocations/vehicle/{vehicleId}
• GET /api/currentlocations/device/{deviceId}

📡 Device Status API

Implemented:

• Online Status
• Battery Level
• GPS Signal
• Ignition Status
• Movement Status
• Power Status

Endpoints:

• GET /api/devicestatus
• GET /api/devicestatus/device/{deviceId}
• GET /api/devicestatus/vehicle/{vehicleId}

---

🏗 Architecture Improvements

This is the biggest part of this release: the introduction of the Query Repository Pattern for telemetry data.

Before: every repository returned full entities.

Now: telemetry modules follow a dedicated read pipeline:

Projection → DTO → Repository → Service

Expression Mapping

Introduced Expression<Func<TEntity, DTO>> for query projections.

Benefits:

• No duplicated mappings
• Better EF Core SQL generation
• Faster queries
• Easier maintenance

Read vs. Write Separation

Business Modules	Telemetry Modules
Repository → UnitOfWork → Service	Repository → Projection → Service

---

Summary of Existing Modules (for context)

Authentication

• JWT Authentication
• Login API
• Authorization foundation

Customer Management

• Create / Update / Retrieve Customers
• Soft Delete
• Duplicate validation

Vehicle Management

• Vehicle CRUD
• Customer-Vehicle relationship
• Duplicate Vehicle Number validation
• Chassis / Engine validation

GPS Device Management

• Register GPS Device
• IMEI / SIM validation
• Activation Status, Firmware, Installation Details, Warranty Tracking

Device Assignment

• Assign / Unassign Device
• Assignment History
• Active Assignment Validation
• Transaction Support
• Business Rule Enforcement

---

⏭ Next Release (v0.5.0)

• GPS Tracking API
• Device Events API
• Raw Packet API
• Filtering
• Pagination
• Production Hardening

---

Git Tag

git add .
git commit -m "feat(api): implement Current Location and Device Status telemetry APIs"
git push origin main
git tag -a v0.4.0 -m "ShaloTrack API v0.4.0 - Telemetry Foundation Release"
git push origin v0.4.0

---

GitHub Release

Tag: v0.4.0

Title: ShaloTrack API v0.4.0 - Telemetry Foundation Release

Description:

## 🚀 Highlights
This release marks a major milestone in the ShaloTrack API by introducing the first telemetry-focused modules alongside significant architectural improvements.
✨ New Features

📍 Current Location API
📡 Device Status API
Projection-based query architecture
Expression-based DTO mapping
Read-only telemetry repositories

✅ Completed Modules

Authentication
Customer Management
Vehicle Management
GPS Device Management
Device Assignment
Current Location
Device Status

🏗 Architecture

Repository Pattern
Unit of Work
Query Repository Pattern
Projection Mapping
Dependency Injection
Layered Architecture

⏭ Coming Next

GPS Tracking
Device Events
Raw Packets
Filtering & Pagination
Production Hardening