How ranatashad92/sentinix works
Sentinix is a mobile phishing-URL scanner: a user submits a URL, the backend scores its URL structure with two ML models and checks threat-intelligence services, then returns a verdict and explanation for display and local history. The README also describes model-comparison and structural-analysis visualizations, privacy information, and three verdict levels. The scan handler and client hook are sampled; some backend internals and screen wiring are only partially shown, so uncertain calls are omitted.
Main entry points: index.tsx Scanner screen · api.py Scan API · useScanner.ts Scan client · ScanResult.tsx Verdict display
Components 17
Mobile app
- Scanner screen
phishing-detector-app/src/app/index.tsx - Scan client
phishing-detector-app/src/hooks/useScanner.ts - Client protection
phishing-detector-app/src/utils/antiBot.ts - Verdict display
phishing-detector-app/src/components/ScanResult.tsx - Risk gauge
phishing-detector-app/src/components/RiskGauge.tsx - Feature charts
phishing-detector-app/src/components/StructuralFeatureCharts.tsx - Model comparison
phishing-detector-app/src/components/ModelLineChart.tsx - Privacy information
phishing-detector-app/src/components/PrivacyPolicyModal.tsx
Scan backend
- Scan API
phishing-detector/src/api.py
Detection system
- URL features
phishing-detector/src/features.py - Dual ML models
phishing-detector/models - VirusTotal
- Safe Browsing
Scan history
- History view
phishing-detector-app/src/app/index.tsx - History storage
phishing-detector-app/src/utils/storage.ts - Device storage
Other components
- Mobile user
Connections 18
- Mobile user → Scanner screen: enters URL
- Scanner screen → Scan client: starts scan
- Scan client → Client protection: checks limit; signs
- Scan client → Scan API: posts URL
- Scan API → URL features: extracts features
- Scan API → Dual ML models: loads; predicts
- Scan API → VirusTotal: checks URL
- Scan API → Safe Browsing: checks URL
- Scan API → Scan client: returns verdict
- Scan client → Verdict display: provides result
- Verdict display → Risk gauge: shows score
- Verdict display → Feature charts: shows features
- Scanner screen → Model comparison: shows model data
- Scanner screen → Privacy information: opens policy
- Scan client → History storage: saves scan
- Scanner screen → History storage: loads; clears
- History storage → Device storage: reads; writes
- Scanner screen → History view: shows history