# konetisannihith4/deepshield-ai-deepfake-detector architecture

> Architecture diagram of the GitHub repository konetisannihith4/deepshield-ai-deepfake-detector, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/konetisannihith4/deepshield-ai-deepfake-detector
- Repository: https://github.com/konetisannihith4/deepshield-ai-deepfake-detector

## Overview

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: [`deepfake/server/src/controllers/detectionController.ts`](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/detectionController.ts) (Detection Controller), [`deepfake/ai-service/app.py`](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/app.py) (Inference API), [`deepfake/server/src/index.ts`](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/index.ts) (HTTP Server), [`deepfake/client/src/services/apiClient.ts`](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/apiClient.ts) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web Client"]
  node_webapp["Web App<br/>[App.tsx]"]
  node_authui["Session Auth<br/>[AuthContext.tsx]"]
  node_scanui["Media Scanning<br/>[UploadPage.tsx]"]
  node_videoui["Video Scanning"]
  node_clientapi["API Client<br/>[apiClient.ts]"]
  node_history["Scan History"]
  node_exporter["Report Export<br/>[reportExporter.ts]"]
  node_analytics["Analytics &amp; Admin<br/>[AnalyticsPage.tsx]"]
end

subgraph group_server["Application Server"]
  node_server["HTTP Server<br/>[index.ts]"]
  node_auth["Token &amp; Roles<br/>[auth.ts]"]
  node_authctrl["Account Services<br/>[authController.ts]"]
  node_detect["Detection Controller"]
  node_videoctrl["Video Controller"]
  node_media["Media Processing<br/>[mediaProcessor.ts]"]
  node_db[("Application Database<br/>[prisma.ts]")]
end

subgraph group_ai["AI Detection"]
  node_ai_engine["Audio Detection Engine"]
  node_pyapi["Inference API<br/>[app.py]"]
  node_audio["Audio Model Inference<br/>[inference.py]"]
  node_preprocess["Audio Preprocessing<br/>[preprocess.py]"]
  node_video_infer["Video Inference<br/>[video_inference.py]"]
  node_eff_video["EfficientNet Video"]
  node_image_model["Image Detection"]
end

subgraph group_reports["Forensic Reports"]
  node_pdf["PDF Reports"]
  node_json["JSON Reports"]
  node_reportstore[("Report File Store")]
end

node_user(("User"))
node_email(("Email Provider"))

node_user -->|"uses"| node_webapp
node_webapp -->|"provides sessions"| node_authui
node_webapp -->|"routes scans"| node_scanui
node_webapp -->|"routes video scans"| node_videoui
node_authui -->|"sends auth requests"| node_clientapi
node_authui -->|"clears history"| node_history
node_scanui -->|"submits media"| node_clientapi
node_videoui -->|"submits video"| node_clientapi
node_scanui -->|"saves scan"| node_history
node_videoui -->|"saves scan"| node_history
node_scanui -->|"exports reports"| node_exporter
node_videoui -->|"exports reports"| node_exporter
node_analytics -->|"loads analytics"| node_clientapi
node_clientapi -.->|"calls API"| node_server
node_server -.->|"routes account requests"| node_authctrl
node_server -.->|"routes detections"| node_detect
node_server -.->|"routes video requests"| node_videoctrl
node_authctrl -->|"reads and writes"| node_db
node_authctrl -->|"sends email"| node_email
node_auth -.->|"guards requests"| node_server
node_detect -->|"uses identity"| node_auth
node_detect -->|"processes media"| node_media
node_detect -->|"analyzes audio"| node_ai_engine
node_detect -->|"stores detections"| node_db
node_detect -->|"generates reports"| node_pdf
node_detect -->|"calculates findings"| node_json
node_detect -->|"lists reports"| node_reportstore
node_videoctrl -->|"reads and writes"| node_db
node_videoctrl -->|"generates reports"| node_pdf
node_ai_engine -->|"sends audio specimen"| node_pyapi
node_pyapi -->|"dispatches audio"| node_audio
node_pyapi -->|"dispatches video"| node_video_infer
node_pyapi -->|"dispatches EfficientNet"| node_eff_video
node_pyapi -->|"dispatches image"| node_image_model
node_audio -->|"preprocesses audio"| node_preprocess
node_video_infer -->|"delegates inference"| node_eff_video
node_pdf -->|"creates JSON report"| node_json
node_pdf -->|"limits report files"| node_reportstore
node_json -->|"stores JSON report"| node_reportstore

