How sairaj4code/job-scam-detector works
Job-Scam-Detector is a web app for assessing suspicious job postings, submitting scam reports, and asking an AI assistant about job-scam risk. Users enter through the React app: they can analyze a posting or submit a report, while the analysis endpoint combines an ML probability with rule-based indicators into a risk verdict. Chat uses a separate frontend component and backend endpoint that calls Gemini. The dashboard and landing experience are additional UI capabilities. Report handling internals are not shown, so that branch is kept unexpanded.
Main entry points: App.jsx React app · analyze.py Analyze endpoint · api.js API client · app.py Flask app
Components 20
Web experience
- React app
frontend/scam-detector-ui/src/App.jsx - Navigation
frontend/scam-detector-ui/src/components/Navbar.jsx - Landing page
frontend/scam-detector-ui/src/components/LandingPage.jsx - Job prediction
frontend/scam-detector-ui/src/components/JobPrediction.jsx - Report form
frontend/scam-detector-ui/src/components/ReportScam.jsx - Dashboard
frontend/scam-detector-ui/src/components/Dashboard.jsx - Dashboard navigation
frontend/scam-detector-ui/src/components/dashboard/Sidebar.jsx - Dashboard header
frontend/scam-detector-ui/src/components/dashboard/DashboardHeader.jsx - Dashboard metrics
frontend/scam-detector-ui/src/components/dashboard/StatCard.jsx - API client
frontend/scam-detector-ui/src/services/api.js
Risk analysis
- Analyze endpoint
backend/routes/analyze.py - ML prediction
backend/ML/ml_service.py - Rule scoring
backend/service/rules.py - Verdict scoring
backend/service/scoring.py
Backend services
- Flask app
backend/app.py - Report endpoint
backend/routes/report.py
AI assistant
- Chat interface
frontend/scam-detector-ui/ChatBot.jsx - Chat endpoint
backend/routes/chat.py
Other components
- Job seeker
- Gemini service
Connections 19
- Job seeker → React app: uses
frontend/scam-detector-ui/src/App.jsx - React app → Navigation: renders
frontend/scam-detector-ui/src/App.jsx - React app → Landing page: routes to
frontend/scam-detector-ui/src/App.jsx - React app → Job prediction: routes to
frontend/scam-detector-ui/src/App.jsx - React app → Report form: routes to
frontend/scam-detector-ui/src/App.jsx - React app → Dashboard: routes to
frontend/scam-detector-ui/src/App.jsx - React app → Chat interface: routes to
frontend/scam-detector-ui/src/App.jsx - Job prediction → API client: requests analysis
frontend/scam-detector-ui/src/services/api.js - API client → Analyze endpoint: posts analysis
frontend/scam-detector-ui/src/services/api.js - Analyze endpoint → ML prediction: gets probability
backend/routes/analyze.py - Analyze endpoint → Rule scoring: gets rule score
backend/routes/analyze.py - Analyze endpoint → Verdict scoring: calculates verdict
backend/routes/analyze.py - Report form → API client: submits report
frontend/scam-detector-ui/src/services/api.js - API client → Report endpoint: posts report
- Chat interface → Chat endpoint: posts message
frontend/scam-detector-ui/ChatBot.jsx - Chat endpoint → Gemini service: requests response
backend/routes/chat.py - Flask app → Analyze endpoint: registers route
backend/app.py - Flask app → Report endpoint: registers route
backend/app.py - Flask app → Chat endpoint: registers route
backend/app.py