How swastikvitthare/patchpilot works
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: engine.py Scan Orchestrator · scanner.py Scan Routes · useScanner.ts Scan State · base.py Scanner Interface
Components 24
Code Review UI
- Code Scanner UI
frontend/src/app/scanner/page.tsx - Scan State
frontend/src/hooks/useScanner.ts - Typed API Client
frontend/src/lib/api.ts - Browser Scanner
frontend/src/lib/client-scanner.ts - Results View
frontend/src/components/views/ResultsView.tsx - Patch Diff View
frontend/src/components/views/PatchView.tsx - Report View
frontend/src/components/views/ReportView.tsx
Backend API
- FastAPI App
backend/app/main.py - Scan Routes
backend/app/routers/scanner.py - Patch Route
backend/app/routers/patcher.py - Report Route
backend/app/routers/report.py - Input Validation
backend/app/utils/sanitizer.py
Security Analysis
- Scan Orchestrator
backend/app/scanners/engine.py - Scanner Interface
backend/app/scanners/base.py - SQL Detection
backend/app/scanners/sql_injection.py - Credential Detection
backend/app/scanners/hardcoded_creds.py - Unsafe Execution
backend/app/scanners/unsafe_eval.py - Python Static Checks
backend/app/scanners/python_static.py
Fixes and Reports
- AI Explanations
backend/app/services/ai_service.py - Gemma Client
backend/app/services/gemma_client.py - Patch Generator
backend/app/services/patch_generator.py - Report Generator
backend/app/services/report_generator.py
Other components
- Developer
- Gemma API
Connections 30
- 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
backend/app/main.py - FastAPI App → Patch Route: registers routes
backend/app/main.py - FastAPI App → Report Route: registers routes
backend/app/main.py - Scan Routes → Input Validation: validates input
backend/app/routers/scanner.py - Scan Routes → Scan Orchestrator: runs scan
backend/app/routers/scanner.py - Scan Orchestrator → SQL Detection: dispatches scan
backend/app/scanners/engine.py - Scan Orchestrator → Credential Detection: dispatches scan
backend/app/scanners/engine.py - Scan Orchestrator → Unsafe Execution: dispatches scan
backend/app/scanners/engine.py - Scan Orchestrator → Python Static Checks: dispatches scan
backend/app/scanners/engine.py - SQL Detection → Scanner Interface: implements interface
backend/app/scanners/engine.py - Credential Detection → Scanner Interface: implements interface
backend/app/scanners/engine.py - Unsafe Execution → Scanner Interface: implements interface
backend/app/scanners/engine.py - Python Static Checks → Scanner Interface: implements interface
backend/app/scanners/engine.py - Scan State → Results View: shows findings
- Scan Routes → AI Explanations: requests explanations
- Patch Route → Input Validation: validates code
backend/app/routers/patcher.py - Patch Route → Patch Generator: generates fixes
backend/app/routers/patcher.py - Patch Generator → Gemma Client: requests generation
backend/app/services/patch_generator.py - Gemma Client → Gemma API: sends prompts
backend/app/services/gemma_client.py - Patch Generator → Patch Diff View: returns patch
- Report Route → Report Generator: generates report
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