# skygreen2001/redishelper architecture

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

- Interactive diagram: https://gitdiagram.com/skygreen2001/redishelper
- Repository: https://github.com/skygreen2001/redishelper

## Overview

Redis小助手 is a cross-platform Redis administration app with desktop (Tauri) and browser modes. Users configure a server, choose a database, browse/search keys, and edit or manage values; the same interface also exposes monitoring, memory analysis, slow logs, audit history, import/export, and a recoverable trash flow. The frontend selects Tauri IPC or a browser adapter, while Rust commands handle desktop operations and Redis access. The README documents the browser WebSocket proxy and several capabilities whose implementation paths were not sampled; those links are documented rather than inferred from unseen code.

Main entry points: [`src/frontend/views/MainView.vue`](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/MainView.vue) (Main workspace), [`src-tauri/src/main.rs`](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/main.rs) (Tauri command host), [`src-tauri/src/commands/redis.rs`](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/redis.rs) (Redis commands), [`src-tauri/src/redis/connection.rs`](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/redis/connection.rs) (Redis connection layer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_mainview["Main workspace<br/>[MainView.vue]"]
  node_serverconfig["Server settings"]
  node_home["Key browser<br/>[HomeView.vue]"]
  node_tabbar["Tabs<br/>[TabBar.vue]"]
  node_memoryui["Memory dashboard<br/>[MemoryDialog.vue]"]
  node_logui["Logs and audit UI<br/>[LogDialog.vue]"]
end

subgraph group_frontend["Frontend services"]
  node_sessions["Session manager<br/>[SessionManager.ts]"]
  node_session["Session state<br/>[Session.ts]"]
  node_stores["Frontend stores"]
  node_invoke["Runtime dispatcher<br/>[tauri.ts]"]
end

subgraph group_backend["Desktop backend"]
  node_tauri["Tauri command host<br/>[main.rs]"]
  node_servercmd["Server commands<br/>[server.rs]"]
  node_rediscmd["Redis commands<br/>[redis.rs]"]
  node_trashcmd["Trash commands<br/>[trash.rs]"]
  node_auditcmd["Audit commands<br/>[audit.rs]"]
  node_exportcmd["Import export<br/>[export.rs]"]
  node_config[("Config storage<br/>[config.rs]")]
  node_trashstore[("Trash storage<br/>[trash.rs]")]
end

subgraph group_redis["Redis operations"]
  node_connection["Redis connection layer<br/>[connection.rs]"]
  node_audit["Redis audit log<br/>[audit.rs]"]
  node_redisserver[("Redis server")]
end

subgraph group_browser["Browser connectivity"]
  node_browseradapter["Browser adapter<br/>[browser-adapter.ts]"]
  node_proxy["WebSocket proxy<br/>[ws-proxy.js]"]
end

node_user(("Redis operator"))
node_browseruser(("Browser user"))

node_user -->|"uses"| node_mainview
node_mainview -->|"opens settings"| node_serverconfig
node_mainview -->|"shows keys"| node_home
node_mainview -->|"renders"| node_tabbar
node_mainview -->|"opens analysis"| node_memoryui
node_mainview -->|"opens logs"| node_logui
node_mainview -->|"manages tabs"| node_sessions
node_sessions -->|"creates sessions"| node_session
node_session -->|"invokes commands"| node_invoke
node_serverconfig -->|"updates configuration"| node_stores
node_home -->|"loads key data"| node_stores
node_memoryui -->|"requests metrics"| node_stores
node_logui -->|"reads log state"| node_stores
node_invoke -->|"dispatches browser calls"| node_browseradapter
node_browseradapter -->|"forwards Redis requests"| node_proxy
node_browseruser -->|"uses browser app"| node_mainview
node_proxy -->|"relays commands"| node_redisserver
node_invoke -.->|"sends IPC"| node_tauri
node_tauri -->|"registers commands"| node_servercmd
node_tauri -->|"registers commands"| node_rediscmd
node_tauri -->|"registers commands"| node_trashcmd
node_tauri -->|"registers commands"| node_auditcmd
node_tauri -->|"registers commands"| node_exportcmd
node_servercmd -->|"reads and writes"| node_config
node_rediscmd -->|"executes Redis operations"| node_connection
node_rediscmd -->|"records operations"| node_audit
node_rediscmd -->|"checks settings"| node_config
node_trashcmd -->|"persists trash"| node_trashstore
node_trashcmd -->|"moves keys"| node_connection
node_auditcmd -->|"queries audit data"| node_audit
node_auditcmd -->|"checks audit setting"| node_config
node_exportcmd -->|"imports or exports data"| node_connection
node_connection -->|"reads and writes"| node_redisserver
node_audit -->|"stores audit records"| node_redisserver

click node_mainview "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/MainView.vue"
click node_serverconfig "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/ServerConfigView.vue"
click node_home "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/HomeView.vue"
click node_tabbar "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/components/TabBar.vue"
click node_memoryui "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/components/MemoryDialog.vue"
click node_logui "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/components/LogDialog.vue"
click node_sessions "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/sessions/SessionManager.ts"
click node_session "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/sessions/Session.ts"
click node_stores "https://github.com/skygreen2001/redishelper/tree/master/src/frontend/stores"
click node_invoke "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/utils/tauri.ts"
click node_browseradapter "https://github.com/skygreen2001/redishelper/blob/master/src/frontend/adapters/browser-adapter.ts"
click node_proxy "https://github.com/skygreen2001/redishelper/blob/master/server/ws-proxy.js"
click node_tauri "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/main.rs"
click node_servercmd "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/server.rs"
click node_rediscmd "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/redis.rs"
click node_trashcmd "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/trash.rs"
click node_auditcmd "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/audit.rs"
click node_exportcmd "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/export.rs"
click node_config "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/storage/config.rs"
click node_trashstore "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/storage/trash.rs"
click node_connection "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/redis/connection.rs"
click node_audit "https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/redis/audit.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_mainview,node_serverconfig,node_home,node_tabbar,node_memoryui,node_logui,node_browseruser toneBlue
class node_sessions,node_session,node_stores,node_invoke,node_user toneAmber
class node_tauri,node_servercmd,node_rediscmd,node_trashcmd,node_auditcmd,node_exportcmd,node_config,node_trashstore toneMint
class node_connection,node_audit,node_redisserver toneRose
class node_browseradapter,node_proxy toneIndigo
```

## Components

### User interface

- [Main workspace](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/MainView.vue): `src/frontend/views/MainView.vue`
- [Server settings](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/ServerConfigView.vue): `src/frontend/views/ServerConfigView.vue`
- [Key browser](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/views/HomeView.vue): `src/frontend/views/HomeView.vue`
- [Tabs](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/components/TabBar.vue): `src/frontend/components/TabBar.vue`
- [Memory dashboard](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/components/MemoryDialog.vue): `src/frontend/components/MemoryDialog.vue`
- [Logs and audit UI](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/components/LogDialog.vue): `src/frontend/components/LogDialog.vue`

### Frontend services

- [Session manager](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/sessions/SessionManager.ts): `src/frontend/sessions/SessionManager.ts`
- [Session state](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/sessions/Session.ts): `src/frontend/sessions/Session.ts`
- [Frontend stores](https://github.com/skygreen2001/redishelper/tree/master/src/frontend/stores): `src/frontend/stores`
- [Runtime dispatcher](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/utils/tauri.ts): `src/frontend/utils/tauri.ts`

### Desktop backend

- [Tauri command host](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/main.rs): `src-tauri/src/main.rs`
- [Server commands](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/server.rs): `src-tauri/src/commands/server.rs`
- [Redis commands](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/redis.rs): `src-tauri/src/commands/redis.rs`
- [Trash commands](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/trash.rs): `src-tauri/src/commands/trash.rs`
- [Audit commands](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/audit.rs): `src-tauri/src/commands/audit.rs`
- [Import export](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/commands/export.rs): `src-tauri/src/commands/export.rs`
- [Config storage](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/storage/config.rs): `src-tauri/src/storage/config.rs`
- [Trash storage](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/storage/trash.rs): `src-tauri/src/storage/trash.rs`

### Redis operations

- [Redis connection layer](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/redis/connection.rs): `src-tauri/src/redis/connection.rs`
- [Redis audit log](https://github.com/skygreen2001/redishelper/blob/master/src-tauri/src/redis/audit.rs): `src-tauri/src/redis/audit.rs`
- **Redis server**

### Browser connectivity

- [Browser adapter](https://github.com/skygreen2001/redishelper/blob/master/src/frontend/adapters/browser-adapter.ts): `src/frontend/adapters/browser-adapter.ts`
- [WebSocket proxy](https://github.com/skygreen2001/redishelper/blob/master/server/ws-proxy.js): `server/ws-proxy.js`

### Other components

- **Redis operator**
- **Browser user**

## Connections

- Redis operator → Main workspace: uses (evidence: `README.md`)
- Main workspace → Server settings: opens settings (evidence: `src/frontend/views/MainView.vue`)
- Main workspace → Key browser: shows keys (evidence: `src/frontend/views/MainView.vue`)
- Main workspace → Tabs: renders (evidence: `src/frontend/views/MainView.vue`)
- Main workspace → Memory dashboard: opens analysis (evidence: `src/frontend/views/MainView.vue`)
- Main workspace → Logs and audit UI: opens logs (evidence: `src/frontend/views/MainView.vue`)
- Main workspace → Session manager: manages tabs (evidence: `src/frontend/views/MainView.vue`)
- Session manager → Session state: creates sessions (evidence: `src/frontend/sessions/SessionManager.ts`)
- Session state → Runtime dispatcher: invokes commands (evidence: `src/frontend/sessions/Session.ts`)
- Server settings → Frontend stores: updates configuration (evidence: `src/frontend/views/ServerConfigView.vue`)
- Key browser → Frontend stores: loads key data (evidence: `src/frontend/views/HomeView.vue`)
- Memory dashboard → Frontend stores: requests metrics (evidence: `src/frontend/components/MemoryDialog.vue`)
- Logs and audit UI → Frontend stores: reads log state (evidence: `src/frontend/components/LogDialog.vue`)
- Runtime dispatcher → Browser adapter: dispatches browser calls (evidence: `src/frontend/utils/tauri.ts`)
- Browser adapter → WebSocket proxy: forwards Redis requests (evidence: `README.md`)
- Browser user → Main workspace: uses browser app (evidence: `README.md`)
- WebSocket proxy → Redis server: relays commands (evidence: `README.md`)
- Runtime dispatcher → Tauri command host: sends IPC
- Tauri command host → Server commands: registers commands (evidence: `src-tauri/src/main.rs`)
- Tauri command host → Redis commands: registers commands (evidence: `src-tauri/src/main.rs`)
- Tauri command host → Trash commands: registers commands (evidence: `src-tauri/src/main.rs`)
- Tauri command host → Audit commands: registers commands (evidence: `src-tauri/src/main.rs`)
- Tauri command host → Import export: registers commands (evidence: `src-tauri/src/main.rs`)
- Server commands → Config storage: reads and writes (evidence: `src-tauri/src/commands/server.rs`)
- Redis commands → Redis connection layer: executes Redis operations (evidence: `src-tauri/src/commands/redis.rs`)
- Redis commands → Redis audit log: records operations (evidence: `src-tauri/src/commands/redis.rs`)
- Redis commands → Config storage: checks settings (evidence: `src-tauri/src/commands/redis.rs`)
- Trash commands → Trash storage: persists trash (evidence: `src-tauri/src/commands/trash.rs`)
- Trash commands → Redis connection layer: moves keys (evidence: `src-tauri/src/commands/trash.rs`)
- Audit commands → Redis audit log: queries audit data (evidence: `src-tauri/src/commands/audit.rs`)
- Audit commands → Config storage: checks audit setting (evidence: `src-tauri/src/commands/audit.rs`)
- Import export → Redis connection layer: imports or exports data (evidence: `src-tauri/src/commands/export.rs`)
- Redis connection layer → Redis server: reads and writes (evidence: `README.md`)
- Redis audit log → Redis server: stores audit records (evidence: `src-tauri/src/redis/audit.rs`)
