# vijay-48/ai-generated-code-security-auditor architecture

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

- Interactive diagram: https://gitdiagram.com/vijay-48/ai-generated-code-security-auditor
- Repository: https://github.com/vijay-48/ai-generated-code-security-auditor

## Overview

AI Code Security Auditor scans code and repositories for vulnerabilities, enriches findings with remediation and AI analysis, and can generate and apply fixes. The primary user workflow is CLI or API submission → scanning → vulnerability analysis and patch suggestions → report or fix application. The README documents static, secret, and AI detection; multiple report formats; backups and interactive fixes; REST API; analytics; and optional Redis-backed caching. Source excerpts and the index support several internal links, but do not expose every CLI, report, or API implementation detail, so those links are omitted where unverified.

Main entry points: [`app/agents/security_agent.py`](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/agents/security_agent.py) (Security Agent), [`auditor/cli.py`](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/auditor/cli.py) (Auditor CLI), [`app/workers/scan_worker.py`](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/workers/scan_worker.py) (Scan Worker), [`app/main.py`](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/main.py) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["Auditor CLI<br/>[cli.py]"]
  node_api["REST API<br/>[main.py]"]
  node_async_api["Async API<br/>[async_endpoints.py]"]
end

subgraph group_scan["Scanning and Analysis"]
  node_scan["Security Scanner<br/>[scanner.py]"]
  node_agent["Security Agent<br/>[security_agent.py]"]
  node_repo["Repository Scan"]
  node_git["Git Service<br/>[git_service.py]"]
end

subgraph group_ai["AI and Remediation"]
  node_rag["Remediation Retrieval<br/>[rag_service.py]"]
  node_llm["AI Analysis<br/>[llm_service.py]"]
  node_llm_client["Model Client<br/>[llm_client.py]"]
  node_fixes["Fix Application<br/>[cli.py]"]
end

subgraph group_async["Async Processing"]
  node_worker["Scan Worker<br/>[scan_worker.py]"]
  node_celery["Task Queue<br/>[celery_app.py]"]
  node_cache[("Cache Service<br/>[cache_service.py]")]
  node_websocket["Progress Updates"]
end

subgraph group_insights["Results and Insights"]
  node_analytics_api["Analytics API"]
  node_analytics["Analytics Service"]
  node_models["Analytics Models<br/>[analytics.py]"]
  node_reports["Reports"]
  node_visuals["CLI Visualizations<br/>[charts.py]"]
  node_heatmap["CLI Heatmap<br/>[heatmap.py]"]
  node_terminal["Terminal Capabilities<br/>[terminal.py]"]
end

node_user(("User"))
node_provider{{"LLM Providers"}}

node_user -->|"runs commands"| node_cli
node_user -->|"submits scans"| node_api
node_cli -->|"requests analysis"| node_agent
node_api -->|"routes requests"| node_async_api
node_api -.->|"invokes analysis"| node_agent
node_agent -->|"scans code"| node_scan
node_agent -->|"retrieves remediation"| node_rag
node_agent -->|"generates fixes"| node_llm
node_llm -->|"calls models"| node_provider
node_llm_client -->|"sends requests"| node_provider
node_cli -->|"offers fix commands"| node_fixes
node_async_api -->|"dispatches scans"| node_worker
node_async_api -->|"dispatches repository scans"| node_repo
node_celery -->|"registers tasks"| node_worker
node_celery -->|"registers tasks"| node_repo
node_worker -->|"runs analysis"| node_agent
node_repo -->|"clones repository"| node_git
node_repo -->|"analyzes files"| node_agent
node_worker -->|"reads and writes progress"| node_cache
node_worker -->|"publishes progress"| node_websocket
node_api -->|"stores scan results"| node_analytics
node_analytics_api -.->|"serves analytics"| node_analytics
node_analytics -->|"uses data models"| node_models
node_cli -->|"produces reports"| node_reports
node_cli -.->|"renders findings"| node_visuals
node_visuals -->|"uses capabilities"| node_terminal
node_visuals -.->|"includes heatmaps"| node_heatmap

