How jayendra-877/qubitquest works
QubitQuest is a quantum-learning game: learners study theory, build circuits, run simulations, and complete challenges for progress. The frontend exposes learning, sandbox, authentication, and challenge views; the Java backend contains the richer documented domain, including saved circuits, AI assistance, and live arena matchmaking. Circuit execution is a separate Qiskit service. The tree also contains an Express API alongside the Java backend; its routing is visible, but its broader role and frontend integrations are not established by the excerpts.
Main entry points: App.jsx Route application · AuthController.java Authentication API · execution_routes.py Execution endpoints · auth.js Express auth
Components 24
Learner experience
- Route application
frontend/src/App.jsx - Login and signup
frontend/src/pages/Auth - Theory learning
frontend/src/pages/Learning/Learning.jsx - Challenge views
frontend/src/pages/Challenges/ChallengeDetail.jsx - Circuit sandbox
frontend/src/pages/Sandbox/Sandbox.jsx - Circuit canvas
frontend/src/components/CircuitCanvas/CircuitCanvas.jsx
Learning and play
- Challenge API
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/controller/ChallengeController.java - Challenge workflow
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service/ChallengeService.java - Saved circuits
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service/SavedCircuitService.java - Live arena
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service - Arena state
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service/Impl/ArenaRedisService.java
Identity
- Authentication API
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/controller/AuthController.java - Account service
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service/Impl/AuthServiceImpl.java - JWT tokens
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/security/JwtTokenService.java - User records
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/repository/UserRepository.java
Circuit simulation
- Execution client
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service/ExecutionClient.java - Execution endpoints
QubitQuest-ExecutionService/app/api/execution_routes.py - Qiskit simulation
QubitQuest-ExecutionService/app/services/qiskit_service.py - Simulation results
QubitQuest-ExecutionService/app/models/circuit_models.py
Express API
- Express API router
backend/server.js - Express auth
backend/routes/auth.js - Token middleware
backend/middleware/authMiddleware.js - Express users
backend/models/User.js
Other components
- Learner
Connections 23
- Learner → Route application: uses
frontend/src/App.jsx - Route application → Login and signup: routes to
frontend/src/App.jsx - Route application → Theory learning: routes to
frontend/src/App.jsx - Route application → Challenge views: routes to
frontend/src/App.jsx - Route application → Circuit sandbox: routes to
frontend/src/App.jsx - Learner → Authentication API: requests
- Authentication API → Account service: delegates
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/controller/AuthController.java - Authentication API → JWT tokens: issues token
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/controller/AuthController.java - Account service → User records: reads and writes
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/service/Impl/AuthServiceImpl.java - Learner → Challenge API: requests
- Challenge API → Challenge workflow: delegates
QubitQuest-Backend/src/main/java/com/sih/Q_Six/QubitQuest/controller/ChallengeController.java - Learner → Circuit canvas: builds circuit
- Circuit sandbox → Execution client: submits circuit
- Challenge workflow → Execution client: runs circuit
- Execution client → Execution endpoints: calls
- Execution endpoints → Qiskit simulation: runs simulation
QubitQuest-ExecutionService/app/api/execution_routes.py - Execution endpoints → Simulation results: formats response
QubitQuest-ExecutionService/app/api/execution_routes.py - Learner → Saved circuits: manages circuits
- Learner → Live arena: plays matches
- Live arena → Arena state: stores match state
- Express API router → Express auth: mounts route
backend/server.js - Express auth → Express users: reads and writes
backend/routes/auth.js - Express auth → Token middleware: protects profile
backend/routes/auth.js