# komal-kalyanraman/container_manager architecture

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

- Interactive diagram: https://gitdiagram.com/komal-kalyanraman/container_manager
- Repository: https://github.com/komal-kalyanraman/container_manager

## Overview

Container Manager is a modular service that accepts container-operation requests over several protocols, decodes JSON or Protobuf (with optional decryption), dispatches operations to Docker/Podman implementations, and tracks operation status in a pluggable database. Startup wires the selected backend, service, executor, and enabled consumers; a separate heartbeat server serves health checks. The README also documents a Python UI and optional gRPC, though gRPC is planned. Some implementation files were not sampled, so uncertain request-dispatch links are left unverified rather than inferred.

Main entry points: [`App/main.cpp`](https://github.com/komal-kalyanraman/container_manager/blob/main/App/main.cpp) (Application startup), [`App/runtime/src/command_factory.cpp`](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/command_factory.cpp) (Command factory), [`App/core/src/container_service.cpp`](https://github.com/komal-kalyanraman/container_manager/blob/main/App/core/src/container_service.cpp) (Container service), [`App/api/src/http_server.cpp`](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/http_server.cpp) (REST / HTTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingress["Request ingress"]
  node_ui["Python UI"]
  node_http["REST / HTTP<br/>[http_server.cpp]"]
  node_mqtt["MQTT subscriber"]
  node_posix["POSIX queue"]
  node_dbus["D-Bus consumer<br/>[dbus_consumer.cpp]"]
  node_grpc["gRPC server<br/>[grpc_server.hpp]"]
  node_heartbeat["Heartbeat server"]
end

subgraph group_execution["Request execution"]
  node_executor["Request executor"]
  node_json["JSON executor"]
  node_protobuf["Protobuf executor"]
end

subgraph group_runtime["Container runtimes"]
  node_factory["Command factory"]
  node_dockercli["Docker CLI"]
  node_podmancli["Podman CLI"]
  node_dockerapi["Docker API"]
  node_podmanapi["Podman API"]
  node_podmanyaml["Podman YAML"]
  node_curl["Unix-socket HTTP<br/>[curl_handler.cpp]"]
end

subgraph group_state["State and security"]
  node_security["Security providers"]
  node_database["Database interface"]
  node_embedded[("Embedded database")]
  node_redis[("Redis database<br/>[redis_database.cpp]")]
end

subgraph group_operations["Service operations"]
  node_service["Container service"]
  node_main["Application startup<br/>[main.cpp]"]
end

node_client(("API clients"))
node_docker["Docker engine"]
node_podman["Podman engine"]

node_client -.->|"sends requests"| node_http
node_client -.->|"publishes requests"| node_mqtt
node_client -.->|"sends requests"| node_posix
node_client -.->|"calls methods"| node_dbus
node_ui -.->|"submits requests"| node_http
node_main -->|"starts"| node_http
node_main -->|"starts"| node_mqtt
node_main -->|"starts"| node_posix
node_main -->|"starts"| node_dbus
node_main -->|"starts"| node_heartbeat
node_main -->|"constructs"| node_service
node_main -->|"selects backend"| node_database
node_main -->|"selects provider"| node_security
node_main -->|"selects executor"| node_json
node_main -->|"selects executor"| node_protobuf
node_http -.->|"forwards requests"| node_executor
node_mqtt -.->|"forwards requests"| node_executor
node_posix -.->|"forwards requests"| node_executor
node_dbus -.->|"forwards requests"| node_executor
node_json -.->|"dispatches request"| node_service
node_protobuf -.->|"dispatches request"| node_service
node_service -->|"creates command"| node_factory
node_factory -.->|"selects command"| node_dockercli
node_factory -.->|"selects command"| node_podmancli
node_factory -.->|"selects command"| node_dockerapi
node_factory -.->|"selects command"| node_podmanapi
node_factory -.->|"selects command"| node_podmanyaml
node_dockerapi -->|"sends HTTP"| node_curl
node_dockerapi -.->|"controls engine"| node_docker
node_dockercli -.->|"runs commands"| node_docker
node_podmanapi -.->|"controls engine"| node_podman
node_podmancli -.->|"runs commands"| node_podman
node_podmanyaml -.->|"applies YAML"| node_podman
node_service -->|"updates status"| node_database
node_embedded -->|"implements"| node_database
node_redis -->|"implements"| node_database

click node_ui "https://github.com/komal-kalyanraman/container_manager/blob/main/ui/container_creator_logic.py"
click node_http "https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/http_server.cpp"
click node_mqtt "https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/mosquitto_mqtt_subscriber.cpp"
click node_posix "https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/posix_message_queue_consumer.cpp"
click node_dbus "https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/dbus_consumer.cpp"
click node_grpc "https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/inc/grpc_server.hpp"
click node_heartbeat "https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/heartbeat_server.cpp"
click node_executor "https://github.com/komal-kalyanraman/container_manager/blob/main/App/executor/inc/request_executor.hpp"
click node_json "https://github.com/komal-kalyanraman/container_manager/blob/main/App/executor/src/json_request_executor.cpp"
click node_protobuf "https://github.com/komal-kalyanraman/container_manager/blob/main/App/executor/src/protobuf_request_executor.cpp"
click node_security "https://github.com/komal-kalyanraman/container_manager/blob/main/App/security/src/aes_gcm_security_provider.cpp"
click node_service "https://github.com/komal-kalyanraman/container_manager/blob/main/App/core/src/container_service.cpp"
click node_factory "https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/command_factory.cpp"
click node_dockercli "https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/docker_commands.cpp"
click node_podmancli "https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/podman_commands.cpp"
click node_dockerapi "https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/docker_api_commands.cpp"
click node_podmanapi "https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/podman_api_commands.cpp"
click node_podmanyaml "https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/podman_yaml_commands.cpp"
click node_curl "https://github.com/komal-kalyanraman/container_manager/blob/main/App/utils/src/curl_handler.cpp"
click node_database "https://github.com/komal-kalyanraman/container_manager/blob/main/App/database/inc/database_interface.hpp"
click node_embedded "https://github.com/komal-kalyanraman/container_manager/blob/main/App/database/src/embedded_database.cpp"
click node_redis "https://github.com/komal-kalyanraman/container_manager/blob/main/App/database/src/redis_database.cpp"
click node_main "https://github.com/komal-kalyanraman/container_manager/blob/main/App/main.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_ui,node_http,node_mqtt,node_posix,node_dbus,node_grpc,node_heartbeat,node_client toneBlue
class node_executor,node_json,node_protobuf toneAmber
class node_factory,node_dockercli,node_podmancli,node_dockerapi,node_podmanapi,node_podmanyaml,node_curl toneMint
class node_security,node_database,node_embedded,node_redis toneRose
class node_service,node_main,node_docker,node_podman toneIndigo
```

## Components

### Request ingress

- [Python UI](https://github.com/komal-kalyanraman/container_manager/blob/main/ui/container_creator_logic.py): `ui/container_creator_logic.py`
- [REST / HTTP](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/http_server.cpp): `App/api/src/http_server.cpp`
- [MQTT subscriber](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/mosquitto_mqtt_subscriber.cpp): `App/api/src/mosquitto_mqtt_subscriber.cpp`
- [POSIX queue](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/posix_message_queue_consumer.cpp): `App/api/src/posix_message_queue_consumer.cpp`
- [D-Bus consumer](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/dbus_consumer.cpp): `App/api/src/dbus_consumer.cpp`
- [gRPC server](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/inc/grpc_server.hpp): `App/api/inc/grpc_server.hpp`
- [Heartbeat server](https://github.com/komal-kalyanraman/container_manager/blob/main/App/api/src/heartbeat_server.cpp): `App/api/src/heartbeat_server.cpp`

### Request execution

- [Request executor](https://github.com/komal-kalyanraman/container_manager/blob/main/App/executor/inc/request_executor.hpp): `App/executor/inc/request_executor.hpp`
- [JSON executor](https://github.com/komal-kalyanraman/container_manager/blob/main/App/executor/src/json_request_executor.cpp): `App/executor/src/json_request_executor.cpp`
- [Protobuf executor](https://github.com/komal-kalyanraman/container_manager/blob/main/App/executor/src/protobuf_request_executor.cpp): `App/executor/src/protobuf_request_executor.cpp`

### Container runtimes

- [Command factory](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/command_factory.cpp): `App/runtime/src/command_factory.cpp`
- [Docker CLI](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/docker_commands.cpp): `App/runtime/src/docker_commands.cpp`
- [Podman CLI](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/podman_commands.cpp): `App/runtime/src/podman_commands.cpp`
- [Docker API](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/docker_api_commands.cpp): `App/runtime/src/docker_api_commands.cpp`
- [Podman API](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/podman_api_commands.cpp): `App/runtime/src/podman_api_commands.cpp`
- [Podman YAML](https://github.com/komal-kalyanraman/container_manager/blob/main/App/runtime/src/podman_yaml_commands.cpp): `App/runtime/src/podman_yaml_commands.cpp`
- [Unix-socket HTTP](https://github.com/komal-kalyanraman/container_manager/blob/main/App/utils/src/curl_handler.cpp): `App/utils/src/curl_handler.cpp`

### State and security

- [Security providers](https://github.com/komal-kalyanraman/container_manager/blob/main/App/security/src/aes_gcm_security_provider.cpp): `App/security/src/aes_gcm_security_provider.cpp`
- [Database interface](https://github.com/komal-kalyanraman/container_manager/blob/main/App/database/inc/database_interface.hpp): `App/database/inc/database_interface.hpp`
- [Embedded database](https://github.com/komal-kalyanraman/container_manager/blob/main/App/database/src/embedded_database.cpp): `App/database/src/embedded_database.cpp`
- [Redis database](https://github.com/komal-kalyanraman/container_manager/blob/main/App/database/src/redis_database.cpp): `App/database/src/redis_database.cpp`

### Service operations

- [Container service](https://github.com/komal-kalyanraman/container_manager/blob/main/App/core/src/container_service.cpp): `App/core/src/container_service.cpp`
- [Application startup](https://github.com/komal-kalyanraman/container_manager/blob/main/App/main.cpp): `App/main.cpp`

### Other components

- **API clients**
- **Docker engine**
- **Podman engine**

## Connections

- API clients → REST / HTTP: sends requests (evidence: `README.md`)
- API clients → MQTT subscriber: publishes requests (evidence: `README.md`)
- API clients → POSIX queue: sends requests (evidence: `README.md`)
- API clients → D-Bus consumer: calls methods (evidence: `README.md`)
- Python UI → REST / HTTP: submits requests
- Application startup → REST / HTTP: starts (evidence: `App/main.cpp`)
- Application startup → MQTT subscriber: starts (evidence: `App/main.cpp`)
- Application startup → POSIX queue: starts (evidence: `App/main.cpp`)
- Application startup → D-Bus consumer: starts (evidence: `App/main.cpp`)
- Application startup → Heartbeat server: starts (evidence: `App/main.cpp`)
- Application startup → Container service: constructs (evidence: `App/main.cpp`)
- Application startup → Database interface: selects backend (evidence: `App/main.cpp`)
- Application startup → Security providers: selects provider (evidence: `App/main.cpp`)
- Application startup → JSON executor: selects executor (evidence: `App/main.cpp`)
- Application startup → Protobuf executor: selects executor (evidence: `App/main.cpp`)
- REST / HTTP → Request executor: forwards requests
- MQTT subscriber → Request executor: forwards requests
- POSIX queue → Request executor: forwards requests
- D-Bus consumer → Request executor: forwards requests
- JSON executor → Container service: dispatches request
- Protobuf executor → Container service: dispatches request
- Container service → Command factory: creates command (evidence: `App/core/src/container_service.cpp`)
- Command factory → Docker CLI: selects command
- Command factory → Podman CLI: selects command
- Command factory → Docker API: selects command
- Command factory → Podman API: selects command
- Command factory → Podman YAML: selects command
- Docker API → Unix-socket HTTP: sends HTTP (evidence: `App/runtime/src/docker_api_commands.cpp`)
- Docker API → Docker engine: controls engine
- Docker CLI → Docker engine: runs commands
- Podman API → Podman engine: controls engine
- Podman CLI → Podman engine: runs commands
- Podman YAML → Podman engine: applies YAML
- Container service → Database interface: updates status (evidence: `App/core/src/container_service.cpp`)
- Embedded database → Database interface: implements
- Redis database → Database interface: implements
