# smaranvelpula/ai-code-reviewer-gemini architecture

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

- Interactive diagram: https://gitdiagram.com/smaranvelpula/ai-code-reviewer-gemini
- Repository: https://github.com/smaranvelpula/ai-code-reviewer-gemini

## Overview

This is an AI-powered code-review web app. A developer edits source in the React interface and submits it; the backend validates the code, numbers its lines, and asks Gemini for a structured Markdown review, which the interface displays. The runtime is a small React-to-Express request path with a prompt/model layer. The README describes syntax, logic, bug, efficiency, and best-practice feedback; the sampled service prompt also requests security review and improved code. No persistent database is shown. Arrows are limited to relationships visible in excerpts or documented in the README.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/App.jsx) (Editor and submit), [`BackEnd/src/app.js`](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/app.js) (Express app), [`BackEnd/src/routes/ai.routes.js`](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/routes/ai.routes.js) (Review route), [`BackEnd/src/controllers/ai.controller.js`](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/controllers/ai.controller.js) (Review controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Review interface"]
  node_entry["React entry<br/>[main.jsx]"]
  node_app["Editor and submit<br/>[App.jsx]"]
  node_renderer["Markdown renderer<br/>[App.jsx]"]
end

subgraph group_backend["HTTP backend"]
  node_server["HTTP server<br/>[server.js]"]
  node_express["Express app<br/>[app.js]"]
  node_routes["Review route<br/>[ai.routes.js]"]
  node_controller["Review controller<br/>[ai.controller.js]"]
end

subgraph group_review["AI review"]
  node_service["Prompt and code review<br/>[ai.service.js]"]
end

node_developer(("Developer"))
node_gemini{{"Gemini API"}}

node_developer -->|"edits and submits"| node_app
node_entry -->|"renders"| node_app
node_app -->|"renders review"| node_renderer
node_app -->|"POSTs code"| node_express
node_express -->|"mounts at /ai"| node_routes
node_server -->|"starts"| node_express
node_routes -->|"dispatches review"| node_controller
node_controller -->|"requests review"| node_service
node_service -->|"generates review"| node_gemini
node_express -->|"returns response"| node_app

click node_entry "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/main.jsx"
click node_app "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/App.jsx"
click node_renderer "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/App.jsx"
click node_server "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/server.js"
click node_express "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/app.js"
click node_routes "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/routes/ai.routes.js"
click node_controller "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/controllers/ai.controller.js"
click node_service "https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/services/ai.service.js"

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_entry,node_app,node_renderer toneBlue
class node_server,node_express,node_routes,node_controller toneAmber
class node_service,node_gemini toneMint
class node_developer toneIndigo
```

## Components

### Review interface

- [React entry](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/main.jsx): `Frontend/src/main.jsx`
- [Editor and submit](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Markdown renderer](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`

### HTTP backend

- [HTTP server](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/server.js): `BackEnd/server.js`
- [Express app](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/app.js): `BackEnd/src/app.js`
- [Review route](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/routes/ai.routes.js): `BackEnd/src/routes/ai.routes.js`
- [Review controller](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/controllers/ai.controller.js): `BackEnd/src/controllers/ai.controller.js`

### AI review

- [Prompt and code review](https://github.com/smaranvelpula/ai-code-reviewer-gemini/blob/main/BackEnd/src/services/ai.service.js): `BackEnd/src/services/ai.service.js`

### Other components

- **Developer**
- **Gemini API**

## Connections

- Developer → Editor and submit: edits and submits (evidence: `Frontend/src/App.jsx`)
- React entry → Editor and submit: renders (evidence: `Frontend/src/main.jsx`)
- Editor and submit → Markdown renderer: renders review (evidence: `Frontend/src/App.jsx`)
- Editor and submit → Express app: POSTs code (evidence: `Frontend/src/App.jsx`)
- Express app → Review route: mounts at /ai (evidence: `BackEnd/src/app.js`)
- HTTP server → Express app: starts (evidence: `BackEnd/server.js`)
- Review route → Review controller: dispatches review (evidence: `BackEnd/src/routes/ai.routes.js`)
- Review controller → Prompt and code review: requests review (evidence: `BackEnd/src/controllers/ai.controller.js`)
- Prompt and code review → Gemini API: generates review (evidence: `BackEnd/src/services/ai.service.js`)
- Express app → Editor and submit: returns response (evidence: `Frontend/src/App.jsx`)
