# slimwerken/mainframe-installer architecture

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

- Interactive diagram: https://gitdiagram.com/slimwerken/mainframe-installer
- Repository: https://github.com/slimwerken/mainframe-installer

## Overview

Mainframe-installer is a cross-platform installer for Mainframe with Jarvis; the README says installation begins on the Slim Werken install page or through Claude, and Mainframe and its app are provided only after a valid license code. The repository also includes a local key-protection wizard and a post-installation health checker. The checker’s license-server request and its use of the key module are visible in excerpts; installer internals and several checker controls are not sampled, so their detailed connections are omitted.

Main entry points: [`check/mainframe_check.py`](https://github.com/slimwerken/mainframe-installer/blob/main/check/mainframe_check.py) (Installation checker), [`sleutels/mainframe_sleutels.py`](https://github.com/slimwerken/mainframe-installer/blob/main/sleutels/mainframe_sleutels.py) (Key protection wizard), [`Mainframe-installeren.cmd`](https://github.com/slimwerken/mainframe-installer/blob/main/Mainframe-installeren.cmd) (Windows launcher), [`installeer.ps1`](https://github.com/slimwerken/mainframe-installer/blob/main/installeer.ps1) (PowerShell installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_install_web["Install entry"]
  node_cmd_installer["Windows launcher"]
  node_ps_installer["PowerShell installer<br/>[installeer.ps1]"]
  node_sh_installer["Shell installer<br/>[installeer.sh]"]
  node_license["License code"]
  node_mainframe["Mainframe and app"]
end

subgraph group_security["Key protection"]
  node_key_wizard["Key protection wizard"]
  node_dotenvx["dotenvx"]
end

subgraph group_validation["Health checks"]
  node_checker["Installation checker<br/>[mainframe_check.py]"]
end

node_user(("Mainframe user"))
node_license_api["Slim Werken API"]

node_user -->|"starts installation"| node_install_web
node_user -.->|"runs"| node_cmd_installer
node_user -.->|"runs"| node_ps_installer
node_user -.->|"runs"| node_sh_installer
node_install_web -->|"requires valid code"| node_license
node_license -->|"unlocks"| node_mainframe
node_user -.->|"secures keys"| node_key_wizard
node_key_wizard -->|"invokes"| node_dotenvx
node_user -.->|"runs checks"| node_checker
node_checker -->|"checks license"| node_license_api
node_checker -->|"reports results"| node_license_api
node_checker -->|"calls key protection"| node_key_wizard

click node_cmd_installer "https://github.com/slimwerken/mainframe-installer/blob/main/Mainframe-installeren.cmd"
click node_ps_installer "https://github.com/slimwerken/mainframe-installer/blob/main/installeer.ps1"
click node_sh_installer "https://github.com/slimwerken/mainframe-installer/blob/main/installeer.sh"
click node_key_wizard "https://github.com/slimwerken/mainframe-installer/blob/main/sleutels/mainframe_sleutels.py"
click node_checker "https://github.com/slimwerken/mainframe-installer/blob/main/check/mainframe_check.py"

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_install_web,node_cmd_installer,node_ps_installer,node_sh_installer,node_license,node_mainframe,node_user toneBlue
class node_key_wizard,node_dotenvx toneAmber
class node_checker,node_license_api toneMint
```

## Components

### Installation

- **Install entry**
- [Windows launcher](https://github.com/slimwerken/mainframe-installer/blob/main/Mainframe-installeren.cmd): `Mainframe-installeren.cmd`
- [PowerShell installer](https://github.com/slimwerken/mainframe-installer/blob/main/installeer.ps1): `installeer.ps1`
- [Shell installer](https://github.com/slimwerken/mainframe-installer/blob/main/installeer.sh): `installeer.sh`
- **License code**
- **Mainframe and app**

### Key protection

- [Key protection wizard](https://github.com/slimwerken/mainframe-installer/blob/main/sleutels/mainframe_sleutels.py): `sleutels/mainframe_sleutels.py`
- **dotenvx**

### Health checks

- [Installation checker](https://github.com/slimwerken/mainframe-installer/blob/main/check/mainframe_check.py): `check/mainframe_check.py`

### Other components

- **Mainframe user**
- **Slim Werken API**

## Connections

- Mainframe user → Install entry: starts installation (evidence: `README.md`)
- Mainframe user → Windows launcher: runs
- Mainframe user → PowerShell installer: runs
- Mainframe user → Shell installer: runs
- Install entry → License code: requires valid code (evidence: `README.md`)
- License code → Mainframe and app: unlocks (evidence: `README.md`)
- Mainframe user → Key protection wizard: secures keys
- Key protection wizard → dotenvx: invokes (evidence: `sleutels/mainframe_sleutels.py`)
- Mainframe user → Installation checker: runs checks
- Installation checker → Slim Werken API: checks license (evidence: `check/mainframe_check.py`)
- Installation checker → Slim Werken API: reports results (evidence: `check/mainframe_check.py`)
- Installation checker → Key protection wizard: calls key protection (evidence: `check/mainframe_check.py`)