click node_cli "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/auditor/cli.py"
click node_api "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/main.py"
click node_async_api "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/api/async_endpoints.py"
click node_scan "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/scanner.py"
click node_agent "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/agents/security_agent.py"
click node_repo "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/workers/repo_scan_worker.py"
click node_git "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/git_service.py"
click node_rag "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/rag_service.py"
click node_llm "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/llm_service.py"
click node_llm_client "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/llm_client.py"
click node_fixes "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/auditor/cli.py"
click node_worker "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/workers/scan_worker.py"
click node_celery "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/celery_app.py"
click node_cache "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/cache_service.py"
click node_websocket "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/websocket_manager.py"
click node_analytics_api "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/api/analytics_endpoints.py"
click node_analytics "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/analytics_service.py"
click node_models "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/models/analytics.py"
click node_reports "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/utils/report_generator.py"
click node_visuals "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/cli_visuals/charts.py"
click node_heatmap "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/cli_visuals/heatmap.py"
click node_terminal "https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/cli_visuals/terminal.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_cli,node_api,node_async_api,node_user toneBlue
class node_scan,node_agent,node_repo,node_git toneAmber
class node_rag,node_llm,node_llm_client,node_fixes toneMint
class node_worker,node_celery,node_cache,node_websocket toneRose
class node_analytics_api,node_analytics,node_models,node_reports,node_visuals,node_heatmap,node_terminal,node_provider toneIndigo
```

## Components

### User Interfaces

- [Auditor CLI](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/auditor/cli.py): `auditor/cli.py`
- [REST API](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/main.py): `app/main.py`
- [Async API](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/api/async_endpoints.py): `app/api/async_endpoints.py`

### Scanning and Analysis

- [Security Scanner](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/scanner.py): `app/services/scanner.py`
- [Security Agent](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/agents/security_agent.py): `app/agents/security_agent.py`
- [Repository Scan](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/workers/repo_scan_worker.py): `app/workers/repo_scan_worker.py`
- [Git Service](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/git_service.py): `app/services/git_service.py`

### AI and Remediation

- [Remediation Retrieval](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/rag_service.py): `app/services/rag_service.py`
- [AI Analysis](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/llm_service.py): `app/services/llm_service.py`
- [Model Client](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/llm_client.py): `app/services/llm_client.py`
- [Fix Application](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/auditor/cli.py): `auditor/cli.py`

### Async Processing

- [Scan Worker](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/workers/scan_worker.py): `app/workers/scan_worker.py`
- [Task Queue](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/celery_app.py): `app/celery_app.py`
- [Cache Service](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/cache_service.py): `app/services/cache_service.py`
- [Progress Updates](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/websocket_manager.py): `app/websocket_manager.py`

### Results and Insights

- [Analytics API](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/api/analytics_endpoints.py): `app/api/analytics_endpoints.py`
- [Analytics Service](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/services/analytics_service.py): `app/services/analytics_service.py`
- [Analytics Models](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/models/analytics.py): `app/models/analytics.py`
- [Reports](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/app/utils/report_generator.py): `app/utils/report_generator.py`
- [CLI Visualizations](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/cli_visuals/charts.py): `cli_visuals/charts.py`
- [CLI Heatmap](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/cli_visuals/heatmap.py): `cli_visuals/heatmap.py`
- [Terminal Capabilities](https://github.com/vijay-48/ai-generated-code-security-auditor/blob/main/cli_visuals/terminal.py): `cli_visuals/terminal.py`

### Other components

- **User**
- **LLM Providers**

## Connections

- User → Auditor CLI: runs commands (evidence: `README.md`)
- User → REST API: submits scans (evidence: `README.md`)
- Auditor CLI → Security Agent: requests analysis (evidence: `auditor/cli.py`)
- REST API → Async API: routes requests (evidence: `app/main.py`)
- REST API → Security Agent: invokes analysis (evidence: `app/main.py`)
- Security Agent → Security Scanner: scans code (evidence: `app/agents/security_agent.py`)
- Security Agent → Remediation Retrieval: retrieves remediation (evidence: `app/agents/security_agent.py`)
- Security Agent → AI Analysis: generates fixes (evidence: `app/agents/security_agent.py`)
- AI Analysis → LLM Providers: calls models (evidence: `app/services/llm_service.py`)
- Model Client → LLM Providers: sends requests (evidence: `app/services/llm_client.py`)
- Auditor CLI → Fix Application: offers fix commands (evidence: `README.md`)
- Async API → Scan Worker: dispatches scans (evidence: `app/api/async_endpoints.py`)
- Async API → Repository Scan: dispatches repository scans (evidence: `app/api/async_endpoints.py`)
- Task Queue → Scan Worker: registers tasks (evidence: `app/celery_app.py`)
- Task Queue → Repository Scan: registers tasks (evidence: `app/celery_app.py`)
- Scan Worker → Security Agent: runs analysis (evidence: `app/workers/scan_worker.py`)
- Repository Scan → Git Service: clones repository (evidence: `app/workers/repo_scan_worker.py`)
- Repository Scan → Security Agent: analyzes files (evidence: `app/workers/repo_scan_worker.py`)
- Scan Worker → Cache Service: reads and writes progress (evidence: `app/workers/scan_worker.py`)
- Scan Worker → Progress Updates: publishes progress (evidence: `app/workers/scan_worker.py`)
- REST API → Analytics Service: stores scan results (evidence: `app/main.py`)
- Analytics API → Analytics Service: serves analytics (evidence: `app/api/analytics_endpoints.py`)
- Analytics Service → Analytics Models: uses data models (evidence: `app/services/analytics_service.py`)
- Auditor CLI → Reports: produces reports (evidence: `README.md`)
- Auditor CLI → CLI Visualizations: renders findings
- CLI Visualizations → Terminal Capabilities: uses capabilities (evidence: `cli_visuals/charts.py`)
- CLI Visualizations → CLI Heatmap: includes heatmaps
