# swastikvitthare/patchpilot architecture

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

- Interactive diagram: https://gitdiagram.com/swastikvitthare/patchpilot
- Repository: https://github.com/swastikvitthare/patchpilot

## Overview

PATCHPILOT is a Python security-scanning application with a Next.js interface. Users submit Python code, review detected vulnerabilities and explanations, generate patches, re-scan patched code, and download a report. The backend also includes a browser-side fallback scanner. The graph preserves the documented scanning, AI, patching, verification, and reporting capabilities; frontend-to-API wiring and some route behavior are based on README descriptions because those source files were not excerpted.

Main entry points: [`backend/app/scanners/engine.py`](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/engine.py) (Scan Orchestrator), [`backend/app/routers/scanner.py`](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/scanner.py) (Scan Routes), [`frontend/src/hooks/useScanner.ts`](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/hooks/useScanner.ts) (Scan State), [`backend/app/scanners/base.py`](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/base.py) (Scanner Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Code Review UI"]
  node_scanner_ui["Code Scanner UI<br/>[page.tsx]"]
  node_scan_state["Scan State<br/>[useScanner.ts]"]
  node_api_client["Typed API Client<br/>[api.ts]"]
  node_browser_scan["Browser Scanner<br/>[client-scanner.ts]"]
  node_results_ui["Results View<br/>[ResultsView.tsx]"]
  node_patch_ui["Patch Diff View<br/>[PatchView.tsx]"]
  node_report_ui["Report View<br/>[ReportView.tsx]"]
end

subgraph group_api["Backend API"]
  node_api_app["FastAPI App<br/>[main.py]"]
  node_scan_route["Scan Routes<br/>[scanner.py]"]
  node_patch_route["Patch Route<br/>[patcher.py]"]
  node_report_route["Report Route<br/>[report.py]"]
  node_sanitizer["Input Validation<br/>[sanitizer.py]"]
end

subgraph group_scanning["Security Analysis"]
  node_scan_engine["Scan Orchestrator<br/>[engine.py]"]
  node_base_scanner["Scanner Interface<br/>[base.py]"]
  node_sql_scanner["SQL Detection<br/>[sql_injection.py]"]
  node_credential_scanner["Credential Detection<br/>[hardcoded_creds.py]"]
  node_execution_scanner["Unsafe Execution<br/>[unsafe_eval.py]"]
  node_static_scanner["Python Static Checks<br/>[python_static.py]"]
end

subgraph group_remediation["Fixes and Reports"]
  node_ai_explainer["AI Explanations<br/>[ai_service.py]"]
  node_gemma_client["Gemma Client<br/>[gemma_client.py]"]
  node_patch_generator["Patch Generator<br/>[patch_generator.py]"]
  node_report_generator["Report Generator"]
end

node_user(("Developer"))
node_gemma_service(("Gemma API"))

node_user -->|"submits code"| node_scanner_ui
node_scanner_ui -.->|"starts scan"| node_scan_state
node_scan_state -.->|"requests scan"| node_api_client
node_scan_state -.->|"fallback scans"| node_browser_scan
node_api_client -.->|"calls API"| node_scan_route
node_api_app -->|"registers routes"| node_scan_route
node_api_app -->|"registers routes"| node_patch_route
node_api_app -->|"registers routes"| node_report_route
node_scan_route -->|"validates input"| node_sanitizer
node_scan_route -->|"runs scan"| node_scan_engine
node_scan_engine -->|"dispatches scan"| node_sql_scanner
node_scan_engine -->|"dispatches scan"| node_credential_scanner
node_scan_engine -->|"dispatches scan"| node_execution_scanner
node_scan_engine -->|"dispatches scan"| node_static_scanner
node_sql_scanner -->|"implements interface"| node_base_scanner
node_credential_scanner -->|"implements interface"| node_base_scanner
node_execution_scanner -->|"implements interface"| node_base_scanner
node_static_scanner -->|"implements interface"| node_base_scanner
node_scan_state -.->|"shows findings"| node_results_ui
node_scan_route -.->|"requests explanations"| node_ai_explainer
node_patch_route -->|"validates code"| node_sanitizer
node_patch_route -->|"generates fixes"| node_patch_generator
node_patch_generator -->|"requests generation"| node_gemma_client
node_gemma_client -->|"sends prompts"| node_gemma_service
node_patch_generator -.->|"returns patch"| node_patch_ui
node_report_route -->|"generates report"| node_report_generator
node_report_generator -.->|"provides report"| node_report_ui
node_user -.->|"reviews diff"| node_patch_ui
node_user -.->|"downloads report"| node_report_ui
node_user -.->|"reviews findings"| node_results_ui

click node_scanner_ui "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/app/scanner/page.tsx"
click node_scan_state "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/hooks/useScanner.ts"
click node_api_client "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/lib/api.ts"
click node_browser_scan "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/lib/client-scanner.ts"
click node_results_ui "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/components/views/ResultsView.tsx"
click node_patch_ui "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/components/views/PatchView.tsx"
click node_report_ui "https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/components/views/ReportView.tsx"
click node_api_app "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/main.py"
click node_scan_route "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/scanner.py"
click node_patch_route "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/patcher.py"
click node_report_route "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/report.py"
click node_sanitizer "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/utils/sanitizer.py"
click node_scan_engine "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/engine.py"
click node_base_scanner "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/base.py"
click node_sql_scanner "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/sql_injection.py"
click node_credential_scanner "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/hardcoded_creds.py"
click node_execution_scanner "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/unsafe_eval.py"
click node_static_scanner "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/python_static.py"
click node_ai_explainer "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/ai_service.py"
click node_gemma_client "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/gemma_client.py"
click node_patch_generator "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/patch_generator.py"
click node_report_generator "https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/report_generator.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_scanner_ui,node_scan_state,node_api_client,node_browser_scan,node_results_ui,node_patch_ui,node_report_ui toneBlue
class node_api_app,node_scan_route,node_patch_route,node_report_route,node_sanitizer toneAmber
class node_scan_engine,node_base_scanner,node_sql_scanner,node_credential_scanner,node_execution_scanner,node_static_scanner,node_gemma_service toneMint
class node_ai_explainer,node_gemma_client,node_patch_generator,node_report_generator toneRose
class node_user toneIndigo
```

## Components

### Code Review UI

- [Code Scanner UI](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/app/scanner/page.tsx): `frontend/src/app/scanner/page.tsx`
- [Scan State](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/hooks/useScanner.ts): `frontend/src/hooks/useScanner.ts`
- [Typed API Client](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Browser Scanner](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/lib/client-scanner.ts): `frontend/src/lib/client-scanner.ts`
- [Results View](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/components/views/ResultsView.tsx): `frontend/src/components/views/ResultsView.tsx`
- [Patch Diff View](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/components/views/PatchView.tsx): `frontend/src/components/views/PatchView.tsx`
- [Report View](https://github.com/swastikvitthare/patchpilot/blob/main/frontend/src/components/views/ReportView.tsx): `frontend/src/components/views/ReportView.tsx`

### Backend API

- [FastAPI App](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/main.py): `backend/app/main.py`
- [Scan Routes](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/scanner.py): `backend/app/routers/scanner.py`
- [Patch Route](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/patcher.py): `backend/app/routers/patcher.py`
- [Report Route](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/routers/report.py): `backend/app/routers/report.py`
- [Input Validation](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/utils/sanitizer.py): `backend/app/utils/sanitizer.py`

### Security Analysis

- [Scan Orchestrator](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/engine.py): `backend/app/scanners/engine.py`
- [Scanner Interface](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/base.py): `backend/app/scanners/base.py`
- [SQL Detection](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/sql_injection.py): `backend/app/scanners/sql_injection.py`
- [Credential Detection](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/hardcoded_creds.py): `backend/app/scanners/hardcoded_creds.py`
- [Unsafe Execution](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/unsafe_eval.py): `backend/app/scanners/unsafe_eval.py`
- [Python Static Checks](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/scanners/python_static.py): `backend/app/scanners/python_static.py`

### Fixes and Reports

- [AI Explanations](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/ai_service.py): `backend/app/services/ai_service.py`
- [Gemma Client](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/gemma_client.py): `backend/app/services/gemma_client.py`
- [Patch Generator](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/patch_generator.py): `backend/app/services/patch_generator.py`
- [Report Generator](https://github.com/swastikvitthare/patchpilot/blob/main/backend/app/services/report_generator.py): `backend/app/services/report_generator.py`

### Other components

- **Developer**
- **Gemma API**

## Connections

- Developer → Code Scanner UI: submits code
- Code Scanner UI → Scan State: starts scan
- Scan State → Typed API Client: requests scan
- Scan State → Browser Scanner: fallback scans
- Typed API Client → Scan Routes: calls API
- FastAPI App → Scan Routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI App → Patch Route: registers routes (evidence: `backend/app/main.py`)
- FastAPI App → Report Route: registers routes (evidence: `backend/app/main.py`)
- Scan Routes → Input Validation: validates input (evidence: `backend/app/routers/scanner.py`)
- Scan Routes → Scan Orchestrator: runs scan (evidence: `backend/app/routers/scanner.py`)
- Scan Orchestrator → SQL Detection: dispatches scan (evidence: `backend/app/scanners/engine.py`)
- Scan Orchestrator → Credential Detection: dispatches scan (evidence: `backend/app/scanners/engine.py`)
- Scan Orchestrator → Unsafe Execution: dispatches scan (evidence: `backend/app/scanners/engine.py`)
- Scan Orchestrator → Python Static Checks: dispatches scan (evidence: `backend/app/scanners/engine.py`)
- SQL Detection → Scanner Interface: implements interface (evidence: `backend/app/scanners/engine.py`)
- Credential Detection → Scanner Interface: implements interface (evidence: `backend/app/scanners/engine.py`)
- Unsafe Execution → Scanner Interface: implements interface (evidence: `backend/app/scanners/engine.py`)
- Python Static Checks → Scanner Interface: implements interface (evidence: `backend/app/scanners/engine.py`)
- Scan State → Results View: shows findings
- Scan Routes → AI Explanations: requests explanations
- Patch Route → Input Validation: validates code (evidence: `backend/app/routers/patcher.py`)
- Patch Route → Patch Generator: generates fixes (evidence: `backend/app/routers/patcher.py`)
- Patch Generator → Gemma Client: requests generation (evidence: `backend/app/services/patch_generator.py`)
- Gemma Client → Gemma API: sends prompts (evidence: `backend/app/services/gemma_client.py`)
- Patch Generator → Patch Diff View: returns patch
- Report Route → Report Generator: generates report (evidence: `backend/app/routers/report.py`)
- Report Generator → Report View: provides report
- Developer → Patch Diff View: reviews diff
- Developer → Report View: downloads report
- Developer → Results View: reviews findings
