# pranay898/ai_repo_mind architecture

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

- Interactive diagram: https://gitdiagram.com/pranay898/ai_repo_mind
- Repository: https://github.com/pranay898/ai_repo_mind

## Overview

Gitly AI accepts a public GitHub repository, clones and analyzes its source, then presents architecture, codebase exploration and onboarding results in a browser workbench; users can also ask repository-aware questions. The README documents broad analysis capabilities, while sampled code confirms the controller-to-service API boundary, Gemini HTTP integration and cache-pruning behavior. Some analysis internals and frontend request wiring were not shown, so those relationships are documented or left unasserted rather than inferred from module names.

Main entry points: [`backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java) (Analysis Orchestrator), [`backend/src/main/java/com/repomind/controller/RepositoryController.java`](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/controller/RepositoryController.java) (REST Controller), [`backend/src/main/java/com/repomind/service/GeminiAIService.java`](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/GeminiAIService.java) (Gemini Integration), [`backend/src/main/java/com/repomind/repository/RepositoryEntityRepository.java`](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/RepositoryEntityRepository.java) (Repository Access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Developer Workbench"]
  node_workbench["Gitly Workbench<br/>[App.tsx]"]
end

subgraph group_api["Repository API"]
  node_controller["REST Controller"]
  node_requestmodels["Request DTOs"]
  node_analysisresult["Analysis Result DTO"]
end

subgraph group_analysis["Codebase Intelligence"]
  node_understanding["Analysis Orchestrator"]
  node_gitclone["GitHub Clone"]
  node_staticanalysis["Polyglot Analysis"]
  node_topology["Architecture Topology"]
  node_explorer["File Explorer"]
  node_workflow["Workflow Diagrams"]
  node_apis["API Discovery"]
  node_datamodels["Data Model Mapping"]
  node_onboarding["Onboarding Guide"]
end

subgraph group_assistant["AI Assistant"]
  node_chat["Codebase Chat"]
  node_gemini["Gemini Integration"]
end

subgraph group_state["Repository State"]
  node_repositoryentity["Repository Records"]
  node_analysisrecord["Analysis Records"]
  node_chatsession["Chat Sessions"]
  node_chatmessage["Chat Messages"]
  node_repositories["Repository Access"]
  node_analysisrecords["Analysis Access"]
  node_sessions["Session Access"]
  node_messages["Message Access"]
  node_pruning["Cache Pruning"]
end

node_developer(("Developer"))
node_github(("GitHub Repository"))
node_google(("Google Gemini API"))

node_developer -->|"uses"| node_workbench
node_workbench -.->|"HTTP requests"| node_controller
node_controller -->|"dispatches analysis"| node_understanding
node_controller -->|"configures key"| node_gemini
node_controller -->|"accepts"| node_requestmodels
node_understanding -.->|"returns results"| node_analysisresult
node_understanding -.->|"clones repository"| node_gitclone
node_gitclone -.->|"fetches source"| node_github
node_understanding -->|"analyzes source"| node_staticanalysis
node_understanding -->|"synthesizes topology"| node_topology
node_understanding -->|"builds file tree"| node_explorer
node_understanding -->|"generates workflows"| node_workflow
node_understanding -->|"discovers endpoints"| node_apis
node_understanding -->|"maps data models"| node_datamodels
node_understanding -->|"creates guide"| node_onboarding
node_controller -->|"dispatches chat"| node_chat
node_chat -.->|"requests answers"| node_gemini
node_gemini -->|"calls model API"| node_google
node_understanding -.->|"uses persistence"| node_repositories
node_understanding -.->|"uses persistence"| node_analysisrecords
node_understanding -.->|"uses persistence"| node_sessions
node_understanding -.->|"uses persistence"| node_messages
node_repositories -->|"stores"| node_repositoryentity
node_analysisrecords -->|"stores"| node_analysisrecord
node_sessions -->|"stores"| node_chatsession
node_messages -->|"stores"| node_chatmessage
node_pruning -->|"finds inactive"| node_repositories
node_pruning -->|"deletes records"| node_analysisrecords

click node_workbench "https://github.com/pranay898/ai_repo_mind/blob/main/frontend/src/App.tsx"
click node_controller "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/controller/RepositoryController.java"
click node_requestmodels "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/dto/AnalyzeRepoRequest.java"
click node_analysisresult "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/dto/RepositoryAnalysisResult.java"
click node_understanding "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_gitclone "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/GitHubRepositoryService.java"
click node_staticanalysis "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_topology "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_explorer "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_workflow "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_apis "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_datamodels "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_onboarding "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_chat "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java"
click node_gemini "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/GeminiAIService.java"
click node_repositoryentity "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/RepositoryEntity.java"
click node_analysisrecord "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/AnalysisRecordEntity.java"
click node_chatsession "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/ChatSessionEntity.java"
click node_chatmessage "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/ChatMessageEntity.java"
click node_repositories "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/RepositoryEntityRepository.java"
click node_analysisrecords "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/AnalysisRecordRepository.java"
click node_sessions "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/ChatSessionRepository.java"
click node_messages "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/ChatMessageRepository.java"
click node_pruning "https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/CachePruningService.java"

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_workbench toneBlue
class node_controller,node_requestmodels,node_analysisresult toneAmber
class node_understanding,node_gitclone,node_staticanalysis,node_topology,node_explorer,node_workflow,node_apis,node_datamodels,node_onboarding,node_google toneMint
class node_chat,node_gemini toneRose
class node_repositoryentity,node_analysisrecord,node_chatsession,node_chatmessage,node_repositories,node_analysisrecords,node_sessions,node_messages,node_pruning,node_developer,node_github toneIndigo
```

## Components

### Developer Workbench

- [Gitly Workbench](https://github.com/pranay898/ai_repo_mind/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Repository API

- [REST Controller](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/controller/RepositoryController.java): `backend/src/main/java/com/repomind/controller/RepositoryController.java`
- [Request DTOs](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/dto/AnalyzeRepoRequest.java): `backend/src/main/java/com/repomind/dto/AnalyzeRepoRequest.java`
- [Analysis Result DTO](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/dto/RepositoryAnalysisResult.java): `backend/src/main/java/com/repomind/dto/RepositoryAnalysisResult.java`

### Codebase Intelligence

- [Analysis Orchestrator](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [GitHub Clone](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/GitHubRepositoryService.java): `backend/src/main/java/com/repomind/service/GitHubRepositoryService.java`
- [Polyglot Analysis](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [Architecture Topology](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [File Explorer](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [Workflow Diagrams](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [API Discovery](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [Data Model Mapping](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [Onboarding Guide](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`

### AI Assistant

- [Codebase Chat](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java): `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`
- [Gemini Integration](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/GeminiAIService.java): `backend/src/main/java/com/repomind/service/GeminiAIService.java`

### Repository State

- [Repository Records](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/RepositoryEntity.java): `backend/src/main/java/com/repomind/entity/RepositoryEntity.java`
- [Analysis Records](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/AnalysisRecordEntity.java): `backend/src/main/java/com/repomind/entity/AnalysisRecordEntity.java`
- [Chat Sessions](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/ChatSessionEntity.java): `backend/src/main/java/com/repomind/entity/ChatSessionEntity.java`
- [Chat Messages](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/entity/ChatMessageEntity.java): `backend/src/main/java/com/repomind/entity/ChatMessageEntity.java`
- [Repository Access](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/RepositoryEntityRepository.java): `backend/src/main/java/com/repomind/repository/RepositoryEntityRepository.java`
- [Analysis Access](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/AnalysisRecordRepository.java): `backend/src/main/java/com/repomind/repository/AnalysisRecordRepository.java`
- [Session Access](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/ChatSessionRepository.java): `backend/src/main/java/com/repomind/repository/ChatSessionRepository.java`
- [Message Access](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/repository/ChatMessageRepository.java): `backend/src/main/java/com/repomind/repository/ChatMessageRepository.java`
- [Cache Pruning](https://github.com/pranay898/ai_repo_mind/blob/main/backend/src/main/java/com/repomind/service/CachePruningService.java): `backend/src/main/java/com/repomind/service/CachePruningService.java`

### Other components

- **Developer**
- **GitHub Repository**
- **Google Gemini API**

## Connections

- Developer → Gitly Workbench: uses (evidence: `README.md`)
- Gitly Workbench → REST Controller: HTTP requests (evidence: `README.md`)
- REST Controller → Analysis Orchestrator: dispatches analysis (evidence: `backend/src/main/java/com/repomind/controller/RepositoryController.java`)
- REST Controller → Gemini Integration: configures key (evidence: `backend/src/main/java/com/repomind/controller/RepositoryController.java`)
- REST Controller → Request DTOs: accepts (evidence: `backend/src/main/java/com/repomind/controller/RepositoryController.java`)
- Analysis Orchestrator → Analysis Result DTO: returns results (evidence: `README.md`)
- Analysis Orchestrator → GitHub Clone: clones repository (evidence: `README.md`)
- GitHub Clone → GitHub Repository: fetches source (evidence: `README.md`)
- Analysis Orchestrator → Polyglot Analysis: analyzes source (evidence: `README.md`)
- Analysis Orchestrator → Architecture Topology: synthesizes topology (evidence: `README.md`)
- Analysis Orchestrator → File Explorer: builds file tree (evidence: `README.md`)
- Analysis Orchestrator → Workflow Diagrams: generates workflows (evidence: `README.md`)
- Analysis Orchestrator → API Discovery: discovers endpoints (evidence: `README.md`)
- Analysis Orchestrator → Data Model Mapping: maps data models (evidence: `README.md`)
- Analysis Orchestrator → Onboarding Guide: creates guide (evidence: `README.md`)
- REST Controller → Codebase Chat: dispatches chat (evidence: `backend/src/main/java/com/repomind/controller/RepositoryController.java`)
- Codebase Chat → Gemini Integration: requests answers (evidence: `README.md`)
- Gemini Integration → Google Gemini API: calls model API (evidence: `backend/src/main/java/com/repomind/service/GeminiAIService.java`)
- Analysis Orchestrator → Repository Access: uses persistence (evidence: `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`)
- Analysis Orchestrator → Analysis Access: uses persistence (evidence: `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`)
- Analysis Orchestrator → Session Access: uses persistence (evidence: `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`)
- Analysis Orchestrator → Message Access: uses persistence (evidence: `backend/src/main/java/com/repomind/service/RepositoryUnderstandingService.java`)
- Repository Access → Repository Records: stores (evidence: `backend/src/main/java/com/repomind/repository/RepositoryEntityRepository.java`)
- Analysis Access → Analysis Records: stores (evidence: `backend/src/main/java/com/repomind/repository/AnalysisRecordRepository.java`)
- Session Access → Chat Sessions: stores (evidence: `backend/src/main/java/com/repomind/repository/ChatSessionRepository.java`)
- Message Access → Chat Messages: stores (evidence: `backend/src/main/java/com/repomind/repository/ChatMessageRepository.java`)
- Cache Pruning → Repository Access: finds inactive (evidence: `backend/src/main/java/com/repomind/service/CachePruningService.java`)
- Cache Pruning → Analysis Access: deletes records (evidence: `backend/src/main/java/com/repomind/service/CachePruningService.java`)
