# deepstruct-ilyasa/zerodash architecture

> Architecture diagram of the GitHub repository deepstruct-ilyasa/zerodash, 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/deepstruct-ilyasa/zerodash
- Repository: https://github.com/deepstruct-ilyasa/zerodash

## Overview

ZeroDash is a web dashboard for managing MikroTik ZeroTier controllers and Traffic Flow, with a separate tool for branch routers. Administrators log in, configure the master router, and manage instances, networks, members, routes, and traffic reporting; users can also inspect topology and manage saved routers and accounts. The graph follows the server’s registered routes into the sampled service, database, and RouterOS adapters. Remote-router and several dashboard capabilities are documented, but their full implementations were not sampled, so those links are documented or left unverified.

Main entry points: [`server.js`](https://github.com/deepstruct-ilyasa/zerodash/blob/main/server.js) (Express server), [`config/database.js`](https://github.com/deepstruct-ilyasa/zerodash/blob/main/config/database.js) (SQLite data), [`routes/api.js`](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/api.js) (Controller API routes), [`routes/users.js`](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/users.js) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Dashboard"]
  node_server["Express server<br/>[server.js]"]
  node_dashboard["Dashboard pages"]
  node_browserjs["Dashboard interactions<br/>[app.js]"]
end

subgraph group_access["Access &amp; Accounts"]
  node_authroutes["Login routes<br/>[auth.js]"]
  node_authguard["Session &amp; role guards<br/>[auth.js]"]
  node_users["User management<br/>[users.js]"]
  node_sqlite[("SQLite data<br/>[database.js]")]
end

subgraph group_controller["Controller Management"]
  node_api["Controller API routes<br/>[api.js]"]
  node_controller["Controller operations"]
  node_routerclient["RouterOS adapters<br/>[routerosClient.js]"]
end

subgraph group_remote["Remote Router Tools"]
  node_master["Saved routers<br/>[routerMaster.js]"]
  node_remoteapi["Remote router operations<br/>[remoteApi.js]"]
end

subgraph group_telemetry["Topology &amp; Traffic"]
  node_topology["Topology positions<br/>[topology.js]"]
  node_trafficlistener["Traffic Flow listener<br/>[server.js]"]
end

node_operator(("Network operator"))
node_masterrouter{{"Master MikroTik"}}
node_branchrouter{{"Branch MikroTik"}}
node_collector{{"Flow collector"}}

node_operator -->|"opens dashboard"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_api
node_server -->|"mounts routes"| node_remoteapi
node_server -->|"mounts routes"| node_master
node_server -->|"mounts routes"| node_users
node_server -->|"mounts routes"| node_topology
node_server -->|"renders pages"| node_dashboard
node_authroutes -->|"reads accounts"| node_sqlite
node_server -->|"protects requests"| node_authguard
node_users -->|"requires admin"| node_authguard
node_users -->|"manages accounts"| node_sqlite
node_api -->|"delegates operations"| node_controller
node_controller -->|"uses adapters"| node_routerclient
node_routerclient -->|"loads settings"| node_sqlite
node_routerclient -.->|"configures controller"| node_masterrouter
node_master -->|"stores credentials"| node_sqlite
node_remoteapi -->|"fetches and manages"| node_branchrouter
node_operator -->|"uses dashboard"| node_browserjs
node_browserjs -.->|"requests dashboard data"| node_api
node_topology -->|"stores positions"| node_sqlite
node_api -->|"reads traffic stats"| node_trafficlistener
node_masterrouter -.->|"sends flow data"| node_collector

click node_server "https://github.com/deepstruct-ilyasa/zerodash/blob/main/server.js"
click node_dashboard "https://github.com/deepstruct-ilyasa/zerodash/tree/main/views"
click node_browserjs "https://github.com/deepstruct-ilyasa/zerodash/blob/main/public/js/app.js"
click node_authroutes "https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/auth.js"
click node_authguard "https://github.com/deepstruct-ilyasa/zerodash/blob/main/middleware/auth.js"
click node_users "https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/users.js"
click node_api "https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/api.js"
click node_controller "https://github.com/deepstruct-ilyasa/zerodash/blob/main/services/controllerService.js"
click node_routerclient "https://github.com/deepstruct-ilyasa/zerodash/blob/main/config/routerosClient.js"
click node_master "https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/routerMaster.js"
click node_remoteapi "https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/remoteApi.js"
click node_topology "https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/topology.js"
click node_trafficlistener "https://github.com/deepstruct-ilyasa/zerodash/blob/main/server.js"
click node_sqlite "https://github.com/deepstruct-ilyasa/zerodash/blob/main/config/database.js"

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_server,node_dashboard,node_browserjs toneBlue
class node_authroutes,node_authguard,node_users,node_sqlite toneAmber
class node_api,node_controller,node_routerclient toneMint
class node_master,node_remoteapi toneRose
class node_topology,node_trafficlistener,node_operator,node_masterrouter,node_branchrouter,node_collector toneIndigo
```

## Components

### Dashboard

- [Express server](https://github.com/deepstruct-ilyasa/zerodash/blob/main/server.js): `server.js`
- [Dashboard pages](https://github.com/deepstruct-ilyasa/zerodash/tree/main/views): `views`
- [Dashboard interactions](https://github.com/deepstruct-ilyasa/zerodash/blob/main/public/js/app.js): `public/js/app.js`

### Access & Accounts

- [Login routes](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/auth.js): `routes/auth.js`
- [Session & role guards](https://github.com/deepstruct-ilyasa/zerodash/blob/main/middleware/auth.js): `middleware/auth.js`
- [User management](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/users.js): `routes/users.js`
- [SQLite data](https://github.com/deepstruct-ilyasa/zerodash/blob/main/config/database.js): `config/database.js`

### Controller Management

- [Controller API routes](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/api.js): `routes/api.js`
- [Controller operations](https://github.com/deepstruct-ilyasa/zerodash/blob/main/services/controllerService.js): `services/controllerService.js`
- [RouterOS adapters](https://github.com/deepstruct-ilyasa/zerodash/blob/main/config/routerosClient.js): `config/routerosClient.js`

### Remote Router Tools

- [Saved routers](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/routerMaster.js): `routes/routerMaster.js`
- [Remote router operations](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/remoteApi.js): `routes/remoteApi.js`

### Topology & Traffic

- [Topology positions](https://github.com/deepstruct-ilyasa/zerodash/blob/main/routes/topology.js): `routes/topology.js`
- [Traffic Flow listener](https://github.com/deepstruct-ilyasa/zerodash/blob/main/server.js): `server.js`

### Other components

- **Network operator**
- **Master MikroTik**
- **Branch MikroTik**
- **Flow collector**

## Connections

- Network operator → Express server: opens dashboard (evidence: `Readme.md`)
- Express server → Login routes: mounts routes (evidence: `server.js`)
- Express server → Controller API routes: mounts routes (evidence: `server.js`)
- Express server → Remote router operations: mounts routes (evidence: `server.js`)
- Express server → Saved routers: mounts routes (evidence: `server.js`)
- Express server → User management: mounts routes (evidence: `server.js`)
- Express server → Topology positions: mounts routes (evidence: `server.js`)
- Express server → Dashboard pages: renders pages (evidence: `server.js`)
- Login routes → SQLite data: reads accounts (evidence: `routes/auth.js`)
- Express server → Session & role guards: protects requests (evidence: `server.js`)
- User management → Session & role guards: requires admin (evidence: `routes/users.js`)
- User management → SQLite data: manages accounts (evidence: `routes/users.js`)
- Controller API routes → Controller operations: delegates operations (evidence: `routes/api.js`)
- Controller operations → RouterOS adapters: uses adapters (evidence: `services/controllerService.js`)
- RouterOS adapters → SQLite data: loads settings (evidence: `config/routerosClient.js`)
- RouterOS adapters → Master MikroTik: configures controller (evidence: `Readme.md`)
- Saved routers → SQLite data: stores credentials (evidence: `routes/routerMaster.js`)
- Remote router operations → Branch MikroTik: fetches and manages (evidence: `Readme.md`)
- Network operator → Dashboard interactions: uses dashboard (evidence: `Readme.md`)
- Dashboard interactions → Controller API routes: requests dashboard data
- Topology positions → SQLite data: stores positions (evidence: `routes/topology.js`)
- Controller API routes → Traffic Flow listener: reads traffic stats (evidence: `routes/api.js`)
- Master MikroTik → Flow collector: sends flow data (evidence: `Readme.md`)
