How makwana23-harshil/most-final-major-project works
CyberSentinel Pro is a browser-based threat-detection platform backed by a Flask API. The main workflow is a user submitting SMS, email, or URL content through the scanner; the detection API dispatches to detector modules, stores scan results, and returns verdicts for the user-facing history and analytics views. Separate branches handle authentication and administration. README capabilities include deep link checks and dashboards; several frontend/API connections and unsampled route details are documented only broadly, so those links are marked unverified or omitted.
Main entry points: detection_routes.py Detection API · link_inspector.py Deep link inspector · app.py Flask app · text_scanner.py Text scanner
Components 26
Browser experience
- Scanner UI
frontend/js/scan.js - History and dashboard
frontend/js/history.js - Admin console
frontend/js/admin.js
API and identity
- Flask app
backend/app.py - Auth routes
backend/auth/routes.py - JWT middleware
backend/auth/middleware.py - Detection API
backend/api/detection_routes.py - User API
backend/api/user_routes.py - Admin API
backend/api/admin_routes.py
Threat analysis
- SMS detector
backend/detection/sms/sms_detector.py - Email detector
backend/detection/email/email_detector.py - URL detector
backend/detection/url/url_detector.py - Email parser
backend/services/email_parser.py - Text scanner
backend/services/text_scanner.py - URL scanner
backend/services/url_scanner.py - Risk rules
backend/services/rule_engine.py - Explanations
backend/services/explainability.py - Deep link inspector
backend/detection/link/link_inspector.py - LLM inspection
backend/detection/link/llm_inspector.py
Accounts and history
- MongoDB
backend/database.py - Scan history model
backend/models/scan_history.py
External checks
- VirusTotal
- Google Safe Browsing
- Gemini API
Other components
- User
- Administrator
Connections 35
- User → Scanner UI: submits scan
- Scanner UI → Detection API: requests scan
- Detection API → SMS detector: dispatches SMS
backend/api/detection_routes.py - Detection API → Email detector: dispatches email
backend/api/detection_routes.py - Detection API → URL detector: dispatches URL
backend/api/detection_routes.py - SMS detector → Deep link inspector: inspects links
backend/detection/sms/sms_detector.py - Email detector → Deep link inspector: inspects links
backend/detection/email/email_detector.py - Email detector → LLM inspection: uses analysis
backend/detection/email/email_detector.py - URL detector → Deep link inspector: inspects URL
backend/detection/url/url_detector.py - Deep link inspector → LLM inspection: requests analysis
backend/detection/link/link_inspector.py - Deep link inspector → VirusTotal: checks reputation
backend/detection/link/link_inspector.py - Deep link inspector → Google Safe Browsing: checks URL
- LLM inspection → Gemini API: generates analysis
backend/detection/link/llm_inspector.py - Detection API → MongoDB: saves scans
backend/api/detection_routes.py - User → Auth routes: registers or logs in
- Auth routes → MongoDB: reads and updates users
backend/auth/routes.py - Auth routes → JWT middleware: creates tokens
backend/auth/routes.py - User API → JWT middleware: guards routes
backend/api/user_routes.py - Admin API → JWT middleware: guards routes
backend/api/admin_routes.py - Detection API → JWT middleware: guards scans
backend/api/detection_routes.py - User API → MongoDB: reads scan stats
backend/api/user_routes.py - Admin API → MongoDB: manages users and scans
backend/api/admin_routes.py - User → History and dashboard: views history
- Administrator → Admin console: reviews platform
- History and dashboard → User API: requests history
- Admin console → Admin API: requests administration
- Flask app → Auth routes: registers routes
backend/app.py - Flask app → Detection API: registers routes
backend/app.py - Flask app → User API: registers routes
backend/app.py - Flask app → Admin API: registers routes
backend/app.py - Text scanner → Risk rules: applies rules
backend/services/text_scanner.py - Text scanner → Email parser: parses email
backend/services/text_scanner.py - Text scanner → URL scanner: scans URLs
backend/services/text_scanner.py - Text scanner → Explanations: builds explanations
backend/services/text_scanner.py - URL scanner → Risk rules: applies rules
backend/services/url_scanner.py