How arkar-myintmyat/sodtwaredevopsgpproject works
This repository is a simulated telemetry system that modernizes the gateway-to-cloud link while preserving an unmodifiable legacy device hop. A device samples sensors, formats and encrypts a reading, and sends it to the gateway; the gateway validates and parses frames, checks sequence numbers, then forwards readings through either the operator-selected legacy uplink or the ML-KEM channel. The cloud establishes sessions, accepts and stores readings, and serves health, read APIs, and a live dashboard. The graph reflects README-described HTTP links where source excerpts do not show transport details; unsampled internals are not inferred.
Main entry points: gateway.py TCP frame listener · app.py Read APIs · channel.py Channel cryptography · protocol.py Frame generation
Components 16
Legacy device
- Sensor simulator
legacy_device/device.py - Frame generation
legacy_device/protocol.py
Edge gateway
- TCP frame listener
edge_gateway/gateway.py - Frame validation
legacy_device/protocol.py - Replay tracking
edge_gateway/gateway.py - Legacy uplink
edge_gateway/gateway.py - PQC uplink
edge_gateway/gateway.py
Secure uplink
- Channel cryptography
pqc_channel/channel.py - Session handshake
cloud_service/app.py
Cloud service
- Cloud key management
cloud_service/app.py - Sealed ingest
cloud_service/app.py - Legacy ingest
cloud_service/app.py - Reading store
cloud_service/app.py - Read APIs
cloud_service/app.py - Live dashboard
cloud_service/static/dashboard.html
Other components
- Operator / viewer
Connections 19
- Sensor simulator → Frame generation: formats and encrypts
legacy_device/device.py - Frame generation → TCP frame listener: sends TCP frames
README.md - TCP frame listener → Frame validation: decrypts and parses
edge_gateway/gateway.py - TCP frame listener → Replay tracking: checks sequences
edge_gateway/gateway.py - TCP frame listener → Legacy uplink: dispatches readings
edge_gateway/gateway.py - TCP frame listener → PQC uplink: dispatches readings
edge_gateway/gateway.py - Legacy uplink → Legacy ingest: posts readings
edge_gateway/gateway.py - PQC uplink → Cloud key management: fetches public key
edge_gateway/gateway.py - PQC uplink → Channel cryptography: uses crypto
edge_gateway/gateway.py - PQC uplink → Session handshake: opens sessions
edge_gateway/gateway.py - PQC uplink → Sealed ingest: posts sealed readings
README.md - Cloud key management → Channel cryptography: fingerprints key
cloud_service/app.py - Session handshake → Channel cryptography: derives session keys
README.md - Legacy ingest → Reading store: stores readings
cloud_service/app.py - Sealed ingest → Reading store: stores readings
cloud_service/app.py - Read APIs → Reading store: reads readings
cloud_service/app.py - Operator / viewer → Read APIs: requests readings
README.md - Operator / viewer → Live dashboard: views dashboard
README.md - Live dashboard → Read APIs: refreshes via APIs
cloud_service/app.py