# sriramgg/jobguardai architecture

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

- Interactive diagram: https://gitdiagram.com/sriramgg/jobguardai
- Repository: https://github.com/sriramgg/jobguardai

## Overview

JobGuardAI detects fraudulent job listings from pasted text or URLs, combines model-based and reputation signals into a risk assessment, stores scan results, and presents explainable findings. The product also includes bulk CSV scanning, scan history and analytics, a threat map, account authentication, downloadable reports, and a fraud Q&A chatbot. The graph follows documented flows and source-index references; unsampled frontend wiring and some backend internals are represented only where the README supports them.

Main entry points: [`backend/api/v1/routes/analyze.py`](https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/analyze.py) (Scan and batch routes), [`backend/utils/risk_scorer.py`](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/risk_scorer.py) (Risk scoring), [`backend/app.py`](https://github.com/sriramgg/jobguardai/blob/master/backend/app.py) (FastAPI application), [`frontend/web/dashboard.html`](https://github.com/sriramgg/jobguardai/blob/master/frontend/web/dashboard.html) (Dashboard and history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User experiences"]
  node_web["Web application<br/>[index.html]"]
  node_dashboard["Dashboard and history<br/>[dashboard.html]"]
  node_map["Threat map<br/>[globe-map.js]"]
  node_auth["Authentication UI<br/>[auth.js]"]
  node_extension["Browser extension<br/>[popup.js]"]
end

subgraph group_api["API and orchestration"]
  node_app["FastAPI application<br/>[app.py]"]
  node_scan["Scan and batch routes<br/>[analyze.py]"]
  node_chat["Chat route<br/>[chat.py]"]
  node_status["Status route<br/>[int_routes.py]"]
end

subgraph group_analysis["Fraud analysis"]
  node_scraper["Listing scraper<br/>[scraper.py]"]
  node_preprocess["Text preprocessing<br/>[preprocess.py]"]
  node_risk["Risk scoring<br/>[risk_scorer.py]"]
  node_domain["Domain intelligence<br/>[domain_check.py]"]
  node_company["Company verification<br/>[company_verify.py]"]
  node_blacklist[("Scam blacklist<br/>[blacklist.py]")]
  node_explain["Prediction explanation<br/>[explain.py]"]
end

subgraph group_state["Persistence and reports"]
  node_records[("Scan records<br/>[analyze.py]")]
  node_database[("MongoDB connection<br/>[database.py]")]
  node_pdf["PDF reports<br/>[pdf_generator.py]"]
end

subgraph group_integrations["External services"]
  node_groq["Groq AI"]
  node_firebase["Firebase Auth"]
  node_osm["OpenStreetMap"]
  node_smtp["Gmail SMTP"]
end

node_jobseeker(("Job seeker"))

node_jobseeker -->|"submits listing"| node_web
node_jobseeker -.->|"scans listing"| node_extension
node_web -->|"calls API"| node_app
node_extension -.->|"requests scan"| node_scan
node_app -->|"registers route"| node_scan
node_app -->|"registers route"| node_chat
node_app -->|"registers route"| node_status
node_scan -->|"scrapes URL"| node_scraper
node_scan -->|"prepares text"| node_preprocess
node_scan -->|"scores listing"| node_risk
node_risk -->|"checks domain"| node_domain
node_risk -->|"verifies company"| node_company
node_risk -->|"checks reports"| node_blacklist
node_risk -->|"explains prediction"| node_explain
node_scan -->|"stores result"| node_records
node_scan -->|"generates report"| node_pdf
node_scan -.->|"uses persistence"| node_database
node_chat -->|"queries model"| node_groq
node_dashboard -->|"requests scans"| node_app
node_dashboard -->|"shows history"| node_records
node_dashboard -->|"renders threats"| node_map
node_web -->|"provides sign-in"| node_auth
node_auth -->|"authenticates users"| node_firebase
node_map -->|"geocodes origins"| node_osm
node_scan -.->|"sends welcome email"| node_smtp

click node_web "https://github.com/sriramgg/jobguardai/blob/master/frontend/web/index.html"
click node_dashboard "https://github.com/sriramgg/jobguardai/blob/master/frontend/web/dashboard.html"
click node_map "https://github.com/sriramgg/jobguardai/blob/master/frontend/web/assets/js/globe-map.js"
click node_auth "https://github.com/sriramgg/jobguardai/blob/master/frontend/web/assets/js/auth.js"
click node_extension "https://github.com/sriramgg/jobguardai/blob/master/frontend/extension/popup.js"
click node_app "https://github.com/sriramgg/jobguardai/blob/master/backend/app.py"
click node_scan "https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/analyze.py"
click node_chat "https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/chat.py"
click node_status "https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/int_routes.py"
click node_scraper "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/scraper.py"
click node_preprocess "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/preprocess.py"
click node_risk "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/risk_scorer.py"
click node_domain "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/domain_check.py"
click node_company "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/company_verify.py"
click node_blacklist "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/blacklist.py"
click node_explain "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/explain.py"
click node_records "https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/analyze.py"
click node_database "https://github.com/sriramgg/jobguardai/blob/master/backend/database.py"
click node_pdf "https://github.com/sriramgg/jobguardai/blob/master/backend/utils/pdf_generator.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_web,node_dashboard,node_map,node_auth,node_extension toneBlue
class node_app,node_scan,node_chat,node_status toneAmber
class node_scraper,node_preprocess,node_risk,node_domain,node_company,node_blacklist,node_explain toneMint
class node_records,node_database,node_pdf toneRose
class node_groq,node_firebase,node_osm,node_smtp,node_jobseeker toneIndigo
```

## Components

### User experiences

- [Web application](https://github.com/sriramgg/jobguardai/blob/master/frontend/web/index.html): `frontend/web/index.html`
- [Dashboard and history](https://github.com/sriramgg/jobguardai/blob/master/frontend/web/dashboard.html): `frontend/web/dashboard.html`
- [Threat map](https://github.com/sriramgg/jobguardai/blob/master/frontend/web/assets/js/globe-map.js): `frontend/web/assets/js/globe-map.js`
- [Authentication UI](https://github.com/sriramgg/jobguardai/blob/master/frontend/web/assets/js/auth.js): `frontend/web/assets/js/auth.js`
- [Browser extension](https://github.com/sriramgg/jobguardai/blob/master/frontend/extension/popup.js): `frontend/extension/popup.js`

### API and orchestration

- [FastAPI application](https://github.com/sriramgg/jobguardai/blob/master/backend/app.py): `backend/app.py`
- [Scan and batch routes](https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/analyze.py): `backend/api/v1/routes/analyze.py`
- [Chat route](https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/chat.py): `backend/api/v1/routes/chat.py`
- [Status route](https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/int_routes.py): `backend/api/v1/routes/int_routes.py`

### Fraud analysis

- [Listing scraper](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/scraper.py): `backend/utils/scraper.py`
- [Text preprocessing](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/preprocess.py): `backend/utils/preprocess.py`
- [Risk scoring](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/risk_scorer.py): `backend/utils/risk_scorer.py`
- [Domain intelligence](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/domain_check.py): `backend/utils/domain_check.py`
- [Company verification](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/company_verify.py): `backend/utils/company_verify.py`
- [Scam blacklist](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/blacklist.py): `backend/utils/blacklist.py`
- [Prediction explanation](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/explain.py): `backend/utils/explain.py`

### Persistence and reports

- [Scan records](https://github.com/sriramgg/jobguardai/blob/master/backend/api/v1/routes/analyze.py): `backend/api/v1/routes/analyze.py`
- [MongoDB connection](https://github.com/sriramgg/jobguardai/blob/master/backend/database.py): `backend/database.py`
- [PDF reports](https://github.com/sriramgg/jobguardai/blob/master/backend/utils/pdf_generator.py): `backend/utils/pdf_generator.py`

### External services

- **Groq AI**
- **Firebase Auth**
- **OpenStreetMap**
- **Gmail SMTP**

### Other components

- **Job seeker**

## Connections

- Job seeker → Web application: submits listing (evidence: `README.md`)
- Job seeker → Browser extension: scans listing
- Web application → FastAPI application: calls API (evidence: `README.md`)
- Browser extension → Scan and batch routes: requests scan
- FastAPI application → Scan and batch routes: registers route (evidence: `backend/app.py`)
- FastAPI application → Chat route: registers route (evidence: `backend/app.py`)
- FastAPI application → Status route: registers route (evidence: `backend/app.py`)
- Scan and batch routes → Listing scraper: scrapes URL (evidence: `backend/api/v1/routes/analyze.py`)
- Scan and batch routes → Text preprocessing: prepares text
- Scan and batch routes → Risk scoring: scores listing (evidence: `backend/api/v1/routes/analyze.py`)
- Risk scoring → Domain intelligence: checks domain (evidence: `backend/utils/risk_scorer.py`)
- Risk scoring → Company verification: verifies company (evidence: `backend/utils/risk_scorer.py`)
- Risk scoring → Scam blacklist: checks reports (evidence: `backend/utils/risk_scorer.py`)
- Risk scoring → Prediction explanation: explains prediction (evidence: `backend/utils/risk_scorer.py`)
- Scan and batch routes → Scan records: stores result (evidence: `backend/api/v1/routes/analyze.py`)
- Scan and batch routes → PDF reports: generates report (evidence: `backend/api/v1/routes/analyze.py`)
- Scan and batch routes → MongoDB connection: uses persistence (evidence: `backend/api/v1/routes/analyze.py`)
- Chat route → Groq AI: queries model (evidence: `backend/api/v1/routes/chat.py`)
- Dashboard and history → FastAPI application: requests scans (evidence: `README.md`)
- Dashboard and history → Scan records: shows history (evidence: `README.md`)
- Dashboard and history → Threat map: renders threats (evidence: `README.md`)
- Web application → Authentication UI: provides sign-in (evidence: `README.md`)
- Authentication UI → Firebase Auth: authenticates users (evidence: `README.md`)
- Threat map → OpenStreetMap: geocodes origins (evidence: `README.md`)
- Scan and batch routes → Gmail SMTP: sends welcome email
