# god3tier/rpc_server_toy architecture

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

- Interactive diagram: https://gitdiagram.com/god3tier/rpc_server_toy
- Repository: https://github.com/god3tier/rpc_server_toy

## Overview

This repository implements a remote file-operation service with a Zig client, a Rust proxy, and a Rust server. The intended request path is client → proxy session → remote server → filesystem, with the proxy caching file data; the excerpts confirm the proxy/server internals but do not show the Zig client's calls or establish its connection to the proxy. The graph therefore leaves that boundary unverified and preserves the server's directory-tree and directory-entry operations as distinct capabilities.

Main entry points: [`remote_server/src/request/executer.rs`](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/request/executer.rs) (File operation executor), [`proxy_server/src/user/mod.rs`](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/user/mod.rs) (Client session), [`remote_server/src/main.rs`](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/main.rs) (Remote listener), [`proxy_server/src/main.rs`](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/main.rs) (Proxy listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_zig_client["File client<br/>[interpose.zig]"]
end

subgraph group_proxy["Proxy"]
  node_proxy_listener["Proxy listener<br/>[main.rs]"]
  node_proxy_session["Client session<br/>[mod.rs]"]
  node_proxy_protocol["Request parser<br/>[mod.rs]"]
  node_cache[("File cache<br/>[mod.rs]")]
  node_cache_entry["Cached file entry<br/>[entry.rs]"]
  node_rpc_client["Remote RPC client<br/>[mod.rs]"]
end

subgraph group_server["Remote server"]
  node_remote_listener["Remote listener<br/>[main.rs]"]
  node_remote_protocol["Request decoder<br/>[mod.rs]"]
  node_executor["File operation executor<br/>[executer.rs]"]
  node_dir_tree["Directory tree<br/>[mod.rs]"]
  node_dir_entries["Directory entries<br/>[getdirentries.rs]"]
  node_threadpool["Worker pool<br/>[workers.rs]"]
end

node_filesystem[("Host filesystem")]

node_proxy_listener -->|"creates session"| node_proxy_session
node_proxy_listener -->|"initializes"| node_cache
node_proxy_session -->|"parses commands"| node_proxy_protocol
node_proxy_session -->|"reads and writes"| node_cache
node_cache -->|"manages entries"| node_cache_entry
node_cache_entry -->|"fetches and flushes"| node_rpc_client
node_rpc_client -.->|"sends requests"| node_remote_listener
node_remote_listener -->|"dispatches jobs"| node_threadpool
node_remote_listener -->|"parses stream"| node_remote_protocol
node_remote_protocol -->|"dispatches operations"| node_executor
node_executor -->|"performs file calls"| node_filesystem
node_executor -->|"builds tree"| node_dir_tree
node_executor -->|"reads entries"| node_dir_entries
node_zig_client -.->|"sends operations"| node_proxy_listener

click node_zig_client "https://github.com/god3tier/rpc_server_toy/blob/main/library_client/src/interpose.zig"
click node_proxy_listener "https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/main.rs"
click node_proxy_session "https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/user/mod.rs"
click node_proxy_protocol "https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/request/mod.rs"
click node_cache "https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/cache/mod.rs"
click node_cache_entry "https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/cache/entry.rs"
click node_rpc_client "https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/client/mod.rs"
click node_remote_listener "https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/main.rs"
click node_remote_protocol "https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/request/mod.rs"
click node_executor "https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/request/executer.rs"
click node_dir_tree "https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/dirtreenode/mod.rs"
click node_dir_entries "https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/getdirentries.rs"
click node_threadpool "https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/threadpool/workers.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_zig_client toneBlue
class node_proxy_listener,node_proxy_session,node_proxy_protocol,node_cache,node_cache_entry,node_rpc_client,node_filesystem toneAmber
class node_remote_listener,node_remote_protocol,node_executor,node_dir_tree,node_dir_entries,node_threadpool toneMint
```

## Components

### Client

- [File client](https://github.com/god3tier/rpc_server_toy/blob/main/library_client/src/interpose.zig): `library_client/src/interpose.zig`

### Proxy

- [Proxy listener](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/main.rs): `proxy_server/src/main.rs`
- [Client session](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/user/mod.rs): `proxy_server/src/user/mod.rs`
- [Request parser](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/request/mod.rs): `proxy_server/src/request/mod.rs`
- [File cache](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/cache/mod.rs): `proxy_server/src/cache/mod.rs`
- [Cached file entry](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/cache/entry.rs): `proxy_server/src/cache/entry.rs`
- [Remote RPC client](https://github.com/god3tier/rpc_server_toy/blob/main/proxy_server/src/client/mod.rs): `proxy_server/src/client/mod.rs`

### Remote server

- [Remote listener](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/main.rs): `remote_server/src/main.rs`
- [Request decoder](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/request/mod.rs): `remote_server/src/request/mod.rs`
- [File operation executor](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/request/executer.rs): `remote_server/src/request/executer.rs`
- [Directory tree](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/dirtreenode/mod.rs): `remote_server/src/dirtreenode/mod.rs`
- [Directory entries](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/getdirentries.rs): `remote_server/src/getdirentries.rs`
- [Worker pool](https://github.com/god3tier/rpc_server_toy/blob/main/remote_server/src/threadpool/workers.rs): `remote_server/src/threadpool/workers.rs`

### Other components

- **Host filesystem**

## Connections

- Proxy listener → Client session: creates session (evidence: `proxy_server/src/main.rs`)
- Proxy listener → File cache: initializes (evidence: `proxy_server/src/main.rs`)
- Client session → Request parser: parses commands (evidence: `proxy_server/src/user/mod.rs`)
- Client session → File cache: reads and writes (evidence: `proxy_server/src/user/mod.rs`)
- File cache → Cached file entry: manages entries (evidence: `proxy_server/src/cache/mod.rs`)
- Cached file entry → Remote RPC client: fetches and flushes (evidence: `proxy_server/src/cache/entry.rs`)
- Remote RPC client → Remote listener: sends requests
- Remote listener → Worker pool: dispatches jobs (evidence: `remote_server/src/main.rs`)
- Remote listener → Request decoder: parses stream (evidence: `remote_server/src/main.rs`)
- Request decoder → File operation executor: dispatches operations (evidence: `remote_server/src/request/mod.rs`)
- File operation executor → Host filesystem: performs file calls (evidence: `remote_server/src/request/executer.rs`)
- File operation executor → Directory tree: builds tree (evidence: `remote_server/src/request/executer.rs`)
- File operation executor → Directory entries: reads entries (evidence: `remote_server/src/request/executer.rs`)
- File client → Proxy listener: sends operations
