# sasoliv/dotfiles architecture

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

- Interactive diagram: https://gitdiagram.com/sasoliv/dotfiles
- Repository: https://github.com/sasoliv/dotfiles

## Overview

This repository is a personal server and home-automation configuration collection, rather than a single application. Its visible runtime components include a dashboard, monitoring services, MQTT, reverse-proxy configuration, and a Shelly-event mapper; host configuration and power-management files form a separate branch. The mapper subscribes for button events and publishes mapped commands to MQTT. The README is empty and most configuration files were not excerpted, so other service relationships cannot be verified and are omitted.

Main entry points: [`docker/shelly-mapper/shelly-mapper.py`](https://github.com/sasoliv/dotfiles/blob/pluto/docker/shelly-mapper/shelly-mapper.py) (Shelly mapper), [`docker/mosquitto/mosquitto.conf`](https://github.com/sasoliv/dotfiles/blob/pluto/docker/mosquitto/mosquitto.conf) (MQTT broker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host configuration"]
  node_host_config["Host settings"]
  node_power_service["Power service"]
  node_power_listener["Power listener"]
end

subgraph group_services["Server services"]
  node_compose["Service stack"]
  node_homepage["Homepage dashboard"]
  node_nginx["Reverse proxy<br/>[default.conf]"]
  node_prometheus["Prometheus<br/>[prometheus.yml]"]
  node_grafana["Grafana<br/>[grafana.ini]"]
  node_qbittorrent["qBittorrent"]
end

subgraph group_automation["Home automation"]
  node_mosquitto["MQTT broker<br/>[mosquitto.conf]"]
  node_mapper["Shelly mapper<br/>[shelly-mapper.py]"]
end

node_operator(("Operator"))
node_shelly(("Shelly button"))

node_shelly -->|"sends events"| node_mapper
node_mapper -->|"subscribes and publishes"| node_mosquitto

click node_host_config "https://github.com/sasoliv/dotfiles/tree/pluto/bck-system/etc"
click node_power_service "https://github.com/sasoliv/dotfiles/blob/pluto/bck-system/etc/systemd/system/power-management.service"
click node_power_listener "https://github.com/sasoliv/dotfiles/blob/pluto/bck-system/usr/local/bin/start-power-management-listener"
click node_compose "https://github.com/sasoliv/dotfiles/blob/pluto/docker/docker-compose.yaml"
click node_homepage "https://github.com/sasoliv/dotfiles/tree/pluto/docker/homepage/config"
click node_nginx "https://github.com/sasoliv/dotfiles/blob/pluto/docker/nginx/default.conf"
click node_prometheus "https://github.com/sasoliv/dotfiles/blob/pluto/docker/prometheus/prometheus.yml"
click node_grafana "https://github.com/sasoliv/dotfiles/blob/pluto/docker/grafana/grafana.ini"
click node_qbittorrent "https://github.com/sasoliv/dotfiles/tree/pluto/docker/qbittorrent"
click node_mosquitto "https://github.com/sasoliv/dotfiles/blob/pluto/docker/mosquitto/mosquitto.conf"
click node_mapper "https://github.com/sasoliv/dotfiles/blob/pluto/docker/shelly-mapper/shelly-mapper.py"

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_host_config,node_power_service,node_power_listener toneBlue
class node_compose,node_homepage,node_nginx,node_prometheus,node_grafana,node_qbittorrent toneAmber
class node_mosquitto,node_mapper toneMint
class node_operator,node_shelly toneIndigo
```

## Components

### Host configuration

- [Host settings](https://github.com/sasoliv/dotfiles/tree/pluto/bck-system/etc): `bck-system/etc`
- [Power service](https://github.com/sasoliv/dotfiles/blob/pluto/bck-system/etc/systemd/system/power-management.service): `bck-system/etc/systemd/system/power-management.service`
- [Power listener](https://github.com/sasoliv/dotfiles/blob/pluto/bck-system/usr/local/bin/start-power-management-listener): `bck-system/usr/local/bin/start-power-management-listener`

### Server services

- [Service stack](https://github.com/sasoliv/dotfiles/blob/pluto/docker/docker-compose.yaml): `docker/docker-compose.yaml`
- [Homepage dashboard](https://github.com/sasoliv/dotfiles/tree/pluto/docker/homepage/config): `docker/homepage/config`
- [Reverse proxy](https://github.com/sasoliv/dotfiles/blob/pluto/docker/nginx/default.conf): `docker/nginx/default.conf`
- [Prometheus](https://github.com/sasoliv/dotfiles/blob/pluto/docker/prometheus/prometheus.yml): `docker/prometheus/prometheus.yml`
- [Grafana](https://github.com/sasoliv/dotfiles/blob/pluto/docker/grafana/grafana.ini): `docker/grafana/grafana.ini`
- [qBittorrent](https://github.com/sasoliv/dotfiles/tree/pluto/docker/qbittorrent): `docker/qbittorrent`

### Home automation

- [MQTT broker](https://github.com/sasoliv/dotfiles/blob/pluto/docker/mosquitto/mosquitto.conf): `docker/mosquitto/mosquitto.conf`
- [Shelly mapper](https://github.com/sasoliv/dotfiles/blob/pluto/docker/shelly-mapper/shelly-mapper.py): `docker/shelly-mapper/shelly-mapper.py`

### Other components

- **Operator**
- **Shelly button**

## Connections

- Shelly button → Shelly mapper: sends events (evidence: `docker/shelly-mapper/shelly-mapper.py`)
- Shelly mapper → MQTT broker: subscribes and publishes (evidence: `docker/shelly-mapper/shelly-mapper.py`)
