# sanhith30/ita0605-ml architecture

> Architecture diagram of the GitHub repository sanhith30/ita0605-ml, 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/sanhith30/ita0605-ml
- Repository: https://github.com/sanhith30/ita0605-ml

## Overview

PhishShield is a phishing-URL detection product: users scan a URL in the dashboard or browser extension and receive a classification, risk score, and human-readable reasons. The evidenced server flow applies request limits, extracts URL/DOM features, then invokes model prediction; the extension also has background and popup modules, though their connection to the API is not established by the excerpts. The frontend advertises analytics, custom-domain setup, pricing, and extension guidance. These capabilities are included, but links not shown in source are omitted; README content was not provided.

Main entry points: [`Capstone/frontend/src/App.jsx`](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/App.jsx) (App navigation), [`Capstone/backend/app/main.py`](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/main.py) (API routes), [`Capstone/chrome-extension/manifest.json`](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/manifest.json) (Extension manifest and UI), [`Capstone/frontend/src/components/Dashboard.jsx`](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Dashboard.jsx) (URL scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App navigation<br/>[App.jsx]"]
  node_dashboard["URL scanner<br/>[Dashboard.jsx]"]
  node_analytics["Analytics<br/>[Analytics.jsx]"]
  node_customdomain["Custom domain<br/>[CustomDomain.jsx]"]
  node_pricing["Pricing plans<br/>[Pricing.jsx]"]
  node_extensionguide["Extension guide<br/>[ExtensionGuide.jsx]"]
  node_policies["Legal pages<br/>[PrivacyPolicy.jsx]"]
  node_terms["Terms page<br/>[Terms.jsx]"]
  node_notfound["Not found<br/>[NotFound.jsx]"]
  node_shortcuts["Shortcuts modal<br/>[ShortcutsModal.jsx]"]
  node_splash["Splash screen<br/>[SplashScreen.jsx]"]
end

subgraph group_api["Detection API"]
  node_backend["API routes<br/>[main.py]"]
  node_schemas["Request schemas<br/>[predict.py]"]
  node_limiter["Rate limiter<br/>[rate_limiter.py]"]
  node_extractor["Feature extraction<br/>[extractor.py]"]
  node_predictor["Model prediction<br/>[predictor.py]"]
  node_models[("Model artifacts")]
end

subgraph group_extension["Browser extension"]
  node_popup["Extension popup<br/>[popup.js]"]
  node_background["Extension background<br/>[background.js]"]
  node_extension_files["Extension manifest and UI<br/>[manifest.json]"]
end

node_user(("User"))
node_browser(("Browser user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_analytics
node_app -->|"renders"| node_customdomain
node_app -->|"renders"| node_pricing
node_app -->|"renders"| node_extensionguide
node_app -->|"renders"| node_policies
node_app -->|"renders"| node_terms
node_app -->|"renders"| node_notfound
node_app -.->|"uses"| node_shortcuts
node_app -.->|"uses"| node_splash
node_dashboard -.->|"posts scan"| node_backend
node_backend -->|"validates"| node_schemas
node_backend -->|"enforces limits"| node_limiter
node_backend -->|"extracts features"| node_extractor
node_backend -->|"predicts"| node_predictor
node_predictor -->|"loads artifacts"| node_models
node_browser -->|"uses"| node_popup
node_extension_files -->|"defines UI"| node_popup
node_extension_files -->|"registers"| node_background

click node_app "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/App.jsx"
click node_dashboard "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Dashboard.jsx"
click node_analytics "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Analytics.jsx"
click node_customdomain "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/CustomDomain.jsx"
click node_pricing "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Pricing.jsx"
click node_extensionguide "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/ExtensionGuide.jsx"
click node_policies "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/PrivacyPolicy.jsx"
click node_terms "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Terms.jsx"
click node_notfound "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/NotFound.jsx"
click node_shortcuts "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/ShortcutsModal.jsx"
click node_splash "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/SplashScreen.jsx"
click node_backend "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/main.py"
click node_schemas "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/schemas/predict.py"
click node_limiter "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/services/rate_limiter.py"
click node_extractor "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/services/extractor.py"
click node_predictor "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/services/predictor.py"
click node_models "https://github.com/sanhith30/ita0605-ml/tree/main/Capstone/backend/models"
click node_popup "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/popup.js"
click node_background "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/background.js"
click node_extension_files "https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/manifest.json"

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_app,node_dashboard,node_analytics,node_customdomain,node_pricing,node_extensionguide,node_policies,node_terms,node_notfound,node_shortcuts,node_splash,node_user,node_browser toneBlue
class node_backend,node_schemas,node_limiter,node_extractor,node_predictor,node_models toneAmber
class node_popup,node_background,node_extension_files toneMint
```

## Components

### Web application

- [App navigation](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/App.jsx): `Capstone/frontend/src/App.jsx`
- [URL scanner](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Dashboard.jsx): `Capstone/frontend/src/components/Dashboard.jsx`
- [Analytics](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Analytics.jsx): `Capstone/frontend/src/components/Analytics.jsx`
- [Custom domain](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/CustomDomain.jsx): `Capstone/frontend/src/components/CustomDomain.jsx`
- [Pricing plans](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Pricing.jsx): `Capstone/frontend/src/components/Pricing.jsx`
- [Extension guide](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/ExtensionGuide.jsx): `Capstone/frontend/src/components/ExtensionGuide.jsx`
- [Legal pages](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/PrivacyPolicy.jsx): `Capstone/frontend/src/components/PrivacyPolicy.jsx`
- [Terms page](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/Terms.jsx): `Capstone/frontend/src/components/Terms.jsx`
- [Not found](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/NotFound.jsx): `Capstone/frontend/src/components/NotFound.jsx`
- [Shortcuts modal](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/ShortcutsModal.jsx): `Capstone/frontend/src/components/ShortcutsModal.jsx`
- [Splash screen](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/frontend/src/components/SplashScreen.jsx): `Capstone/frontend/src/components/SplashScreen.jsx`

### Detection API

- [API routes](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/main.py): `Capstone/backend/app/main.py`
- [Request schemas](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/schemas/predict.py): `Capstone/backend/app/schemas/predict.py`
- [Rate limiter](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/services/rate_limiter.py): `Capstone/backend/app/services/rate_limiter.py`
- [Feature extraction](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/services/extractor.py): `Capstone/backend/app/services/extractor.py`
- [Model prediction](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/backend/app/services/predictor.py): `Capstone/backend/app/services/predictor.py`
- [Model artifacts](https://github.com/sanhith30/ita0605-ml/tree/main/Capstone/backend/models): `Capstone/backend/models`

### Browser extension

- [Extension popup](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/popup.js): `Capstone/chrome-extension/popup.js`
- [Extension background](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/background.js): `Capstone/chrome-extension/background.js`
- [Extension manifest and UI](https://github.com/sanhith30/ita0605-ml/blob/main/Capstone/chrome-extension/manifest.json): `Capstone/chrome-extension/manifest.json`

### Other components

- **User**
- **Browser user**

## Connections

- User → App navigation: uses
- App navigation → URL scanner: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Analytics: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Custom domain: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Pricing plans: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Extension guide: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Legal pages: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Terms page: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Not found: renders (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Shortcuts modal: uses (evidence: `Capstone/frontend/src/App.jsx`)
- App navigation → Splash screen: uses (evidence: `Capstone/frontend/src/App.jsx`)
- URL scanner → API routes: posts scan
- API routes → Request schemas: validates (evidence: `Capstone/backend/app/main.py`)
- API routes → Rate limiter: enforces limits (evidence: `Capstone/backend/app/main.py`)
- API routes → Feature extraction: extracts features (evidence: `Capstone/backend/app/main.py`)
- API routes → Model prediction: predicts (evidence: `Capstone/backend/app/main.py`)
- Model prediction → Model artifacts: loads artifacts (evidence: `Capstone/backend/app/services/predictor.py`)
- Browser user → Extension popup: uses
- Extension manifest and UI → Extension popup: defines UI
- Extension manifest and UI → Extension background: registers
