ATLAS — Adaptive Time-Series Analytics and Logging System Image


React 19 Spring Boot TimescaleDB MQTT Redis Docker Java 21

Status Version License Services University


A production-grade, domain-agnostic IoT monitoring and risk management platform
built for government and critical infrastructure — from rivers to smart cities.


ATLAS – Adaptive Time-Series Analytics and Logging System

Domain-Agnostic Government Monitoring Platform

Team

Supervised by: Prof. Kamalanath Samarakoon
Module: CO2060 – Software Systems Design
Department of Computer Engineering, University of Peradeniya, Sri Lanka

Table of Contents

  1. Introduction
  2. Live Dashboard Preview
  3. System Design
  4. System Architecture
  5. Feature Deep-Dives
  6. End Product
  7. Conclusion

Introduction

ATLAS (Adaptive Time-Series Analytics and Logging System) is a domain-agnostic monitoring and management platform designed to be adapted by multiple government organizations.

While the primary use case is Integrated Hydro Risk Management, the system is architected to support any domain requiring:

The platform connects IoT field sensors → MQTT message broker → intelligent backend services → interactive GIS dashboard, delivering a complete real-time situational awareness system for decision-makers and field operators.

ATLAS enables:

The ATLAS (Adaptive Time-Series Analytics and Logging System) is a full-stack, microservices-based monitoring platform engineered for “Integrated Hydro Risk Management”: with the architectural flexibility to serve any domain involving field sensors, real-time data, and risk alerting platform.

Domains ATLAS can serve out-of-the-box using different sensor sets:

Originally developed as the primary use case for flood and hydrological risk monitoring across Sri Lankan river systems, ATLAS is built to scale seamlessly into irrigation networks, power distribution, environmental monitoring, and smart city infrastructure.


Live Dashboard Preview

Hydro Risk Management Project Demo

Real-time GIS mapping, telemetry analytics, and intelligent alert management - all in one platform

     
GIS Live Map
Interactive Leaflet map with animated, severity-coded sensor markers and fly-to animations
MQTT Data Ingestion
Persistent, auto-reconnecting subscriber with batch writes to TimescaleDB every 8 seconds
4-Level Alert Engine
Cron-based sliding-window evaluation with escalation, de-escalation, and auto-resolution
Analytics Dashboard
Health score gauges, battery charts, occurrence timelines, threshold donut charts — auto-refreshed
JWT + RBAC Security
15-min access tokens, HttpOnly refresh cookies, Redis blacklisting, and role-gated routes
PDF Report Generation
Download telemetry and alert history reports for any date range via iText + Thymeleaf
Microservices Architecture
7 independently deployable services, each owning its domain — orchestrated by Docker Compose
Domain-Agnostic
Adapt to any sensor domain without touching core code — just register types, sites, and thresholds
One-Command Deployment
docker compose up --build -d launches the entire 9-container stack in under 5 minutes



System Design

Real-Time Data Flow


Technology Stack

Frontend Backend Infrastructure
Framework Framework Containers
Language Language Web Server
UI Library Database Broker
Maps Cache CI/CD
Charts Security
HTTP MQTT
Router PDF

System Architecture

The platform follows a clean microservices topology with a shared TimescaleDB at the core, fronted by a React 19 SPA served through Nginx.

Service Tech Stack Responsibility
MQTT Ingestion Spring Boot 4, Eclipse Paho, TimescaleDB Subscribes to MQTT topic; validates, buffers, and batch-writes sensor telemetry into hypertables
Metadata Service Spring Boot 4, PostgreSQL, Redis, Swagger Full CRUD REST API for Sites, Sensors, and SensorTypes with JWT protection and OpenAPI docs
Alerting Service Spring Boot 4, PostgreSQL, Spring Scheduler Cron-based DDD engine that creates, escalates, and auto-resolves 4-level threshold alerts
Report Service Spring Boot 4, iText, Thymeleaf, PostgreSQL Generates downloadable PDF reports from historical telemetry and alert data
User/Auth Service Spring Boot 4, JWT, Spring Security, Redis Authentication, JWT lifecycle management, Redis-backed blacklisting, and RBAC
GIS Service Spring Boot 4, PostgreSQL Read-optimized aggregation API serving sensor positions, telemetry, and alerts for the map
Frontend React 19, Vite 7, Ant Design 5, Leaflet, Recharts Interactive monitoring SPA with GIS map, analytics charts, and metadata management


ATLAS System Architecture Diagram


ATLAS System Architecture Diagram

Architecture and Design Decisions

  1. Shared TimescaleDB: A single shared database simplifies the architecture, enables easy joins across services, and centralizes backups.

  2. TimescaleDB Extension: The TimescaleDB extension provides efficient time-series querying and automatic time-based data partitioning.

  3. Public MQTT Broker: A public MQTT broker eliminates the need to manage broker infrastructure during development and demonstrations.

  4. Cron-Based Alerting (Pull): Periodic cron-based evaluation keeps alerting simple, stateless, and easy to restart.

  5. Buffer and Batch Write: Buffering incoming MQTT messages and writing them in batches protects the database from high-frequency data bursts.

  6. Domain-Driven Design (DDD) in the Alerting Service: Separating domain, application, and infrastructure layers improves modularity, maintainability, and separation of concerns.

  7. Mock Data Fallback: Mock data allows the frontend to remain fully demonstrable even when the backend is unavailable.

  8. No API Gateway: Each service independently handles authentication validation, reducing architectural complexity and simplifying deployment.


Feature Deep-Dives


GIS Map Dashboard

The interactive map provides real-time spatial awareness of all deployed field assets:

Analytics Dashboard

A comprehensive operational intelligence view:

Alert Engine

The alerting service implements a 4-level hierarchical severity model, evaluated every minute using a sliding 10-minute window:


Security Architecture

Security properties and method of implementations are as below:


Database Design

All services share the kernelx TimescaleDB database. Several tables are initialized as hypertables, thus automatically partitioned by time for high-throughput time-series queries.


End Product


Testing

Deployment Options


Conclusion

ATLAS successfully demonstrates a scalable, modular, and domain-independent monitoring platform suitable for multiple government applications.

Achievements

Commercialization Potential

Potential Future Developments

v1.0.0 is released and stable. Planned for future versions:

Built by Team KernelX · Department of Computer Engineering · University of Peradeniya

GitHub Repository Project Page Department University