# futurelesswindchan/dlctool0fwindchan architecture

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

## Overview

KAZEUSA is a Wails desktop manager for Steam DLC manifests and decryption-key packages. Users configure and check their Steam/OST environment, search online sources, compare source trial results, select a package, and deploy selected DLC manifests; they can also import ZIPs and manage an installed library. The frontend separates views, state, and a Wails API wrapper from Go application services and source/deployment modules. README documents key backend stages, but most Go implementation files were not sampled, so internal call links are omitted where evidence is unavailable.

Main entry points: [`app.go`](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/app.go) (App services), [`frontend/src/api/index.ts`](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/api/index.ts) (API wrapper), [`app_trial.go`](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/app_trial.go) (Source trials), [`frontend/src/composables/useDlcSelection.ts`](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/composables/useDlcSelection.ts) (DLC selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop interface"]
  node_app_ui["App shell<br/>[App.vue]"]
  node_search_view["Search view<br/>[SearchPane.vue]"]
  node_search_state["Search state<br/>[search.ts]"]
  node_game_view["Game details<br/>[GamePane.vue]"]
  node_dlc_selection["DLC selection<br/>[useDlcSelection.ts]"]
  node_library_state["Library state<br/>[library.ts]"]
  node_import_view["ZIP import<br/>[ImportPane.vue]"]
end

subgraph group_workflow["Acquisition workflow"]
  node_trial["Source trials<br/>[app_trial.go]"]
  node_repository_clients["Repository clients<br/>[repo_client.go]"]
  node_store_client["Store client<br/>[store_client.go]"]
  node_manifest_client["Manifest client<br/>[msite_client.go]"]
  node_package_parser["Package parsing<br/>[lua_parser.go]"]
  node_package_store[("Package storage<br/>[package_store.go]")]
end

subgraph group_backend["Application services"]
  node_api["API wrapper<br/>[index.ts]"]
  node_bindings["Wails bindings<br/>[App.js]"]
  node_app_service["App services<br/>[app.go]"]
  node_deployment["Manifest deployment<br/>[deployer.go]"]
  node_environment["Environment detection<br/>[detector.go]"]
end

subgraph group_integrations["External systems"]
  node_ost_deployer["OST integration<br/>[deployer_ost.go]"]
  node_steam["Steam installation"]
  node_online_sources["Online sources"]
  node_ost["OpenSteamTool"]
end

node_user(("User"))

node_user -->|"searches"| node_search_view
node_search_view -->|"triggers"| node_search_state
node_search_state -->|"requests"| node_api
node_api -->|"calls"| node_bindings
node_bindings -->|"invokes"| node_app_service
node_user -->|"selects package"| node_game_view
node_game_view -->|"manages DLCs"| node_dlc_selection
node_dlc_selection -->|"deploys selection"| node_api
node_dlc_selection -->|"refreshes"| node_library_state
node_app_ui -->|"checks startup"| node_api
node_library_state -->|"reads history"| node_api
node_user -->|"imports ZIP"| node_import_view
node_import_view -->|"submits file"| node_api
node_app_service -.->|"runs trials"| node_trial
node_trial -.->|"queries sources"| node_repository_clients
node_trial -.->|"probes stores"| node_store_client
node_trial -.->|"probes manifests"| node_manifest_client
node_online_sources -.->|"serves packages"| node_repository_clients
node_online_sources -.->|"serves manifests"| node_store_client
node_online_sources -.->|"serves credentials"| node_manifest_client
node_app_service -.->|"parses manifests"| node_package_parser
node_app_service -.->|"stores packages"| node_package_store
node_app_service -->|"deploys files"| node_deployment
node_deployment -.->|"uses OST mode"| node_ost_deployer
node_ost_deployer -->|"integrates with"| node_ost
node_app_service -.->|"checks setup"| node_environment
node_environment -.->|"detects installation"| node_steam

click node_app_ui "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/App.vue"
click node_search_view "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/views/panes/SearchPane.vue"
click node_search_state "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/stores/search.ts"
click node_game_view "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/views/panes/GamePane.vue"
click node_dlc_selection "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/composables/useDlcSelection.ts"
click node_library_state "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/stores/library.ts"
click node_import_view "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/views/panes/ImportPane.vue"
click node_api "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/api/index.ts"
click node_bindings "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/wailsjs/go/main/App.js"
click node_app_service "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/app.go"
click node_trial "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/app_trial.go"
click node_repository_clients "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/repo_client.go"
click node_store_client "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/store_client.go"
click node_manifest_client "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/msite_client.go"
click node_package_parser "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/lua_parser.go"
click node_package_store "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/package_store.go"
click node_deployment "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/deployer.go"
click node_ost_deployer "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/deployer_ost.go"
click node_environment "https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/detector.go"

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_ui,node_search_view,node_search_state,node_game_view,node_dlc_selection,node_library_state,node_import_view,node_user toneBlue
class node_trial,node_repository_clients,node_store_client,node_manifest_client,node_package_parser,node_package_store toneAmber
class node_api,node_bindings,node_app_service,node_deployment,node_environment toneMint
class node_ost_deployer,node_steam,node_online_sources,node_ost toneRose
```

## Components

### Desktop interface

- [App shell](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Search view](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/views/panes/SearchPane.vue): `frontend/src/views/panes/SearchPane.vue`
- [Search state](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/stores/search.ts): `frontend/src/stores/search.ts`
- [Game details](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/views/panes/GamePane.vue): `frontend/src/views/panes/GamePane.vue`
- [DLC selection](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/composables/useDlcSelection.ts): `frontend/src/composables/useDlcSelection.ts`
- [Library state](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/stores/library.ts): `frontend/src/stores/library.ts`
- [ZIP import](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/views/panes/ImportPane.vue): `frontend/src/views/panes/ImportPane.vue`

### Acquisition workflow

- [Source trials](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/app_trial.go): `app_trial.go`
- [Repository clients](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/repo_client.go): `repo_client.go`
- [Store client](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/store_client.go): `store_client.go`
- [Manifest client](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/msite_client.go): `msite_client.go`
- [Package parsing](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/lua_parser.go): `lua_parser.go`
- [Package storage](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/package_store.go): `package_store.go`

### Application services

- [API wrapper](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/src/api/index.ts): `frontend/src/api/index.ts`
- [Wails bindings](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/frontend/wailsjs/go/main/App.js): `frontend/wailsjs/go/main/App.js`
- [App services](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/app.go): `app.go`
- [Manifest deployment](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/deployer.go): `deployer.go`
- [Environment detection](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/detector.go): `detector.go`

### External systems

- [OST integration](https://github.com/futurelesswindchan/dlctool0fwindchan/blob/main/deployer_ost.go): `deployer_ost.go`
- **Steam installation**
- **Online sources**
- **OpenSteamTool**

### Other components

- **User**

## Connections

- User → Search view: searches
- Search view → Search state: triggers (evidence: `frontend/src/views/panes/SearchPane.vue`)
- Search state → API wrapper: requests (evidence: `frontend/src/stores/search.ts`)
- API wrapper → Wails bindings: calls (evidence: `frontend/src/api/index.ts`)
- Wails bindings → App services: invokes (evidence: `frontend/wailsjs/go/main/App.js`)
- User → Game details: selects package
- Game details → DLC selection: manages DLCs (evidence: `frontend/src/views/panes/GamePane.vue`)
- DLC selection → API wrapper: deploys selection (evidence: `frontend/src/composables/useDlcSelection.ts`)
- DLC selection → Library state: refreshes (evidence: `frontend/src/composables/useDlcSelection.ts`)
- App shell → API wrapper: checks startup (evidence: `frontend/src/App.vue`)
- Library state → API wrapper: reads history (evidence: `frontend/src/stores/library.ts`)
- User → ZIP import: imports ZIP
- ZIP import → API wrapper: submits file (evidence: `frontend/src/views/panes/ImportPane.vue`)
- App services → Source trials: runs trials
- Source trials → Repository clients: queries sources
- Source trials → Store client: probes stores
- Source trials → Manifest client: probes manifests
- Online sources → Repository clients: serves packages
- Online sources → Store client: serves manifests
- Online sources → Manifest client: serves credentials
- App services → Package parsing: parses manifests
- App services → Package storage: stores packages
- App services → Manifest deployment: deploys files
- Manifest deployment → OST integration: uses OST mode
- OST integration → OpenSteamTool: integrates with
- App services → Environment detection: checks setup
- Environment detection → Steam installation: detects installation