click node_webapp "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/App.tsx"
click node_authui "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/context/AuthContext.tsx"
click node_scanui "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/pages/UploadPage.tsx"
click node_videoui "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/pages/VideoDetectionPage.tsx"
click node_clientapi "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/apiClient.ts"
click node_history "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/scanHistoryService.ts"
click node_exporter "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/reportExporter.ts"
click node_analytics "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/pages/AnalyticsPage.tsx"
click node_server "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/index.ts"
click node_auth "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/middleware/auth.ts"
click node_authctrl "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/authController.ts"
click node_detect "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/detectionController.ts"
click node_videoctrl "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/videoDetectionController.ts"
click node_media "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/mediaProcessor.ts"
click node_db "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/db/prisma.ts"
click node_ai_engine "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/aiDetectionEngine.ts"
click node_pyapi "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/app.py"
click node_audio "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/inference.py"
click node_preprocess "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/preprocess.py"
click node_video_infer "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/video_inference.py"
click node_eff_video "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/efficientnet_video_inference.py"
click node_image_model "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/image_ai_detector.py"
click node_pdf "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/pdfReportService.ts"
click node_json "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/jsonReportService.ts"
click node_reportstore "https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/reportStorageManager.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_authui,node_scanui,node_videoui,node_clientapi,node_history,node_exporter,node_analytics,node_user toneBlue
class node_server,node_auth,node_authctrl,node_detect,node_videoctrl,node_media,node_db toneAmber
class node_ai_engine,node_pyapi,node_audio,node_preprocess,node_video_infer,node_eff_video,node_image_model toneMint
class node_pdf,node_json,node_reportstore toneRose
class node_email toneIndigo
```

## Components

### Web Client

- [Web App](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/App.tsx): `deepfake/client/src/App.tsx`
- [Session Auth](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/context/AuthContext.tsx): `deepfake/client/src/context/AuthContext.tsx`
- [Media Scanning](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/pages/UploadPage.tsx): `deepfake/client/src/pages/UploadPage.tsx`
- [Video Scanning](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/pages/VideoDetectionPage.tsx): `deepfake/client/src/pages/VideoDetectionPage.tsx`
- [API Client](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/apiClient.ts): `deepfake/client/src/services/apiClient.ts`
- [Scan History](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/scanHistoryService.ts): `deepfake/client/src/services/scanHistoryService.ts`
- [Report Export](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/services/reportExporter.ts): `deepfake/client/src/services/reportExporter.ts`
- [Analytics & Admin](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/client/src/pages/AnalyticsPage.tsx): `deepfake/client/src/pages/AnalyticsPage.tsx`

### Application Server

- [HTTP Server](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/index.ts): `deepfake/server/src/index.ts`
- [Token & Roles](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/middleware/auth.ts): `deepfake/server/src/middleware/auth.ts`
- [Account Services](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/authController.ts): `deepfake/server/src/controllers/authController.ts`
- [Detection Controller](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/detectionController.ts): `deepfake/server/src/controllers/detectionController.ts`
- [Video Controller](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/controllers/videoDetectionController.ts): `deepfake/server/src/controllers/videoDetectionController.ts`
- [Media Processing](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/mediaProcessor.ts): `deepfake/server/src/services/mediaProcessor.ts`
- [Application Database](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/db/prisma.ts): `deepfake/server/src/db/prisma.ts`

### AI Detection

- [Audio Detection Engine](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/aiDetectionEngine.ts): `deepfake/server/src/services/aiDetectionEngine.ts`
- [Inference API](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/app.py): `deepfake/ai-service/app.py`
- [Audio Model Inference](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/inference.py): `deepfake/ai-service/inference.py`
- [Audio Preprocessing](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/preprocess.py): `deepfake/ai-service/preprocess.py`
- [Video Inference](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/video_inference.py): `deepfake/ai-service/video_inference.py`
- [EfficientNet Video](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/efficientnet_video_inference.py): `deepfake/ai-service/efficientnet_video_inference.py`
- [Image Detection](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/ai-service/image_ai_detector.py): `deepfake/ai-service/image_ai_detector.py`

### Forensic Reports

- [PDF Reports](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/pdfReportService.ts): `deepfake/server/src/services/pdfReportService.ts`
- [JSON Reports](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/jsonReportService.ts): `deepfake/server/src/services/jsonReportService.ts`
- [Report File Store](https://github.com/konetisannihith4/deepshield-ai-deepfake-detector/blob/main/deepfake/server/src/services/reportStorageManager.ts): `deepfake/server/src/services/reportStorageManager.ts`

### Other components

- **User**
- **Email Provider**

## Connections

- User → Web App: uses
- Web App → Session Auth: provides sessions (evidence: `deepfake/client/src/App.tsx`)
- Web App → Media Scanning: routes scans (evidence: `deepfake/client/src/App.tsx`)
- Web App → Video Scanning: routes video scans (evidence: `deepfake/client/src/App.tsx`)
- Session Auth → API Client: sends auth requests (evidence: `deepfake/client/src/context/AuthContext.tsx`)
- Session Auth → Scan History: clears history (evidence: `deepfake/client/src/context/AuthContext.tsx`)
- Media Scanning → API Client: submits media (evidence: `deepfake/client/src/pages/UploadPage.tsx`)
- Video Scanning → API Client: submits video (evidence: `deepfake/client/src/pages/VideoDetectionPage.tsx`)
- Media Scanning → Scan History: saves scan (evidence: `deepfake/client/src/pages/UploadPage.tsx`)
- Video Scanning → Scan History: saves scan (evidence: `deepfake/client/src/pages/VideoDetectionPage.tsx`)
- Media Scanning → Report Export: exports reports (evidence: `deepfake/client/src/pages/UploadPage.tsx`)
- Video Scanning → Report Export: exports reports (evidence: `deepfake/client/src/pages/VideoDetectionPage.tsx`)
- Analytics & Admin → API Client: loads analytics (evidence: `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 (evidence: `deepfake/server/src/controllers/authController.ts`)
- Account Services → Email Provider: sends email (evidence: `deepfake/server/src/controllers/authController.ts`)
- Token & Roles → HTTP Server: guards requests
- Detection Controller → Token & Roles: uses identity (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Detection Controller → Media Processing: processes media (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Detection Controller → Audio Detection Engine: analyzes audio (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Detection Controller → Application Database: stores detections (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Detection Controller → PDF Reports: generates reports (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Detection Controller → JSON Reports: calculates findings (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Detection Controller → Report File Store: lists reports (evidence: `deepfake/server/src/controllers/detectionController.ts`)
- Video Controller → Application Database: reads and writes (evidence: `deepfake/server/src/controllers/videoDetectionController.ts`)
- Video Controller → PDF Reports: generates reports (evidence: `deepfake/server/src/controllers/videoDetectionController.ts`)
- Audio Detection Engine → Inference API: sends audio specimen (evidence: `deepfake/server/src/services/aiDetectionEngine.ts`)
- Inference API → Audio Model Inference: dispatches audio (evidence: `deepfake/ai-service/app.py`)
- Inference API → Video Inference: dispatches video (evidence: `deepfake/ai-service/app.py`)
- Inference API → EfficientNet Video: dispatches EfficientNet (evidence: `deepfake/ai-service/app.py`)
- Inference API → Image Detection: dispatches image (evidence: `deepfake/ai-service/app.py`)
- Audio Model Inference → Audio Preprocessing: preprocesses audio (evidence: `deepfake/ai-service/inference.py`)
- Video Inference → EfficientNet Video: delegates inference (evidence: `deepfake/ai-service/video_inference.py`)
- PDF Reports → JSON Reports: creates JSON report (evidence: `deepfake/server/src/services/pdfReportService.ts`)
- PDF Reports → Report File Store: limits report files (evidence: `deepfake/server/src/services/pdfReportService.ts`)
- JSON Reports → Report File Store: stores JSON report (evidence: `deepfake/server/src/services/jsonReportService.ts`)
