# gabrielgalbavy/kryptologiesolutions architecture

> Architecture diagram of the GitHub repository gabrielgalbavy/kryptologiesolutions, 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/gabrielgalbavy/kryptologiesolutions
- Repository: https://github.com/gabrielgalbavy/kryptologiesolutions

## Overview

Crypto Solver is a Kotlin/Swing desktop application for encrypting, decrypting, and visualizing classical ciphers. The user selects a cipher in the launch menu, opens its dedicated window, enters text and keys or settings, and receives transformed output with cipher-specific previews. Four separate solver implementations cover Affine, Playfair, ADFG(V)X, and RSA; the shared Solver base provides common operations such as text normalization. The README documents capabilities beyond the sampled excerpts; those are represented at subsystem level, and edges are limited to relationships supported by excerpts or documentation.

Main entry points: [`src/crypto/ui/WelcomeFrame.kt`](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/WelcomeFrame.kt) (Cipher menu), [`src/crypto/models/solutionModel.kt`](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/models/solutionModel.kt) (Shared solver logic), [`src/crypto/Main.kt`](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/Main.kt) (Application startup), [`src/crypto/ui/FirstSolutionFrame.kt`](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/FirstSolutionFrame.kt) (Affine workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch"]
  node_app["Application startup<br/>[Main.kt]"]
  node_welcome["Cipher menu<br/>[WelcomeFrame.kt]"]
end

subgraph group_interfaces["Cipher interfaces"]
  node_affine_ui["Affine workspace"]
  node_playfair_ui["Playfair workspace"]
  node_adfgvx_ui["ADFG&#40;V&#41;X workspace"]
  node_rsa_ui["RSA workspace"]
end

subgraph group_engines["Cipher engines"]
  node_affine["Affine solver<br/>[FirstSolution.kt]"]
  node_playfair["Playfair solver<br/>[SecondSolution.kt]"]
  node_adfgvx["ADFG&#40;V&#41;X solver<br/>[ThirdSolution.kt]"]
  node_rsa["RSA solver<br/>[FourthSolution.kt]"]
  node_solver_base["Shared solver logic<br/>[solutionModel.kt]"]
end

node_user(("User"))

node_user -->|"launches"| node_app
node_app -->|"opens"| node_welcome
node_user -->|"selects cipher"| node_welcome
node_welcome -->|"opens"| node_affine_ui
node_welcome -->|"opens"| node_playfair_ui
node_welcome -->|"opens"| node_adfgvx_ui
node_welcome -->|"opens"| node_rsa_ui
node_affine_ui -->|"encrypts or decrypts"| node_affine
node_playfair_ui -->|"configures and encrypts"| node_playfair
node_adfgvx_ui -->|"configures and encrypts"| node_adfgvx
node_rsa_ui -->|"encrypts or decrypts"| node_rsa
node_affine -->|"extends"| node_solver_base
node_playfair -->|"extends"| node_solver_base
node_adfgvx -->|"extends"| node_solver_base
node_rsa -->|"extends"| node_solver_base

click node_app "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/Main.kt"
click node_welcome "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/WelcomeFrame.kt"
click node_affine_ui "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/FirstSolutionFrame.kt"
click node_playfair_ui "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/SecondSolutionFrame.kt"
click node_adfgvx_ui "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/ThirdSolutionFrame.kt"
click node_rsa_ui "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/FourthSolutionFrame.kt"
click node_affine "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/FirstSolution.kt"
click node_playfair "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/SecondSolution.kt"
click node_adfgvx "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/ThirdSolution.kt"
click node_rsa "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/FourthSolution.kt"
click node_solver_base "https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/models/solutionModel.kt"

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_app,node_welcome,node_user toneBlue
class node_affine_ui,node_playfair_ui,node_adfgvx_ui,node_rsa_ui toneAmber
class node_affine,node_playfair,node_adfgvx,node_rsa,node_solver_base toneMint
```

## Components

### Launch

- [Application startup](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/Main.kt): `src/crypto/Main.kt`
- [Cipher menu](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/WelcomeFrame.kt): `src/crypto/ui/WelcomeFrame.kt`

### Cipher interfaces

- [Affine workspace](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/FirstSolutionFrame.kt): `src/crypto/ui/FirstSolutionFrame.kt`
- [Playfair workspace](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/SecondSolutionFrame.kt): `src/crypto/ui/SecondSolutionFrame.kt`
- [ADFG(V)X workspace](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/ThirdSolutionFrame.kt): `src/crypto/ui/ThirdSolutionFrame.kt`
- [RSA workspace](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/ui/FourthSolutionFrame.kt): `src/crypto/ui/FourthSolutionFrame.kt`

### Cipher engines

- [Affine solver](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/FirstSolution.kt): `src/crypto/algorithms/FirstSolution.kt`
- [Playfair solver](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/SecondSolution.kt): `src/crypto/algorithms/SecondSolution.kt`
- [ADFG(V)X solver](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/ThirdSolution.kt): `src/crypto/algorithms/ThirdSolution.kt`
- [RSA solver](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/algorithms/FourthSolution.kt): `src/crypto/algorithms/FourthSolution.kt`
- [Shared solver logic](https://github.com/gabrielgalbavy/kryptologiesolutions/blob/master/src/crypto/models/solutionModel.kt): `src/crypto/models/solutionModel.kt`

### Other components

- **User**

## Connections

- User → Application startup: launches (evidence: `src/crypto/Main.kt`)
- Application startup → Cipher menu: opens (evidence: `src/crypto/Main.kt`)
- User → Cipher menu: selects cipher (evidence: `src/crypto/ui/WelcomeFrame.kt`)
- Cipher menu → Affine workspace: opens (evidence: `src/crypto/ui/WelcomeFrame.kt`)
- Cipher menu → Playfair workspace: opens (evidence: `src/crypto/ui/WelcomeFrame.kt`)
- Cipher menu → ADFG(V)X workspace: opens (evidence: `src/crypto/ui/WelcomeFrame.kt`)
- Cipher menu → RSA workspace: opens (evidence: `src/crypto/ui/WelcomeFrame.kt`)
- Affine workspace → Affine solver: encrypts or decrypts (evidence: `src/crypto/ui/FirstSolutionFrame.kt`)
- Playfair workspace → Playfair solver: configures and encrypts (evidence: `src/crypto/ui/SecondSolutionFrame.kt`)
- ADFG(V)X workspace → ADFG(V)X solver: configures and encrypts (evidence: `src/crypto/ui/ThirdSolutionFrame.kt`)
- RSA workspace → RSA solver: encrypts or decrypts (evidence: `src/crypto/ui/FourthSolutionFrame.kt`)
- Affine solver → Shared solver logic: extends (evidence: `src/crypto/algorithms/FirstSolution.kt`)
- Playfair solver → Shared solver logic: extends (evidence: `src/crypto/algorithms/SecondSolution.kt`)
- ADFG(V)X solver → Shared solver logic: extends (evidence: `src/crypto/algorithms/ThirdSolution.kt`)
- RSA solver → Shared solver logic: extends (evidence: `src/crypto/algorithms/FourthSolution.kt`)
