How jagadeesh54g/qniverse works
Qniverse is an interactive quantum-computing learning platform. A learner enters through the learning interface, completes an assessment, studies structured modules, experiments with circuits, and practices through algorithm studios and challenges; progress can be saved. Authentication, a context-aware tutor, and a student community support that learning loop. The README documents the learning and simulation capabilities, while sampled API handlers confirm persistence and integration behavior; wiring between several UI components is not shown, so those links are omitted.
Main entry points: page.jsx Community · onboarding/route.js Assessment API · Playground.jsx Circuit workspace · tutor/route.js Tutor API
Components 33
Learning experience
- Landing
app/page.jsx - Learning assessment
app/onboarding/page.jsx - Assessment UI
components/OnboardingAssessment.jsx - Learning modules
app/learn/page.jsx - Lesson content
lib/lessons.js - Progress view
app/progress/page.jsx - Tutor panel
components/TutorPanel.jsx
Quantum lab
- Quantum playground
app/playground/page.jsx - Circuit workspace
components/Playground.jsx - Statevector simulation
lib/quantum.js - Code parser
lib/challenges/qasm.js - Circuit visualization
components/challenges/CircuitBuilder.jsx - Algorithm studio
app/algorithms/page.jsx - Circuit challenges
app/challenges/page.jsx - Challenge grading
lib/challenges/grader.js - Browser Python runtime
public/qniverse-py/worker.js - Python runner service
server/main.py
Learner services
- Assessment API
app/api/onboarding/route.js - Assessment scoring
lib/onboarding.js - Progress API
app/api/progress/route.js - Tutor API
app/api/tutor/route.js - Local tutor fallback
app/api/tutor/route.js - Sign-in
app/sign-in/page.jsx - Authentication API
app/api/auth/route.js - Session handling
lib/auth.js
Community
- Community
app/community/page.jsx - Posts and replies API
app/api/community/posts/route.js - Reply API
app/api/community/replies/route.js - Likes API
app/api/community/like/route.js - Student directory API
app/api/community/students/route.js
Other components
- Learner
- Qwen service
- MongoDB
Connections 33
- Learner → Landing: opens
- Learner → Learning assessment: assesses
- Learner → Learning modules: studies
- Learner → Quantum playground: experiments
- Learner → Algorithm studio: explores
- Learner → Circuit challenges: practices
- Learner → Sign-in: signs in
- Learner → Community: participates
- Assessment UI → Assessment API: submits answers
- Assessment API → Assessment scoring: scores
- Assessment API → MongoDB: writes profile
- Assessment API → Assessment scoring: uses scoring
- Learning modules → Lesson content: loads content
- Circuit workspace → Statevector simulation: simulates circuits
- Circuit workspace → Code parser: parses code
- Circuit workspace → Circuit visualization: visualizes circuits
- Circuit challenges → Challenge grading: validates solutions
- Progress view → Progress API: loads and saves
- Progress API → MongoDB: reads and writes
- Tutor panel → Tutor API: asks questions
- Tutor API → Qwen service: requests answer
- Tutor API → Local tutor fallback: falls back
- Sign-in → Authentication API: submits credentials
- Authentication API → Session handling: creates session
- Authentication API → MongoDB: reads and writes
- Community → Posts and replies API: loads and posts
- Community → Reply API: submits replies
- Community → Likes API: likes posts
- Community → Student directory API: loads students
- Posts and replies API → MongoDB: reads and writes
- Reply API → MongoDB: reads and writes
- Likes API → MongoDB: updates likes
- Student directory API → MongoDB: reads users