# beluga550/pawkit architecture

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

- Interactive diagram: https://gitdiagram.com/beluga550/pawkit
- Repository: https://github.com/beluga550/pawkit

## Overview

Pawkit is a Windows desktop console for one Minecraft server operator. The main workflow is connect with RCON credentials, inspect online players, choose a fixed validated management action, confirm risky changes, and view server replies or daily activity. The UI also provides ban and whitelist management, reconnects and refreshes player state, and keeps preferences and history locally. Edges follow explicit README statements or the shown imports and calls; unsampled subsystem wiring is omitted where it cannot be established.

Main entry points: [`src/components/Shell.svelte`](https://github.com/beluga550/pawkit/blob/main/src/components/Shell.svelte) (Navigation shell), [`src/lib/operations.js`](https://github.com/beluga550/pawkit/blob/main/src/lib/operations.js) (Operation confirmation), [`src-tauri/src/commands.rs`](https://github.com/beluga550/pawkit/blob/main/src-tauri/src/commands.rs) (Tauri commands), [`src/lib/session.svelte.js`](https://github.com/beluga550/pawkit/blob/main/src/lib/session.svelte.js) (Connection session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Operator interface"]
  node_connect["Connection setup<br/>[Connect.svelte]"]
  node_app["App shell<br/>[App.svelte]"]
  node_shell["Navigation shell<br/>[Shell.svelte]"]
  node_avatar["Player avatar<br/>[Avatar.svelte]"]
end

subgraph group_state["Session and history"]
  node_operations["Operation confirmation<br/>[operations.js]"]
  node_validation["Input validation<br/>[validate.js]"]
  node_session["Connection session<br/>[session.svelte.js]"]
  node_history["Daily history<br/>[history.svelte.js]"]
  node_storage[("Local preferences<br/>[storage.js]")]
end

subgraph group_backend["Command backend"]
  node_api["Tauri API bridge<br/>[api.js]"]
  node_commands["Tauri commands<br/>[commands.rs]"]
  node_action["Action validation<br/>[action.rs]"]
  node_parse["Reply parsing<br/>[parse.rs]"]
  node_rcon["RCON transport<br/>[rcon.rs]"]
end

subgraph group_features["Server management"]
  node_players["Player management<br/>[Players.svelte]"]
  node_drawer["Player actions"]
  node_composer["Broadcast composer<br/>[Composer.svelte]"]
  node_bans["Ban management<br/>[Bans.svelte]"]
  node_whitelist["Whitelist management<br/>[Whitelist.svelte]"]
  node_historypage["Activity history<br/>[History.svelte]"]
  node_map["Map placeholder<br/>[map.rs]"]
end

node_operator(("Server operator"))
node_server(("Minecraft server"))
node_avatarservice(("mc-heads.net"))

node_operator -->|"enters credentials"| node_connect
node_connect -.->|"connects"| node_session
node_app -->|"renders"| node_shell
node_app -->|"renders"| node_connect
node_shell -->|"routes to"| node_players
node_shell -->|"routes to"| node_bans
node_shell -->|"routes to"| node_whitelist
node_shell -->|"routes to"| node_historypage
node_players -.->|"opens"| node_drawer
node_players -->|"renders"| node_composer
node_drawer -->|"submits actions"| node_operations
node_composer -->|"submits actions"| node_operations
node_bans -->|"submits actions"| node_operations
node_whitelist -->|"submits actions"| node_operations
node_drawer -->|"validates fields"| node_validation
node_composer -->|"validates input"| node_validation
node_bans -->|"validates input"| node_validation
node_operations -->|"runs action"| node_session
node_session -->|"invokes backend"| node_api
node_api -->|"calls commands"| node_commands
node_commands -->|"validates action"| node_action
node_commands -->|"parses replies"| node_parse
node_commands -->|"uses transport"| node_rcon
node_rcon -->|"exchanges RCON"| node_server
node_session -.->|"records activity"| node_history
node_historypage -.->|"reads entries"| node_history
node_history -.->|"persists locally"| node_storage
node_avatar -.->|"loads skin"| node_avatarservice
node_operator -.->|"future capability"| node_map

click node_connect "https://github.com/beluga550/pawkit/blob/main/src/pages/Connect.svelte"
click node_app "https://github.com/beluga550/pawkit/blob/main/src/App.svelte"
click node_shell "https://github.com/beluga550/pawkit/blob/main/src/components/Shell.svelte"
click node_players "https://github.com/beluga550/pawkit/blob/main/src/pages/Players.svelte"
click node_drawer "https://github.com/beluga550/pawkit/blob/main/src/components/PlayerDrawer.svelte"
click node_composer "https://github.com/beluga550/pawkit/blob/main/src/components/Composer.svelte"
click node_bans "https://github.com/beluga550/pawkit/blob/main/src/pages/Bans.svelte"
click node_whitelist "https://github.com/beluga550/pawkit/blob/main/src/pages/Whitelist.svelte"
click node_historypage "https://github.com/beluga550/pawkit/blob/main/src/pages/History.svelte"
click node_operations "https://github.com/beluga550/pawkit/blob/main/src/lib/operations.js"
click node_validation "https://github.com/beluga550/pawkit/blob/main/src/lib/validate.js"
click node_session "https://github.com/beluga550/pawkit/blob/main/src/lib/session.svelte.js"
click node_history "https://github.com/beluga550/pawkit/blob/main/src/lib/history.svelte.js"
click node_storage "https://github.com/beluga550/pawkit/blob/main/src/lib/storage.js"
click node_api "https://github.com/beluga550/pawkit/blob/main/src/lib/api.js"
click node_commands "https://github.com/beluga550/pawkit/blob/main/src-tauri/src/commands.rs"
click node_action "https://github.com/beluga550/pawkit/blob/main/src-tauri/src/action.rs"
click node_parse "https://github.com/beluga550/pawkit/blob/main/src-tauri/src/parse.rs"
click node_rcon "https://github.com/beluga550/pawkit/blob/main/src-tauri/src/rcon.rs"
click node_avatar "https://github.com/beluga550/pawkit/blob/main/src/components/Avatar.svelte"
click node_map "https://github.com/beluga550/pawkit/blob/main/src-tauri/src/map.rs"

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_connect,node_app,node_shell,node_avatar toneBlue
class node_operations,node_validation,node_session,node_history,node_storage toneAmber
class node_api,node_commands,node_action,node_parse,node_rcon,node_operator,node_server toneMint
class node_players,node_drawer,node_composer,node_bans,node_whitelist,node_historypage,node_map toneRose
class node_avatarservice toneIndigo
```

## Components

### Operator interface

- [Connection setup](https://github.com/beluga550/pawkit/blob/main/src/pages/Connect.svelte): `src/pages/Connect.svelte`
- [App shell](https://github.com/beluga550/pawkit/blob/main/src/App.svelte): `src/App.svelte`
- [Navigation shell](https://github.com/beluga550/pawkit/blob/main/src/components/Shell.svelte): `src/components/Shell.svelte`
- [Player avatar](https://github.com/beluga550/pawkit/blob/main/src/components/Avatar.svelte): `src/components/Avatar.svelte`

### Session and history

- [Operation confirmation](https://github.com/beluga550/pawkit/blob/main/src/lib/operations.js): `src/lib/operations.js`
- [Input validation](https://github.com/beluga550/pawkit/blob/main/src/lib/validate.js): `src/lib/validate.js`
- [Connection session](https://github.com/beluga550/pawkit/blob/main/src/lib/session.svelte.js): `src/lib/session.svelte.js`
- [Daily history](https://github.com/beluga550/pawkit/blob/main/src/lib/history.svelte.js): `src/lib/history.svelte.js`
- [Local preferences](https://github.com/beluga550/pawkit/blob/main/src/lib/storage.js): `src/lib/storage.js`

### Command backend

- [Tauri API bridge](https://github.com/beluga550/pawkit/blob/main/src/lib/api.js): `src/lib/api.js`
- [Tauri commands](https://github.com/beluga550/pawkit/blob/main/src-tauri/src/commands.rs): `src-tauri/src/commands.rs`
- [Action validation](https://github.com/beluga550/pawkit/blob/main/src-tauri/src/action.rs): `src-tauri/src/action.rs`
- [Reply parsing](https://github.com/beluga550/pawkit/blob/main/src-tauri/src/parse.rs): `src-tauri/src/parse.rs`
- [RCON transport](https://github.com/beluga550/pawkit/blob/main/src-tauri/src/rcon.rs): `src-tauri/src/rcon.rs`

### Server management

- [Player management](https://github.com/beluga550/pawkit/blob/main/src/pages/Players.svelte): `src/pages/Players.svelte`
- [Player actions](https://github.com/beluga550/pawkit/blob/main/src/components/PlayerDrawer.svelte): `src/components/PlayerDrawer.svelte`
- [Broadcast composer](https://github.com/beluga550/pawkit/blob/main/src/components/Composer.svelte): `src/components/Composer.svelte`
- [Ban management](https://github.com/beluga550/pawkit/blob/main/src/pages/Bans.svelte): `src/pages/Bans.svelte`
- [Whitelist management](https://github.com/beluga550/pawkit/blob/main/src/pages/Whitelist.svelte): `src/pages/Whitelist.svelte`
- [Activity history](https://github.com/beluga550/pawkit/blob/main/src/pages/History.svelte): `src/pages/History.svelte`
- [Map placeholder](https://github.com/beluga550/pawkit/blob/main/src-tauri/src/map.rs): `src-tauri/src/map.rs`

### Other components

- **Server operator**
- **Minecraft server**
- **mc-heads.net**

## Connections

- Server operator → Connection setup: enters credentials
- Connection setup → Connection session: connects
- App shell → Navigation shell: renders (evidence: `src/App.svelte`)
- App shell → Connection setup: renders (evidence: `src/App.svelte`)
- Navigation shell → Player management: routes to (evidence: `src/components/Shell.svelte`)
- Navigation shell → Ban management: routes to (evidence: `src/components/Shell.svelte`)
- Navigation shell → Whitelist management: routes to (evidence: `src/components/Shell.svelte`)
- Navigation shell → Activity history: routes to (evidence: `src/components/Shell.svelte`)
- Player management → Player actions: opens
- Player management → Broadcast composer: renders (evidence: `src/pages/Players.svelte`)
- Player actions → Operation confirmation: submits actions (evidence: `src/components/PlayerDrawer.svelte`)
- Broadcast composer → Operation confirmation: submits actions (evidence: `src/components/Composer.svelte`)
- Ban management → Operation confirmation: submits actions (evidence: `src/pages/Bans.svelte`)
- Whitelist management → Operation confirmation: submits actions (evidence: `src/pages/Whitelist.svelte`)
- Player actions → Input validation: validates fields (evidence: `src/components/PlayerDrawer.svelte`)
- Broadcast composer → Input validation: validates input (evidence: `src/components/Composer.svelte`)
- Ban management → Input validation: validates input (evidence: `src/pages/Bans.svelte`)
- Operation confirmation → Connection session: runs action (evidence: `src/lib/operations.js`)
- Connection session → Tauri API bridge: invokes backend (evidence: `src/lib/session.svelte.js`)
- Tauri API bridge → Tauri commands: calls commands (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → Action validation: validates action (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → Reply parsing: parses replies (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → RCON transport: uses transport (evidence: `src-tauri/src/commands.rs`)
- RCON transport → Minecraft server: exchanges RCON
- Connection session → Daily history: records activity
- Activity history → Daily history: reads entries
- Daily history → Local preferences: persists locally
- Player avatar → mc-heads.net: loads skin
- Server operator → Map placeholder: future capability
