WMS System

Executive Overview

Water utilities worldwide face mounting pressure: aging infrastructure, rising operational costs, non-revenue water losses that erode profitability, and growing customer expectations for transparency and digital service. The Smart Water Meter Management System directly addresses these challenges with a purpose-built, end-to-end IoT platform that digitalizes the entire water metering lifecycle — from device provisioning and remote field operations to real-time data analytics, prepaid vending, and customer relationship management.

The platform is production-ready today, delivering a unified operational hub accessible through a modern web interface with enterprise-grade role-based security.

### 1. Device Management

The device module serves as the single source of truth for all metering assets deployed in the field.

- Full Meter Lifecycle: Complete CRUD operations covering installation, activation, deactivation, and retirement. Each meter record carries its operational status, IMEI, geographic location, and assigned model configuration.

- Bulk Operations: Batch import via structured files and field import via handheld units (HHU), enabling efficient large-scale deployments without per-device manual entry.

- Device Catalog: A meter model registry that standardizes parameter definitions, communication protocols, and capability profiles across different hardware vendors and model variants — ensuring interoperability across a mixed fleet.

- Geographic Visualization: An interactive map view that plots meters spatially, enabling operators to locate devices, inspect real-time status, and identify geographic clusters of issues at a glance.

- Group Management: Logical grouping of meters by district, zone, or any user-defined criteria for convenient batch operations and reporting.

### 2. Remote Command & Control

The command module enables operators to interact with field meters remotely, eliminating costly on-site visits and reducing response times from days to seconds.

- Command Console: A centralized interface for issuing commands to individual meters or groups. Supported command types include parameter reads and writes, valve open and close, data recapture, and remote firmware upgrades.

- Batch Configuration: Structured forms for configuring meter parameters across multiple devices simultaneously, with a raw JSON fallback for custom payloads that may be needed during integration or troubleshooting.

- Reliable State Machine: Each command progresses through a well-defined lifecycle — PENDING → SENT → SUCCESS / FAILED / EXPIRED. The system handles automatic dispatch when meters come online, configurable retry logic with exponential backoff, timeout scanning, and concurrent acknowledgment guards to prevent duplicate processing.

- Full Audit Trail: A comprehensive command log with success-rate analytics, time-range filters, and payload inspection for post-mortem analysis and regulatory compliance.

- Template System: Predefined command templates for common operations, reducing operator error and accelerating training for new staff.

### 3. Data Ingestion & Alarm Management

Real-time visibility into meter operations is critical for reducing non-revenue water and responding to field incidents before they escalate.

- Multi-Granularity Data: The system ingests and stores daily consumption totals, high-resolution curve (interval) data for detailed usage pattern analysis, and instant snapshot readings for real-time verification.

- Intelligent Anomaly Detection: A configurable alarm engine monitors incoming data streams against event codes and thresholds, detecting leaks, reverse flow, low battery conditions, meter tampering, pressure anomalies, and other predefined events.

- Real-Time Push Notifications: Alarm events are broadcast to operator dashboards in real time via SSE (Server-Sent Events) streaming, enabling immediate situational awareness and rapid dispatch of field crews.

- Data Visualization Suite: Consumption trend charts, statistical summaries, anomaly dashboards, and comparative analytics help operators identify patterns, outliers, and emerging issues at a glance.

- Historical Data Recapture: For meters with intermittent connectivity, a recapture mechanism retrieves historical data gaps either on demand or on a scheduled basis, ensuring billing and analytics data sets remain complete.

### 4. Prepaid Vending & Billing Integration

For utilities serving prepaid customer bases — increasingly common in large urban deployments — the system provides a complete vending and financial operations suite.

- Token Generation: Fully compliant Standard Transfer Specification (STS) token generation for pay-before-use metering, supporting ISO/IEC 80079 compliant encryption and token formats.

- Vending Workflow: End-to-end vend flow from customer token request through payment confirmation, token delivery, and receipt generation — handling both counter and remote transactions.

- Point-of-Sale Module: Operator-facing POS interface for counter transactions, balance inquiries, receipt printing, and reconciliation.

- Order Lifecycle Management: Complete tracking of vend history, refunds, adjustments, and daily reconciliation for financial audit.

- Flexible Tariff Engine: Configurable tiered pricing, time-of-use rates, fixed charges, and connection fees — adaptable to different regulatory environments and customer classes.

### 5. Customer Relationship Management

Bridging operational data with customer account management, the CRM module enables utilities to manage consumer relationships holistically across the entire service lifecycle.

- Customer Archive: Central repository for consumer information, account status, service history, and contact preferences — eliminating silos between operational and billing systems.

- Tariff Point Assignment: Precise mapping of customers to individual meters and applicable tariff structures, ensuring billing accuracy.

- Debt & Collections Management: Tracks outstanding balances, overdue aging, payment history, and supports collections workflows with configurable escalation rules.

- Organizational Hierarchy: Multi-level organization structure that mirrors the utility's operational hierarchy — region → district → zone — ensuring data ownership and operational responsibility are clearly delineated.

### 6. System Administration & Security

The platform is built on a foundation of enterprise-grade security and administrative controls, designed to meet the compliance requirements of regulated utility environments.

- Role-Based Access Control: Granular permission model where every menu entry, API endpoint, and operation is individually governed by authority checks. Roles are configurable and tied to organizational scope.

- Data Scope Isolation: The organizational hierarchy ensures operators see only data belonging to their authorized scope — preventing cross-region data leakage without requiring separate system instances.

- JWT Authentication: Stateless token-based authentication with configurable expiry and refresh mechanisms, transmitted securely via HTTP Authorization headers.

- Comprehensive Audit Logging: Detailed logging of operator login events, sensitive operations, configuration changes, and data modifications — providing a complete forensic trail for compliance and incident investigation.

- API Security: Dedicated API key authentication for collector and meter communication, preventing unauthorized access to device-facing endpoints.

- Database Backup Management: Built-in backup configuration and scheduling for data protection and disaster recovery preparedness.

*The Smart Water Meter Management System — built for utilities that demand operational excellence, security, and scalability in digital water management.*

For technical inquiries, implementation consultations, or partnership opportunities, please contact the project team.