# yuvaraj-ui132/algoquest architecture

> Architecture diagram of the GitHub repository yuvaraj-ui132/algoquest, 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/yuvaraj-ui132/algoquest
- Repository: https://github.com/yuvaraj-ui132/algoquest

## Overview

AlgoQuest is a DSA interview-practice platform. The main workflow is: a learner selects a curated problem, edits and runs code against visible examples, then submits for hidden-test verification and polls for a verdict; progress and submission history are persisted per user. The graph also covers account setup, saved editor code, bookmarks, notes, and analytics. Relationships use README architecture statements and the supplied source excerpts/index; unsampled frontend and route internals limit more detailed call-level links.

Main entry points: [`backend/app/main.py`](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/routes/submissions.py`](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/submissions.py) (Execution routes), [`js/app.js`](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/app.js) (Practice SPA), [`backend/app/services/firestore_service.py`](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/firestore_service.py) (User data service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Practice workspace"]
  node_spa["Practice SPA<br/>[app.js]"]
  node_problem_bank["Problem bank<br/>[questions.json]"]
  node_question_metadata["Problem metadata"]
  node_workspace["Code workspace<br/>[compiler.js]"]
  node_client_api["Authenticated API client<br/>[api.js]"]
  node_client_auth["Firebase client auth<br/>[firebase.js]"]
  node_history_ui["History analytics<br/>[history.js]"]
end

subgraph group_api["API and identity"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_auth_dependency["Token verification<br/>[dependencies.py]"]
  node_firebase_admin["Firebase Admin setup<br/>[security.py]"]
  node_request_models["Request validation<br/>[requests.py]"]
  node_response_models["Response schemas<br/>[responses.py]"]
end

subgraph group_execution["Code execution"]
  node_submission_routes["Execution routes<br/>[submissions.py]"]
  node_submission_queue["Async job queue"]
  node_judge_service["Judge0 adapter<br/>[judge0_service.py]"]
  node_hidden_tests["Hidden test cases<br/>[test_cases.json]"]
end

subgraph group_userdata["User data"]
  node_progress_routes["Progress routes<br/>[progress.py]"]
  node_bookmark_routes["Bookmark routes<br/>[bookmarks.py]"]
  node_notes_routes["Notes routes<br/>[notes.py]"]
  node_editor_routes["Saved code routes<br/>[editor.py]"]
  node_user_routes["Profile setup<br/>[user.py]"]
  node_firestore_service["User data service"]
end

subgraph group_services["External services"]
  node_firebase_auth_service["Firebase Authentication"]
  node_judge0["Judge0 CE"]
  node_firestore[("Cloud Firestore")]
end

node_learner(("Learner"))

node_learner -->|"practices in"| node_spa
node_spa -->|"shows problems"| node_problem_bank
node_spa -->|"uses metadata"| node_question_metadata
node_spa -->|"opens editor"| node_workspace
node_spa -->|"calls API"| node_client_api
node_spa -->|"authenticates with"| node_client_auth
node_spa -->|"shows analytics"| node_history_ui
node_client_api -->|"sends requests"| node_api_app
node_client_auth -->|"signs in"| node_firebase_auth_service
node_client_api -->|"sends ID token"| node_auth_dependency
node_api_app -->|"registers routes"| node_submission_routes
node_api_app -->|"registers routes"| node_progress_routes
node_api_app -->|"registers routes"| node_bookmark_routes
node_api_app -->|"registers routes"| node_notes_routes
node_api_app -->|"registers routes"| node_editor_routes
node_api_app -->|"registers routes"| node_user_routes
node_api_app -->|"initializes"| node_firebase_admin
node_submission_routes -->|"verifies user"| node_auth_dependency
node_submission_routes -->|"validates input"| node_request_models
node_submission_routes -->|"returns schema"| node_response_models
node_submission_routes -->|"loads test data"| node_hidden_tests
node_submission_routes -->|"runs code"| node_judge_service
node_submission_routes -->|"enqueues jobs"| node_submission_queue
node_submission_queue -->|"executes jobs"| node_judge_service
node_judge_service -->|"submits code"| node_judge0
node_submission_queue -->|"records results"| node_firestore_service
node_submission_routes -->|"reads history"| node_firestore_service
node_progress_routes -->|"reads and writes"| node_firestore_service
node_bookmark_routes -->|"reads and writes"| node_firestore_service
node_notes_routes -->|"reads and writes"| node_firestore_service
node_editor_routes -->|"reads and writes"| node_firestore_service
node_user_routes -->|"initializes profile"| node_firestore_service
node_firestore_service -->|"stores user data"| node_firestore
node_history_ui -->|"requests history"| node_client_api

click node_spa "https://github.com/yuvaraj-ui132/algoquest/blob/main/js/app.js"
click node_problem_bank "https://github.com/yuvaraj-ui132/algoquest/blob/main/data/questions.json"
click node_question_metadata "https://github.com/yuvaraj-ui132/algoquest/blob/main/js/question-metadata.js"
click node_workspace "https://github.com/yuvaraj-ui132/algoquest/blob/main/js/compiler.js"
click node_client_api "https://github.com/yuvaraj-ui132/algoquest/blob/main/js/api.js"
click node_client_auth "https://github.com/yuvaraj-ui132/algoquest/blob/main/js/firebase.js"
click node_history_ui "https://github.com/yuvaraj-ui132/algoquest/blob/main/js/history.js"
click node_api_app "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/main.py"
click node_auth_dependency "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/dependencies.py"
click node_firebase_admin "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/utils/security.py"
click node_request_models "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/models/requests.py"
click node_response_models "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/models/responses.py"
click node_submission_routes "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/submissions.py"
click node_submission_queue "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/submission_queue.py"
click node_judge_service "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/judge0_service.py"
click node_hidden_tests "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/data/test_cases.json"
click node_progress_routes "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/progress.py"
click node_bookmark_routes "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/bookmarks.py"
click node_notes_routes "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/notes.py"
click node_editor_routes "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/editor.py"
click node_user_routes "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/user.py"
click node_firestore_service "https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/firestore_service.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_spa,node_problem_bank,node_question_metadata,node_workspace,node_client_api,node_client_auth,node_history_ui toneBlue
class node_api_app,node_auth_dependency,node_firebase_admin,node_request_models,node_response_models toneAmber
class node_submission_routes,node_submission_queue,node_judge_service,node_hidden_tests toneMint
class node_progress_routes,node_bookmark_routes,node_notes_routes,node_editor_routes,node_user_routes,node_firestore_service toneRose
class node_firebase_auth_service,node_judge0,node_firestore,node_learner toneIndigo
```

## Components

### Practice workspace

- [Practice SPA](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/app.js): `js/app.js`
- [Problem bank](https://github.com/yuvaraj-ui132/algoquest/blob/main/data/questions.json): `data/questions.json`
- [Problem metadata](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/question-metadata.js): `js/question-metadata.js`
- [Code workspace](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/compiler.js): `js/compiler.js`
- [Authenticated API client](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/api.js): `js/api.js`
- [Firebase client auth](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/firebase.js): `js/firebase.js`
- [History analytics](https://github.com/yuvaraj-ui132/algoquest/blob/main/js/history.js): `js/history.js`

### API and identity

- [FastAPI app](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/main.py): `backend/app/main.py`
- [Token verification](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/dependencies.py): `backend/app/dependencies.py`
- [Firebase Admin setup](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/utils/security.py): `backend/app/utils/security.py`
- [Request validation](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/models/requests.py): `backend/app/models/requests.py`
- [Response schemas](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/models/responses.py): `backend/app/models/responses.py`

### Code execution

- [Execution routes](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/submissions.py): `backend/app/routes/submissions.py`
- [Async job queue](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/submission_queue.py): `backend/app/services/submission_queue.py`
- [Judge0 adapter](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/judge0_service.py): `backend/app/services/judge0_service.py`
- [Hidden test cases](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/data/test_cases.json): `backend/data/test_cases.json`

### User data

- [Progress routes](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/progress.py): `backend/app/routes/progress.py`
- [Bookmark routes](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/bookmarks.py): `backend/app/routes/bookmarks.py`
- [Notes routes](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/notes.py): `backend/app/routes/notes.py`
- [Saved code routes](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/editor.py): `backend/app/routes/editor.py`
- [Profile setup](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/routes/user.py): `backend/app/routes/user.py`
- [User data service](https://github.com/yuvaraj-ui132/algoquest/blob/main/backend/app/services/firestore_service.py): `backend/app/services/firestore_service.py`

### External services

- **Firebase Authentication**
- **Judge0 CE**
- **Cloud Firestore**

### Other components

- **Learner**

## Connections

- Learner → Practice SPA: practices in (evidence: `README.md`)
- Practice SPA → Problem bank: shows problems (evidence: `README.md`)
- Practice SPA → Problem metadata: uses metadata (evidence: `README.md`)
- Practice SPA → Code workspace: opens editor (evidence: `README.md`)
- Practice SPA → Authenticated API client: calls API (evidence: `README.md`)
- Practice SPA → Firebase client auth: authenticates with (evidence: `README.md`)
- Practice SPA → History analytics: shows analytics (evidence: `README.md`)
- Authenticated API client → FastAPI app: sends requests (evidence: `README.md`)
- Firebase client auth → Firebase Authentication: signs in (evidence: `README.md`)
- Authenticated API client → Token verification: sends ID token (evidence: `README.md`)
- FastAPI app → Execution routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Progress routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Bookmark routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Notes routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Saved code routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Profile setup: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Firebase Admin setup: initializes (evidence: `backend/app/main.py`)
- Execution routes → Token verification: verifies user (evidence: `backend/app/routes/submissions.py`)
- Execution routes → Request validation: validates input (evidence: `backend/app/routes/submissions.py`)
- Execution routes → Response schemas: returns schema (evidence: `backend/app/models/responses.py`)
- Execution routes → Hidden test cases: loads test data (evidence: `README.md`)
- Execution routes → Judge0 adapter: runs code (evidence: `backend/app/routes/submissions.py`)
- Execution routes → Async job queue: enqueues jobs (evidence: `backend/app/routes/submissions.py`)
- Async job queue → Judge0 adapter: executes jobs (evidence: `backend/app/services/submission_queue.py`)
- Judge0 adapter → Judge0 CE: submits code (evidence: `README.md`)
- Async job queue → User data service: records results (evidence: `README.md`)
- Execution routes → User data service: reads history (evidence: `README.md`)
- Progress routes → User data service: reads and writes (evidence: `backend/app/routes/progress.py`)
- Bookmark routes → User data service: reads and writes (evidence: `backend/app/routes/bookmarks.py`)
- Notes routes → User data service: reads and writes (evidence: `backend/app/routes/notes.py`)
- Saved code routes → User data service: reads and writes (evidence: `backend/app/routes/editor.py`)
- Profile setup → User data service: initializes profile (evidence: `backend/app/routes/user.py`)
- User data service → Cloud Firestore: stores user data (evidence: `README.md`)
- History analytics → Authenticated API client: requests history (evidence: `README.md`)
