# stclairc/hamdb architecture

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

- Interactive diagram: https://gitdiagram.com/stclairc/hamdb
- Repository: https://github.com/stclairc/hamdb

## Overview

hamdb is a Bash-based FCC amateur-radio license database utility. Its documented workflow downloads FCC license data and populates a database; it also provides a query tool. The README does not describe implementation details, so the graph is limited to those documented capabilities.

Main entry points: [`hamdb`](https://github.com/stclairc/hamdb/blob/main/hamdb) (Download and import)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_operator(("Radio operator"))
node_hamdb_import["Download and import"]
node_fcc_data["FCC license data"]
node_license_db[("License database")]
node_query_tool["Query tool"]

node_hamdb_import -->|"downloads"| node_fcc_data
node_hamdb_import -->|"populates"| node_license_db
node_operator -->|"uses"| node_query_tool
node_query_tool -->|"queries"| node_license_db

click node_hamdb_import "https://github.com/stclairc/hamdb/blob/main/hamdb"
click node_query_tool "https://github.com/stclairc/hamdb/blob/main/hamdb"

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_operator,node_fcc_data toneIndigo
class node_hamdb_import,node_query_tool toneTeal
class node_license_db toneAmber
```

## Components

### Other components

- **Radio operator**
- [Download and import](https://github.com/stclairc/hamdb/blob/main/hamdb): `hamdb`
- **FCC license data**
- **License database**
- [Query tool](https://github.com/stclairc/hamdb/blob/main/hamdb): `hamdb`

## Connections

- Download and import → FCC license data: downloads (evidence: `README.md`)
- Download and import → License database: populates (evidence: `README.md`)
- Radio operator → Query tool: uses (evidence: `README.md`)
- Query tool → License database: queries (evidence: `README.md`)
