# yahyabhais/uniquekey-generator architecture

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

- Interactive diagram: https://gitdiagram.com/yahyabhais/uniquekey-generator
- Repository: https://github.com/yahyabhais/uniquekey-generator

## Overview

This is a small console application: the user selects key generation, enters a count, receives randomly generated four-part uppercase keys, and the app saves them to a text file. The same menu also provides project information and exit. Generation and persistence are implemented in one source file; the README describes uniqueness and unpredictability, but the shown algorithm does not check for duplicates and uses rand().

Main entry points: [`UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp) (Menu and input), [`UniqueKey-Generator/UniqueKey-Generator/MyGeneratedKeys.txt`](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/MyGeneratedKeys.txt) (Generated keys file)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Console application"]
  node_menu["Menu and input"]
  node_about["About and exit"]
  node_count["Count validation"]
end

subgraph group_generation["Key generation"]
  node_key["Key formatting"]
  node_random["Character selection"]
end

subgraph group_persistence["File output"]
  node_save["Save keys"]
  node_file["Generated keys file"]
end

node_user(("Console user"))

node_user -->|"chooses option"| node_menu
node_menu -->|"reads count"| node_count
node_menu -->|"generates keys"| node_key
node_key -->|"requests characters"| node_random
node_menu -->|"writes key list"| node_save
node_save -->|"writes"| node_file
node_menu -->|"handles options"| node_about

click node_menu "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp"
click node_about "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp"
click node_count "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp"
click node_key "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp"
click node_random "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp"
click node_save "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp"
click node_file "https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/MyGeneratedKeys.txt"

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_menu,node_about,node_count,node_user toneBlue
class node_key,node_random toneAmber
class node_save,node_file toneMint
```

## Components

### Console application

- [Menu and input](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp): `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`
- [About and exit](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp): `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`
- [Count validation](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp): `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`

### Key generation

- [Key formatting](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp): `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`
- [Character selection](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp): `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`

### File output

- [Save keys](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp): `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`
- [Generated keys file](https://github.com/yahyabhais/uniquekey-generator/blob/main/UniqueKey-Generator/UniqueKey-Generator/MyGeneratedKeys.txt): `UniqueKey-Generator/UniqueKey-Generator/MyGeneratedKeys.txt`

### Other components

- **Console user**

## Connections

- Console user → Menu and input: chooses option (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
- Menu and input → Count validation: reads count (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
- Menu and input → Key formatting: generates keys (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
- Key formatting → Character selection: requests characters (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
- Menu and input → Save keys: writes key list (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
- Save keys → Generated keys file: writes (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
- Menu and input → About and exit: handles options (evidence: `UniqueKey-Generator/UniqueKey-Generator/UniqueKey-Generator.cpp`)
