# greenchannel/website_manager architecture

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

- Interactive diagram: https://gitdiagram.com/greenchannel/website_manager
- Repository: https://github.com/greenchannel/website_manager

## Overview

website_manager is a CMD-oriented key–value list manager. The main workflow is: a user invokes a subcommand, the program selects or identifies a list, performs an operation on its files, and prints results or logs status. The README also documents list merging and directory listing, which are included as capabilities even though their implementations were not shown in the excerpt. The application is concentrated in webm.cpp; spdlog and CLI11 are vendored dependencies. Relationships for unsampled commands are documented rather than inferred from names.

Main entry points: [`webm.cpp`](https://github.com/greenchannel/website_manager/blob/main/webm.cpp) (List operations), [`spdlog/spdlog.h`](https://github.com/greenchannel/website_manager/blob/main/spdlog/spdlog.h) (spdlog API), [`spdlog/details/registry.h`](https://github.com/greenchannel/website_manager/blob/main/spdlog/details/registry.h) (Logger registry), [`spdlog/cfg/helpers-inl.h`](https://github.com/greenchannel/website_manager/blob/main/spdlog/cfg/helpers-inl.h) (Log-level config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["List management"]
  node_environment["Initialize environment<br/>[webm.cpp]"]
  node_selection["Current list selection<br/>[webm.cpp]"]
  node_listops["List operations<br/>[webm.cpp]"]
  node_records[("Key-value records<br/>[webm.cpp]")]
  node_listfiles[("List files<br/>[webm.cpp]")]
  node_config["Active-list config<br/>[webm.cpp]"]
end

subgraph group_cli["Command interface"]
  node_dispatch["CLI dispatch<br/>[webm.cpp]"]
  node_arguments["Argument parsing<br/>[CLI11.hpp]"]
end

subgraph group_logging["Logging"]
  node_logger["spdlog API<br/>[spdlog.h]"]
end

subgraph group_vendor["Logging internals"]
  node_pattern["Log formatting"]
  node_sinks["Log sinks<br/>[base_sink.h]"]
  node_registry["Logger registry<br/>[registry.h]"]
  node_format["Formatting library<br/>[format.h]"]
  node_logconfig["Log-level config<br/>[helpers-inl.h]"]
end

node_user(("CMD user"))

node_user -->|"invokes"| node_dispatch
node_dispatch -->|"parses arguments"| node_arguments
node_dispatch -->|"runs init"| node_environment
node_dispatch -->|"runs set/show"| node_selection
node_dispatch -->|"dispatches commands"| node_listops
node_listops -->|"appends and reads"| node_records
node_listops -->|"creates and deletes"| node_listfiles
node_listops -->|"updates selection"| node_config
node_selection -->|"reads active list"| node_config
node_listops -->|"logs status"| node_logger
node_logger -.->|"formats messages"| node_pattern
node_logger -.->|"emits messages"| node_sinks
node_logger -->|"uses registry"| node_registry
node_logger -.->|"formats arguments"| node_format
node_logconfig -->|"sets levels"| node_registry

click node_dispatch "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_arguments "https://github.com/greenchannel/website_manager/blob/main/CLI11.hpp"
click node_environment "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_selection "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_listops "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_records "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_listfiles "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_config "https://github.com/greenchannel/website_manager/blob/main/webm.cpp"
click node_logger "https://github.com/greenchannel/website_manager/blob/main/spdlog/spdlog.h"
click node_pattern "https://github.com/greenchannel/website_manager/blob/main/spdlog/pattern_formatter-inl.h"
click node_sinks "https://github.com/greenchannel/website_manager/blob/main/spdlog/sinks/base_sink.h"
click node_registry "https://github.com/greenchannel/website_manager/blob/main/spdlog/details/registry.h"
click node_format "https://github.com/greenchannel/website_manager/blob/main/spdlog/fmt/bundled/format.h"
click node_logconfig "https://github.com/greenchannel/website_manager/blob/main/spdlog/cfg/helpers-inl.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_environment,node_selection,node_listops,node_records,node_listfiles,node_config,node_user toneBlue
class node_dispatch,node_arguments toneAmber
class node_logger toneMint
class node_pattern,node_sinks,node_registry,node_format,node_logconfig toneRose
```

## Components

### List management

- [Initialize environment](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`
- [Current list selection](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`
- [List operations](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`
- [Key-value records](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`
- [List files](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`
- [Active-list config](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`

### Command interface

- [CLI dispatch](https://github.com/greenchannel/website_manager/blob/main/webm.cpp): `webm.cpp`
- [Argument parsing](https://github.com/greenchannel/website_manager/blob/main/CLI11.hpp): `CLI11.hpp`

### Logging

- [spdlog API](https://github.com/greenchannel/website_manager/blob/main/spdlog/spdlog.h): `spdlog/spdlog.h`

### Logging internals

- [Log formatting](https://github.com/greenchannel/website_manager/blob/main/spdlog/pattern_formatter-inl.h): `spdlog/pattern_formatter-inl.h`
- [Log sinks](https://github.com/greenchannel/website_manager/blob/main/spdlog/sinks/base_sink.h): `spdlog/sinks/base_sink.h`
- [Logger registry](https://github.com/greenchannel/website_manager/blob/main/spdlog/details/registry.h): `spdlog/details/registry.h`
- [Formatting library](https://github.com/greenchannel/website_manager/blob/main/spdlog/fmt/bundled/format.h): `spdlog/fmt/bundled/format.h`
- [Log-level config](https://github.com/greenchannel/website_manager/blob/main/spdlog/cfg/helpers-inl.h): `spdlog/cfg/helpers-inl.h`

### Other components

- **CMD user**

## Connections

- CMD user → CLI dispatch: invokes
- CLI dispatch → Argument parsing: parses arguments (evidence: `webm.cpp`)
- CLI dispatch → Initialize environment: runs init (evidence: `webm.cpp`)
- CLI dispatch → Current list selection: runs set/show (evidence: `webm.cpp`)
- CLI dispatch → List operations: dispatches commands (evidence: `webm.cpp`)
- List operations → Key-value records: appends and reads (evidence: `webm.cpp`)
- List operations → List files: creates and deletes (evidence: `webm.cpp`)
- List operations → Active-list config: updates selection (evidence: `webm.cpp`)
- Current list selection → Active-list config: reads active list (evidence: `webm.cpp`)
- List operations → spdlog API: logs status (evidence: `webm.cpp`)
- spdlog API → Log formatting: formats messages
- spdlog API → Log sinks: emits messages
- spdlog API → Logger registry: uses registry (evidence: `spdlog/spdlog.h`)
- spdlog API → Formatting library: formats arguments
- Log-level config → Logger registry: sets levels (evidence: `spdlog/cfg/helpers-inl.h`)
