Navixy Repository: Entity-centric data management for telematics & IoT

Many organizations working with entities and field operations face a common issue: they have to manage telematics data and business data separately, often across different systems or disconnected databases, create custom entities and assign custom attributes to reflect their operational models. This fragmentation leads to increased complexity, inefficiencies, and a lack of flexibility when modeling real-world processes.

Navixy Repository solves this problem by providing a unified modeling layer. This architecture allows users to combine entities, their attributes, and the relationships between them, as well as location, sensor, and event data, making it easier to work directly with these links. Although telematics and business data reside in separate storage systems, the Navixy Repository unifies all business data, enabling seamless integration and delivering real-time insights across both operational and geospatial contexts.

What is Navixy Repository?

Navixy Repository is a high-performance, PostgreSQL-based system designed for unified modeling of business data. Using JSONB for storing semi-structured metadata, it supports both entity modeling and real-time telemetry ingestion in a single data schema. With a RESTful API, technical teams can define custom entities such as trucks, geofences, departments, groups, and associate them with sensor inputs, spatial boundaries, and inter-entity relationships.

The current version focuses on five core features:

• Custom entity types: Organizations can define and manage their own entity types tailored to specific operational domains.
• Flexible properties: Entities can include custom properties in the form of text, numbers, timestamps, coordinates (geojson format), and master devices
• Device binding: GPS trackers and other telematics devices can be assigned to entities for real-time data capture.
• Relationship mapping: Logical relationships between entities (e.g., vehicle-driver, equipment-project) can be defined and queried.
• Integrated telematics flow: The repository allows users to define business objects and attributes at a separate modeling layer, and then associate objects with data in the telematics system.

Entity-centric approach

While many modern telematics platforms have moved toward asset-oriented models, they often remain limited in the variety of entities. Navixy Repository extends this paradigm by introducing a dedicated business data layer where companies can define operational entities such as trucks, departments and groups, sites, or containers with full flexibility. These entities are not tied to devices by default, but can be linked to them when needed, enabling a clean separation between business modeling and data acquisition.

Devices serve as the primary sources of telematics data, delivering real-time and historical insights such as location, speed, temperature, and other key performance indicators. At the same time, business entities and their attributes act as sources of business data, capturing operational, organizational, and contextual details that complement and enrich telematics inputs. By linking these telemetry streams to business entities, the system enables accurate modeling of real-world relationships while maintaining modularity, scalability, and compatibility with diverse operational workflows.

Each entity in the Navixy Repository can hold an unlimited number of properties using different field types, including text, numbers, dates, geographic boundaries, and structured JSON data. For example:

• A container entity might store business data such as temperature thresholds, cargo type, and route assignment, while its linked devices in the business database act as the actual sources of telematics data
• A technician entity can store certifications, shift times, and assigned tasks
• A geofence entity can be linked with regulatory constraints or maintenance windows

All this information is structured, queryable. There's no need to manage multiple disconnected systems to analyze operations holistically.

Navixy Repository allows users to define how entities interact. This may include temporary or permanent connections: which driver is currently assigned to which truck, which assets are distributed among a group of specialists at the construction site, and how the hitch traveled to its destination. This dynamic relationship engine supports fluid business models, where assignments, availability, and constraints change daily. Querying these relationships becomes a native part of the data structure rather than requiring custom code.

Technical integration and API capabilities

Navixy Repository is designed to bridge the gap between operational reality and digital systems, enabling companies to model, monitor, and manage their assets and operations with exceptional precision. Built on a fully documented REST API that follows the OpenAPI standard, it serves as a powerful integration layer between business data and telematics flows, allowing organizations to create and manage entities, define complex relationships, and connect them to real-time data sources without disrupting existing infrastructure.

This architecture allows businesses to define any type of trackable entity with the exact properties they need whether it is a truck, a warehouse, a piece of machinery, or a livestock herd and to establish relationships that reflect real-world operations. These connections make it possible to implement advanced workflows, from end-to-end logistics chains and preventive equipment maintenance to agricultural monitoring and field operations coordination.

