# rudra3007-pro/vulnmonitor architecture

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

- Interactive diagram: https://gitdiagram.com/rudra3007-pro/vulnmonitor
- Repository: https://github.com/rudra3007-pro/vulnmonitor

## Overview

VulnMonitor is a vulnerability-monitoring web application: security teams use its dashboard and admin interface to browse CVEs, review alerts and reports, and monitor websites. Its principal workflow fetches NVD data, deduplicates it into the vulnerability catalog, and presents searchable results and dashboard summaries. A separate scanning workflow assesses monitored websites and matches detected technologies to CVEs. The README also documents AI risk analysis, asset matching, PDF export, authentication, and scheduled syncs. Some feature details come from the README because their implementation was not sampled.

Main entry points: [`backend/app.py`](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py) (Flask API), [`frontend/index.html`](https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/index.html) (Dashboard and CVE views), [`backend/scanner.py`](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/scanner.py) (Website security scanner), [`frontend/admin.html`](https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/admin.html) (Admin interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Web interface"]
  node_dashboard["Dashboard and CVE views<br/>[index.html]"]
  node_admin["Admin interface<br/>[admin.html]"]
end

subgraph group_api["Application API"]
  node_api_server["Flask API<br/>[app.py]"]
  node_auth["Google authentication<br/>[app.py]"]
  node_scheduler["Scheduled sync<br/>[app.py]"]
end

subgraph group_intelligence["CVE intelligence"]
  node_sync["CVE sync and deduplication<br/>[app.py]"]
  node_catalog["Vulnerability catalog<br/>[app.py]"]
  node_insights["Stats, alerts, and logs<br/>[app.py]"]
  node_ai["AI risk and asset analysis<br/>[app.py]"]
  node_pdf["PDF reports<br/>[index.html]"]
end

subgraph group_scanning["Website scanning"]
  node_targets["Target management and scan dispatch<br/>[app.py]"]
  node_scanner["Website security scanner<br/>[scanner.py]"]
end

node_team(("Security team"))
node_nvd["NVD API"]
node_supabase[("Supabase")]
node_groq["Groq LLaMA"]
node_google["Google OAuth"]

node_team -->|"uses"| node_dashboard
node_team -.->|"uses"| node_admin
node_dashboard -->|"requests data"| node_api_server
node_admin -.->|"uses API"| node_api_server
node_api_server -->|"registers"| node_auth
node_auth -->|"authenticates with"| node_google
node_scheduler -->|"triggers hourly"| node_sync
node_sync -->|"fetches CVEs"| node_nvd
node_sync -->|"checks and stores"| node_supabase
node_api_server -->|"runs scheduled sync"| node_scheduler
node_api_server -->|"serves CVE queries"| node_catalog
node_catalog -->|"reads records"| node_supabase
node_api_server -->|"serves summaries"| node_insights
node_insights -->|"queries data"| node_supabase
node_dashboard -->|"requests analysis"| node_ai
node_ai -->|"analyzes with"| node_groq
node_dashboard -->|"exports reports"| node_pdf
node_api_server -->|"manages targets"| node_targets
node_targets -->|"stores targets"| node_supabase
node_targets -.->|"dispatches scans"| node_scanner
node_scanner -->|"matches stored CVEs"| node_supabase
node_scanner -->|"retrieves CVE data"| node_nvd

click node_dashboard "https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/index.html"
click node_admin "https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/admin.html"
click node_api_server "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_auth "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_scheduler "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_sync "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_catalog "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_insights "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_ai "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_pdf "https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/index.html"
click node_targets "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py"
click node_scanner "https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/scanner.py"

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,node_admin toneBlue
class node_api_server,node_auth,node_scheduler,node_supabase toneAmber
class node_sync,node_catalog,node_insights,node_ai,node_pdf,node_nvd toneMint
class node_targets,node_scanner toneRose
class node_team,node_groq,node_google toneIndigo
```

## Components

### Web interface

- [Dashboard and CVE views](https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/index.html): `frontend/index.html`
- [Admin interface](https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/admin.html): `frontend/admin.html`

### Application API

- [Flask API](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [Google authentication](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [Scheduled sync](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`

### CVE intelligence

- [CVE sync and deduplication](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [Vulnerability catalog](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [Stats, alerts, and logs](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [AI risk and asset analysis](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [PDF reports](https://github.com/rudra3007-pro/vulnmonitor/blob/main/frontend/index.html): `frontend/index.html`

### Website scanning

- [Target management and scan dispatch](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/app.py): `backend/app.py`
- [Website security scanner](https://github.com/rudra3007-pro/vulnmonitor/blob/main/backend/scanner.py): `backend/scanner.py`

### Other components

- **Security team**
- **NVD API**
- **Supabase**
- **Groq LLaMA**
- **Google OAuth**

## Connections

- Security team → Dashboard and CVE views: uses (evidence: `README.md`)
- Security team → Admin interface: uses
- Dashboard and CVE views → Flask API: requests data (evidence: `README.md`)
- Admin interface → Flask API: uses API
- Flask API → Google authentication: registers (evidence: `backend/app.py`)
- Google authentication → Google OAuth: authenticates with (evidence: `backend/app.py`)
- Scheduled sync → CVE sync and deduplication: triggers hourly (evidence: `README.md`)
- CVE sync and deduplication → NVD API: fetches CVEs (evidence: `backend/app.py`)
- CVE sync and deduplication → Supabase: checks and stores (evidence: `backend/app.py`)
- Flask API → Scheduled sync: runs scheduled sync (evidence: `README.md`)
- Flask API → Vulnerability catalog: serves CVE queries (evidence: `README.md`)
- Vulnerability catalog → Supabase: reads records (evidence: `backend/app.py`)
- Flask API → Stats, alerts, and logs: serves summaries (evidence: `README.md`)
- Stats, alerts, and logs → Supabase: queries data (evidence: `backend/app.py`)
- Dashboard and CVE views → AI risk and asset analysis: requests analysis (evidence: `README.md`)
- AI risk and asset analysis → Groq LLaMA: analyzes with (evidence: `README.md`)
- Dashboard and CVE views → PDF reports: exports reports (evidence: `README.md`)
- Flask API → Target management and scan dispatch: manages targets (evidence: `backend/app.py`)
- Target management and scan dispatch → Supabase: stores targets (evidence: `backend/app.py`)
- Target management and scan dispatch → Website security scanner: dispatches scans (evidence: `backend/app.py`)
- Website security scanner → Supabase: matches stored CVEs (evidence: `backend/scanner.py`)
- Website security scanner → NVD API: retrieves CVE data (evidence: `backend/scanner.py`)
