[ SYSTEM MANUAL ]

PROJECT OVERVIEW//Geospatial Intelligence

Aether Tracking

A clean, production-ready, real-time location tracker built with React (Vite) and Node.js/Express + Socket.IO.

// STATUSLIVE

// VERSIONv2.0.0

// ENGINENode.js

// REPO VERSION1.0.0-Stable

Interactive Platform Preview

AETHER GEOSPATIAL RADAR

SOCKET CONNECTED

LATENCY // 12msOSRM HOPS // 3 Nodes

01 / Project Detail & Scope

Aether Tracking is a real-time location tracker built by Vanshika (Frontend) and Lokesh (Backend & Architecture). It supports multiple tabs/clients, robust state synchronization, and structured server-side logging of users and coordinates, overlaid onto interactive Leaflet maps.

// THE PROBLEM STATEMENT

Executing real-time coordinate streaming requires highly performant client-side state hooks to manage map updates without triggering UI lag, connection health loss, or memory locks during reconnects.

02 / Architectural Topology

Low-latency system boundaries and data routing graphs mapping internal transaction flows:

+-----------------------------------------------------------+ | AETHER CLIENT | | | | +--------------------+ +--------------------+ | | | Leaflet Map Canvas |<=========>| useUserDistances | | | | (Realtime Markers) | | (Socket Hook) | | | +--------------------+ +--------------------+ | | | | | +-----------v---------------------------------v-------------+ | WebSocket Telemetry | RPC Event v v +-----------------------------------------------------------+ | BACKEND CLUSTER | | | | +--------------------+ +--------------------+ | | | Socket.IO Backend |<=========>| Express server.js | | | | (Distance Emitters)| | (Coordinate Logs) | | | +--------------------+ +--------------------+ | +-----------------------------------------------------------+

03 / Key Features

FEAT_01

Real-time Tracker

Coordinates broadcasted dynamically across all active clients at sub-second rates.

FEAT_02

Leaflet Map Canvas

Interactive leaflet map wrapper with dynamic user location markers.

FEAT_03

Connection Health

Monitors health parameters and triggers auto-reconnection on network dropouts.

04 / Technology Blueprint & Decisions

// BACKEND STACKS

Node.js

Express

Socket.IO

// FRONTEND ASSETS

React

Vite

Leaflet

Tailwind CSS

// DB ENGINES

Local State Storage

// PLATFORMS

WebSocket engine

// HISTORICAL DECISION RECORDS

DECISION // Leaflet

Lightweight mapping engine offering native zoom and touch control capabilities.

DECISION // Socket.IO

Provides full duplex frame sockets support for location updates and health checks.

05 / Technical Specification Manual

Friend Location Tracking & Collaborative Dispatching

Aether Tracking coordinates exact, real-time location mapping across clients. Built around secure, shareable collaboration URLs, users share their exact positions dynamically.

Coordinate Streaming Mechanics

1.**Sub-Second Location Sync**: Client devices acquire GPS coordinate parameters. These coordinates are broadcasted across connected sessions using high-speed socket streams.

2.**Performance Leaflet Canvas**: Markers are rendered onto a client-side mapping canvas. To optimize rendering performance, marker updates are batched, preventing UI lag during map pans.

3.**Volatile Server State**: Connected socket IDs and coordinates are stored in volatile server-side memory for maximum throughput. Location histories are kept stateless to protect privacy.

Network Resiliency Loops

To ensure constant synchronization during transit:

**Connection Health Checks**: Active clients exchange light telemetry pings with the gateway.

**Auto-Reconnection**: If connection health dips during network handovers, client hooks execute immediate back-off retry loops to restore state synchronization.