How zeph2004/sms-based-fraud-detection- works
Argus combines a Flutter SMS-safety app, a Spring Boot fraud-detection API, and a React admin portal. The admin flow is login, email OTP verification, then authenticated dashboard use for SMS audit review and user administration. The backend also exposes SMS scanning, fraud alerts, feedback, and administration; the mobile app includes SMS ingestion and detection services. Backend and mobile links beyond the README-described system boundaries are dashed where implementation excerpts were unavailable.
Main entry points: App.tsx Portal navigation · ScanController.java SMS scanning · VerificationPage.tsx OTP verification · AdminController.java Admin operations
Components 24
Admin portal
- Portal entry
web-client/src/main.tsx - Portal navigation
web-client/src/App.tsx - Admin login
web-client/src/pages/LoginPage.tsx - OTP verification
web-client/src/pages/VerificationPage.tsx - Admin dashboard
web-client/src/pages/DashboardPage.tsx - Auth API client
web-client/src/services/authService.ts - Admin API client
web-client/src/services/adminService.ts
Mobile app
- Mobile app
frontend/lib/main.dart - SMS ingestion
frontend/lib/services/sms_ingestion_service.dart - SMS detection
frontend/lib/services/sms_detection_service.dart - Background SMS worker
frontend/android/app/src/main/kotlin/com/example/secure_signal/SmsScanWorker.kt
Fraud API
- Spring API
backend/src/main/java/com/example/smsfraud/SmsfraudApplication.java - Authentication
backend/src/main/java/com/example/smsfraud/auth/AuthController.java - SMS scanning
backend/src/main/java/com/example/smsfraud/scan/ScanController.java - Fraud alerts
backend/src/main/java/com/example/smsfraud/scan/FraudAlertController.java - Fraud feedback
backend/src/main/java/com/example/smsfraud/feedback/FraudRecordController.java - Admin operations
backend/src/main/java/com/example/smsfraud/admin/AdminController.java - ML detection client
backend/src/main/java/com/example/smsfraud/ml/MlFraudDetectionClient.java
Persistence and integrations
- Scan records
backend/src/main/java/com/example/smsfraud/scan/SmsScanRepository.java - User records
backend/src/main/java/com/example/smsfraud/user/UserRepository.java - Feedback records
backend/src/main/java/com/example/smsfraud/feedback/FraudRecordRepository.java - PostgreSQL
Other components
- Admin
- ML service
Connections 26
- Admin → Portal entry: opens
README.md - Portal entry → Portal navigation: renders
web-client/src/main.tsx - Portal navigation → Admin login: shows
web-client/src/App.tsx - Portal navigation → OTP verification: shows
web-client/src/App.tsx - Portal navigation → Admin dashboard: shows
web-client/src/App.tsx - Admin login → Auth API client: requests login
web-client/src/pages/LoginPage.tsx - OTP verification → Auth API client: verifies OTP
web-client/src/pages/VerificationPage.tsx - Auth API client → Authentication: HTTP requests
web-client/src/services/authService.ts - OTP verification → Admin dashboard: continues on success
web-client/src/App.tsx - Admin dashboard → Admin API client: loads and updates
web-client/src/pages/DashboardPage.tsx - Admin API client → Admin operations: HTTP requests
web-client/src/services/adminService.ts - Admin → Mobile app: uses
README.md - Mobile app → SMS ingestion: uses
- SMS ingestion → SMS detection: submits messages
- Background SMS worker → SMS ingestion: supports background scans
- SMS detection → SMS scanning: requests classification
- Spring API → SMS scanning: exposes
- SMS scanning → ML detection client: requests detection
- ML detection client → ML service: calls
- SMS scanning → Scan records: persists scans
- Admin operations → Scan records: reads scan data
- Admin operations → User records: manages users
- Fraud feedback → Feedback records: persists feedback
- Scan records → PostgreSQL: stored in
README.md - User records → PostgreSQL: stored in
README.md - Feedback records → PostgreSQL: stored in
README.md