How shubhh004/scamshield-ai works
ScamShield AI is a web platform for multimodal scam detection. Users enter through the React application, authenticate for protected tools, submit URL, email, SMS, QR, or image content for analysis, and can review scan history, dashboard summaries, analytics, and AI explanations. The server separates route/controller handling from feature services and persists user and scan data. README capability descriptions establish the product scope; the client-to-server request wiring and several scanner internals were not excerpted, so those links are omitted or marked unverified.
Main entry points: features Scanner pages · App.tsx App routing · history.model.ts Scan records · pages Login and registration
Components 21
Web application
- App routing
client/src/App.tsx - Login and registration
client/src/features/auth/pages - Scanner pages
client/src/features - History and insights
client/src/features
Threat scanning
- URL analysis
server/src/features/scan-url - URL risk engine
server/src/features/scan-url/risk.engine.ts - Email analysis
server/src/features/scan-email - SMS analysis
server/src/features/scan-sms - QR decoding
server/src/features/scan-qr - Image OCR
server/src/features/scan-image - File scanning
server/src/features/scan-file
Accounts and insights
- Authentication API
server/src/features/auth/auth.controller.ts - User records
server/src/features/auth/user.model.ts - Scan history
server/src/features/history/history.service.ts - Scan records
server/src/features/history/history.model.ts - Dashboard summary
server/src/features/dashboard/dashboard.service.ts - Analytics
server/src/features/analytics
API and persistence
- AI explanations
server/src/features/ai/ai.service.ts - Database configuration
server/src/config/db.ts
Other components
- Platform user
- Groq inference
Connections 18
- Platform user → App routing: uses
- App routing → Login and registration: routes to
client/src/App.tsx - App routing → Scanner pages: routes to
client/src/App.tsx - App routing → History and insights: routes to
client/src/App.tsx - Login and registration → Authentication API: submits credentials
- Scanner pages → URL analysis: submits scans
- Scanner pages → Email analysis: submits scans
- Scanner pages → SMS analysis: submits scans
- Scanner pages → QR decoding: submits images
- Scanner pages → Image OCR: submits images
- Scanner pages → File scanning: submits files
- History and insights → Scan history: requests history
- Authentication API → User records: reads and writes
- Scan history → Scan records: reads and writes
server/src/features/history/history.service.ts - Dashboard summary → Scan records: reads
server/src/features/dashboard/dashboard.service.ts - URL analysis → URL risk engine: assesses risk
server/src/features/scan-url/risk.engine.ts - AI explanations → Groq inference: requests inference
- Database configuration → Scan records: configures storage