# arnav-aka-guy/repository-scanner-engine architecture

> Architecture diagram of the GitHub repository arnav-aka-guy/repository-scanner-engine, 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/arnav-aka-guy/repository-scanner-engine
- Repository: https://github.com/arnav-aka-guy/repository-scanner-engine

## Overview

Repository Scanner Engine is a codebase-intelligence application: users scan local or public GitHub repositories, then explore parsed source, dependency structure, search code, ask citation-grounded questions, and review health and technical debt. The backend coordinates scanning, graph analysis, embeddings, retrieval, and LLM responses; the frontend exposes these workflows. The README documents several capabilities whose implementation files were not sampled, so those connections are shown only where documented; unsampled internal wiring is omitted or marked unverified.

Main entry points: [`backend/main.py`](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/main.py) (FastAPI runtime), [`frontend/src/App.tsx`](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/App.tsx) (React application), [`backend/api/repository.py`](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/repository.py) (Repository scanning API), [`backend/parser/service.py`](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/service.py) (Incremental parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop and UI"]
  node_desktop["Electron shell<br/>[main.js]"]
  node_app["React application<br/>[App.tsx]"]
  node_repo_ui["Repository explorer"]
  node_architecture_ui["Architecture viewer"]
  node_workspace["Workspace state<br/>[workspaceStore.ts]"]
  node_health_ui["Health dashboard"]
end

subgraph group_api["API workflows"]
  node_repository_api["Repository scanning API<br/>[repository.py]"]
  node_graph_api["Graph and visualization API<br/>[visualization.py]"]
  node_chat_api["Chat API<br/>[chat.py]"]
  node_health_api["Health and debt APIs<br/>[health_score.py]"]
end

subgraph group_analysis["Repository analysis"]
  node_parser["Incremental parser<br/>[service.py]"]
  node_scanner["Repository scanner<br/>[scanner.py]"]
  node_language_parsers["Language parsers<br/>[python_parser.py]"]
  node_graph["Graph analysis<br/>[service.py]"]
  node_health_services["Health and debt analysis<br/>[health_score.py]"]
  node_github["GitHub clone service<br/>[github_scanner.py]"]
end

subgraph group_intelligence["Search and AI"]
  node_embeddings["Embedding index<br/>[service.py]"]
  node_vector_store[("Per-repository vector store<br/>[store.py]")]
  node_retrieval["Hybrid retrieval<br/>[service.py]"]
  node_llm["LLM orchestration<br/>[service.py]"]
  node_providers["LLM providers"]
end

subgraph group_platform["Runtime platform"]
  node_backend["FastAPI runtime<br/>[main.py]"]
  node_security["Request security<br/>[auth.py]"]
  node_database[("Optional database<br/>[database.py]")]
end

node_user(("Engineer"))
node_repository["Code repository"]
node_github_service(("GitHub"))
node_llm_service(("Configured LLM"))

node_user -->|"uses"| node_desktop
node_desktop -->|"hosts"| node_app
node_user -->|"uses"| node_app
node_app -->|"routes to"| node_repo_ui
node_app -->|"routes to"| node_architecture_ui
node_repo_ui -->|"uses"| node_workspace
node_architecture_ui -->|"uses"| node_workspace
node_user -->|"reviews"| node_health_ui
node_app -->|"routes to"| node_health_ui
node_app -->|"HTTP requests"| node_backend
node_backend -->|"mounts"| node_repository_api
node_backend -->|"mounts"| node_graph_api
node_backend -->|"mounts"| node_chat_api
node_backend -->|"authenticates"| node_security
node_backend -->|"initializes"| node_database
node_repository -->|"scanned by"| node_repository_api
node_repository_api -->|"parses"| node_parser
node_repository_api -->|"indexes"| node_embeddings
node_repository_api -->|"clones via"| node_github
node_github_service -->|"clones from"| node_github
node_parser -->|"discovers files"| node_scanner
node_parser -->|"parses files"| node_language_parsers
node_graph_api -->|"requests graphs"| node_graph
node_graph -.->|"uses parsed files"| node_parser
node_embeddings -->|"stores vectors"| node_vector_store
node_chat_api -.->|"retrieves context"| node_retrieval
node_chat_api -.->|"requests answers"| node_llm
node_retrieval -->|"searches vectors"| node_embeddings
node_retrieval -->|"retrieves structure"| node_graph
node_llm -->|"generates through"| node_providers
node_providers -.->|"queries provider"| node_llm_service
node_health_ui -.->|"requests analysis"| node_health_api
node_health_api -.->|"runs analysis"| node_health_services

click node_desktop "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/desktop/main.js"
click node_app "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/App.tsx"
click node_repo_ui "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/pages/RepositoryExplorer.tsx"
click node_architecture_ui "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/pages/ArchitectureViewer.tsx"
click node_workspace "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/stores/workspaceStore.ts"
click node_health_ui "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/pages/HealthDashboard.tsx"
click node_repository_api "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/repository.py"
click node_graph_api "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/visualization.py"
click node_chat_api "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/chat.py"
click node_health_api "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/health_score.py"
click node_parser "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/service.py"
click node_scanner "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/scanner.py"
click node_language_parsers "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/python_parser.py"
click node_graph "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/graph/service.py"
click node_health_services "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/services/health_score.py"
click node_embeddings "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/embeddings/service.py"
click node_vector_store "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/embeddings/store.py"
click node_retrieval "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/retrieval/service.py"
click node_llm "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/llm/service.py"
click node_providers "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/llm/provider_manager.py"
click node_github "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/services/github_scanner.py"
click node_backend "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/main.py"
click node_security "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/security/auth.py"
click node_database "https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/db/database.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_desktop,node_app,node_repo_ui,node_architecture_ui,node_workspace,node_health_ui toneBlue
class node_repository_api,node_graph_api,node_chat_api,node_health_api toneAmber
class node_parser,node_scanner,node_language_parsers,node_graph,node_health_services,node_github toneMint
class node_embeddings,node_vector_store,node_retrieval,node_llm,node_providers toneRose
class node_backend,node_security,node_database,node_user,node_repository,node_github_service,node_llm_service toneIndigo
```

## Components

### Desktop and UI

- [Electron shell](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/desktop/main.js): `desktop/main.js`
- [React application](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Repository explorer](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/pages/RepositoryExplorer.tsx): `frontend/src/pages/RepositoryExplorer.tsx`
- [Architecture viewer](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/pages/ArchitectureViewer.tsx): `frontend/src/pages/ArchitectureViewer.tsx`
- [Workspace state](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/stores/workspaceStore.ts): `frontend/src/stores/workspaceStore.ts`
- [Health dashboard](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/frontend/src/pages/HealthDashboard.tsx): `frontend/src/pages/HealthDashboard.tsx`

### API workflows

- [Repository scanning API](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/repository.py): `backend/api/repository.py`
- [Graph and visualization API](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/visualization.py): `backend/api/visualization.py`
- [Chat API](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/chat.py): `backend/api/chat.py`
- [Health and debt APIs](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/api/health_score.py): `backend/api/health_score.py`

### Repository analysis

- [Incremental parser](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/service.py): `backend/parser/service.py`
- [Repository scanner](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/scanner.py): `backend/parser/scanner.py`
- [Language parsers](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/parser/python_parser.py): `backend/parser/python_parser.py`
- [Graph analysis](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/graph/service.py): `backend/graph/service.py`
- [Health and debt analysis](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/services/health_score.py): `backend/services/health_score.py`
- [GitHub clone service](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/services/github_scanner.py): `backend/services/github_scanner.py`

### Search and AI

- [Embedding index](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/embeddings/service.py): `backend/embeddings/service.py`
- [Per-repository vector store](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/embeddings/store.py): `backend/embeddings/store.py`
- [Hybrid retrieval](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/retrieval/service.py): `backend/retrieval/service.py`
- [LLM orchestration](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/llm/service.py): `backend/llm/service.py`
- [LLM providers](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/llm/provider_manager.py): `backend/llm/provider_manager.py`

### Runtime platform

- [FastAPI runtime](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/main.py): `backend/main.py`
- [Request security](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/security/auth.py): `backend/security/auth.py`
- [Optional database](https://github.com/arnav-aka-guy/repository-scanner-engine/blob/main/backend/db/database.py): `backend/db/database.py`

### Other components

- **Engineer**
- **Code repository**
- **GitHub**
- **Configured LLM**

## Connections

- Engineer → Electron shell: uses
- Electron shell → React application: hosts
- Engineer → React application: uses
- React application → Repository explorer: routes to (evidence: `frontend/src/App.tsx`)
- React application → Architecture viewer: routes to (evidence: `frontend/src/App.tsx`)
- Repository explorer → Workspace state: uses (evidence: `frontend/src/pages/RepositoryExplorer.tsx`)
- Architecture viewer → Workspace state: uses (evidence: `frontend/src/pages/ArchitectureViewer.tsx`)
- Engineer → Health dashboard: reviews
- React application → Health dashboard: routes to (evidence: `frontend/src/App.tsx`)
- React application → FastAPI runtime: HTTP requests
- FastAPI runtime → Repository scanning API: mounts (evidence: `backend/main.py`)
- FastAPI runtime → Graph and visualization API: mounts (evidence: `backend/main.py`)
- FastAPI runtime → Chat API: mounts (evidence: `backend/main.py`)
- FastAPI runtime → Request security: authenticates (evidence: `backend/main.py`)
- FastAPI runtime → Optional database: initializes (evidence: `backend/main.py`)
- Code repository → Repository scanning API: scanned by (evidence: `backend/api/repository.py`)
- Repository scanning API → Incremental parser: parses (evidence: `backend/api/repository.py`)
- Repository scanning API → Embedding index: indexes (evidence: `backend/api/repository.py`)
- Repository scanning API → GitHub clone service: clones via (evidence: `backend/api/repository.py`)
- GitHub → GitHub clone service: clones from
- Incremental parser → Repository scanner: discovers files (evidence: `backend/parser/service.py`)
- Incremental parser → Language parsers: parses files (evidence: `backend/parser/service.py`)
- Graph and visualization API → Graph analysis: requests graphs (evidence: `backend/api/visualization.py`)
- Graph analysis → Incremental parser: uses parsed files
- Embedding index → Per-repository vector store: stores vectors (evidence: `backend/embeddings/service.py`)
- Chat API → Hybrid retrieval: retrieves context
- Chat API → LLM orchestration: requests answers
- Hybrid retrieval → Embedding index: searches vectors (evidence: `backend/retrieval/service.py`)
- Hybrid retrieval → Graph analysis: retrieves structure (evidence: `backend/retrieval/service.py`)
- LLM orchestration → LLM providers: generates through (evidence: `backend/llm/service.py`)
- LLM providers → Configured LLM: queries provider
- Health dashboard → Health and debt APIs: requests analysis
- Health and debt APIs → Health and debt analysis: runs analysis
