How yuvaraj-ui132/algoquest works
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: main.py FastAPI app · submissions.py Execution routes · app.js Practice SPA · firestore_service.py User data service
Components 26
Practice workspace
- Practice SPA
js/app.js - Problem bank
data/questions.json - Problem metadata
js/question-metadata.js - Code workspace
js/compiler.js - Authenticated API client
js/api.js - Firebase client auth
js/firebase.js - History analytics
js/history.js
API and identity
- FastAPI app
backend/app/main.py - Token verification
backend/app/dependencies.py - Firebase Admin setup
backend/app/utils/security.py - Request validation
backend/app/models/requests.py - Response schemas
backend/app/models/responses.py
Code execution
- Execution routes
backend/app/routes/submissions.py - Async job queue
backend/app/services/submission_queue.py - Judge0 adapter
backend/app/services/judge0_service.py - Hidden test cases
backend/data/test_cases.json
User data
- Progress routes
backend/app/routes/progress.py - Bookmark routes
backend/app/routes/bookmarks.py - Notes routes
backend/app/routes/notes.py - Saved code routes
backend/app/routes/editor.py - Profile setup
backend/app/routes/user.py - User data service
backend/app/services/firestore_service.py
External services
- Firebase Authentication
- Judge0 CE
- Cloud Firestore
Other components
- Learner
Connections 34
- Learner → Practice SPA: practices in
README.md - Practice SPA → Problem bank: shows problems
README.md - Practice SPA → Problem metadata: uses metadata
README.md - Practice SPA → Code workspace: opens editor
README.md - Practice SPA → Authenticated API client: calls API
README.md - Practice SPA → Firebase client auth: authenticates with
README.md - Practice SPA → History analytics: shows analytics
README.md - Authenticated API client → FastAPI app: sends requests
README.md - Firebase client auth → Firebase Authentication: signs in
README.md - Authenticated API client → Token verification: sends ID token
README.md - FastAPI app → Execution routes: registers routes
backend/app/main.py - FastAPI app → Progress routes: registers routes
backend/app/main.py - FastAPI app → Bookmark routes: registers routes
backend/app/main.py - FastAPI app → Notes routes: registers routes
backend/app/main.py - FastAPI app → Saved code routes: registers routes
backend/app/main.py - FastAPI app → Profile setup: registers routes
backend/app/main.py - FastAPI app → Firebase Admin setup: initializes
backend/app/main.py - Execution routes → Token verification: verifies user
backend/app/routes/submissions.py - Execution routes → Request validation: validates input
backend/app/routes/submissions.py - Execution routes → Response schemas: returns schema
backend/app/models/responses.py - Execution routes → Hidden test cases: loads test data
README.md - Execution routes → Judge0 adapter: runs code
backend/app/routes/submissions.py - Execution routes → Async job queue: enqueues jobs
backend/app/routes/submissions.py - Async job queue → Judge0 adapter: executes jobs
backend/app/services/submission_queue.py - Judge0 adapter → Judge0 CE: submits code
README.md - Async job queue → User data service: records results
README.md - Execution routes → User data service: reads history
README.md - Progress routes → User data service: reads and writes
backend/app/routes/progress.py - Bookmark routes → User data service: reads and writes
backend/app/routes/bookmarks.py - Notes routes → User data service: reads and writes
backend/app/routes/notes.py - Saved code routes → User data service: reads and writes
backend/app/routes/editor.py - Profile setup → User data service: initializes profile
backend/app/routes/user.py - User data service → Cloud Firestore: stores user data
README.md - History analytics → Authenticated API client: requests history
README.md