# digitalshoestringsolutions/powermonitoring architecture

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

- Interactive diagram: https://gitdiagram.com/digitalshoestringsolutions/powermonitoring
- Repository: https://github.com/digitalshoestringsolutions/powermonitoring

## Overview

Power Monitoring gathers electrical measurements, supports scheduled analysis and reporting, and presents energy data in Grafana and a custom graph UI. The sampled analysis runner shows query–calculation–write steps; the report runner shows scheduled email reporting. The README documents configurable current sensing and dashboards, but the sensing implementation and Grafana runtime wiring are not shown, so those connections are omitted. The custom UI’s data endpoint is likewise not identified in the sampled code.

Main entry points: [`solution_config/source_config/analysis/analysis_modules/run.py`](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/solution_config/source_config/analysis/analysis_modules/run.py) (Analysis Runner), [`solution_config/source_config/report/report_modules/run.py`](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/solution_config/source_config/report/report_modules/run.py) (Report Runner), [`custom_service_modules/report/code/trigger/engine.py`](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/engine.py) (Trigger Engine), [`custom_service_modules/report/code/trigger/mqtt_event/mqtt_event.py`](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/mqtt_event.py) (MQTT Trigger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Measurement Configuration"]
  node_sensing_config["Current Sensing"]
end

subgraph group_analytics["Analysis and Reporting"]
  node_analysis_runner["Analysis Runner<br/>[run.py]"]
  node_report_runner["Report Runner<br/>[run.py]"]
  node_config["Config Manager<br/>[config_manager.py]"]
  node_pipeline["Async Pipeline<br/>[pipeline.py]"]
  node_influx_query["Influx Queries<br/>[influx.py]"]
  node_electrical["Electrical Analysis<br/>[electrical.py]"]
  node_general_analysis["General Analysis<br/>[general.py]"]
  node_influx_output["Influx Output<br/>[influx.py]"]
  node_email_output["Email Output<br/>[email.py]"]
end

subgraph group_triggers["Trigger Runtime"]
  node_trigger_engine["Trigger Engine<br/>[engine.py]"]
  node_scheduler["Scheduler<br/>[scheduler.py]"]
  node_scheduler_executor["Schedule Executor<br/>[custom_executor.py]"]
  node_http_trigger["HTTP Trigger<br/>[http_request.py]"]
  node_mqtt_trigger["MQTT Trigger<br/>[mqtt_event.py]"]
  node_mqtt_handler["MQTT Handler<br/>[mqtt_handler.py]"]
  node_mqtt_tree["Topic Matcher<br/>[simple_tree.py]"]
end

subgraph group_presentation["Dashboards"]
  node_graph_ui["Energy Graph UI<br/>[App.jsx]"]
  node_api_client["REST Client<br/>[RestAPI.jsx]"]
  node_grafana_dashboards["Grafana Dashboards"]
end

node_operator(("Solution Operator"))
node_energy_api["Energy Data API"]
node_mqtt_broker["MQTT Broker"]

node_operator -->|"configures"| node_sensing_config
node_operator -->|"configures"| node_analysis_runner
node_operator -->|"views dashboards"| node_grafana_dashboards
node_analysis_runner -->|"loads config"| node_config
node_analysis_runner -->|"starts triggers"| node_trigger_engine
node_analysis_runner -->|"runs steps"| node_pipeline
node_analysis_runner -->|"queries data"| node_influx_query
node_analysis_runner -->|"calculates power"| node_electrical
node_analysis_runner -->|"groups energy"| node_general_analysis
node_analysis_runner -->|"writes results"| node_influx_output
node_report_runner -->|"loads config"| node_config
node_report_runner -->|"starts triggers"| node_trigger_engine
node_report_runner -->|"runs steps"| node_pipeline
node_report_runner -->|"queries usage"| node_influx_query
node_report_runner -->|"computes change"| node_general_analysis
node_report_runner -->|"sends report"| node_email_output
node_trigger_engine -->|"runs"| node_scheduler
node_trigger_engine -->|"runs"| node_http_trigger
node_trigger_engine -->|"runs"| node_mqtt_trigger
node_scheduler -->|"uses"| node_scheduler_executor
node_mqtt_trigger -->|"dispatches messages"| node_mqtt_handler
node_mqtt_handler -->|"matches topics"| node_mqtt_tree
node_mqtt_trigger -.->|"receives events"| node_mqtt_broker
node_graph_ui -->|"requests data"| node_api_client
node_graph_ui -.->|"fetches energy"| node_energy_api

click node_sensing_config "https://github.com/digitalshoestringsolutions/powermonitoring/tree/main/solution_config/source_config/current_sensing"
click node_analysis_runner "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/solution_config/source_config/analysis/analysis_modules/run.py"
click node_report_runner "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/solution_config/source_config/report/report_modules/run.py"
click node_config "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/config_manager.py"
click node_pipeline "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/pipeline.py"
click node_influx_query "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/query/influx.py"
click node_electrical "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/analysis/electrical.py"
click node_general_analysis "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/analysis/general.py"
click node_influx_output "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/output/influx.py"
click node_email_output "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/output/email.py"
click node_trigger_engine "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/engine.py"
click node_scheduler "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/scheduler/scheduler.py"
click node_scheduler_executor "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/scheduler/custom_executor.py"
click node_http_trigger "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/http_request/http_request.py"
click node_mqtt_trigger "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/mqtt_event.py"
click node_mqtt_handler "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/mqtt_handler.py"
click node_mqtt_tree "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/simple_tree.py"
click node_graph_ui "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/graph/code/src/App.jsx"
click node_api_client "https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/graph/code/src/RestAPI.jsx"
click node_grafana_dashboards "https://github.com/digitalshoestringsolutions/powermonitoring/tree/main/solution_config/source_config/grafana/dashboards/Power%20Monitoring"

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_sensing_config toneBlue
class node_analysis_runner,node_report_runner,node_config,node_pipeline,node_influx_query,node_electrical,node_general_analysis,node_influx_output,node_email_output toneAmber
class node_trigger_engine,node_scheduler,node_scheduler_executor,node_http_trigger,node_mqtt_trigger,node_mqtt_handler,node_mqtt_tree,node_energy_api toneMint
class node_graph_ui,node_api_client,node_grafana_dashboards toneRose
class node_operator,node_mqtt_broker toneIndigo
```

## Components

### Measurement Configuration

- [Current Sensing](https://github.com/digitalshoestringsolutions/powermonitoring/tree/main/solution_config/source_config/current_sensing): `solution_config/source_config/current_sensing`

### Analysis and Reporting

- [Analysis Runner](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/solution_config/source_config/analysis/analysis_modules/run.py): `solution_config/source_config/analysis/analysis_modules/run.py`
- [Report Runner](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/solution_config/source_config/report/report_modules/run.py): `solution_config/source_config/report/report_modules/run.py`
- [Config Manager](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/config_manager.py): `custom_service_modules/report/code/config_manager.py`
- [Async Pipeline](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/pipeline.py): `custom_service_modules/report/code/pipeline.py`
- [Influx Queries](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/query/influx.py): `custom_service_modules/report/code/query/influx.py`
- [Electrical Analysis](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/analysis/electrical.py): `custom_service_modules/report/code/analysis/electrical.py`
- [General Analysis](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/analysis/general.py): `custom_service_modules/report/code/analysis/general.py`
- [Influx Output](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/output/influx.py): `custom_service_modules/report/code/output/influx.py`
- [Email Output](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/output/email.py): `custom_service_modules/report/code/output/email.py`

### Trigger Runtime

- [Trigger Engine](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/engine.py): `custom_service_modules/report/code/trigger/engine.py`
- [Scheduler](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/scheduler/scheduler.py): `custom_service_modules/report/code/trigger/scheduler/scheduler.py`
- [Schedule Executor](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/scheduler/custom_executor.py): `custom_service_modules/report/code/trigger/scheduler/custom_executor.py`
- [HTTP Trigger](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/http_request/http_request.py): `custom_service_modules/report/code/trigger/http_request/http_request.py`
- [MQTT Trigger](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/mqtt_event.py): `custom_service_modules/report/code/trigger/mqtt_event/mqtt_event.py`
- [MQTT Handler](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/mqtt_handler.py): `custom_service_modules/report/code/trigger/mqtt_event/mqtt_handler.py`
- [Topic Matcher](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/report/code/trigger/mqtt_event/simple_tree.py): `custom_service_modules/report/code/trigger/mqtt_event/simple_tree.py`

### Dashboards

- [Energy Graph UI](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/graph/code/src/App.jsx): `custom_service_modules/graph/code/src/App.jsx`
- [REST Client](https://github.com/digitalshoestringsolutions/powermonitoring/blob/main/custom_service_modules/graph/code/src/RestAPI.jsx): `custom_service_modules/graph/code/src/RestAPI.jsx`
- [Grafana Dashboards](https://github.com/digitalshoestringsolutions/powermonitoring/tree/main/solution_config/source_config/grafana/dashboards/Power%20Monitoring): `solution_config/source_config/grafana/dashboards/Power Monitoring`

### Other components

- **Solution Operator**
- **Energy Data API**
- **MQTT Broker**

## Connections

- Solution Operator → Current Sensing: configures (evidence: `README.md`)
- Solution Operator → Analysis Runner: configures (evidence: `README.md`)
- Solution Operator → Grafana Dashboards: views dashboards (evidence: `README.md`)
- Analysis Runner → Config Manager: loads config (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Analysis Runner → Trigger Engine: starts triggers (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Analysis Runner → Async Pipeline: runs steps (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Analysis Runner → Influx Queries: queries data (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Analysis Runner → Electrical Analysis: calculates power (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Analysis Runner → General Analysis: groups energy (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Analysis Runner → Influx Output: writes results (evidence: `solution_config/source_config/analysis/analysis_modules/run.py`)
- Report Runner → Config Manager: loads config (evidence: `solution_config/source_config/report/report_modules/run.py`)
- Report Runner → Trigger Engine: starts triggers (evidence: `solution_config/source_config/report/report_modules/run.py`)
- Report Runner → Async Pipeline: runs steps (evidence: `solution_config/source_config/report/report_modules/run.py`)
- Report Runner → Influx Queries: queries usage (evidence: `solution_config/source_config/report/report_modules/run.py`)
- Report Runner → General Analysis: computes change (evidence: `solution_config/source_config/report/report_modules/run.py`)
- Report Runner → Email Output: sends report (evidence: `solution_config/source_config/report/report_modules/run.py`)
- Trigger Engine → Scheduler: runs (evidence: `custom_service_modules/report/code/trigger/engine.py`)
- Trigger Engine → HTTP Trigger: runs (evidence: `custom_service_modules/report/code/trigger/engine.py`)
- Trigger Engine → MQTT Trigger: runs (evidence: `custom_service_modules/report/code/trigger/engine.py`)
- Scheduler → Schedule Executor: uses (evidence: `custom_service_modules/report/code/trigger/scheduler/scheduler.py`)
- MQTT Trigger → MQTT Handler: dispatches messages (evidence: `custom_service_modules/report/code/trigger/mqtt_event/mqtt_event.py`)
- MQTT Handler → Topic Matcher: matches topics (evidence: `custom_service_modules/report/code/trigger/mqtt_event/mqtt_handler.py`)
- MQTT Trigger → MQTT Broker: receives events
- Energy Graph UI → REST Client: requests data (evidence: `custom_service_modules/graph/code/src/App.jsx`)
- Energy Graph UI → Energy Data API: fetches energy
