How bipeen-ranjan/nlp-lexical-ai-qr-phishing-detection works
QPhish Guardian is a pre-click QR and URL phishing analysis platform. Users submit a QR image or decoded payload; the documented detection flow analyzes URL structure and payload characteristics, classifies risk, checks threat intelligence, applies a risk policy, and presents an explainable verdict. The backend also provides accounts, scan records, dashboards, administration, and PDF reports, while a browser extension detects QR codes on pages. The detection stages are documented in the README; backend scan-service connections are supported by the scan router’s source-index references, but many UI-to-API details were not sampled.
Main entry points: main.py API Router · scan.py Scan Endpoint · App.tsx Web Application · database.py Application Database
Components 27
User Clients
- Web Application
frontend/src/App.tsx - Session Context
frontend/src/context/AuthContext.tsx - QR Scan UI
frontend/src/pages/ScanQR.tsx - Browser Extension
extension/content.js - Dashboard & Analytics
frontend/src/pages/Dashboard.tsx - History View
frontend/src/pages/History.tsx - Analytics View
frontend/src/pages/Analytics.tsx - Admin View
frontend/src/pages/Admin.tsx
Threat Analysis
- Scan Endpoint
backend/app/routers/scan.py - QR Decoding
backend/app/services/qr_service.py - Payload Analysis
backend/app/services/qr_payload_service.py - Lexical Features
backend/app/services/lexical_service.py - ML Classification
backend/app/services/ml_service.py - Model Features
ml/qphish_features.py - Threat Intelligence
backend/app/services/threat_intel_service.py - Risk Policy
backend/app/services/risk_policy_service.py
Platform Services
- API Router
backend/app/main.py - Authentication
backend/app/routers/auth.py - JWT & Access Control
backend/app/auth.py - Domain Models
backend/app/models.py - Application Database
backend/app/database.py
History & Insights
- Dashboard Stats
backend/app/routers/dashboard.py - Scan History
backend/app/routers/history.py - Administration
backend/app/routers/admin.py - PDF Reports
backend/app/routers/reports.py - PDF Generation
backend/app/services/pdf_service.py
Other components
- User
Connections 37
- User → Web Application: uses
frontend/src/App.tsx - Web Application → Session Context: provides session
frontend/src/App.tsx - Web Application → QR Scan UI: routes to
frontend/src/App.tsx - User → Browser Extension: scans page
- Browser Extension → API Router: submits payload
- QR Scan UI → API Router: requests analysis
- API Router → Scan Endpoint: routes scans
backend/app/main.py - API Router → Authentication: routes auth
backend/app/main.py - API Router → Dashboard Stats: routes stats
backend/app/main.py - API Router → Scan History: routes history
backend/app/main.py - API Router → Administration: routes admin
backend/app/main.py - API Router → PDF Reports: routes reports
backend/app/main.py - Scan Endpoint → QR Decoding: decodes QR
backend/app/routers/scan.py - Scan Endpoint → Payload Analysis: analyzes payload
backend/app/routers/scan.py - Scan Endpoint → Lexical Features: extracts features
backend/app/routers/scan.py - Scan Endpoint → ML Classification: classifies URL
backend/app/routers/scan.py - ML Classification → Model Features: featurizes URL
backend/app/services/ml_service.py - Scan Endpoint → Threat Intelligence: checks reputation
backend/app/routers/scan.py - Scan Endpoint → Risk Policy: sets risk
backend/app/routers/scan.py - Scan Endpoint → Application Database: persists scan
backend/app/routers/scan.py - Scan Endpoint → Domain Models: records results
backend/app/routers/scan.py - Authentication → JWT & Access Control: authenticates
backend/app/routers/auth.py - Authentication → Application Database: reads users
backend/app/routers/auth.py - JWT & Access Control → Application Database: loads user
backend/app/auth.py - Dashboard Stats → Application Database: queries scans
backend/app/routers/dashboard.py - Scan History → Application Database: queries scans
backend/app/routers/history.py - Administration → Application Database: queries records
backend/app/routers/admin.py - PDF Reports → PDF Generation: generates report
backend/app/routers/reports.py - PDF Reports → Application Database: loads scan data
backend/app/routers/reports.py - Web Application → Dashboard & Analytics: routes to
frontend/src/App.tsx - Web Application → History View: routes to
frontend/src/App.tsx - Web Application → Analytics View: routes to
frontend/src/App.tsx - Web Application → Admin View: routes to
frontend/src/App.tsx - Dashboard & Analytics → API Router: loads insights
- History View → API Router: loads scans
- Analytics View → API Router: loads analytics
- Admin View → API Router: requests admin