# mcfso/irix architecture

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

- Interactive diagram: https://gitdiagram.com/mcfso/irix
- Repository: https://github.com/mcfso/irix

## Overview

IriX is a cross-platform Minecraft server management application: Flutter provides the user-facing workflows, while Rust crates supply native services and a server-cluster control plane. The tree provided omits the Flutter application sources, so UI capabilities and their wiring are represented only where the README supports them; Rust relationships below are limited to documented or indexed references.

Main entry points: [`rust/orchestrator/src/lib.rs`](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/lib.rs) (Orchestrator FFI), [`rust/orchestrator/src/engine.rs`](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/engine.rs) (Reconcile and scaling), [`rust/orchestrator/src/migration.rs`](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/migration.rs) (Migration workflow), [`rust/plugin_host/src/registry.rs`](https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/registry.rs) (Plugin registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Launcher workflows"]
  node_flutter["Flutter launcher"]
  node_instance_market["Instances and marketplace"]
  node_node_files["Nodes and files"]
  node_ai_rag["AI and knowledge base"]
  node_nbt_ui["NBT editor"]
end

subgraph group_native["Rust native services"]
  node_backup["Backup compression<br/>[lib.rs]"]
  node_downloader["Resumable downloads<br/>[lib.rs]"]
  node_file_ops["File operations<br/>[lib.rs]"]
  node_http["HTTP client<br/>[lib.rs]"]
  node_db_client["Remote databases<br/>[lib.rs]"]
  node_vector_store["Vector knowledge store<br/>[lib.rs]"]
  node_devlog["Developer log<br/>[lib.rs]"]
  node_logger["Logging<br/>[lib.rs]"]
  node_nbt_ffi["NBT FFI<br/>[lib.rs]"]
  node_nbt_codec["NBT codec<br/>[nbt.rs]"]
end

subgraph group_cluster["Cluster control plane"]
  node_orchestrator_api["Orchestrator FFI<br/>[lib.rs]"]
  node_engine["Reconcile and scaling<br/>[engine.rs]"]
  node_models["Cluster models<br/>[models.rs]"]
  node_cluster_db[("Cluster state store<br/>[db.rs]")]
  node_migration["Migration workflow<br/>[migration.rs]"]
  node_mcping["Minecraft ping<br/>[mcping.rs]"]
end

subgraph group_extensions["Native extensions"]
  node_plugin_ffi["Plugin host FFI<br/>[lib.rs]"]
  node_registry["Plugin registry<br/>[registry.rs]"]
  node_manifest["Manifest validation<br/>[manifest.rs]"]
  node_loader["Native library loader<br/>[loader.rs]"]
  node_abi["Plugin C ABI<br/>[abi.rs]"]
end

node_operator(("Server operator"))
node_milvus[("Milvus service")]
node_remote_db[("Remote DB service")]
node_managed_nodes["Managed server nodes"]

node_operator -->|"uses"| node_flutter
node_flutter -->|"manages"| node_instance_market
node_flutter -->|"manages"| node_node_files
node_flutter -->|"queries"| node_ai_rag
node_flutter -->|"edits"| node_nbt_ui
node_instance_market -.->|"downloads cores"| node_downloader
node_node_files -.->|"operates files"| node_file_ops
node_node_files -.->|"creates backups"| node_backup
node_ai_rag -->|"stores and retrieves"| node_vector_store
node_vector_store -->|"accesses"| node_milvus
node_ai_rag -->|"requests embeddings"| node_http
node_flutter -->|"connects remotely"| node_db_client
node_db_client -->|"queries"| node_remote_db
node_nbt_ui -->|"calls FFI"| node_nbt_ffi
node_nbt_ffi -->|"uses codec"| node_nbt_codec
node_flutter -->|"calls FFI"| node_orchestrator_api
node_orchestrator_api -->|"reconciles"| node_engine
node_orchestrator_api -->|"handles migration"| node_migration
node_orchestrator_api -->|"opens and updates"| node_cluster_db
node_engine -->|"reads and writes"| node_cluster_db
node_migration -->|"reads and writes"| node_cluster_db
node_engine -->|"uses models"| node_models
node_migration -->|"uses models"| node_models
node_flutter -->|"observes and executes actions"| node_managed_nodes
node_orchestrator_api -->|"returns actions for"| node_managed_nodes
node_flutter -->|"calls FFI"| node_plugin_ffi
node_plugin_ffi -->|"delegates management"| node_registry
node_registry -->|"validates manifests"| node_manifest
node_registry -->|"loads libraries"| node_loader
node_loader -->|"invokes plugin ABI"| node_abi
node_flutter -.->|"records activity"| node_devlog

click node_backup "https://github.com/mcfso/irix/blob/main/rust/backup/src/lib.rs"
click node_downloader "https://github.com/mcfso/irix/blob/main/rust/downloader/src/lib.rs"
click node_file_ops "https://github.com/mcfso/irix/blob/main/rust/file_ops/src/lib.rs"
click node_http "https://github.com/mcfso/irix/blob/main/rust/http_client/src/lib.rs"
click node_db_client "https://github.com/mcfso/irix/blob/main/rust/db_client/src/lib.rs"
click node_vector_store "https://github.com/mcfso/irix/blob/main/rust/vector_store/src/lib.rs"
click node_devlog "https://github.com/mcfso/irix/blob/main/rust/devlog/src/lib.rs"
click node_logger "https://github.com/mcfso/irix/blob/main/rust/logger/src/lib.rs"
click node_nbt_ffi "https://github.com/mcfso/irix/blob/main/rust/nbt/src/lib.rs"
click node_nbt_codec "https://github.com/mcfso/irix/blob/main/rust/nbt/src/nbt.rs"
click node_orchestrator_api "https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/lib.rs"
click node_engine "https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/engine.rs"
click node_models "https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/models.rs"
click node_cluster_db "https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/db.rs"
click node_migration "https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/migration.rs"
click node_mcping "https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/mcping.rs"
click node_plugin_ffi "https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/lib.rs"
click node_registry "https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/registry.rs"
click node_manifest "https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/manifest.rs"
click node_loader "https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/loader.rs"
click node_abi "https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/abi.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_flutter,node_instance_market,node_node_files,node_ai_rag,node_nbt_ui toneBlue
class node_backup,node_downloader,node_file_ops,node_http,node_db_client,node_vector_store,node_devlog,node_logger,node_nbt_ffi,node_nbt_codec,node_milvus,node_remote_db toneAmber
class node_orchestrator_api,node_engine,node_models,node_cluster_db,node_migration,node_mcping,node_operator,node_managed_nodes toneMint
class node_plugin_ffi,node_registry,node_manifest,node_loader,node_abi toneRose
```

## Components

### Launcher workflows

- **Flutter launcher**
- **Instances and marketplace**
- **Nodes and files**
- **AI and knowledge base**
- **NBT editor**

### Rust native services

- [Backup compression](https://github.com/mcfso/irix/blob/main/rust/backup/src/lib.rs): `rust/backup/src/lib.rs`
- [Resumable downloads](https://github.com/mcfso/irix/blob/main/rust/downloader/src/lib.rs): `rust/downloader/src/lib.rs`
- [File operations](https://github.com/mcfso/irix/blob/main/rust/file_ops/src/lib.rs): `rust/file_ops/src/lib.rs`
- [HTTP client](https://github.com/mcfso/irix/blob/main/rust/http_client/src/lib.rs): `rust/http_client/src/lib.rs`
- [Remote databases](https://github.com/mcfso/irix/blob/main/rust/db_client/src/lib.rs): `rust/db_client/src/lib.rs`
- [Vector knowledge store](https://github.com/mcfso/irix/blob/main/rust/vector_store/src/lib.rs): `rust/vector_store/src/lib.rs`
- [Developer log](https://github.com/mcfso/irix/blob/main/rust/devlog/src/lib.rs): `rust/devlog/src/lib.rs`
- [Logging](https://github.com/mcfso/irix/blob/main/rust/logger/src/lib.rs): `rust/logger/src/lib.rs`
- [NBT FFI](https://github.com/mcfso/irix/blob/main/rust/nbt/src/lib.rs): `rust/nbt/src/lib.rs`
- [NBT codec](https://github.com/mcfso/irix/blob/main/rust/nbt/src/nbt.rs): `rust/nbt/src/nbt.rs`

### Cluster control plane

- [Orchestrator FFI](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/lib.rs): `rust/orchestrator/src/lib.rs`
- [Reconcile and scaling](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/engine.rs): `rust/orchestrator/src/engine.rs`
- [Cluster models](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/models.rs): `rust/orchestrator/src/models.rs`
- [Cluster state store](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/db.rs): `rust/orchestrator/src/db.rs`
- [Migration workflow](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/migration.rs): `rust/orchestrator/src/migration.rs`
- [Minecraft ping](https://github.com/mcfso/irix/blob/main/rust/orchestrator/src/mcping.rs): `rust/orchestrator/src/mcping.rs`

### Native extensions

- [Plugin host FFI](https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/lib.rs): `rust/plugin_host/src/lib.rs`
- [Plugin registry](https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/registry.rs): `rust/plugin_host/src/registry.rs`
- [Manifest validation](https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/manifest.rs): `rust/plugin_host/src/manifest.rs`
- [Native library loader](https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/loader.rs): `rust/plugin_host/src/loader.rs`
- [Plugin C ABI](https://github.com/mcfso/irix/blob/main/rust/plugin_host/src/abi.rs): `rust/plugin_host/src/abi.rs`

### Other components

- **Server operator**
- **Milvus service**
- **Remote DB service**
- **Managed server nodes**

## Connections

- Server operator → Flutter launcher: uses (evidence: `README.md`)
- Flutter launcher → Instances and marketplace: manages (evidence: `README.md`)
- Flutter launcher → Nodes and files: manages (evidence: `README.md`)
- Flutter launcher → AI and knowledge base: queries (evidence: `README.md`)
- Flutter launcher → NBT editor: edits (evidence: `README.md`)
- Instances and marketplace → Resumable downloads: downloads cores
- Nodes and files → File operations: operates files
- Nodes and files → Backup compression: creates backups
- AI and knowledge base → Vector knowledge store: stores and retrieves (evidence: `README.md`)
- Vector knowledge store → Milvus service: accesses (evidence: `README.md`)
- AI and knowledge base → HTTP client: requests embeddings (evidence: `README.md`)
- Flutter launcher → Remote databases: connects remotely (evidence: `README.md`)
- Remote databases → Remote DB service: queries (evidence: `README.md`)
- NBT editor → NBT FFI: calls FFI (evidence: `README.md`)
- NBT FFI → NBT codec: uses codec (evidence: `rust/nbt/src/lib.rs`)
- Flutter launcher → Orchestrator FFI: calls FFI (evidence: `README.md`)
- Orchestrator FFI → Reconcile and scaling: reconciles (evidence: `rust/orchestrator/src/lib.rs`)
- Orchestrator FFI → Migration workflow: handles migration (evidence: `rust/orchestrator/src/lib.rs`)
- Orchestrator FFI → Cluster state store: opens and updates (evidence: `rust/orchestrator/src/lib.rs`)
- Reconcile and scaling → Cluster state store: reads and writes (evidence: `rust/orchestrator/src/engine.rs`)
- Migration workflow → Cluster state store: reads and writes (evidence: `rust/orchestrator/src/migration.rs`)
- Reconcile and scaling → Cluster models: uses models (evidence: `rust/orchestrator/src/engine.rs`)
- Migration workflow → Cluster models: uses models (evidence: `rust/orchestrator/src/migration.rs`)
- Flutter launcher → Managed server nodes: observes and executes actions (evidence: `README.md`)
- Orchestrator FFI → Managed server nodes: returns actions for (evidence: `rust/orchestrator/src/lib.rs`)
- Flutter launcher → Plugin host FFI: calls FFI (evidence: `README.md`)
- Plugin host FFI → Plugin registry: delegates management (evidence: `rust/plugin_host/src/lib.rs`)
- Plugin registry → Manifest validation: validates manifests (evidence: `rust/plugin_host/src/registry.rs`)
- Plugin registry → Native library loader: loads libraries (evidence: `rust/plugin_host/src/registry.rs`)
- Native library loader → Plugin C ABI: invokes plugin ABI (evidence: `rust/plugin_host/src/loader.rs`)
- Flutter launcher → Developer log: records activity
