# garcia-786/code-reviewer architecture

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

- Interactive diagram: https://gitdiagram.com/garcia-786/code-reviewer
- Repository: https://github.com/garcia-786/code-reviewer

## Overview

This Reflex web app lets students submit Python code for AST syntax checks, Flake8 style findings, and Groq-powered feedback including issues, optimizations, and complexity estimates. The main flow runs through AnalyzerState, which gathers both analyses, updates displayed results, then saves the review; users can revisit or delete saved reviews and chat about code with the AI bot. The graph also includes the documented home-page capabilities. Some page and core excerpts are partial, so only relationships supported by shown calls or README statements are drawn.

Main entry points: [`ai_code_reviewer/components/navbar.py`](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/components/navbar.py) (Shared layout), [`ai_code_reviewer/state.py`](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py) (Analysis state), [`ai_code_reviewer/pages/analyzer.py`](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/analyzer.py) (Analyzer page), [`ai_code_reviewer/pages`](https://github.com/garcia-786/code-reviewer/tree/main/ai_code_reviewer/pages) (Page routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_app["App entry"]
  node_pages["Page routes"]
  node_home["Home features<br/>[index.py]"]
  node_shared_ui["Shared layout<br/>[navbar.py]"]
  node_footer["Footer<br/>[footer.py]"]
end

subgraph group_review["Code review"]
  node_analyzer_ui["Analyzer page<br/>[analyzer.py]"]
  node_analyzer_state["Analysis state<br/>[state.py]"]
  node_basic_checks["AST and style checks<br/>[analyzer.py]"]
end

subgraph group_assistant["AI assistant"]
  node_ai_review["AI code review<br/>[ai_helper.py]"]
  node_chat_ui["AI bot page<br/>[aibot.py]"]
  node_chat_state["Chat state<br/>[state.py]"]
end

subgraph group_history["Review history"]
  node_history_ui["History page<br/>[history.py]"]
  node_history_state["History state<br/>[state.py]"]
  node_history_ops["History persistence<br/>[history_db.py]"]
  node_history_file[("Review history file")]
end

node_student(("Student"))
node_groq{{"Groq LLM"}}

node_app -->|"registers routes"| node_pages
node_pages -.-> node_analyzer_ui
node_pages -.-> node_home
node_student -.->|"opens app"| node_home
node_student -.->|"submits code"| node_analyzer_ui
node_analyzer_ui -->|"uses layout"| node_shared_ui
node_home -->|"uses layout"| node_shared_ui
node_shared_ui -->|"renders"| node_footer
node_analyzer_ui -->|"dispatches analysis"| node_analyzer_state
node_analyzer_state -->|"runs checks"| node_basic_checks
node_analyzer_state -->|"requests AI review"| node_ai_review
node_ai_review -->|"calls model"| node_groq
node_analyzer_state -->|"saves review"| node_history_ops
node_history_ui -->|"uses layout"| node_shared_ui
node_history_ui -->|"loads and deletes"| node_history_state
node_history_state -->|"reads and deletes"| node_history_ops
node_history_ops -->|"reads and writes"| node_history_file
node_chat_ui -->|"uses layout"| node_shared_ui
node_chat_ui -->|"dispatches messages"| node_chat_state
node_chat_state -->|"requests chat"| node_ai_review

click node_app "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/ai_code_reviewer.py"
click node_pages "https://github.com/garcia-786/code-reviewer/tree/main/ai_code_reviewer/pages"
click node_home "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/index.py"
click node_shared_ui "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/components/navbar.py"
click node_footer "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/components/footer.py"
click node_analyzer_ui "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/analyzer.py"
click node_analyzer_state "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py"
click node_basic_checks "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/core/analyzer.py"
click node_ai_review "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/core/ai_helper.py"
click node_chat_ui "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/aibot.py"
click node_chat_state "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py"
click node_history_ui "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/history.py"
click node_history_state "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py"
click node_history_ops "https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/core/history_db.py"
click node_history_file "https://github.com/garcia-786/code-reviewer/blob/main/review_history.json"

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_pages,node_home,node_shared_ui,node_footer toneBlue
class node_analyzer_ui,node_analyzer_state,node_basic_checks toneAmber
class node_ai_review,node_chat_ui,node_chat_state toneMint
class node_history_ui,node_history_state,node_history_ops,node_history_file toneRose
class node_student,node_groq toneIndigo
```

## Components

### Web experience

- [App entry](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/ai_code_reviewer.py): `ai_code_reviewer/ai_code_reviewer.py`
- [Page routes](https://github.com/garcia-786/code-reviewer/tree/main/ai_code_reviewer/pages): `ai_code_reviewer/pages`
- [Home features](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/index.py): `ai_code_reviewer/pages/index.py`
- [Shared layout](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/components/navbar.py): `ai_code_reviewer/components/navbar.py`
- [Footer](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/components/footer.py): `ai_code_reviewer/components/footer.py`

### Code review

- [Analyzer page](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/analyzer.py): `ai_code_reviewer/pages/analyzer.py`
- [Analysis state](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py): `ai_code_reviewer/state.py`
- [AST and style checks](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/core/analyzer.py): `ai_code_reviewer/core/analyzer.py`

### AI assistant

- [AI code review](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/core/ai_helper.py): `ai_code_reviewer/core/ai_helper.py`
- [AI bot page](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/aibot.py): `ai_code_reviewer/pages/aibot.py`
- [Chat state](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py): `ai_code_reviewer/state.py`

### Review history

- [History page](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/pages/history.py): `ai_code_reviewer/pages/history.py`
- [History state](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/state.py): `ai_code_reviewer/state.py`
- [History persistence](https://github.com/garcia-786/code-reviewer/blob/main/ai_code_reviewer/core/history_db.py): `ai_code_reviewer/core/history_db.py`
- [Review history file](https://github.com/garcia-786/code-reviewer/blob/main/review_history.json): `review_history.json`

### Other components

- **Student**
- **Groq LLM**

## Connections

- App entry → Page routes: registers routes (evidence: `ai_code_reviewer/ai_code_reviewer.py`)
- Page routes → Analyzer page
- Page routes → Home features
- Student → Home features: opens app
- Student → Analyzer page: submits code
- Analyzer page → Shared layout: uses layout (evidence: `ai_code_reviewer/pages/analyzer.py`)
- Home features → Shared layout: uses layout (evidence: `ai_code_reviewer/pages/index.py`)
- Shared layout → Footer: renders (evidence: `ai_code_reviewer/components/navbar.py`)
- Analyzer page → Analysis state: dispatches analysis (evidence: `ai_code_reviewer/pages/analyzer.py`)
- Analysis state → AST and style checks: runs checks (evidence: `ai_code_reviewer/state.py`)
- Analysis state → AI code review: requests AI review (evidence: `ai_code_reviewer/state.py`)
- AI code review → Groq LLM: calls model (evidence: `ai_code_reviewer/core/ai_helper.py`)
- Analysis state → History persistence: saves review (evidence: `ai_code_reviewer/state.py`)
- History page → Shared layout: uses layout (evidence: `ai_code_reviewer/pages/history.py`)
- History page → History state: loads and deletes (evidence: `ai_code_reviewer/pages/history.py`)
- History state → History persistence: reads and deletes (evidence: `ai_code_reviewer/state.py`)
- History persistence → Review history file: reads and writes (evidence: `ai_code_reviewer/core/history_db.py`)
- AI bot page → Shared layout: uses layout (evidence: `ai_code_reviewer/pages/aibot.py`)
- AI bot page → Chat state: dispatches messages (evidence: `ai_code_reviewer/pages/aibot.py`)
- Chat state → AI code review: requests chat (evidence: `ai_code_reviewer/state.py`)
