# sabanvurgun03-ui/kediray architecture

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

- Interactive diagram: https://gitdiagram.com/sabanvurgun03-ui/kediray
- Repository: https://github.com/sabanvurgun03-ui/kediray

## Overview

KediRay is an OpenWrt VPN manager combining a LuCI interface with a router-side CLI and runtime. The user configures VPN engines, servers, routing rules, and traffic controls in LuCI; the CLI and service files provide the router-side operations. Separate branches provide traffic reporting, optional dashboard and theme features, AW1K integration, and an opt-in anonymous usage counter. README statements document several capabilities, but the sampled source does not reveal most UI-to-runtime wiring, so those links are omitted.

Main entry points: [`package/kediray/files/usr/bin/kediray`](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/bin/kediray) (KediRay CLI), [`luci-app-kediray/htdocs/luci-static/resources/view/kediray/ayir.js`](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/ayir.js) (VPN separation), [`server/stats-worker/worker.js`](https://github.com/sabanvurgun03-ui/kediray/blob/main/server/stats-worker/worker.js) (Usage counter API), [`package/kediray/files/etc/init.d/kediray`](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/init.d/kediray) (Service lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["LuCI Interface"]
  node_dashboard_view["Control panel<br/>[dash.js]"]
  node_status_view["Status<br/>[status.js]"]
  node_separation_view["VPN separation<br/>[ayir.js]"]
  node_cores_view["Core management<br/>[cores.js]"]
  node_settings_view["Settings<br/>[settings.js]"]
  node_traffic_view["Traffic view<br/>[trafik.js]"]
  node_logs_view["Logs<br/>[log.js]"]
  node_about_view["About and backup<br/>[about.js]"]
  node_translations["Translations<br/>[i18n.js]"]
end

subgraph group_runtime["VPN Runtime"]
  node_cli["KediRay CLI"]
  node_service["Service lifecycle<br/>[kediray]"]
  node_configuration["VPN configuration"]
  node_node_manager["Server nodes<br/>[node.uc]"]
  node_firewall_hooks["Network hooks<br/>[99-kediray]"]
end

subgraph group_insights["Traffic and Insights"]
  node_traffic_engine["Traffic accounting<br/>[traffic.uc]"]
  node_stats_worker["Usage counter API<br/>[worker.js]"]
end

subgraph group_appearance["Themes and Dashboard"]
  node_theme["Kedi LuCI theme<br/>[kedi.css]"]
  node_dashboard_bundle["MetaCubeXD bundle<br/>[metacubexd.tgz]"]
end

subgraph group_integrations["External Integrations"]
  node_stats_store[("Cloudflare KV")]
  node_vpn_engines["VPN engines"]
  node_aw1k_tools["AW1K modem tools"]
end

node_operator(("Router operator"))

node_operator -->|"uses"| node_dashboard_view
node_operator -->|"configures routing"| node_separation_view
node_operator -->|"manages engines"| node_cores_view
node_operator -->|"views usage"| node_traffic_view
node_operator -->|"backs up"| node_about_view
node_separation_view -->|"executes commands"| node_cli
node_cli -.->|"starts and stops"| node_vpn_engines
node_service -.->|"starts service"| node_cli
node_operator -->|"runs commands"| node_cli
node_operator -->|"selects appearance"| node_theme
node_operator -->|"opens dashboard"| node_dashboard_bundle
node_stats_worker -->|"reads and writes"| node_stats_store
node_operator -->|"opts into reporting"| node_stats_worker
node_operator -->|"uses companion app"| node_aw1k_tools

click node_dashboard_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/dash.js"
click node_status_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/status.js"
click node_separation_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/ayir.js"
click node_cores_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/cores.js"
click node_settings_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/settings.js"
click node_traffic_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/trafik.js"
click node_logs_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/log.js"
click node_about_view "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/about.js"
click node_translations "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/i18n.js"
click node_cli "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/bin/kediray"
click node_service "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/init.d/kediray"
click node_configuration "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/config/kediray"
click node_node_manager "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/share/kediray/node.uc"
click node_firewall_hooks "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/hotplug.d/firewall/99-kediray"
click node_traffic_engine "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/share/kediray/traffic.uc"
click node_stats_worker "https://github.com/sabanvurgun03-ui/kediray/blob/main/server/stats-worker/worker.js"
click node_theme "https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-theme-kedi/htdocs/luci-static/kedi/kedi.css"
click node_dashboard_bundle "https://github.com/sabanvurgun03-ui/kediray/blob/main/dashboard/metacubexd.tgz"
click node_aw1k_tools "https://github.com/sabanvurgun03-ui/kediray/blob/main/package/aw1k-panel/files/usr/bin/aw1k-usage"

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_dashboard_view,node_status_view,node_separation_view,node_cores_view,node_settings_view,node_traffic_view,node_logs_view,node_about_view,node_translations toneBlue
class node_cli,node_service,node_configuration,node_node_manager,node_firewall_hooks toneAmber
class node_traffic_engine,node_stats_worker,node_operator toneMint
class node_theme,node_dashboard_bundle toneRose
class node_stats_store,node_vpn_engines,node_aw1k_tools toneIndigo
```

## Components

### LuCI Interface

- [Control panel](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/dash.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/dash.js`
- [Status](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/status.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/status.js`
- [VPN separation](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/ayir.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/ayir.js`
- [Core management](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/cores.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/cores.js`
- [Settings](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/settings.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/settings.js`
- [Traffic view](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/trafik.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/trafik.js`
- [Logs](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/log.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/log.js`
- [About and backup](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/about.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/about.js`
- [Translations](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-app-kediray/htdocs/luci-static/resources/view/kediray/i18n.js): `luci-app-kediray/htdocs/luci-static/resources/view/kediray/i18n.js`

### VPN Runtime

- [KediRay CLI](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/bin/kediray): `package/kediray/files/usr/bin/kediray`
- [Service lifecycle](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/init.d/kediray): `package/kediray/files/etc/init.d/kediray`
- [VPN configuration](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/config/kediray): `package/kediray/files/etc/config/kediray`
- [Server nodes](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/share/kediray/node.uc): `package/kediray/files/usr/share/kediray/node.uc`
- [Network hooks](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/etc/hotplug.d/firewall/99-kediray): `package/kediray/files/etc/hotplug.d/firewall/99-kediray`

### Traffic and Insights

- [Traffic accounting](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/kediray/files/usr/share/kediray/traffic.uc): `package/kediray/files/usr/share/kediray/traffic.uc`
- [Usage counter API](https://github.com/sabanvurgun03-ui/kediray/blob/main/server/stats-worker/worker.js): `server/stats-worker/worker.js`

### Themes and Dashboard

- [Kedi LuCI theme](https://github.com/sabanvurgun03-ui/kediray/blob/main/luci-theme-kedi/htdocs/luci-static/kedi/kedi.css): `luci-theme-kedi/htdocs/luci-static/kedi/kedi.css`
- [MetaCubeXD bundle](https://github.com/sabanvurgun03-ui/kediray/blob/main/dashboard/metacubexd.tgz): `dashboard/metacubexd.tgz`

### External Integrations

- **Cloudflare KV**
- **VPN engines**
- [AW1K modem tools](https://github.com/sabanvurgun03-ui/kediray/blob/main/package/aw1k-panel/files/usr/bin/aw1k-usage): `package/aw1k-panel/files/usr/bin/aw1k-usage`

### Other components

- **Router operator**

## Connections

- Router operator → Control panel: uses (evidence: `README.md`)
- Router operator → VPN separation: configures routing (evidence: `README.md`)
- Router operator → Core management: manages engines (evidence: `README.md`)
- Router operator → Traffic view: views usage (evidence: `README.md`)
- Router operator → About and backup: backs up (evidence: `README.md`)
- VPN separation → KediRay CLI: executes commands (evidence: `luci-app-kediray/htdocs/luci-static/resources/view/kediray/ayir.js`)
- KediRay CLI → VPN engines: starts and stops
- Service lifecycle → KediRay CLI: starts service
- Router operator → KediRay CLI: runs commands (evidence: `README.md`)
- Router operator → Kedi LuCI theme: selects appearance (evidence: `README.md`)
- Router operator → MetaCubeXD bundle: opens dashboard (evidence: `README.md`)
- Usage counter API → Cloudflare KV: reads and writes (evidence: `server/stats-worker/worker.js`)
- Router operator → Usage counter API: opts into reporting (evidence: `README.md`)
- Router operator → AW1K modem tools: uses companion app (evidence: `README.md`)
