# kaif-rizvi/elara architecture

> Architecture diagram of the GitHub repository kaif-rizvi/elara, 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/kaif-rizvi/elara
- Repository: https://github.com/kaif-rizvi/elara

## Overview

ELARA is an API-centered platform for managing bug reports and recommending developers for assignment using code similarity and a weighted ranking engine. A user-facing request enters the FastAPI application, is routed to domain endpoints, and—where assignment analysis is involved—can use retrieval and fusion components to rank developers. Repository ingestion, search, GitHub integration, and workspace/organization management are documented API capabilities; their detailed internal flows are not established by the sampled source. The graph reflects those limits rather than inferring connections between them.

Main entry points: [`backend/app/api/v1/api.py`](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/api.py) (API router), [`backend/app/api/v1/endpoints/auth.py`](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/auth.py) (Authentication endpoints), [`backend/app/api/v1/endpoints/bugs.py`](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/bugs.py) (Bug endpoints), [`backend/app/ai/fusion_engine.py`](https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/fusion_engine.py) (Assignment ranking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_app["FastAPI application<br/>[main.py]"]
  node_router["API router<br/>[api.py]"]
  node_auth["Authentication endpoints<br/>[auth.py]"]
  node_security["Token and password security<br/>[security.py]"]
  node_sessions["Session service<br/>[session_service.py]"]
  node_identity["Identity models<br/>[identity.py]"]
end

subgraph group_work["Bug and workspace workflows"]
  node_bugs["Bug endpoints<br/>[bugs.py]"]
  node_bugservice["Bug service<br/>[bug.py]"]
  node_workspaces["Workspace endpoints<br/>[workspaces.py]"]
  node_workspacesvc["Workspace service<br/>[workspace.py]"]
  node_developers["Developer profiles<br/>[developer.py]"]
  node_organizations["Organization workflows<br/>[organizations.py]"]
  node_dashboard["Dashboard endpoints<br/>[dashboard.py]"]
end

subgraph group_index["Code intelligence"]
  node_repositories["Repository endpoints<br/>[repositories.py]"]
  node_indexing["Indexing endpoints<br/>[indexing.py]"]
  node_search["Search endpoints<br/>[search.py]"]
  node_aiendpoint["AI endpoints<br/>[ai.py]"]
  node_retrieval["Context retrieval<br/>[engine.py]"]
  node_embeddings["Code embeddings<br/>[embeddings.py]"]
  node_fusion["Assignment ranking<br/>[fusion_engine.py]"]
  node_vectors[("Vector store<br/>[vector_store.py]")]
  node_github["GitHub integration<br/>[github.py]"]
end

subgraph group_platform["Platform services"]
  node_storage["Attachment storage<br/>[storage.py]"]
end

node_user(("API user"))
node_qdrant[("Qdrant")]

node_user -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_router
node_router -->|"routes to"| node_auth
node_router -->|"routes to"| node_bugs
node_router -->|"routes to"| node_workspaces
node_router -->|"routes to"| node_repositories
node_router -->|"routes to"| node_indexing
node_router -->|"routes to"| node_search
node_router -->|"routes to"| node_aiendpoint
node_router -->|"routes to"| node_github
node_router -->|"routes to"| node_organizations
node_router -->|"routes to"| node_dashboard
node_auth -->|"uses"| node_security
node_auth -->|"uses"| node_sessions
node_auth -->|"uses"| node_identity
node_bugs -->|"uses"| node_bugservice
node_bugs -->|"uses"| node_workspacesvc
node_bugs -->|"uses"| node_storage
node_workspaces -->|"uses"| node_workspacesvc
node_retrieval -->|"embeds query"| node_embeddings
node_retrieval -->|"searches vectors"| node_vectors
node_fusion -->|"embeds report"| node_embeddings
node_fusion -->|"searches vectors"| node_vectors
node_fusion -->|"ranks profiles"| node_developers
node_vectors -->|"queries and stores"| node_qdrant
node_aiendpoint -.->|"may invoke"| node_fusion
node_aiendpoint -.->|"may invoke"| node_retrieval

click node_app "https://github.com/kaif-rizvi/elara/blob/main/backend/main.py"
click node_router "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/api.py"
click node_auth "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/auth.py"
click node_security "https://github.com/kaif-rizvi/elara/blob/main/backend/app/core/security.py"
click node_sessions "https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/session_service.py"
click node_identity "https://github.com/kaif-rizvi/elara/blob/main/backend/app/models/identity.py"
click node_bugs "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/bugs.py"
click node_bugservice "https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/bug.py"
click node_workspaces "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/workspaces.py"
click node_workspacesvc "https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/workspace.py"
click node_repositories "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/repositories.py"
click node_indexing "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/indexing.py"
click node_search "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/search.py"
click node_aiendpoint "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/ai.py"
click node_retrieval "https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/retrieval/engine.py"
click node_embeddings "https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/embeddings.py"
click node_fusion "https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/fusion_engine.py"
click node_developers "https://github.com/kaif-rizvi/elara/blob/main/backend/app/models/developer.py"
click node_vectors "https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/vector_store.py"
click node_github "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/github.py"
click node_organizations "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/organizations.py"
click node_dashboard "https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/dashboard.py"
click node_storage "https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/storage.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_router,node_auth,node_security,node_sessions,node_identity,node_user toneBlue
class node_bugs,node_bugservice,node_workspaces,node_workspacesvc,node_developers,node_organizations,node_dashboard,node_qdrant toneAmber
class node_repositories,node_indexing,node_search,node_aiendpoint,node_retrieval,node_embeddings,node_fusion,node_vectors,node_github toneMint
class node_storage toneRose
```

## Components

### API and identity

- [FastAPI application](https://github.com/kaif-rizvi/elara/blob/main/backend/main.py): `backend/main.py`
- [API router](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/api.py): `backend/app/api/v1/api.py`
- [Authentication endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/auth.py): `backend/app/api/v1/endpoints/auth.py`
- [Token and password security](https://github.com/kaif-rizvi/elara/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Session service](https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/session_service.py): `backend/app/services/session_service.py`
- [Identity models](https://github.com/kaif-rizvi/elara/blob/main/backend/app/models/identity.py): `backend/app/models/identity.py`

### Bug and workspace workflows

- [Bug endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/bugs.py): `backend/app/api/v1/endpoints/bugs.py`
- [Bug service](https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/bug.py): `backend/app/services/bug.py`
- [Workspace endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/workspaces.py): `backend/app/api/v1/endpoints/workspaces.py`
- [Workspace service](https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/workspace.py): `backend/app/services/workspace.py`
- [Developer profiles](https://github.com/kaif-rizvi/elara/blob/main/backend/app/models/developer.py): `backend/app/models/developer.py`
- [Organization workflows](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/organizations.py): `backend/app/api/v1/endpoints/organizations.py`
- [Dashboard endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/dashboard.py): `backend/app/api/v1/endpoints/dashboard.py`

### Code intelligence

- [Repository endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/repositories.py): `backend/app/api/v1/endpoints/repositories.py`
- [Indexing endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/indexing.py): `backend/app/api/v1/endpoints/indexing.py`
- [Search endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/search.py): `backend/app/api/v1/endpoints/search.py`
- [AI endpoints](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/ai.py): `backend/app/api/v1/endpoints/ai.py`
- [Context retrieval](https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/retrieval/engine.py): `backend/app/ai/retrieval/engine.py`
- [Code embeddings](https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/embeddings.py): `backend/app/ai/embeddings.py`
- [Assignment ranking](https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/fusion_engine.py): `backend/app/ai/fusion_engine.py`
- [Vector store](https://github.com/kaif-rizvi/elara/blob/main/backend/app/ai/vector_store.py): `backend/app/ai/vector_store.py`
- [GitHub integration](https://github.com/kaif-rizvi/elara/blob/main/backend/app/api/v1/endpoints/github.py): `backend/app/api/v1/endpoints/github.py`

### Platform services

- [Attachment storage](https://github.com/kaif-rizvi/elara/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`

### Other components

- **API user**
- **Qdrant**

## Connections

- API user → FastAPI application: sends requests
- FastAPI application → API router: mounts routes (evidence: `backend/main.py`)
- API router → Authentication endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Bug endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Workspace endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Repository endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Indexing endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Search endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → AI endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → GitHub integration: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Organization workflows: routes to (evidence: `backend/app/api/v1/api.py`)
- API router → Dashboard endpoints: routes to (evidence: `backend/app/api/v1/api.py`)
- Authentication endpoints → Token and password security: uses (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Authentication endpoints → Session service: uses (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Authentication endpoints → Identity models: uses (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Bug endpoints → Bug service: uses (evidence: `backend/app/api/v1/endpoints/bugs.py`)
- Bug endpoints → Workspace service: uses (evidence: `backend/app/api/v1/endpoints/bugs.py`)
- Bug endpoints → Attachment storage: uses (evidence: `backend/app/api/v1/endpoints/bugs.py`)
- Workspace endpoints → Workspace service: uses (evidence: `backend/app/api/v1/endpoints/workspaces.py`)
- Context retrieval → Code embeddings: embeds query (evidence: `backend/app/ai/retrieval/engine.py`)
- Context retrieval → Vector store: searches vectors (evidence: `backend/app/ai/retrieval/engine.py`)
- Assignment ranking → Code embeddings: embeds report (evidence: `backend/app/ai/fusion_engine.py`)
- Assignment ranking → Vector store: searches vectors (evidence: `backend/app/ai/fusion_engine.py`)
- Assignment ranking → Developer profiles: ranks profiles (evidence: `backend/app/ai/fusion_engine.py`)
- Vector store → Qdrant: queries and stores (evidence: `backend/app/ai/vector_store.py`)
- AI endpoints → Assignment ranking: may invoke
- AI endpoints → Context retrieval: may invoke
