# ogyreck/dns-manager-bind architecture

> Architecture diagram of the GitHub repository ogyreck/dns-manager-bind, 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/ogyreck/dns-manager-bind
- Repository: https://github.com/ogyreck/dns-manager-bind

## Overview

dns-manager-bind is a Qt desktop manager for BIND9. The main workflow is to inspect zones and records, create or edit them through dialogs or the four-step wizard, then have BindManager update zone files and named.conf, validate changes, and reload BIND9. The UI also exposes asynchronous server controls, settings, help, and an in-memory event viewer. The README documents recursive include parsing and rollback on validation failure; several implementation details are unsampled, so the graph limits edges to relationships shown in excerpts, the source index, or README.

Main entry points: [`src/ui/MainWindow.cpp`](https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/MainWindow.cpp) (Main window), [`src/dns/BindManager.cpp`](https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/BindManager.cpp) (BIND manager), [`src/model`](https://github.com/ogyreck/dns-manager-bind/tree/main/src/model) (Zone and record models), [`src/dns/EventLogger.cpp`](https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/EventLogger.cpp) (Event logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_main["Main window<br/>[MainWindow.cpp]"]
  node_zonewizard["Zone wizard<br/>[ZoneWizard.cpp]"]
  node_dialogs["Edit dialogs"]
  node_settings["Settings dialog<br/>[SettingsDialog.cpp]"]
  node_help["Help dialog<br/>[HelpDialog.cpp]"]
end

subgraph group_dns["BIND operations"]
  node_manager["BIND manager<br/>[BindManager.cpp]"]
  node_validator["Config validator"]
  node_logger["Event logger<br/>[EventLogger.cpp]"]
end

subgraph group_parser["Configuration parsing"]
  node_namedparser["named.conf parser"]
  node_zoneparser["Zone file parser<br/>[ZoneFileParser.cpp]"]
  node_writer["Zone config writer<br/>[ConfigWriter.cpp]"]
end

subgraph group_domain["Domain data"]
  node_models["Zone and record models"]
  node_eventmodel["Event entry model<br/>[EventLogEntry.h]"]
  node_servermodel["Server settings model<br/>[ServerConfig.h]"]
end

node_user(("Administrator"))
node_bind["BIND9 service"]
node_system["Linux service tools"]

node_user -->|"uses"| node_main
node_main -->|"opens"| node_zonewizard
node_main -->|"opens"| node_dialogs
node_main -->|"opens"| node_settings
node_main -->|"opens"| node_help
node_main -->|"delegates"| node_manager
node_main -->|"subscribes"| node_logger
node_main -->|"displays"| node_eventmodel
node_zonewizard -->|"builds"| node_models
node_dialogs -->|"edits"| node_models
node_manager -->|"parses"| node_namedparser
node_manager -->|"parses"| node_zoneparser
node_manager -->|"writes"| node_writer
node_manager -->|"validates"| node_validator
node_manager -->|"records events"| node_logger
node_manager -->|"runs commands"| node_system
node_manager -->|"manages service"| node_bind
node_namedparser -->|"produces zones"| node_models
node_zoneparser -->|"produces records"| node_models
node_writer -->|"serializes zones"| node_models
node_logger -->|"stores entries"| node_eventmodel

click node_main "https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/MainWindow.cpp"
click node_zonewizard "https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/ZoneWizard.cpp"
click node_dialogs "https://github.com/ogyreck/dns-manager-bind/tree/main/src/ui"
click node_settings "https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/SettingsDialog.cpp"
click node_help "https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/HelpDialog.cpp"
click node_manager "https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/BindManager.cpp"
click node_validator "https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/ConfigValidator.cpp"
click node_logger "https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/EventLogger.cpp"
click node_namedparser "https://github.com/ogyreck/dns-manager-bind/blob/main/src/parser/NamedConfParser.cpp"
click node_zoneparser "https://github.com/ogyreck/dns-manager-bind/blob/main/src/parser/ZoneFileParser.cpp"
click node_writer "https://github.com/ogyreck/dns-manager-bind/blob/main/src/parser/ConfigWriter.cpp"
click node_models "https://github.com/ogyreck/dns-manager-bind/tree/main/src/model"
click node_eventmodel "https://github.com/ogyreck/dns-manager-bind/blob/main/src/model/EventLogEntry.h"
click node_servermodel "https://github.com/ogyreck/dns-manager-bind/blob/main/src/model/ServerConfig.h"

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_main,node_zonewizard,node_dialogs,node_settings,node_help toneBlue
class node_manager,node_validator,node_logger toneAmber
class node_namedparser,node_zoneparser,node_writer toneMint
class node_models,node_eventmodel,node_servermodel toneRose
class node_user,node_bind,node_system toneIndigo
```

## Components

### Desktop interface

- [Main window](https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/MainWindow.cpp): `src/ui/MainWindow.cpp`
- [Zone wizard](https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/ZoneWizard.cpp): `src/ui/ZoneWizard.cpp`
- [Edit dialogs](https://github.com/ogyreck/dns-manager-bind/tree/main/src/ui): `src/ui`
- [Settings dialog](https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/SettingsDialog.cpp): `src/ui/SettingsDialog.cpp`
- [Help dialog](https://github.com/ogyreck/dns-manager-bind/blob/main/src/ui/HelpDialog.cpp): `src/ui/HelpDialog.cpp`

### BIND operations

- [BIND manager](https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/BindManager.cpp): `src/dns/BindManager.cpp`
- [Config validator](https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/ConfigValidator.cpp): `src/dns/ConfigValidator.cpp`
- [Event logger](https://github.com/ogyreck/dns-manager-bind/blob/main/src/dns/EventLogger.cpp): `src/dns/EventLogger.cpp`

### Configuration parsing

- [named.conf parser](https://github.com/ogyreck/dns-manager-bind/blob/main/src/parser/NamedConfParser.cpp): `src/parser/NamedConfParser.cpp`
- [Zone file parser](https://github.com/ogyreck/dns-manager-bind/blob/main/src/parser/ZoneFileParser.cpp): `src/parser/ZoneFileParser.cpp`
- [Zone config writer](https://github.com/ogyreck/dns-manager-bind/blob/main/src/parser/ConfigWriter.cpp): `src/parser/ConfigWriter.cpp`

### Domain data

- [Zone and record models](https://github.com/ogyreck/dns-manager-bind/tree/main/src/model): `src/model`
- [Event entry model](https://github.com/ogyreck/dns-manager-bind/blob/main/src/model/EventLogEntry.h): `src/model/EventLogEntry.h`
- [Server settings model](https://github.com/ogyreck/dns-manager-bind/blob/main/src/model/ServerConfig.h): `src/model/ServerConfig.h`

### Other components

- **Administrator**
- **BIND9 service**
- **Linux service tools**

## Connections

- Administrator → Main window: uses (evidence: `README.md`)
- Main window → Zone wizard: opens (evidence: `src/ui/MainWindow.cpp`)
- Main window → Edit dialogs: opens (evidence: `src/ui/MainWindow.cpp`)
- Main window → Settings dialog: opens (evidence: `src/ui/MainWindow.cpp`)
- Main window → Help dialog: opens (evidence: `src/ui/MainWindow.cpp`)
- Main window → BIND manager: delegates (evidence: `src/ui/MainWindow.cpp`)
- Main window → Event logger: subscribes (evidence: `src/ui/MainWindow.cpp`)
- Main window → Event entry model: displays
- Zone wizard → Zone and record models: builds
- Edit dialogs → Zone and record models: edits (evidence: `src/ui/RecordDialog.h`)
- BIND manager → named.conf parser: parses (evidence: `src/dns/BindManager.cpp`)
- BIND manager → Zone file parser: parses (evidence: `src/dns/BindManager.cpp`)
- BIND manager → Zone config writer: writes (evidence: `src/dns/BindManager.cpp`)
- BIND manager → Config validator: validates (evidence: `src/dns/BindManager.cpp`)
- BIND manager → Event logger: records events (evidence: `src/dns/BindManager.cpp`)
- BIND manager → Linux service tools: runs commands (evidence: `src/dns/BindManager.cpp`)
- BIND manager → BIND9 service: manages service (evidence: `README.md`)
- named.conf parser → Zone and record models: produces zones
- Zone file parser → Zone and record models: produces records
- Zone config writer → Zone and record models: serializes zones (evidence: `src/parser/ConfigWriter.cpp`)
- Event logger → Event entry model: stores entries
