# harnishraval09-arch/forensic-workstation-builder architecture

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

- Interactive diagram: https://gitdiagram.com/harnishraval09-arch/forensic-workstation-builder
- Repository: https://github.com/harnishraval09-arch/forensic-workstation-builder

## Overview

Forensic Workstation Builder provides GUI and CLI workflows for discovering forensic tools, installing dependency-aware toolsets, managing reusable profiles, and reproducing or comparing environment snapshots. The primary GUI entry point bootstraps tool and profile managers, then hands shared state to the window and its pages. Installation is coordinated by ToolManager, with download and integrity helpers; profiles and tool definitions supply the domain data. Snapshot, audit, and settings capabilities are documented or represented in the tree, but their detailed runtime wiring was not sampled, so those links are omitted or marked unverified. The tree contains parallel package/UI variants; this map follows the fwb package used by the root entry point.

Main entry points: [`fwb/core/tool_manager.py`](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/tool_manager.py) (Tool manager), [`main.py`](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/main.py) (GUI bootstrap), [`fwb/gui/main_window.py`](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/main_window.py) (Main window), [`cli.py`](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/cli.py) (Command line)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["User interfaces"]
  node_cli["Command line<br/>[cli.py]"]
  node_entry["GUI bootstrap<br/>[main.py]"]
  node_window["Main window<br/>[main_window.py]"]
  node_catalog_page["Tool catalogue<br/>[catalogue_page.py]"]
  node_profiles_page["Profile page<br/>[profiles_page.py]"]
  node_jobs_page["Jobs page<br/>[jobs_page.py]"]
  node_snapshots_page["Snapshots page<br/>[snapshots_page.py]"]
  node_settings_page["Settings page<br/>[settings_page.py]"]
  node_app_state["Application state<br/>[app_state.py]"]
end

subgraph group_catalogue["Tool operations"]
  node_workers["Install workers<br/>[workers.py]"]
  node_tool_manager["Tool manager<br/>[tool_manager.py]"]
  node_installer["Install handlers<br/>[installer.py]"]
  node_downloader["Downloader<br/>[downloader.py]"]
  node_security["Hash verification<br/>[security.py]"]
end

subgraph group_profiles["Profiles and plans"]
  node_profile_manager["Profile manager<br/>[profile_manager.py]"]
  node_resolver["Dependency resolver"]
  node_profile_model["Profile model<br/>[profile.py]"]
end

subgraph group_reproduction["Environment history"]
  node_comparator["Snapshot comparator"]
  node_audit["Audit view<br/>[audit_page.py]"]
end

subgraph group_platform["Domain and utilities"]
  node_tool_model["Tool model<br/>[tool.py]"]
  node_logger["Application logging<br/>[logger.py]"]
end

node_user(("Investigator"))
node_download_service(("Download host"))
node_filesystem[("Local files")]

node_user -->|"runs commands"| node_cli
node_user -->|"starts GUI"| node_entry
node_entry -->|"loads manifests"| node_tool_manager
node_entry -->|"creates manager"| node_profile_manager
node_entry -->|"creates resolver"| node_resolver
node_entry -->|"creates installer"| node_installer
node_entry -->|"builds state"| node_app_state
node_entry -->|"opens window"| node_window
node_window -->|"routes to"| node_catalog_page
node_window -->|"routes to"| node_profiles_page
node_window -->|"routes to"| node_jobs_page
node_window -->|"routes to"| node_snapshots_page
node_window -->|"routes to"| node_settings_page
node_window -->|"routes to"| node_audit
node_catalog_page -->|"starts installs"| node_workers
node_workers -->|"calls install"| node_tool_manager
node_tool_manager -->|"downloads files"| node_downloader
node_tool_manager -->|"checks hashes"| node_security
node_tool_manager -->|"loads tool data"| node_tool_model
node_profile_manager -->|"creates profiles"| node_profile_model
node_cli -->|"invokes operations"| node_tool_manager
node_cli -->|"manages profiles"| node_profile_manager
node_cli -->|"resolves dependencies"| node_resolver
node_cli -->|"installs tools"| node_installer
node_cli -->|"compares snapshots"| node_comparator
node_tool_manager -.->|"fetches packages"| node_download_service
node_profile_manager -->|"reads and writes"| node_filesystem
node_tool_manager -->|"loads manifests"| node_filesystem
node_tool_manager -->|"records activity"| node_logger
node_snapshots_page -.->|"snapshot storage"| node_filesystem

