# ainopol/volt architecture

> Architecture diagram of the GitHub repository ainopol/volt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ainopol/volt
- Repository: https://github.com/ainopol/volt

## Overview

VOLT_HTTP is an OLT device-management service: a web or cloud client uses its HTTP REST interface to manage devices, configure settings, inspect status, and upload and start firmware upgrades. The upgrade path parses and verifies an image, then coordinates flash operations over an OLT session; the session handles Ethernet protocol requests and responses. The README also documents device controls and ONU monitoring. Those feature areas are represented, but their detailed handler-to-manager wiring is not fully visible in the excerpts, so uncertain links are omitted.

Main entry points: [`src/http/HttpServer.cpp`](https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp) (HTTP REST server), [`src/olt/OltSession.cpp`](https://github.com/ainopol/volt/blob/main/src/olt/OltSession.cpp) (OLT session), [`src/olt/UpgradeManager.cpp`](https://github.com/ainopol/volt/blob/main/src/olt/UpgradeManager.cpp) (Upgrade manager), [`src/olt/OltManager.cpp`](https://github.com/ainopol/volt/blob/main/src/olt/OltManager.cpp) (OLT manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP service"]
  node_server["HTTP REST server<br/>[HttpServer.cpp]"]
  node_entry["Service entry<br/>[main.cpp]"]
  node_upload["Firmware upload<br/>[HttpServer.cpp]"]
end

subgraph group_management["Device management"]
  node_manager["OLT manager<br/>[OltManager.cpp]"]
  node_config["Configuration manager"]
  node_monitor["Device and ONU monitoring<br/>[HttpServer.cpp]"]
  node_control["Device controls<br/>[HttpServer.cpp]"]
end

subgraph group_upgrade["Firmware upgrade"]
  node_image["Image parser<br/>[ImageFile.cpp]"]
  node_upgrade_manager["Upgrade manager<br/>[UpgradeManager.cpp]"]
  node_flash["Flash operations<br/>[UpgradeManager.cpp]"]
end

subgraph group_protocol["Protocol transport"]
  node_definitions["Protocol definitions<br/>[MsgDefine.h]"]
  node_session["OLT session<br/>[OltSession.cpp]"]
end

node_client(("Web / cloud client"))
node_device(("OLT device"))

node_client -->|"sends requests"| node_server
node_entry -->|"runs"| node_server
node_server -->|"handles upload"| node_upload
node_upload -.->|"loads image"| node_image
node_server -.->|"starts upgrade"| node_upgrade_manager
node_image -.->|"provides image"| node_upgrade_manager
node_upgrade_manager -->|"coordinates"| node_flash
node_upgrade_manager -->|"sends requests"| node_session
node_config -->|"sends requests"| node_session
node_manager -->|"creates session"| node_session
node_server -.->|"manages devices"| node_manager
node_server -->|"serves monitoring"| node_monitor
node_server -.->|"serves controls"| node_control
node_session -->|"Ethernet exchange"| node_device
node_definitions -->|"defines messages"| node_session

click node_server "https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp"
click node_entry "https://github.com/ainopol/volt/blob/main/src/main.cpp"
click node_manager "https://github.com/ainopol/volt/blob/main/src/olt/OltManager.cpp"
click node_config "https://github.com/ainopol/volt/blob/main/src/olt/OltConfigManager.cpp"
click node_definitions "https://github.com/ainopol/volt/blob/main/src/olt/MsgDefine.h"
click node_session "https://github.com/ainopol/volt/blob/main/src/olt/OltSession.cpp"
click node_upload "https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp"
click node_image "https://github.com/ainopol/volt/blob/main/src/olt/ImageFile.cpp"
click node_upgrade_manager "https://github.com/ainopol/volt/blob/main/src/olt/UpgradeManager.cpp"
click node_flash "https://github.com/ainopol/volt/blob/main/src/olt/UpgradeManager.cpp"
click node_monitor "https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp"
click node_control "https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_entry,node_upload,node_client toneBlue
class node_manager,node_config,node_monitor,node_control toneAmber
class node_image,node_upgrade_manager,node_flash toneMint
class node_definitions,node_session toneRose
class node_device toneIndigo
```

## Components

### HTTP service

- [HTTP REST server](https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp): `src/http/HttpServer.cpp`
- [Service entry](https://github.com/ainopol/volt/blob/main/src/main.cpp): `src/main.cpp`
- [Firmware upload](https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp): `src/http/HttpServer.cpp`

### Device management

- [OLT manager](https://github.com/ainopol/volt/blob/main/src/olt/OltManager.cpp): `src/olt/OltManager.cpp`
- [Configuration manager](https://github.com/ainopol/volt/blob/main/src/olt/OltConfigManager.cpp): `src/olt/OltConfigManager.cpp`
- [Device and ONU monitoring](https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp): `src/http/HttpServer.cpp`
- [Device controls](https://github.com/ainopol/volt/blob/main/src/http/HttpServer.cpp): `src/http/HttpServer.cpp`

### Firmware upgrade

- [Image parser](https://github.com/ainopol/volt/blob/main/src/olt/ImageFile.cpp): `src/olt/ImageFile.cpp`
- [Upgrade manager](https://github.com/ainopol/volt/blob/main/src/olt/UpgradeManager.cpp): `src/olt/UpgradeManager.cpp`
- [Flash operations](https://github.com/ainopol/volt/blob/main/src/olt/UpgradeManager.cpp): `src/olt/UpgradeManager.cpp`

### Protocol transport

- [Protocol definitions](https://github.com/ainopol/volt/blob/main/src/olt/MsgDefine.h): `src/olt/MsgDefine.h`
- [OLT session](https://github.com/ainopol/volt/blob/main/src/olt/OltSession.cpp): `src/olt/OltSession.cpp`

### Other components

- **Web / cloud client**
- **OLT device**

## Connections

- Web / cloud client → HTTP REST server: sends requests (evidence: `README.md`)
- Service entry → HTTP REST server: runs (evidence: `src/main.cpp`)
- HTTP REST server → Firmware upload: handles upload (evidence: `README.md`)
- Firmware upload → Image parser: loads image
- HTTP REST server → Upgrade manager: starts upgrade
- Image parser → Upgrade manager: provides image
- Upgrade manager → Flash operations: coordinates (evidence: `README.md`)
- Upgrade manager → OLT session: sends requests (evidence: `src/olt/UpgradeManager.cpp`)
- Configuration manager → OLT session: sends requests (evidence: `src/olt/OltConfigManager.cpp`)
- OLT manager → OLT session: creates session (evidence: `src/olt/OltManager.cpp`)
- HTTP REST server → OLT manager: manages devices
- HTTP REST server → Device and ONU monitoring: serves monitoring (evidence: `src/http/HttpServer.cpp`)
- HTTP REST server → Device controls: serves controls (evidence: `src/http/HttpServer.cpp`)
- OLT session → OLT device: Ethernet exchange (evidence: `README.md`)
- Protocol definitions → OLT session: defines messages
