# lmiquel/minilab architecture

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

- Interactive diagram: https://gitdiagram.com/lmiquel/minilab
- Repository: https://github.com/lmiquel/minilab

## Overview

Minilab Helper is a Discord bot for administering and monitoring a homelab, with additional printer and WireGuard status features. The main workflow is a Discord slash command routed through the command manager to a handler, which responds with operational information or an action. Background monitoring polls service state and sends owner notifications; WireGuard has a separate handshake watcher. The graph also preserves the service catalog and the Docker, MiniPrint, and WireGuard domains. Relationships are limited to those supported by excerpts or SOURCE INDEX references; unsampled handler internals are not asserted.

Main entry points: [`minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts`](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts) (Service monitoring), [`minilab-helper/src/managers/commands-manager/commands-manager.ts`](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/commands-manager/commands-manager.ts) (Command manager), [`minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts`](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts) (Service catalog), [`minilab-helper/src/index.ts`](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/index.ts) (Application startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discord["Discord interface"]
  node_entry["Application startup<br/>[index.ts]"]
  node_commands["Command manager"]
  node_handlers["Slash handlers"]
end

subgraph group_catalog["Service catalog"]
  node_service_catalog["Service catalog"]
  node_category_catalog["Service categories"]
  node_command_catalog["Command definitions"]
end

subgraph group_ops["Host operations"]
  node_docker["Docker manager<br/>[docker-manager.ts]"]
  node_docker_ops["Docker operations"]
  node_host_types["Host and service types"]
end

subgraph group_monitor["Monitoring"]
  node_monitoring["Service monitoring"]
  node_monitor_tasks["Polling and alerts"]
end

subgraph group_network["Network and printer"]
  node_mini_manager["MiniPrint manager"]
  node_mini_fetch["MiniPrint overview"]
  node_wireguard["WireGuard manager"]
  node_wg_tasks["Peer and handshake tasks"]
  node_wg_types["WireGuard state types<br/>[wireguard-state.ts]"]
end

node_owner(("Bot owner"))
node_discord_api(("Discord API"))

node_owner -->|"issues commands"| node_discord_api
node_discord_api -->|"delivers interactions"| node_commands
node_entry -->|"initializes"| node_commands
node_entry -->|"starts"| node_monitoring
node_entry -->|"starts"| node_wireguard
node_commands -->|"registers commands"| node_discord_api
node_commands -->|"dispatches"| node_handlers
node_handlers -.->|"uses definitions"| node_service_catalog
node_docker -->|"delegates operations"| node_docker_ops
node_docker_ops -->|"resolves services"| node_service_catalog
node_docker -->|"uses types"| node_host_types
node_service_catalog -->|"categorizes services"| node_category_catalog
node_monitoring -->|"runs polling"| node_monitor_tasks
node_monitoring -->|"sends owner DMs"| node_discord_api
node_monitoring -.->|"checks services"| node_service_catalog
node_mini_manager -->|"delegates overview"| node_mini_fetch
node_wireguard -->|"runs peer checks"| node_wg_tasks
node_wireguard -->|"maintains state"| node_wg_types

click node_entry "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/index.ts"
click node_commands "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/commands-manager/commands-manager.ts"
click node_handlers "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/commands-manager/internals/command-handlers.ts"
click node_service_catalog "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts"
click node_category_catalog "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/service-categories-dictionary/types/service-category.ts"
click node_command_catalog "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/command-dictionary/command-dictionary.ts"
click node_docker "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/docker-manager/docker-manager.ts"
click node_docker_ops "https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/managers/docker-manager/internals"
click node_host_types "https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/commons/types"
click node_monitoring "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts"
click node_monitor_tasks "https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/managers/monitoring-manager/internals"
click node_mini_manager "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/miniprint-manager/miniprint-manager.ts"
click node_mini_fetch "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/miniprint-manager/internals/get-miniprint-overview.ts"
click node_wireguard "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts"
click node_wg_tasks "https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/managers/wireguard-manager/internals"
click node_wg_types "https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/wireguard-manager/types/wireguard-state.ts"

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_entry,node_commands,node_handlers toneBlue
class node_service_catalog,node_category_catalog,node_command_catalog toneAmber
class node_docker,node_docker_ops,node_host_types,node_discord_api toneMint
class node_monitoring,node_monitor_tasks toneRose
class node_mini_manager,node_mini_fetch,node_wireguard,node_wg_tasks,node_wg_types,node_owner toneIndigo
```

## Components

### Discord interface

- [Application startup](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/index.ts): `minilab-helper/src/index.ts`
- [Command manager](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/commands-manager/commands-manager.ts): `minilab-helper/src/managers/commands-manager/commands-manager.ts`
- [Slash handlers](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/commands-manager/internals/command-handlers.ts): `minilab-helper/src/managers/commands-manager/internals/command-handlers.ts`

### Service catalog

- [Service catalog](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts): `minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts`
- [Service categories](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/service-categories-dictionary/types/service-category.ts): `minilab-helper/src/dictionaries/service-categories-dictionary/types/service-category.ts`
- [Command definitions](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/dictionaries/command-dictionary/command-dictionary.ts): `minilab-helper/src/dictionaries/command-dictionary/command-dictionary.ts`

### Host operations

- [Docker manager](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/docker-manager/docker-manager.ts): `minilab-helper/src/managers/docker-manager/docker-manager.ts`
- [Docker operations](https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/managers/docker-manager/internals): `minilab-helper/src/managers/docker-manager/internals`
- [Host and service types](https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/commons/types): `minilab-helper/src/commons/types`

### Monitoring

- [Service monitoring](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts): `minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts`
- [Polling and alerts](https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/managers/monitoring-manager/internals): `minilab-helper/src/managers/monitoring-manager/internals`

### Network and printer

- [MiniPrint manager](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/miniprint-manager/miniprint-manager.ts): `minilab-helper/src/managers/miniprint-manager/miniprint-manager.ts`
- [MiniPrint overview](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/miniprint-manager/internals/get-miniprint-overview.ts): `minilab-helper/src/managers/miniprint-manager/internals/get-miniprint-overview.ts`
- [WireGuard manager](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts): `minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts`
- [Peer and handshake tasks](https://github.com/lmiquel/minilab/tree/main/minilab-helper/src/managers/wireguard-manager/internals): `minilab-helper/src/managers/wireguard-manager/internals`
- [WireGuard state types](https://github.com/lmiquel/minilab/blob/main/minilab-helper/src/managers/wireguard-manager/types/wireguard-state.ts): `minilab-helper/src/managers/wireguard-manager/types/wireguard-state.ts`

### Other components

- **Bot owner**
- **Discord API**

## Connections

- Bot owner → Discord API: issues commands
- Discord API → Command manager: delivers interactions (evidence: `minilab-helper/src/managers/commands-manager/commands-manager.ts`)
- Application startup → Command manager: initializes (evidence: `minilab-helper/src/index.ts`)
- Application startup → Service monitoring: starts (evidence: `minilab-helper/src/index.ts`)
- Application startup → WireGuard manager: starts (evidence: `minilab-helper/src/index.ts`)
- Command manager → Discord API: registers commands (evidence: `minilab-helper/src/managers/commands-manager/commands-manager.ts`)
- Command manager → Slash handlers: dispatches (evidence: `minilab-helper/src/managers/commands-manager/commands-manager.ts`)
- Slash handlers → Service catalog: uses definitions
- Docker manager → Docker operations: delegates operations (evidence: `minilab-helper/src/managers/docker-manager/docker-manager.ts`)
- Docker operations → Service catalog: resolves services (evidence: `minilab-helper/src/managers/docker-manager/internals/restart-service.ts`)
- Docker manager → Host and service types: uses types (evidence: `minilab-helper/src/managers/docker-manager/docker-manager.ts`)
- Service catalog → Service categories: categorizes services (evidence: `minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts`)
- Service monitoring → Polling and alerts: runs polling (evidence: `minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts`)
- Service monitoring → Discord API: sends owner DMs (evidence: `minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts`)
- Service monitoring → Service catalog: checks services
- MiniPrint manager → MiniPrint overview: delegates overview (evidence: `minilab-helper/src/managers/miniprint-manager/miniprint-manager.ts`)
- WireGuard manager → Peer and handshake tasks: runs peer checks (evidence: `minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts`)
- WireGuard manager → WireGuard state types: maintains state (evidence: `minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts`)
