# akshat25-code/ai-code-optimizer architecture

> Architecture diagram of the GitHub repository akshat25-code/ai-code-optimizer, 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/akshat25-code/ai-code-optimizer
- Repository: https://github.com/akshat25-code/ai-code-optimizer

## Overview

AI Code Optimizer is a full-stack code-analysis and optimization platform. A developer works in the React workspace, submits code for deterministic analysis and optional AI-assisted optimization, then can verify the result by comparing execution and performance and view proof-oriented reports. Separate capabilities cover repository scanning, staged review, custom rules, GitHub, collaboration, and visualization. The graph preserves these documented branches; some frontend-to-API wiring and unsampled route internals are represented only where the README documents them.

Main entry points: [`server/api/analysis_routes.py`](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/analysis_routes.py) (Analysis endpoints), [`client/src/features/optimization/useOptimizer.js`](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/optimization/useOptimizer.js) (Optimization workspace), [`server/services/execution/verification_engine.py`](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/verification_engine.py) (Optimization verification), [`server/api/execution_routes.py`](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/execution_routes.py) (Execution endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Developer workspace"]
  node_app["App shell<br/>[App.jsx]"]
  node_optimizer["Optimization workspace<br/>[useOptimizer.js]"]
  node_workspace["Project workspace<br/>[WorkspacePage.jsx]"]
  node_reports["Analysis reports<br/>[ProofPanel.jsx]"]
  node_review_ui["Review pipeline UI<br/>[PipelineView.jsx]"]
  node_rules_ui["Rules manager<br/>[RulesManager.jsx]"]
  node_team_tools["Team and GitHub tools<br/>[TeamPanel.jsx]"]
  node_visualization["Code visualization<br/>[TraceRunner.jsx]"]
end

subgraph group_api["Backend API"]
  node_api_app["API application<br/>[main.py]"]
  node_analysis_routes["Analysis endpoints<br/>[analysis_routes.py]"]
  node_execution_routes["Execution endpoints"]
  node_intelligence_routes["Intelligence endpoints"]
  node_review_routes["Review endpoints<br/>[review_routes.py]"]
  node_project_routes["Project endpoints<br/>[project_routes.py]"]
end

subgraph group_analysis["Code intelligence"]
  node_complexity["Complexity analysis"]
  node_intelligence["Static code intelligence"]
  node_review_pipeline["Staged review<br/>[review_pipeline.py]"]
  node_rules_engine["Custom rules<br/>[rules_engine.py]"]
  node_repo_analysis["Repository scanning<br/>[repo_scanner.py]"]
end

subgraph group_ai_execution["AI and verification"]
  node_verification["Optimization verification"]
  node_sandbox["Sandbox execution<br/>[sandbox_runner.py]"]
  node_docker["Docker isolation<br/>[docker_runner.py]"]
  node_ai_provider["AI providers"]
end

subgraph group_platform["Identity and data"]
  node_mongo[("MongoDB persistence<br/>[database.py]")]
  node_auth["Authentication<br/>[auth_routes.py]"]
  node_auth_models["Identity models<br/>[database.py]"]
end

node_developer(("Developer"))
node_research["Benchmark evaluation<br/>[run_benchmark.py]"]

node_developer -->|"uses"| node_app
node_app -.->|"opens"| node_optimizer
node_developer -->|"edits projects"| node_workspace
node_optimizer -->|"requests analysis"| node_analysis_routes
node_analysis_routes -->|"runs inspection"| node_intelligence
node_analysis_routes -->|"requests metrics"| node_complexity
node_optimizer -->|"requests verification"| node_execution_routes
node_execution_routes -->|"verifies optimization"| node_verification
node_verification -->|"inspects code"| node_intelligence
node_verification -->|"runs comparisons"| node_sandbox
node_sandbox -->|"delegates execution"| node_docker
node_verification -.->|"uses AI result"| node_ai_provider
node_optimizer -->|"presents proof"| node_reports
node_developer -->|"starts review"| node_review_ui
node_review_ui -->|"requests pipeline"| node_review_routes
node_review_routes -->|"runs pipeline"| node_review_pipeline
node_review_pipeline -->|"analyzes complexity"| node_complexity
node_review_pipeline -->|"requests AI review"| node_ai_provider
node_developer -->|"manages rules"| node_rules_ui
node_rules_ui -->|"evaluates policies"| node_rules_engine
node_developer -->|"imports repository"| node_project_routes
node_project_routes -->|"analyzes project"| node_repo_analysis
node_developer -->|"uses integrations"| node_team_tools
node_developer -->|"views traces"| node_visualization
node_api_app -->|"registers routes"| node_analysis_routes
node_api_app -->|"registers routes"| node_execution_routes
node_api_app -.->|"registers routes"| node_review_routes
node_analysis_routes -->|"requires identity"| node_auth
node_execution_routes -->|"requires identity"| node_auth
node_auth -->|"loads identity"| node_auth_models
node_auth_models -->|"persists records"| node_mongo
node_research -.->|"evaluates outcomes"| node_developer

click node_app "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/app/App.jsx"
click node_optimizer "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/optimization/useOptimizer.js"
click node_workspace "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/workspace/WorkspacePage.jsx"
click node_reports "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/components/reports/ProofPanel.jsx"
click node_review_ui "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/review/PipelineView.jsx"
click node_rules_ui "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/rules/RulesManager.jsx"
click node_team_tools "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/team/TeamPanel.jsx"
click node_visualization "https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/visualization/TraceRunner.jsx"
click node_api_app "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/main.py"
click node_analysis_routes "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/analysis_routes.py"
click node_execution_routes "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/execution_routes.py"
click node_intelligence_routes "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/intelligence_routes.py"
click node_review_routes "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/review_routes.py"
click node_project_routes "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/project_routes.py"
click node_complexity "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/complexity_engine.py"
click node_intelligence "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/code_intelligence.py"
click node_review_pipeline "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/review_pipeline.py"
click node_rules_engine "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/rules_engine.py"
click node_repo_analysis "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/repo_scanner.py"
click node_verification "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/verification_engine.py"
click node_sandbox "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/sandbox_runner.py"
click node_docker "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/docker_runner.py"
click node_ai_provider "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/ai/provider_service.py"
click node_mongo "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/core/database.py"
click node_auth "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/auth_routes.py"
click node_auth_models "https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/models/database.py"
click node_research "https://github.com/akshat25-code/ai-code-optimizer/blob/main/research/experiments/run_benchmark.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_app,node_optimizer,node_workspace,node_reports,node_review_ui,node_rules_ui,node_team_tools,node_visualization toneBlue
class node_api_app,node_analysis_routes,node_execution_routes,node_intelligence_routes,node_review_routes,node_project_routes toneAmber
class node_complexity,node_intelligence,node_review_pipeline,node_rules_engine,node_repo_analysis toneMint
class node_verification,node_sandbox,node_docker,node_ai_provider toneRose
class node_mongo,node_auth,node_auth_models,node_developer toneIndigo
class node_research toneTeal
```

## Components

### Developer workspace

- [App shell](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/app/App.jsx): `client/src/app/App.jsx`
- [Optimization workspace](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/optimization/useOptimizer.js): `client/src/features/optimization/useOptimizer.js`
- [Project workspace](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/workspace/WorkspacePage.jsx): `client/src/features/workspace/WorkspacePage.jsx`
- [Analysis reports](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/components/reports/ProofPanel.jsx): `client/src/components/reports/ProofPanel.jsx`
- [Review pipeline UI](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/review/PipelineView.jsx): `client/src/features/review/PipelineView.jsx`
- [Rules manager](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/rules/RulesManager.jsx): `client/src/features/rules/RulesManager.jsx`
- [Team and GitHub tools](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/team/TeamPanel.jsx): `client/src/features/team/TeamPanel.jsx`
- [Code visualization](https://github.com/akshat25-code/ai-code-optimizer/blob/main/client/src/features/visualization/TraceRunner.jsx): `client/src/features/visualization/TraceRunner.jsx`

### Backend API

- [API application](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/main.py): `server/main.py`
- [Analysis endpoints](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/analysis_routes.py): `server/api/analysis_routes.py`
- [Execution endpoints](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/execution_routes.py): `server/api/execution_routes.py`
- [Intelligence endpoints](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/intelligence_routes.py): `server/api/intelligence_routes.py`
- [Review endpoints](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/review_routes.py): `server/api/review_routes.py`
- [Project endpoints](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/project_routes.py): `server/api/project_routes.py`

### Code intelligence

- [Complexity analysis](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/complexity_engine.py): `server/services/analysis/complexity_engine.py`
- [Static code intelligence](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/code_intelligence.py): `server/services/analysis/code_intelligence.py`
- [Staged review](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/review_pipeline.py): `server/services/analysis/review_pipeline.py`
- [Custom rules](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/rules_engine.py): `server/services/analysis/rules_engine.py`
- [Repository scanning](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/analysis/repo_scanner.py): `server/services/analysis/repo_scanner.py`

### AI and verification

- [Optimization verification](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/verification_engine.py): `server/services/execution/verification_engine.py`
- [Sandbox execution](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/sandbox_runner.py): `server/services/execution/sandbox_runner.py`
- [Docker isolation](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/execution/docker_runner.py): `server/services/execution/docker_runner.py`
- [AI providers](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/services/ai/provider_service.py): `server/services/ai/provider_service.py`

### Identity and data

- [MongoDB persistence](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/core/database.py): `server/core/database.py`
- [Authentication](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/api/auth_routes.py): `server/api/auth_routes.py`
- [Identity models](https://github.com/akshat25-code/ai-code-optimizer/blob/main/server/models/database.py): `server/models/database.py`

### Other components

- **Developer**
- [Benchmark evaluation](https://github.com/akshat25-code/ai-code-optimizer/blob/main/research/experiments/run_benchmark.py): `research/experiments/run_benchmark.py`

## Connections

- Developer → App shell: uses (evidence: `README.md`)
- App shell → Optimization workspace: opens
- Developer → Project workspace: edits projects (evidence: `README.md`)
- Optimization workspace → Analysis endpoints: requests analysis (evidence: `README.md`)
- Analysis endpoints → Static code intelligence: runs inspection (evidence: `server/api/analysis_routes.py`)
- Analysis endpoints → Complexity analysis: requests metrics (evidence: `server/api/analysis_routes.py`)
- Optimization workspace → Execution endpoints: requests verification (evidence: `README.md`)
- Execution endpoints → Optimization verification: verifies optimization (evidence: `server/api/execution_routes.py`)
- Optimization verification → Static code intelligence: inspects code (evidence: `server/services/execution/verification_engine.py`)
- Optimization verification → Sandbox execution: runs comparisons (evidence: `server/services/execution/verification_engine.py`)
- Sandbox execution → Docker isolation: delegates execution (evidence: `server/services/execution/sandbox_runner.py`)
- Optimization verification → AI providers: uses AI result
- Optimization workspace → Analysis reports: presents proof (evidence: `README.md`)
- Developer → Review pipeline UI: starts review (evidence: `README.md`)
- Review pipeline UI → Review endpoints: requests pipeline (evidence: `README.md`)
- Review endpoints → Staged review: runs pipeline (evidence: `server/api/review_routes.py`)
- Staged review → Complexity analysis: analyzes complexity (evidence: `server/services/analysis/review_pipeline.py`)
- Staged review → AI providers: requests AI review (evidence: `server/services/analysis/review_pipeline.py`)
- Developer → Rules manager: manages rules (evidence: `README.md`)
- Rules manager → Custom rules: evaluates policies (evidence: `README.md`)
- Developer → Project endpoints: imports repository (evidence: `README.md`)
- Project endpoints → Repository scanning: analyzes project (evidence: `server/api/project_routes.py`)
- Developer → Team and GitHub tools: uses integrations (evidence: `README.md`)
- Developer → Code visualization: views traces (evidence: `README.md`)
- API application → Analysis endpoints: registers routes (evidence: `server/main.py`)
- API application → Execution endpoints: registers routes (evidence: `server/main.py`)
- API application → Review endpoints: registers routes (evidence: `server/main.py`)
- Analysis endpoints → Authentication: requires identity (evidence: `server/api/analysis_routes.py`)
- Execution endpoints → Authentication: requires identity (evidence: `server/api/execution_routes.py`)
- Authentication → Identity models: loads identity (evidence: `server/api/auth_routes.py`)
- Identity models → MongoDB persistence: persists records (evidence: `server/models/database.py`)
- Benchmark evaluation → Developer: evaluates outcomes