Navixy Repository synchronizes in real time with the Navixy DataHub, ensuring that updates from devices such as location changes, fuel levels, and sensor readings are instantly captured, stored, and made available for analysis in a unified data model. This live data stream, enriched with business context, becomes a foundation for strategic and tactical decision-making.

Advanced querying capabilities support filtering, sorting, geographic logic, and telemetry streaming to Apache Kafka, enabling real-time analytics, AI- and ML-powered data modeling, and the creation of dynamic dashboards and reports. By combining business context with live telemetry, the architecture not only enhances operational visibility but also provides actionable insights, helping companies increase efficiency, reduce risks, and respond faster to changing conditions..

Device integration and data collection

The platform supports GPS devices and sensors, accommodating everything from basic location trackers to sophisticated IoT networks. Its architecture allows organizations to build complex monitoring solutions that combine location tracking with environmental sensing, equipment diagnostics, and specialized data collection requirements. Device activation and management occur through the same API that handles entity creation and relationship management, providing operational consistency across all platform functions.

API capabilities and system integration

The API provides sophisticated querying capabilities, conditional filtering with logical operators, range queries for numeric and date fields, and flexible sorting with multiple field support. These features enable organizations to build custom interfaces, automated workflows, and data analysis tools that make effective use of their entity data.

Using the Navixy Repository API, you can create, read, update, and delete business assets with ease and also leverage advanced listing with filters and sorting. For example, to retrieve Toyota assets created after a specific date that belong to certain asset categories, sorted alphabetically by name with newest entries first, you would send a POST request to the /asset/list endpoint. In this request, you specify a text search parameter “Toyota,” combine filters with an AND condition — one filter using the "gte" operator on the created_at field and another using the "in" operator for multiple type_id values — and then add multi-field sorting rules (first by label in ascending order, then by created_at in descending order) along with pagination parameters such as limit and offset.

Integration possibilities span enterprise resource planning systems for financial synchronization, customer relationship management platforms for service delivery tracking, business intelligence tools for performance analysis, and custom applications developed for unique operational requirements.

Security and compliance framework

Navixy Repository implements multi-tenant isolation via PostgreSQL token-based tenant isolation, ensuring strict boundary enforcement across organizational data. OAuth 2.0 authentication combined with access scopes API keys provides fine-grained access control for service integrations. Rate limits, audit logs, and encrypted-at-rest storage ensure the system can scale securely. Regional deployment options address data residency and compliance needs for cross-border operations..

Navixy ecosystem integration

Navixy Repository operates within a large-scale telematics ecosystem, including the existing Navixy API for location tracking, route analysis, and sensor data collection and IoT Logic for no-code data processing capabilities and combining all your data in Data Hub, a private telematics lakehouse with easy access. When devices are activated, they automatically become available across all Navixy APIs, enabling organizations to access full telematics capabilities while maintaining rich entity context and relationships. This evolutionary approach ensures organizations can begin building scalable infrastructure immediately while having a clear path toward complete fleet management functionality.

Making the transition

For teams managing separate streams of business data and telemetry data, Navixy Repository simplifies system design by providing a centralized layer for defining and managing user objects and their metadata. This is achieved through APIs that make entity modeling, relationship management, and integration into operational workflows more accessible and consistent. While real-time telemetry data continues to reside in specialized storage for optimal performance, the Repository provides a unified interface for linking that telemetry with business entities, managing schema, and performing contextual queries. This approach allows development teams to work within a single, consistent API and schema environment.

Rather than adapting business workflows to rigid device configurations, organizations can define their own entity types, establish relationships between them, and attach relevant attributes that reflect actual usage.
This flexible approach transforms telematics from raw data streams into actionable context, making day-to-day operations clearer, more efficient, and better connected to business outcomes.

Contact us to explore how Navixy Repository can address your organization's specific asset management requirements and support your transition toward comprehensive fleet management capabilities.