# suhaskoparde/ai-fuzzer architecture

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

- Interactive diagram: https://gitdiagram.com/suhaskoparde/ai-fuzzer
- Repository: https://github.com/suhaskoparde/ai-fuzzer

## Overview

AI-Fuzzer combines a React security-assessment dashboard with a FastAPI backend for target registration, connectivity checks, fuzz-case generation, and execution. The visible frontend is a demo: its pages use an in-memory mock service, and the supplied evidence does not show it calling the backend. The backend’s execution path can send generated prompts to configured AI endpoints. Reports, findings, scan history, and settings are represented in the frontend, but their real backend implementation is not shown.

Main entry points: [`AI-Fuzzer/frontend/src/App.tsx`](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/App.tsx) (Web application), [`AI-Fuzzer/frontend/src/services/mockApi.ts`](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/services/mockApi.ts) (Mock application service), [`backend/app/main.py`](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/main.py) (FastAPI application), [`AI-Fuzzer/frontend/src/pages/DashboardPage.tsx`](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/DashboardPage.tsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Assessment interface"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_targets["Target management<br/>[TargetsPage.tsx]"]
  node_scan_setup["Scan setup<br/>[NewScanPage.tsx]"]
  node_scan_review["Scan history and details"]
  node_finding_review["Finding review<br/>[FindingsPage.tsx]"]
  node_report_review["Report review<br/>[ReportsPage.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
end

subgraph group_demo["Demo data service"]
  node_mock_service["Mock application service<br/>[mockApi.ts]"]
  node_mock_data[("Demo assessment data<br/>[mockData.ts]")]
end

subgraph group_api["Backend API"]
  node_server["FastAPI application<br/>[main.py]"]
  node_target_api["Target API<br/>[targets.py]"]
  node_connectivity_api["Connectivity API<br/>[connectivity.py]"]
  node_fuzzing_api["Fuzzing API<br/>[fuzzing.py]"]
  node_execution_api["Execution API<br/>[execution.py]"]
end

subgraph group_engine["Fuzzing runtime"]
  node_target_manager[("Target manager<br/>[manager.py]")]
  node_connectivity_tester["Connectivity tester<br/>[tester.py]"]
  node_case_generator["Fuzz-case generator<br/>[generator.py]"]
  node_executor["Fuzz executor<br/>[executor.py]"]
end

node_user(("Security operator"))
node_ai_target(("AI endpoint"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_targets
node_webapp -->|"routes to"| node_scan_setup
node_webapp -->|"routes to"| node_scan_review
node_webapp -->|"routes to"| node_finding_review
node_webapp -->|"routes to"| node_report_review
node_webapp -->|"routes to"| node_settings
node_dashboard -->|"requests metrics"| node_mock_service
node_targets -->|"manages targets"| node_mock_service
node_scan_setup -->|"starts scans"| node_mock_service
node_scan_review -->|"loads scans"| node_mock_service
node_finding_review -->|"loads findings"| node_mock_service
node_report_review -->|"loads reports"| node_mock_service
node_mock_service -->|"initializes from"| node_mock_data
node_server -->|"registers router"| node_target_api
node_server -->|"registers router"| node_connectivity_api
node_server -->|"registers router"| node_fuzzing_api
node_server -->|"registers router"| node_execution_api
node_target_api -->|"manages targets"| node_target_manager
node_connectivity_api -->|"tests endpoint"| node_connectivity_tester
node_fuzzing_api -->|"generates cases"| node_case_generator
node_execution_api -->|"executes cases"| node_executor
node_connectivity_tester -->|"checks reachability"| node_ai_target
node_executor -->|"sends prompts"| node_ai_target

click node_webapp "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/App.tsx"
click node_dashboard "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/DashboardPage.tsx"
click node_targets "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/TargetsPage.tsx"
click node_scan_setup "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/NewScanPage.tsx"
click node_scan_review "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/ScanHistoryPage.tsx"
click node_finding_review "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/FindingsPage.tsx"
click node_report_review "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/ReportsPage.tsx"
click node_settings "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/SettingsPage.tsx"
click node_mock_service "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/services/mockApi.ts"
click node_mock_data "https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/data/mockData.ts"
click node_server "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/main.py"
click node_target_api "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/targets.py"
click node_connectivity_api "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/connectivity.py"
click node_fuzzing_api "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/fuzzing.py"
click node_execution_api "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/execution.py"
click node_target_manager "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/adapters/manager.py"
click node_connectivity_tester "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/connectivity/tester.py"
click node_case_generator "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/fuzzing/generator.py"
click node_executor "https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/execution/executor.py"

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_dashboard,node_targets,node_scan_setup,node_scan_review,node_finding_review,node_report_review,node_settings toneBlue
class node_mock_service,node_mock_data toneAmber
class node_server,node_target_api,node_connectivity_api,node_fuzzing_api,node_execution_api toneMint
class node_target_manager,node_connectivity_tester,node_case_generator,node_executor toneRose
class node_user,node_ai_target toneIndigo
```

## Components

### Assessment interface

- [Web application](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/App.tsx): `AI-Fuzzer/frontend/src/App.tsx`
- [Dashboard](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/DashboardPage.tsx): `AI-Fuzzer/frontend/src/pages/DashboardPage.tsx`
- [Target management](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/TargetsPage.tsx): `AI-Fuzzer/frontend/src/pages/TargetsPage.tsx`
- [Scan setup](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/NewScanPage.tsx): `AI-Fuzzer/frontend/src/pages/NewScanPage.tsx`
- [Scan history and details](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/ScanHistoryPage.tsx): `AI-Fuzzer/frontend/src/pages/ScanHistoryPage.tsx`
- [Finding review](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/FindingsPage.tsx): `AI-Fuzzer/frontend/src/pages/FindingsPage.tsx`
- [Report review](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/ReportsPage.tsx): `AI-Fuzzer/frontend/src/pages/ReportsPage.tsx`
- [Settings](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/pages/SettingsPage.tsx): `AI-Fuzzer/frontend/src/pages/SettingsPage.tsx`

### Demo data service

- [Mock application service](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/services/mockApi.ts): `AI-Fuzzer/frontend/src/services/mockApi.ts`
- [Demo assessment data](https://github.com/suhaskoparde/ai-fuzzer/blob/main/AI-Fuzzer/frontend/src/data/mockData.ts): `AI-Fuzzer/frontend/src/data/mockData.ts`

### Backend API

- [FastAPI application](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/main.py): `backend/app/main.py`
- [Target API](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/targets.py): `backend/app/api/targets.py`
- [Connectivity API](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/connectivity.py): `backend/app/api/connectivity.py`
- [Fuzzing API](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/fuzzing.py): `backend/app/api/fuzzing.py`
- [Execution API](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/api/execution.py): `backend/app/api/execution.py`

### Fuzzing runtime

- [Target manager](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/adapters/manager.py): `backend/app/adapters/manager.py`
- [Connectivity tester](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/connectivity/tester.py): `backend/app/connectivity/tester.py`
- [Fuzz-case generator](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/fuzzing/generator.py): `backend/app/fuzzing/generator.py`
- [Fuzz executor](https://github.com/suhaskoparde/ai-fuzzer/blob/main/backend/app/execution/executor.py): `backend/app/execution/executor.py`

### Other components

- **Security operator**
- **AI endpoint**

## Connections

- Security operator → Web application: uses (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Dashboard: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Target management: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Scan setup: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Scan history and details: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Finding review: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Report review: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Web application → Settings: routes to (evidence: `AI-Fuzzer/frontend/src/App.tsx`)
- Dashboard → Mock application service: requests metrics (evidence: `AI-Fuzzer/frontend/src/pages/DashboardPage.tsx`)
- Target management → Mock application service: manages targets (evidence: `AI-Fuzzer/frontend/src/pages/TargetsPage.tsx`)
- Scan setup → Mock application service: starts scans (evidence: `AI-Fuzzer/frontend/src/pages/NewScanPage.tsx`)
- Scan history and details → Mock application service: loads scans
- Finding review → Mock application service: loads findings
- Report review → Mock application service: loads reports
- Mock application service → Demo assessment data: initializes from (evidence: `AI-Fuzzer/frontend/src/services/mockApi.ts`)
- FastAPI application → Target API: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Connectivity API: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Fuzzing API: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Execution API: registers router (evidence: `backend/app/main.py`)
- Target API → Target manager: manages targets (evidence: `backend/app/api/targets.py`)
- Connectivity API → Connectivity tester: tests endpoint (evidence: `backend/app/api/connectivity.py`)
- Fuzzing API → Fuzz-case generator: generates cases (evidence: `backend/app/api/fuzzing.py`)
- Execution API → Fuzz executor: executes cases (evidence: `backend/app/api/execution.py`)
- Connectivity tester → AI endpoint: checks reachability (evidence: `backend/app/connectivity/tester.py`)
- Fuzz executor → AI endpoint: sends prompts (evidence: `backend/app/execution/executor.py`)
