How sriramgg/jobguardai works
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: analyze.py Scan and batch routes · risk_scorer.py Risk scoring · app.py FastAPI application · dashboard.html Dashboard and history
Components 24
User experiences
- Web application
frontend/web/index.html - Dashboard and history
frontend/web/dashboard.html - Threat map
frontend/web/assets/js/globe-map.js - Authentication UI
frontend/web/assets/js/auth.js - Browser extension
frontend/extension/popup.js
API and orchestration
- FastAPI application
backend/app.py - Scan and batch routes
backend/api/v1/routes/analyze.py - Chat route
backend/api/v1/routes/chat.py - Status route
backend/api/v1/routes/int_routes.py
Fraud analysis
- Listing scraper
backend/utils/scraper.py - Text preprocessing
backend/utils/preprocess.py - Risk scoring
backend/utils/risk_scorer.py - Domain intelligence
backend/utils/domain_check.py - Company verification
backend/utils/company_verify.py - Scam blacklist
backend/utils/blacklist.py - Prediction explanation
backend/utils/explain.py
Persistence and reports
- Scan records
backend/api/v1/routes/analyze.py - MongoDB connection
backend/database.py - PDF reports
backend/utils/pdf_generator.py
External services
- Groq AI
- Firebase Auth
- OpenStreetMap
- Gmail SMTP
Other components
- Job seeker
Connections 25
- Job seeker → Web application: submits listing
README.md - Job seeker → Browser extension: scans listing
- Web application → FastAPI application: calls API
README.md - Browser extension → Scan and batch routes: requests scan
- FastAPI application → Scan and batch routes: registers route
backend/app.py - FastAPI application → Chat route: registers route
backend/app.py - FastAPI application → Status route: registers route
backend/app.py - Scan and batch routes → Listing scraper: scrapes URL
backend/api/v1/routes/analyze.py - Scan and batch routes → Text preprocessing: prepares text
- Scan and batch routes → Risk scoring: scores listing
backend/api/v1/routes/analyze.py - Risk scoring → Domain intelligence: checks domain
backend/utils/risk_scorer.py - Risk scoring → Company verification: verifies company
backend/utils/risk_scorer.py - Risk scoring → Scam blacklist: checks reports
backend/utils/risk_scorer.py - Risk scoring → Prediction explanation: explains prediction
backend/utils/risk_scorer.py - Scan and batch routes → Scan records: stores result
backend/api/v1/routes/analyze.py - Scan and batch routes → PDF reports: generates report
backend/api/v1/routes/analyze.py - Scan and batch routes → MongoDB connection: uses persistence
backend/api/v1/routes/analyze.py - Chat route → Groq AI: queries model
backend/api/v1/routes/chat.py - Dashboard and history → FastAPI application: requests scans
README.md - Dashboard and history → Scan records: shows history
README.md - Dashboard and history → Threat map: renders threats
README.md - Web application → Authentication UI: provides sign-in
README.md - Authentication UI → Firebase Auth: authenticates users
README.md - Threat map → OpenStreetMap: geocodes origins
README.md - Scan and batch routes → Gmail SMTP: sends welcome email