click node_cli "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/cli.py"
click node_entry "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/main.py"
click node_window "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/main_window.py"
click node_catalog_page "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/catalogue_page.py"
click node_profiles_page "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/profiles_page.py"
click node_jobs_page "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/jobs_page.py"
click node_snapshots_page "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/snapshots_page.py"
click node_settings_page "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/settings_page.py"
click node_app_state "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/app_state.py"
click node_workers "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/workers.py"
click node_tool_manager "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/tool_manager.py"
click node_installer "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/installer.py"
click node_downloader "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/downloader.py"
click node_security "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/security.py"
click node_profile_manager "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/profile_manager.py"
click node_resolver "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/dependency_resolver.py"
click node_profile_model "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/models/profile.py"
click node_comparator "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/snapshot_comparator.py"
click node_audit "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/audit_page.py"
click node_tool_model "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/models/tool.py"
click node_logger "https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/logger.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_cli,node_entry,node_window,node_catalog_page,node_profiles_page,node_jobs_page,node_snapshots_page,node_settings_page,node_app_state toneBlue
class node_workers,node_tool_manager,node_installer,node_downloader,node_security,node_filesystem toneAmber
class node_profile_manager,node_resolver,node_profile_model toneMint
class node_comparator,node_audit toneRose
class node_tool_model,node_logger,node_user,node_download_service toneIndigo
```

## Components

### User interfaces

- [Command line](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/cli.py): `cli.py`
- [GUI bootstrap](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/main.py): `main.py`
- [Main window](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/main_window.py): `fwb/gui/main_window.py`
- [Tool catalogue](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/catalogue_page.py): `fwb/gui/pages/catalogue_page.py`
- [Profile page](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/profiles_page.py): `fwb/gui/pages/profiles_page.py`
- [Jobs page](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/jobs_page.py): `fwb/gui/pages/jobs_page.py`
- [Snapshots page](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/snapshots_page.py): `fwb/gui/pages/snapshots_page.py`
- [Settings page](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/settings_page.py): `fwb/gui/pages/settings_page.py`
- [Application state](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/app_state.py): `fwb/gui/app_state.py`

### Tool operations

- [Install workers](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/workers.py): `fwb/gui/workers.py`
- [Tool manager](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/tool_manager.py): `fwb/core/tool_manager.py`
- [Install handlers](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/installer.py): `fwb/core/installer.py`
- [Downloader](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/downloader.py): `fwb/utils/downloader.py`
- [Hash verification](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/security.py): `fwb/utils/security.py`

### Profiles and plans

- [Profile manager](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/profile_manager.py): `fwb/core/profile_manager.py`
- [Dependency resolver](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/core/dependency_resolver.py): `fwb/core/dependency_resolver.py`
- [Profile model](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/models/profile.py): `fwb/models/profile.py`

### Environment history

- [Snapshot comparator](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/snapshot_comparator.py): `fwb/utils/snapshot_comparator.py`
- [Audit view](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/gui/pages/audit_page.py): `fwb/gui/pages/audit_page.py`

### Domain and utilities

- [Tool model](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/models/tool.py): `fwb/models/tool.py`
- [Application logging](https://github.com/harnishraval09-arch/forensic-workstation-builder/blob/main/fwb/utils/logger.py): `fwb/utils/logger.py`

### Other components

- **Investigator**
- **Download host**
- **Local files**

## Connections

- Investigator → Command line: runs commands
- Investigator → GUI bootstrap: starts GUI
- GUI bootstrap → Tool manager: loads manifests (evidence: `main.py`)
- GUI bootstrap → Profile manager: creates manager (evidence: `main.py`)
- GUI bootstrap → Dependency resolver: creates resolver (evidence: `main.py`)
- GUI bootstrap → Install handlers: creates installer (evidence: `main.py`)
- GUI bootstrap → Application state: builds state (evidence: `main.py`)
- GUI bootstrap → Main window: opens window (evidence: `main.py`)
- Main window → Tool catalogue: routes to (evidence: `fwb/gui/main_window.py`)
- Main window → Profile page: routes to (evidence: `fwb/gui/main_window.py`)
- Main window → Jobs page: routes to (evidence: `fwb/gui/main_window.py`)
- Main window → Snapshots page: routes to (evidence: `fwb/gui/main_window.py`)
- Main window → Settings page: routes to (evidence: `fwb/gui/main_window.py`)
- Main window → Audit view: routes to (evidence: `fwb/gui/main_window.py`)
- Tool catalogue → Install workers: starts installs
- Install workers → Tool manager: calls install
- Tool manager → Downloader: downloads files (evidence: `fwb/core/tool_manager.py`)
- Tool manager → Hash verification: checks hashes (evidence: `fwb/core/tool_manager.py`)
- Tool manager → Tool model: loads tool data (evidence: `fwb/core/tool_manager.py`)
- Profile manager → Profile model: creates profiles (evidence: `fwb/core/profile_manager.py`)
- Command line → Tool manager: invokes operations (evidence: `cli.py`)
- Command line → Profile manager: manages profiles (evidence: `cli.py`)
- Command line → Dependency resolver: resolves dependencies (evidence: `cli.py`)
- Command line → Install handlers: installs tools (evidence: `cli.py`)
- Command line → Snapshot comparator: compares snapshots (evidence: `cli.py`)
- Tool manager → Download host: fetches packages
- Profile manager → Local files: reads and writes (evidence: `fwb/core/profile_manager.py`)
- Tool manager → Local files: loads manifests
- Tool manager → Application logging: records activity (evidence: `fwb/core/tool_manager.py`)
- Snapshots page → Local files: snapshot storage
