# makwana23-harshil/most-final-major-project architecture

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

- Interactive diagram: https://gitdiagram.com/makwana23-harshil/most-final-major-project
- Repository: https://github.com/makwana23-harshil/most-final-major-project

## Overview

CyberSentinel Pro is a browser-based threat-detection platform backed by a Flask API. The main workflow is a user submitting SMS, email, or URL content through the scanner; the detection API dispatches to detector modules, stores scan results, and returns verdicts for the user-facing history and analytics views. Separate branches handle authentication and administration. README capabilities include deep link checks and dashboards; several frontend/API connections and unsampled route details are documented only broadly, so those links are marked unverified or omitted.

Main entry points: [`backend/api/detection_routes.py`](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/detection_routes.py) (Detection API), [`backend/detection/link/link_inspector.py`](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/link/link_inspector.py) (Deep link inspector), [`backend/app.py`](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/app.py) (Flask app), [`backend/services/text_scanner.py`](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/text_scanner.py) (Text scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_scanner_ui["Scanner UI<br/>[scan.js]"]
  node_user_views["History and dashboard<br/>[history.js]"]
  node_admin_ui["Admin console<br/>[admin.js]"]
end

subgraph group_api["API and identity"]
  node_app["Flask app<br/>[app.py]"]
  node_auth_routes["Auth routes<br/>[routes.py]"]
  node_auth_middleware["JWT middleware<br/>[middleware.py]"]
  node_detection_api["Detection API"]
  node_user_api["User API<br/>[user_routes.py]"]
  node_admin_api["Admin API<br/>[admin_routes.py]"]
end

subgraph group_detection["Threat analysis"]
  node_sms_detector["SMS detector<br/>[sms_detector.py]"]
  node_email_detector["Email detector<br/>[email_detector.py]"]
  node_url_detector["URL detector<br/>[url_detector.py]"]
  node_email_parser["Email parser<br/>[email_parser.py]"]
  node_text_scanner["Text scanner<br/>[text_scanner.py]"]
  node_url_scanner["URL scanner<br/>[url_scanner.py]"]
  node_rule_engine["Risk rules<br/>[rule_engine.py]"]
  node_explainability["Explanations<br/>[explainability.py]"]
  node_link_inspector["Deep link inspector<br/>[link_inspector.py]"]
  node_llm_inspector["LLM inspection<br/>[llm_inspector.py]"]
end

subgraph group_state["Accounts and history"]
  node_database[("MongoDB<br/>[database.py]")]
  node_scan_history["Scan history model<br/>[scan_history.py]"]
end

subgraph group_integrations["External checks"]
  node_vt["VirusTotal"]
  node_safe_browsing["Google Safe Browsing"]
  node_gemini["Gemini API"]
end

node_user(("User"))
node_admin_actor(("Administrator"))

node_user -.->|"submits scan"| node_scanner_ui
node_scanner_ui -.->|"requests scan"| node_detection_api
node_detection_api -->|"dispatches SMS"| node_sms_detector
node_detection_api -->|"dispatches email"| node_email_detector
node_detection_api -->|"dispatches URL"| node_url_detector
node_sms_detector -->|"inspects links"| node_link_inspector
node_email_detector -->|"inspects links"| node_link_inspector
node_email_detector -->|"uses analysis"| node_llm_inspector
node_url_detector -->|"inspects URL"| node_link_inspector
node_link_inspector -->|"requests analysis"| node_llm_inspector
node_link_inspector -->|"checks reputation"| node_vt
node_link_inspector -.->|"checks URL"| node_safe_browsing
node_llm_inspector -->|"generates analysis"| node_gemini
node_detection_api -->|"saves scans"| node_database
node_user -.->|"registers or logs in"| node_auth_routes
node_auth_routes -->|"reads and updates users"| node_database
node_auth_routes -->|"creates tokens"| node_auth_middleware
node_user_api -->|"guards routes"| node_auth_middleware
node_admin_api -->|"guards routes"| node_auth_middleware
node_detection_api -->|"guards scans"| node_auth_middleware
node_user_api -->|"reads scan stats"| node_database
node_admin_api -->|"manages users and scans"| node_database
node_user -.->|"views history"| node_user_views
node_admin_actor -.->|"reviews platform"| node_admin_ui
node_user_views -.->|"requests history"| node_user_api
node_admin_ui -.->|"requests administration"| node_admin_api
node_app -->|"registers routes"| node_auth_routes
node_app -->|"registers routes"| node_detection_api
node_app -->|"registers routes"| node_user_api
node_app -->|"registers routes"| node_admin_api
node_text_scanner -->|"applies rules"| node_rule_engine
node_text_scanner -->|"parses email"| node_email_parser
node_text_scanner -->|"scans URLs"| node_url_scanner
node_text_scanner -->|"builds explanations"| node_explainability
node_url_scanner -->|"applies rules"| node_rule_engine

click node_scanner_ui "https://github.com/makwana23-harshil/most-final-major-project/blob/main/frontend/js/scan.js"
click node_user_views "https://github.com/makwana23-harshil/most-final-major-project/blob/main/frontend/js/history.js"
click node_admin_ui "https://github.com/makwana23-harshil/most-final-major-project/blob/main/frontend/js/admin.js"
click node_app "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/app.py"
click node_auth_routes "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/auth/routes.py"
click node_auth_middleware "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/auth/middleware.py"
click node_detection_api "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/detection_routes.py"
click node_user_api "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/user_routes.py"
click node_admin_api "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/admin_routes.py"
click node_sms_detector "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/sms/sms_detector.py"
click node_email_detector "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/email/email_detector.py"
click node_url_detector "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/url/url_detector.py"
click node_email_parser "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/email_parser.py"
click node_text_scanner "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/text_scanner.py"
click node_url_scanner "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/url_scanner.py"
click node_rule_engine "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/rule_engine.py"
click node_explainability "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/explainability.py"
click node_link_inspector "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/link/link_inspector.py"
click node_llm_inspector "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/link/llm_inspector.py"
click node_database "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/database.py"
click node_scan_history "https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/models/scan_history.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_scanner_ui,node_user_views,node_admin_ui,node_user toneBlue
class node_app,node_auth_routes,node_auth_middleware,node_detection_api,node_user_api,node_admin_api toneAmber
class node_sms_detector,node_email_detector,node_url_detector,node_email_parser,node_text_scanner,node_url_scanner,node_rule_engine,node_explainability,node_link_inspector,node_llm_inspector toneMint
class node_database,node_scan_history toneRose
class node_vt,node_safe_browsing,node_gemini,node_admin_actor toneIndigo
```

## Components

### Browser experience

- [Scanner UI](https://github.com/makwana23-harshil/most-final-major-project/blob/main/frontend/js/scan.js): `frontend/js/scan.js`
- [History and dashboard](https://github.com/makwana23-harshil/most-final-major-project/blob/main/frontend/js/history.js): `frontend/js/history.js`
- [Admin console](https://github.com/makwana23-harshil/most-final-major-project/blob/main/frontend/js/admin.js): `frontend/js/admin.js`

### API and identity

- [Flask app](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/app.py): `backend/app.py`
- [Auth routes](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/auth/routes.py): `backend/auth/routes.py`
- [JWT middleware](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/auth/middleware.py): `backend/auth/middleware.py`
- [Detection API](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/detection_routes.py): `backend/api/detection_routes.py`
- [User API](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/user_routes.py): `backend/api/user_routes.py`
- [Admin API](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/api/admin_routes.py): `backend/api/admin_routes.py`

### Threat analysis

- [SMS detector](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/sms/sms_detector.py): `backend/detection/sms/sms_detector.py`
- [Email detector](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/email/email_detector.py): `backend/detection/email/email_detector.py`
- [URL detector](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/url/url_detector.py): `backend/detection/url/url_detector.py`
- [Email parser](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/email_parser.py): `backend/services/email_parser.py`
- [Text scanner](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/text_scanner.py): `backend/services/text_scanner.py`
- [URL scanner](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/url_scanner.py): `backend/services/url_scanner.py`
- [Risk rules](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/rule_engine.py): `backend/services/rule_engine.py`
- [Explanations](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/services/explainability.py): `backend/services/explainability.py`
- [Deep link inspector](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/link/link_inspector.py): `backend/detection/link/link_inspector.py`
- [LLM inspection](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/detection/link/llm_inspector.py): `backend/detection/link/llm_inspector.py`

### Accounts and history

- [MongoDB](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/database.py): `backend/database.py`
- [Scan history model](https://github.com/makwana23-harshil/most-final-major-project/blob/main/backend/models/scan_history.py): `backend/models/scan_history.py`

### External checks

- **VirusTotal**
- **Google Safe Browsing**
- **Gemini API**

### Other components

- **User**
- **Administrator**

## Connections

- User → Scanner UI: submits scan
- Scanner UI → Detection API: requests scan
- Detection API → SMS detector: dispatches SMS (evidence: `backend/api/detection_routes.py`)
- Detection API → Email detector: dispatches email (evidence: `backend/api/detection_routes.py`)
- Detection API → URL detector: dispatches URL (evidence: `backend/api/detection_routes.py`)
- SMS detector → Deep link inspector: inspects links (evidence: `backend/detection/sms/sms_detector.py`)
- Email detector → Deep link inspector: inspects links (evidence: `backend/detection/email/email_detector.py`)
- Email detector → LLM inspection: uses analysis (evidence: `backend/detection/email/email_detector.py`)
- URL detector → Deep link inspector: inspects URL (evidence: `backend/detection/url/url_detector.py`)
- Deep link inspector → LLM inspection: requests analysis (evidence: `backend/detection/link/link_inspector.py`)
- Deep link inspector → VirusTotal: checks reputation (evidence: `backend/detection/link/link_inspector.py`)
- Deep link inspector → Google Safe Browsing: checks URL
- LLM inspection → Gemini API: generates analysis (evidence: `backend/detection/link/llm_inspector.py`)
- Detection API → MongoDB: saves scans (evidence: `backend/api/detection_routes.py`)
- User → Auth routes: registers or logs in
- Auth routes → MongoDB: reads and updates users (evidence: `backend/auth/routes.py`)
- Auth routes → JWT middleware: creates tokens (evidence: `backend/auth/routes.py`)
- User API → JWT middleware: guards routes (evidence: `backend/api/user_routes.py`)
- Admin API → JWT middleware: guards routes (evidence: `backend/api/admin_routes.py`)
- Detection API → JWT middleware: guards scans (evidence: `backend/api/detection_routes.py`)
- User API → MongoDB: reads scan stats (evidence: `backend/api/user_routes.py`)
- Admin API → MongoDB: manages users and scans (evidence: `backend/api/admin_routes.py`)
- User → History and dashboard: views history
- Administrator → Admin console: reviews platform
- History and dashboard → User API: requests history
- Admin console → Admin API: requests administration
- Flask app → Auth routes: registers routes (evidence: `backend/app.py`)
- Flask app → Detection API: registers routes (evidence: `backend/app.py`)
- Flask app → User API: registers routes (evidence: `backend/app.py`)
- Flask app → Admin API: registers routes (evidence: `backend/app.py`)
- Text scanner → Risk rules: applies rules (evidence: `backend/services/text_scanner.py`)
- Text scanner → Email parser: parses email (evidence: `backend/services/text_scanner.py`)
- Text scanner → URL scanner: scans URLs (evidence: `backend/services/text_scanner.py`)
- Text scanner → Explanations: builds explanations (evidence: `backend/services/text_scanner.py`)
- URL scanner → Risk rules: applies rules (evidence: `backend/services/url_scanner.py`)
