How lmiquel/minilab works
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: monitoring-manager.ts Service monitoring · commands-manager.ts Command manager · docker-services-dictionary.ts Service catalog · index.ts Application startup
Components 18
Discord interface
- Application startup
minilab-helper/src/index.ts - Command manager
minilab-helper/src/managers/commands-manager/commands-manager.ts - Slash handlers
minilab-helper/src/managers/commands-manager/internals/command-handlers.ts
Service catalog
- Service catalog
minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts - Service categories
minilab-helper/src/dictionaries/service-categories-dictionary/types/service-category.ts - Command definitions
minilab-helper/src/dictionaries/command-dictionary/command-dictionary.ts
Host operations
- Docker manager
minilab-helper/src/managers/docker-manager/docker-manager.ts - Docker operations
minilab-helper/src/managers/docker-manager/internals - Host and service types
minilab-helper/src/commons/types
Monitoring
- Service monitoring
minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts - Polling and alerts
minilab-helper/src/managers/monitoring-manager/internals
Network and printer
- MiniPrint manager
minilab-helper/src/managers/miniprint-manager/miniprint-manager.ts - MiniPrint overview
minilab-helper/src/managers/miniprint-manager/internals/get-miniprint-overview.ts - WireGuard manager
minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts - Peer and handshake tasks
minilab-helper/src/managers/wireguard-manager/internals - WireGuard state types
minilab-helper/src/managers/wireguard-manager/types/wireguard-state.ts
Other components
- Bot owner
- Discord API
Connections 18
- Bot owner → Discord API: issues commands
- Discord API → Command manager: delivers interactions
minilab-helper/src/managers/commands-manager/commands-manager.ts - Application startup → Command manager: initializes
minilab-helper/src/index.ts - Application startup → Service monitoring: starts
minilab-helper/src/index.ts - Application startup → WireGuard manager: starts
minilab-helper/src/index.ts - Command manager → Discord API: registers commands
minilab-helper/src/managers/commands-manager/commands-manager.ts - Command manager → Slash handlers: dispatches
minilab-helper/src/managers/commands-manager/commands-manager.ts - Slash handlers → Service catalog: uses definitions
- Docker manager → Docker operations: delegates operations
minilab-helper/src/managers/docker-manager/docker-manager.ts - Docker operations → Service catalog: resolves services
minilab-helper/src/managers/docker-manager/internals/restart-service.ts - Docker manager → Host and service types: uses types
minilab-helper/src/managers/docker-manager/docker-manager.ts - Service catalog → Service categories: categorizes services
minilab-helper/src/dictionaries/docker-services-dictionary/docker-services-dictionary.ts - Service monitoring → Polling and alerts: runs polling
minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts - Service monitoring → Discord API: sends owner DMs
minilab-helper/src/managers/monitoring-manager/monitoring-manager.ts - Service monitoring → Service catalog: checks services
- MiniPrint manager → MiniPrint overview: delegates overview
minilab-helper/src/managers/miniprint-manager/miniprint-manager.ts - WireGuard manager → Peer and handshake tasks: runs peer checks
minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts - WireGuard manager → WireGuard state types: maintains state
minilab-helper/src/managers/wireguard-manager/wireguard-manager.ts