# mchugh19/zabbix-vue architecture

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

- Interactive diagram: https://gitdiagram.com/mchugh19/zabbix-vue
- Repository: https://github.com/mchugh19/zabbix-vue

## Overview

Zabbix Vue is a browser extension that polls configured Zabbix servers and presents current problems in a popup, with a severity/count badge and notifications. Users configure servers and filters in Options; the background process polls the Zabbix API, stores problem results, and updates browser UI. The popup reads the prepared table and offers filtering, sorting, and links or actions for individual problems. The graph reflects the sampled call and import evidence plus README-documented capabilities; unsampled details are grouped by their existing source directory.

Main entry points: [`src/background.js`](https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js) (Background poller), [`src/popup/popup.vue`](https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.vue) (Problem table), [`src/options/options.vue`](https://github.com/mchugh19/zabbix-vue/blob/master/src/options/options.vue) (Server settings), [`src/lib/browser-shim.js`](https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/browser-shim.js) (Browser API shim)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_options["Server settings<br/>[options.vue]"]
  node_options_app["Options app bootstrap<br/>[options.js]"]
end

subgraph group_polling["Polling and results"]
  node_background["Background poller<br/>[background.js]"]
  node_results[("Problem results<br/>[background.js]")]
  node_badge["Severity badge<br/>[background.js]"]
  node_notifications["Problem notifications<br/>[background.js]"]
end

subgraph group_presentation["User interface"]
  node_popup_app["Popup app bootstrap<br/>[popup.js]"]
  node_popup["Problem table<br/>[popup.vue]"]
  node_actions["Problem actions<br/>[popup.vue]"]
end

subgraph group_support["Shared runtime"]
  node_secrets["Credential encryption<br/>[crypto.js]"]
  node_api_client["JSON-RPC client<br/>[zabbix-promise.js]"]
  node_browser_shim["Browser API shim<br/>[browser-shim.js]"]
  node_deep_links["Versioned Zabbix links<br/>[zabbix-urls.js]"]
  node_icons["Custom UI icons<br/>[vuetify-icons.js]"]
end

node_user(("Extension user"))
node_zabbix(("Zabbix server"))
node_browser_api["Browser extension APIs"]

node_user -->|"configures"| node_options
node_options_app -->|"mounts"| node_options
node_options -->|"encrypts credentials"| node_secrets
node_options -->|"reads and saves settings"| node_browser_shim
node_options -->|"requests reinitialization"| node_background
node_background -->|"uses browser APIs"| node_browser_shim
node_background -->|"decrypts credentials"| node_secrets
node_background -->|"calls API client"| node_api_client
node_api_client -->|"sends JSON-RPC"| node_zabbix
node_background -->|"polls configured servers"| node_zabbix
node_background -->|"stores problem results"| node_results
node_background -->|"updates count and color"| node_badge
node_background -->|"notifies new problems"| node_notifications
node_background -->|"uses storage and alarms"| node_browser_api
node_popup_app -->|"mounts"| node_popup
node_popup_app -->|"configures aliases"| node_icons
node_options_app -->|"configures aliases"| node_icons
node_popup -->|"reads popup table"| node_browser_shim
node_popup -->|"displays problems"| node_results
node_popup -->|"offers problem actions"| node_actions
node_actions -->|"builds acknowledge links"| node_deep_links
node_actions -->|"opens server views"| node_zabbix
node_popup -->|"saves table sorting"| node_background
node_browser_shim -->|"aliases namespace"| node_browser_api

click node_options "https://github.com/mchugh19/zabbix-vue/blob/master/src/options/options.vue"
click node_options_app "https://github.com/mchugh19/zabbix-vue/blob/master/src/options/options.js"
click node_secrets "https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/crypto.js"
click node_background "https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js"
click node_api_client "https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/zabbix-promise.js"
click node_browser_shim "https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/browser-shim.js"
click node_results "https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js"
click node_badge "https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js"
click node_notifications "https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js"
click node_popup_app "https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.js"
click node_popup "https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.vue"
click node_actions "https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.vue"
click node_deep_links "https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/zabbix-urls.js"
click node_icons "https://github.com/mchugh19/zabbix-vue/blob/master/src/vuetify-icons.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_options,node_options_app,node_user,node_browser_api toneBlue
class node_background,node_results,node_badge,node_notifications toneAmber
class node_popup_app,node_popup,node_actions,node_zabbix toneMint
class node_secrets,node_api_client,node_browser_shim,node_deep_links,node_icons toneRose
```

## Components

### Configuration

- [Server settings](https://github.com/mchugh19/zabbix-vue/blob/master/src/options/options.vue): `src/options/options.vue`
- [Options app bootstrap](https://github.com/mchugh19/zabbix-vue/blob/master/src/options/options.js): `src/options/options.js`

### Polling and results

- [Background poller](https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js): `src/background.js`
- [Problem results](https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js): `src/background.js`
- [Severity badge](https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js): `src/background.js`
- [Problem notifications](https://github.com/mchugh19/zabbix-vue/blob/master/src/background.js): `src/background.js`

### User interface

- [Popup app bootstrap](https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.js): `src/popup/popup.js`
- [Problem table](https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.vue): `src/popup/popup.vue`
- [Problem actions](https://github.com/mchugh19/zabbix-vue/blob/master/src/popup/popup.vue): `src/popup/popup.vue`

### Shared runtime

- [Credential encryption](https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/crypto.js): `src/lib/crypto.js`
- [JSON-RPC client](https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/zabbix-promise.js): `src/lib/zabbix-promise.js`
- [Browser API shim](https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/browser-shim.js): `src/lib/browser-shim.js`
- [Versioned Zabbix links](https://github.com/mchugh19/zabbix-vue/blob/master/src/lib/zabbix-urls.js): `src/lib/zabbix-urls.js`
- [Custom UI icons](https://github.com/mchugh19/zabbix-vue/blob/master/src/vuetify-icons.js): `src/vuetify-icons.js`

### Other components

- **Extension user**
- **Zabbix server**
- **Browser extension APIs**

## Connections

- Extension user → Server settings: configures (evidence: `README.md`)
- Options app bootstrap → Server settings: mounts (evidence: `src/options/options.js`)
- Server settings → Credential encryption: encrypts credentials (evidence: `src/options/options.vue`)
- Server settings → Browser API shim: reads and saves settings (evidence: `src/options/options.vue`)
- Server settings → Background poller: requests reinitialization (evidence: `src/options/options.vue`)
- Background poller → Browser API shim: uses browser APIs (evidence: `src/background.js`)
- Background poller → Credential encryption: decrypts credentials (evidence: `src/background.js`)
- Background poller → JSON-RPC client: calls API client (evidence: `src/background.js`)
- JSON-RPC client → Zabbix server: sends JSON-RPC (evidence: `src/lib/zabbix-promise.js`)
- Background poller → Zabbix server: polls configured servers (evidence: `README.md`)
- Background poller → Problem results: stores problem results (evidence: `src/background.js`)
- Background poller → Severity badge: updates count and color (evidence: `README.md`)
- Background poller → Problem notifications: notifies new problems (evidence: `README.md`)
- Background poller → Browser extension APIs: uses storage and alarms (evidence: `src/background.js`)
- Popup app bootstrap → Problem table: mounts (evidence: `src/popup/popup.js`)
- Popup app bootstrap → Custom UI icons: configures aliases (evidence: `src/popup/popup.js`)
- Options app bootstrap → Custom UI icons: configures aliases (evidence: `src/options/options.js`)
- Problem table → Browser API shim: reads popup table (evidence: `src/popup/popup.vue`)
- Problem table → Problem results: displays problems (evidence: `README.md`)
- Problem table → Problem actions: offers problem actions (evidence: `README.md`)
- Problem actions → Versioned Zabbix links: builds acknowledge links (evidence: `src/popup/popup.vue`)
- Problem actions → Zabbix server: opens server views (evidence: `src/popup/popup.vue`)
- Problem table → Background poller: saves table sorting (evidence: `src/popup/popup.vue`)
- Browser API shim → Browser extension APIs: aliases namespace (evidence: `src/lib/browser-shim.js`)
