How konetisannihith4/deepshield-ai-deepfake-detector works
DeepShield is a media deepfake detection application: users authenticate, submit audio, image, or video for analysis, and review detection results and forensic reports. The web client also exposes history, analytics, report verification, and organization/admin capabilities. The server coordinates detection, persistence, and report generation; its audio engine calls the Python service, whose routes dispatch to model inference. Source excerpts establish the audio and reporting links; some routing and image/video model internals are unsampled, so those links are omitted or marked unverified.
Main entry points: detectionController.ts Detection Controller · app.py Inference API · index.ts HTTP Server · apiClient.ts API Client
Components 27
Web Client
- Web App
deepfake/client/src/App.tsx - Session Auth
deepfake/client/src/context/AuthContext.tsx - Media Scanning
deepfake/client/src/pages/UploadPage.tsx - Video Scanning
deepfake/client/src/pages/VideoDetectionPage.tsx - API Client
deepfake/client/src/services/apiClient.ts - Scan History
deepfake/client/src/services/scanHistoryService.ts - Report Export
deepfake/client/src/services/reportExporter.ts - Analytics & Admin
deepfake/client/src/pages/AnalyticsPage.tsx
Application Server
- HTTP Server
deepfake/server/src/index.ts - Token & Roles
deepfake/server/src/middleware/auth.ts - Account Services
deepfake/server/src/controllers/authController.ts - Detection Controller
deepfake/server/src/controllers/detectionController.ts - Video Controller
deepfake/server/src/controllers/videoDetectionController.ts - Media Processing
deepfake/server/src/services/mediaProcessor.ts - Application Database
deepfake/server/src/db/prisma.ts
AI Detection
- Audio Detection Engine
deepfake/server/src/services/aiDetectionEngine.ts - Inference API
deepfake/ai-service/app.py - Audio Model Inference
deepfake/ai-service/inference.py - Audio Preprocessing
deepfake/ai-service/preprocess.py - Video Inference
deepfake/ai-service/video_inference.py - EfficientNet Video
deepfake/ai-service/efficientnet_video_inference.py - Image Detection
deepfake/ai-service/image_ai_detector.py
Forensic Reports
- PDF Reports
deepfake/server/src/services/pdfReportService.ts - JSON Reports
deepfake/server/src/services/jsonReportService.ts - Report File Store
deepfake/server/src/services/reportStorageManager.ts
Other components
- User
- Email Provider
Connections 39
- User → Web App: uses
- Web App → Session Auth: provides sessions
deepfake/client/src/App.tsx - Web App → Media Scanning: routes scans
deepfake/client/src/App.tsx - Web App → Video Scanning: routes video scans
deepfake/client/src/App.tsx - Session Auth → API Client: sends auth requests
deepfake/client/src/context/AuthContext.tsx - Session Auth → Scan History: clears history
deepfake/client/src/context/AuthContext.tsx - Media Scanning → API Client: submits media
deepfake/client/src/pages/UploadPage.tsx - Video Scanning → API Client: submits video
deepfake/client/src/pages/VideoDetectionPage.tsx - Media Scanning → Scan History: saves scan
deepfake/client/src/pages/UploadPage.tsx - Video Scanning → Scan History: saves scan
deepfake/client/src/pages/VideoDetectionPage.tsx - Media Scanning → Report Export: exports reports
deepfake/client/src/pages/UploadPage.tsx - Video Scanning → Report Export: exports reports
deepfake/client/src/pages/VideoDetectionPage.tsx - Analytics & Admin → API Client: loads analytics
deepfake/client/src/pages/AnalyticsPage.tsx - API Client → HTTP Server: calls API
- HTTP Server → Account Services: routes account requests
- HTTP Server → Detection Controller: routes detections
- HTTP Server → Video Controller: routes video requests
- Account Services → Application Database: reads and writes
deepfake/server/src/controllers/authController.ts - Account Services → Email Provider: sends email
deepfake/server/src/controllers/authController.ts - Token & Roles → HTTP Server: guards requests
- Detection Controller → Token & Roles: uses identity
deepfake/server/src/controllers/detectionController.ts - Detection Controller → Media Processing: processes media
deepfake/server/src/controllers/detectionController.ts - Detection Controller → Audio Detection Engine: analyzes audio
deepfake/server/src/controllers/detectionController.ts - Detection Controller → Application Database: stores detections
deepfake/server/src/controllers/detectionController.ts - Detection Controller → PDF Reports: generates reports
deepfake/server/src/controllers/detectionController.ts - Detection Controller → JSON Reports: calculates findings
deepfake/server/src/controllers/detectionController.ts - Detection Controller → Report File Store: lists reports
deepfake/server/src/controllers/detectionController.ts - Video Controller → Application Database: reads and writes
deepfake/server/src/controllers/videoDetectionController.ts - Video Controller → PDF Reports: generates reports
deepfake/server/src/controllers/videoDetectionController.ts - Audio Detection Engine → Inference API: sends audio specimen
deepfake/server/src/services/aiDetectionEngine.ts - Inference API → Audio Model Inference: dispatches audio
deepfake/ai-service/app.py - Inference API → Video Inference: dispatches video
deepfake/ai-service/app.py - Inference API → EfficientNet Video: dispatches EfficientNet
deepfake/ai-service/app.py - Inference API → Image Detection: dispatches image
deepfake/ai-service/app.py - Audio Model Inference → Audio Preprocessing: preprocesses audio
deepfake/ai-service/inference.py - Video Inference → EfficientNet Video: delegates inference
deepfake/ai-service/video_inference.py - PDF Reports → JSON Reports: creates JSON report
deepfake/server/src/services/pdfReportService.ts - PDF Reports → Report File Store: limits report files
deepfake/server/src/services/pdfReportService.ts - JSON Reports → Report File Store: stores JSON report
deepfake/server/src/services/jsonReportService.ts