Technical
This section explains how the implemented platform works in enough detail to develop, operate, and troubleshoot it without first reading the entire codebase. It is the technical source of truth for current behavior—not a roadmap.
Find the right level
Section titled “Find the right level”- System Overview explains the complete current topology and ordered data flows.
- Services and components explains every deployable, job, datastore, and supporting control-plane component.
- Architecture explains boundaries, tenancy, data, security, observability, backup, and staged ingestion.
- Contracts contains authoritative cross-module and external message/API behavior.
- ADRs explain why accepted architecture decisions were made.
- Operations contains local development, configuration, Secrets, Argo CD, Kubernetes, migrations, and Netmore runbooks.
- Troubleshooting routes visible symptoms to the owning service and safe diagnostic path.
Current implementation boundary
Section titled “Current implementation boundary”The current system implements web-console administration, authenticated and tenant-aware APIs, audit, resource inventory, Netmore MQTT reception, durable raw buffering, idempotent raw TimescaleDB storage, and the typed telemetry-flow pipeline with disabled-by-default flow, sandbox, and action worker workloads. Customer-facing normalized measurement API/UI and CSV export execution are not yet implemented. Remaining delivery work belongs under Internal, while approved input/output formats remain under Technical contracts.